Ecosystème et outils

Aperçu

L’écosystème Goa comprend des bibliothèques et des outils complémentaires qui répondent aux besoins courants du développement de services et de systèmes d’agents. Ces projets sont conçus pour fonctionner de manière transparente avec Goa et Goa-AI, mais peuvent également être utilisés indépendamment.

Bibliothèques et outils compagnons

Modèle - Diagrammes d’architecture en tant que code

Model fournit un DSL Go pour décrire l’architecture logicielle en utilisant le modèle C4. Au lieu de dessiner des diagrammes dans des outils graphiques, vous définissez votre architecture dans le code :

var _ = Design("My System", "System description", func() {
    var System = SoftwareSystem("My System", "Does something useful")
    
    Person("User", "A user of the system", func() {
        Uses(System, "Uses")
    })
    
    Views(func() {
        SystemContextView(System, "Context", "System context diagram", func() {
            AddAll()
            AutoLayout(RankLeftRight)
        })
    })
})

Avantages:

• Documentation de l’architecture contrôlée par version
• Génération automatique de diagrammes (SVG, JSON)
• Editeur graphique interactif pour le positionnement
• Plugin Goa pour les conceptions combinées API + architecture

En savoir plus: Documentation du modèle

Pulse - Infrastructure d’événements distribués

Pulse fournit des primitives pour construire des systèmes distribués pilotés par les événements. Il est agnostique au niveau du transport et fonctionne avec ou sans les services Goa :

• Streaming : Routage d’événements pub/sub à travers des microservices
• Pools de travailleurs : Travailleurs dédiés avec un hachage cohérent pour la répartition des tâches
• Cartes répliquées : État partagé éventuellement cohérent entre les nœuds

// Publish events to a stream
stream.Add(ctx, "user.created", userEvent)

// Subscribe to events
reader.Subscribe(ctx, func(event *Event) error {
    return processEvent(event)
})

Cas d’utilisation:

• Traitement asynchrone des événements
• Files d’attente de travaux en arrière-plan
• Mise en cache distribuée
• Notifications en temps réel

En savoir plus: Pulse Documentation

Indice - Observabilité des microservices

Clue fournit une instrumentation pour les services Goa construits sur OpenTelemetry. Il couvre les trois piliers de l’observabilité :

// Configure OpenTelemetry
cfg := clue.NewConfig(ctx, "myservice", "1.0.0", metricExporter, spanExporter)
clue.ConfigureOpenTelemetry(ctx, cfg)

// Context-based logging
log.Info(ctx, "processing request", log.KV{"user_id", userID})

// Health checks
checker := health.NewChecker(health.NewPinger("db", dbAddr))

Caractéristiques:

• Traçage distribué avec propagation automatique de la portée
• Journalisation structurée avec mise en mémoire tampon intelligente
• Collecte et exportation de métriques
• Points d’extrémité pour les bilans de santé
• Points d’extrémité de débogage pour le dépannage en cours d’exécution

En savoir plus: Clue Documentation

Chorus - Coordination multi-agents via MCP

Chorus est un serveur MCP construit avec Goa-AI et Pulse permettant à plusieurs agents de codage de se coordonner entre terminaux et familles de modèles via des #channels et des messages directs @agent :

# Installer Chorus, enregistrer http://localhost:9440/mcp et démarrer le service en arrière-plan
curl -fsSL https://raw.githubusercontent.com/goadesign/chorus/main/scripts/install.sh | sh

# Ou installer la skill de l'agent via la CLI Skills
npx skills add goadesign/chorus --skill chorus

Caractéristiques:

• Cinq outils MCP (who, join, leave, send, read) sur un point de terminaison POST /mcp unique
• Curseurs de lecture par agent dans pulse/rmap et journaux de messages bornés dans pulse/streaming
• Livraison groupée des messages non lus sur send et réponses compactes en texte brut
• Écouteur système en arrière-plan (chorus watch) qui bloque jusqu’à l’arrivée d’un message direct, d’une mention ou d’une réponse

En savoir plus: Chorus Documentation

Guides de documentation

Section totale: ~8 600 jetons

Démarrage

Choisissez la bibliothèque ou l’outil qui correspond à vos besoins :

• Documentation d’architecture ? Commencez par Model
• Construire des systèmes pilotés par les événements ? Commencez avec Pulse
• Ajouter de l’observabilité aux services Goa ? Commencez avec Clue
• Coordonner plusieurs agents de codage ? Commencez avec Chorus

Toutes les bibliothèques et outils sont disponibles via go get / go install :

go get goa.design/model
go get goa.design/pulse
go get goa.design/clue
go install github.com/goadesign/chorus/cmd/chorus@latest