Glossario

Termini che appaiono in tutta la guida e nell’app.

• Microservizio (micro): un repository avviabile. È descritto da un manifesto autogenerato.
• Manifesto: la descrizione di come avviare un micro (tecnologia, porte, infrastruttura, dipendenze, avvio). Rilevata automaticamente; la rivedi soltanto.
• Stack: la tecnologia di un micro (quarkus, spring-boot, node, angular, python). Determina come si avvia, dove sta il suo health e come gli viene iniettata la configurazione.
• Scenario: un insieme di micro avviati insieme per testare un flusso.
• Dipendenza: un core che un micro chiama via REST. Si risolve come local, cloud o mock.
• Infrastruttura (infra): Kafka, Redis e PostgreSQL comuni, in Docker.
• Modalità di esecuzione: ogni micro gira nativo (veloce, per quello su cui lavori) o in container (isolato, per quelli di sfondo).
• Verifica dell’ambiente (doctor): il report che indica se hai il necessario per avviare uno scenario —strumenti, repo, Docker, database, credenziali— prima di avviare.
• Prospettiva: da dove si risolvono gli host (la macchina o un container); determina quale indirizzo viene iniettato a ogni client.
• Advertised listener: indirizzo che Kafka annuncia ai suoi client; deve essere raggiungibile da dove gira il client (da qui il doppio listener del compose).
• Porta effettiva: la porta reale assegnata dopo aver risolto le collisioni. I micro dichiarano la loro porta (es. 8080) e MicroLab la rimappa all’avvio se serve.
• Manifesto remote / configurazione effettiva: il valore finale di ogni proprietà di un micro e da quale livello proviene (l’application.yml del repo, la configurazione remote o ciò che MicroLab inietta all’avvio).
• Spazio di lavoro: la cartella base che contiene i repository dei micro.
• .microlab/: la cartella dove vive la configurazione di MicroLab di un progetto (scenari, mock, database, impostazioni locali, stato di runtime).
• Personalizzazione di avvio (run override): impostazioni locali, non versionate, dell’avvio nativo di un micro (proprietà, argomenti, database…).
• Comandi preliminari (preCommands): ciò che viene eseguito prima di avviare un micro (costruire le librerie del workspace, installare i moduli fratelli di un multi-modulo Maven…). Vivono nel manifesto: valgono per tutto il team.
• Pacchetto (bundle): un file autonomo con uno scenario (o tutto il catalogo) per condividerlo o trasferirlo su un’altra macchina.
• Capacità: ciò che la tua licenza ti permette di usare: app, cli, mcp, chat.
• Control server: l’API HTTP locale (con token) che il processo che ospita il motore pubblica; è ciò che la CLI usa per parlare con un motore già attivo.
• MCP (Model Context Protocol): il protocollo con cui MicroLab espone una superficie curata di strumenti agli agenti di IA.
• Copilota: la chat dentro l’app, con gli stessi strumenti del MCP.