Modules métier

Le dossier backend/src/api contient neuf modules. Chacun est un routeur Express monté par backend/src/app.ts sous /api/v1/<module> et, pour compatibilité, sous /api/<module>. Le module système fait exception : ses routes sont montées à la racine du serveur. Les pages de cette section décrivent chaque route avec ses règles métier, sa validation, ses autorisations, ses erreurs et ses effets de bord. La liste brute des 70 routes est générée sur la page Référence de l'API.

#Vue d'ensemble

#Dépendances entre modules

Les modules ne s'appellent pas par HTTP. Ils importent directement les services et repositories les uns des autres, ainsi que les services transverses.

flowchart LR
    auth["auth"] --> ledger["ledgerService"]
    auth --> wallet["walletService"]
    auth --> oauth["oauthVerifierService"]
    lottery["lottery"] --> authRepo["authRepository"]
    lottery --> ledger
    lottery --> gateway["lotteryGateway"]
    lottery --> bsvc["blockchainService"]
    marketplace["marketplace"] --> ledger
    marketplace --> partners["partners : assertPartnerAccess"]
    marketplace --> authRepo
    user["user"] --> ledger
    admin["admin"] --> analytics["analytics"]
    admin --> bsvc
    admin --> gateway
    admin --> emails["file emails-queue"]
    admin --> wallet
    webhooks["webhooks"] --> indexer["blockchainIndexerWorker"]
    gateway --> indexer2["lotteryIndexer"]
    indexer2 --> ledger

#Conventions communes

Toutes les pages de module s'appuient sur les mêmes conventions, détaillées dans Réponses et erreurs.

Le chemin d'une erreur de validation commence par body., query. ou params. car le schéma valide l'objet { body, query, params }.

#Matrice des droits

Résumé des accès par rôle. Les règles fines (propriété d'une entreprise partenaire, 2FA des administrateurs) sont décrites sur chaque page et dans Autorisations et matrice des droits.

#Deux modes d'exécution

Plusieurs modules se comportent différemment selon BLOCKCHAIN_MODE. Le test est fait par chainClient.isOnchain dans chaque service.

La page Mode onchain ou simulé décrit ces deux modes du point de vue de l'intégration blockchain.