Glossaire

Termes qui apparaissent tout au long du guide et de l’app.

• Microservice (micro) : un dépôt lançable. Il est décrit par un manifeste autogénéré.
• Manifeste : la description de comment démarrer un micro (technologie, ports, infrastructure, dépendances, démarrage). Autodétectée ; vous ne faites que la relire.
• Stack : la technologie d’un micro (quarkus, spring-boot, node, angular, python). Elle détermine comment il démarre, où est son health et comment la configuration lui est injectée.
• Scénario : un ensemble de micros lancés ensemble pour tester un flux.
• Dépendance : un core qu’un micro appelle en REST. Elle se résout en local, cloud ou mock.
• Infrastructure (infra) : Kafka, Redis et PostgreSQL communs, dans Docker.
• Mode d’exécution : chaque micro tourne en natif (rapide, pour celui que vous développez) ou en conteneur (isolé, pour ceux d’arrière-plan).
• Vérification de l’environnement (doctor) : le rapport indiquant si vous avez le nécessaire pour lancer un scénario —outils, dépôts, Docker, bases de données, identifiants— avant de démarrer.
• Perspective : d’où les hôtes sont résolus (la machine ou un conteneur) ; elle détermine quelle adresse est injectée à chaque client.
• Advertised listener : adresse que Kafka annonce à ses clients ; elle doit être atteignable depuis où tourne le client (d’où le double listener du compose).
• Port effectif : le port réel assigné après résolution des collisions. Les micros déclarent leur port (p. ex. 8080) et MicroLab le remappe au lancement si nécessaire.
• Manifeste remote / configuration effective : la valeur finale de chaque propriété d’un micro et de quelle couche elle provient (l’application.yml du dépôt, la configuration remote ou ce que MicroLab injecte au démarrage).
• Espace de travail : le dossier de base qui contient les dépôts des micros.
• .microlab/ : le dossier où vit la configuration MicroLab d’un projet (scénarios, mocks, bases de données, paramètres locaux, état d’exécution).
• Personnalisation de démarrage (run override) : réglages locaux, non versionnés, du démarrage natif d’un micro (propriétés, arguments, base de données…).
• Commandes préalables (preCommands) : ce qui s’exécute avant de démarrer un micro (construire les bibliothèques du workspace, installer les modules frères d’un multi-module Maven…). Elles vivent dans le manifeste : valables pour toute l’équipe.
• Paquet (bundle) : un fichier autonome avec un scénario (ou tout le catalogue) pour le partager ou le transférer vers une autre machine.
• Capacité : ce que votre licence vous permet d’utiliser : app, cli, mcp, chat.
• Control server : l’API HTTP locale (avec token) que publie le processus qui héberge le moteur ; c’est ce qu’utilise le CLI pour parler à un moteur déjà actif.
• MCP (Model Context Protocol) : le protocole par lequel MicroLab expose une surface curée d’outils aux agents d’IA.
• Copilote : le chat dans l’app, avec les mêmes outils que le MCP.