Aller au contenu

Architecture

Code des services de données

Le parcours d’une requête dans les couches du service.

Sur cette page

Portée et composants

Un service de données sépare généralement son contrat réseau, son gestionnaire et son code de persistance. Ce schéma aide à naviguer dans le code; chaque opération ne suit pas nécessairement le même chemin.

flowchart LR
    Client --> DTO["DTO de requête RPC"]
    DTO --> Handler["Gestionnaire RPC"]
    Handler --> Repo["Dépôt"]
    Repo --> Ent["Ent et base de données"]
    Repo --> Event["Événement de changement"]
  • internal/domain/rpc/ définit les types de requête et de réponse partagés; internal/domain/event/ définit les événements.
  • app/db/<service>/rpc/ traite les opérations. app/db/<service>/repository/ implémente la persistance, les caches et les lots propres au service.
  • app/db/<service>/ent/schema/ définit les entités Ent. Le code Ent généré est à côté.
  • pkg/bus, pkg/db, pkg/cache et pkg/batch fournissent les mécanismes partagés. Le code des services utilise ces paquets pour les systèmes dont ils sont responsables.

Invariants et échecs

Pour modifier un contrat, suivez l’appelant, le gestionnaire, le dépôt et les consommateurs. Un transport réussi peut contenir un refus applicatif; vérifiez error et, s’il est fourni, code (internal/domain/rpc/code.go).

Parcours d’un instantané utilisateur

Le DTO de projection transporte user_id sous forme de chaîne. Le gestionnaire RPC users le valide, appelle le dépôt, transforme un compte absent en refus not_found et construit un instantané. L’hydrateur consomme la réponse et écrit l’état dérivé. Ni l’appelant ni le projecteur ne consulte directement le schéma users.

Cette séparation guide l’ajout d’un champ : modifiez le schéma et le dépôt du propriétaire, puis le DTO et le gestionnaire, le stockage de projection et ses lecteurs. Testez la sérialisation et les refus à la frontière, puis les données absentes ou périmées chez le consommateur. Les fichiers Ent générés suivent le schéma; voir Tests et le workflow Go pour la génération et les vérifications.