Aller au contenu

Référence

Paquets partagés

Où se trouve le comportement commun de l’infrastructure.

Sur cette page

Portée

Le code des services utilise les paquets partagés pour accéder à l’infrastructure. Si une opération manque, ajoutez-la au paquet partagé au lieu d’émettre des commandes client brutes ou d’ajouter des scripts dans app/. Le fichier AGENTS.md du dépôt demande aussi d’utiliser les constructeurs existants afin de conserver leurs délais, métriques et contrôles d’identité.

Carte des paquets

Paquet Point de départ pour
pkg/bus Connexions NATS, publication, consommateurs et request-reply
pkg/db Connexion, configuration, pool et aides de réessai de la base
pkg/valkey Opérations du client Valkey et primitives atomiques
pkg/ratelimit Coordination et stockage des limites de débit
pkg/cache Caches locaux, chargement et invalidation
pkg/batch Regroupement en mémoire et cycle de flush
pkg/svcboot Démarrage commun et câblage de l’infrastructure
pkg/health et pkg/monitor Santé et surveillance

Contrats d’échec

Ces paquets n’ont pas tous le même contrat d’échec. Par exemple, pkg/batch garde les mises à jour en mémoire et réessaie les flushs échoués; une écriture acceptée n’est pas automatiquement durable. Un délai NATS peut signifier qu’aucune réponse n’a été reçue, sans prouver que l’opération distante n’a pas eu lieu. Lisez la fonction, ses tests et le service appelant avant de choisir une stratégie de réessai ou de signaler une réussite.

Les tests sont à côté des implémentations. Le câblage propre à chaque service et les règles du domaine restent dans app/ et internal/; utilisez la couche partagée pour les mécanismes et le service propriétaire pour les décisions métier.