Glossário

Termos que aparecem ao longo do guia e da app.

• Microsserviço (micro): um repositório arrancável. É descrito por um manifesto autogerado.
• Manifesto: a descrição de como arrancar um micro (tecnologia, portas, infraestrutura, dependências, arranque). Autodetetada; só a revê.
• Stack: a tecnologia de um micro (quarkus, spring-boot, node, angular, python). Determina como arranca, onde está o seu health e como se lhe injeta a configuração.
• Cenário: um conjunto de micros iniciados juntos para testar um fluxo.
• Dependência: um core que um micro chama por REST. Resolve-se como local, cloud ou mock.
• Infraestrutura (infra): Kafka, Redis e PostgreSQL comuns, no Docker.
• Modo de execução: cada micro corre nativo (rápido, para o que está a tocar) ou em contentor (isolado, para os de fundo).
• Verificação do ambiente (doctor): o relatório de se tem o necessário para iniciar um cenário —ferramentas, repos, Docker, bases de dados, credenciais— antes de arrancar.
• Perspetiva: de onde se resolvem os hosts (a máquina ou um contentor); determina que endereço se injeta a cada cliente.
• Advertised listener: endereço que o Kafka anuncia aos seus clientes; tem de ser alcançável a partir de onde corre o cliente (daí o duplo listener do compose).
• Porta efetiva: a porta real atribuída depois de resolver colisões. Os micros declaram a sua porta (p. ex. 8080) e o MicroLab remapeia-a ao iniciar se for preciso.
• Manifesto remote / configuração efetiva: o valor final de cada propriedade de um micro e de que camada provém (o application.yml do repo, a configuração remote ou o que o MicroLab injeta ao arrancar).
• Espaço de trabalho: a pasta base que contém os repositórios dos micros.
• .microlab/: a pasta onde vive a configuração do MicroLab de um projeto (cenários, mocks, bases de dados, definições locais, estado em runtime).
• Personalização de arranque (run override): ajustes locais, não versionados, do arranque nativo de um micro (propriedades, argumentos, base de dados…).
• Comandos prévios (preCommands): o que se executa antes de arrancar um micro (construir bibliotecas do workspace, instalar módulos irmãos de um multimódulo Maven…). Vivem no manifesto: valem para toda a equipa.
• Pacote (bundle): um ficheiro autónomo com um cenário (ou todo o catálogo) para o partilhar ou transferir para outra máquina.
• Capacidade: o que a sua licença lhe permite usar: app, cli, mcp, chat.
• Control server: a API HTTP local (com token) que o processo que aloja o motor publica; é o que o CLI usa para falar com um motor já vivo.
• MCP (Model Context Protocol): o protocolo pelo qual o MicroLab expõe uma superfície curada de ferramentas aos agentes de IA.
• Copiloto: o chat dentro da app, com as mesmas ferramentas que o MCP.