Aller au contenu

Architecture

Vue du système

Les limites et le parcours principal des requêtes.

Sur cette page

Portée et composants

ItsBagelBot reçoit les événements des plateformes, évalue le comportement du bot et renvoie des actions à la plateforme. Les diffuseurs configurent ce comportement dans le tableau de bord. Les services communiquent par NATS; les services de données possèdent leurs schémas et exposent des opérations au lieu de partager leur accès à la base.

flowchart LR
    Twitch --> Ingress["Entrée Twitch"]
    Ingress -->|événements| Sesame
    Sesame -->|actions| Outgress["Sortie Twitch"]
    Outgress --> Twitch
    Dashboard["Tableau de bord"] -->|RPC| Owners["Services de données"]
    Owners -->|événements| Projector["Projecteur"]
    Projector --> Projection[("Projection Valkey")]
    Sesame --> Projection

L’entrée Twitch est en Elixir (app/twitch/ingress); Sesame et la sortie sont en Go (app/twitch/sesame, app/twitch/outgress). Les applications dashboard et admin sont sous web/.

Ce diagramme est un point de départ, pas un graphe complet des dépendances. Voir État du système, Données et état et CONTEXT-MAP.md à la racine. La configuration de déploiement se trouve sous deploy/.

Suivre un événement dans le code

  1. L’entrée reçoit les événements Twitch et publie des messages normalisés. Les sujets et les flux distinguent les voies de trafic; voir les définitions des flux.
  2. Sesame charge le contexte de la chaîne et applique les contrôles des modules et commandes. Une entrée absente du modèle de lecture peut nécessiter un RPC au propriétaire; le client de projection implémente ces lectures.
  3. Sesame publie une action pour la sortie, qui exécute la requête vers la plateforme. L’acceptation d’un message et la réussite de l’appel Twitch sont deux résultats distincts.

Le parcours utilise des délais et une rétention limitée. Un consommateur redémarré peut reprendre le travail encore conservé, mais pas les messages expirés. Les appelants doivent traiter les dépendances indisponibles et les délais dépassés; voir Contrats RPC et Projection.

Modifier une fonctionnalité entre services

Commencez par le service propriétaire et son contrat sous internal/domain. Suivez le producteur ou le client RPC, le gestionnaire, le stockage et les consommateurs. Modifiez les deux côtés et leurs tests ensemble; les permissions des sujets sont dans accounts.yaml. Gardez l’accès aux systèmes externes dans les paquets partagés et vérifiez si l’opération exige un résultat durable, un effet sûr à réessayer ou une projection jetable.