Architecture
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/cacheetpkg/batchfournissent 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.