Service Ledger Wallets

Page en construction (Lot 4 de la refonte documentaire)

Identité

Attribut	Valeur
Port	3002
Schéma DB	dédié
Owner	@ledger-team

Responsabilité

Service comptable double-entrée de Nex. Tient les soldes des wallets, exécute les écritures ledger, expose les intents/transactions ledger-side, gère les cards et payment methods.

Pages à produire

• overview.md (cette page) — vue synthétique.
• api.md — endpoints exposés (auto-généré depuis @nestjs/swagger).
• data-model.md — entités, ERD, contraintes, FK.
• runbook.md — alertes, troubleshooting, points d’entrée on-call.
• threat-model.md — STRIDE local, contrôles, dettes identifiées.

À couvrir dans la refonte (référentiels non documentés)

Audit de couverture (2026-06-05) — ces référentiels « types » n'ont aucune référence canonique aujourd'hui et doivent être documentés (probablement dans data-model.md) :

• Types de comptes (accounts.account_type) : current, main, treasury, commission, suspense, fee_collection, vat_collection, black_account.
• Comptes système (rôle de chacun) : TREASURY (émission / cantonnement e-money), FEE_COLLECTION (frais de service), VAT_COLLECTION (TVA collectée, NS-89), SUSPENSE (transit), BLACK_ACCOUNT (contrepartie technique).
• operation_type des écritures ledger (nomenclature) : payment, funding, transfer, freeze, unfreeze, withdrawal, deposit, refund, fee, adjustment, commission, tax (NS-90), treasury_recall / treasury_destruction / treasury_distribution, master_agent_cash_in / master_agent_cash_out / master_agent_commission_collect, merchant_payout.

Voir aussi le compte VAT_COLLECTION et le moteur de tarification côté Configuration — frais & TVA.

Références existantes

• Compliance — Audit 2026 Ledger Wallets — 5 piliers d’audit avec dettes ouvertes.
• Système de transactions — vue cross-service.