Glosario

Términos que aparecen a lo largo de la guía y de la app.

• Microservicio (micro): un repositorio arrancable. Se describe con un manifiesto autogenerado.
• Manifiesto: la descripción de cómo arrancar un micro (tecnología, puertos, infraestructura, dependencias, arranque). Autodetectada; tú solo la revisas.
• Stack: la tecnología de un micro (quarkus, spring-boot, node, angular, python). Determina cómo se arranca, dónde está su health y cómo se le inyecta la configuración.
• Escenario: un conjunto de micros que se levantan juntos para probar un flujo.
• Dependencia: un core al que un micro llama por REST. Se resuelve como local, nube o mock.
• Infraestructura (infra): Kafka, Redis y PostgreSQL comunes, en Docker.
• Modo de ejecución: cada micro corre nativo (rápido, para el que estás tocando) o en contenedor (aislado, para los de fondo).
• Chequeo de entorno (doctor): el informe de si tienes lo necesario para levantar un escenario —herramientas, repos, Docker, bases de datos, credenciales— antes de arrancar.
• Perspectiva: desde dónde se resuelven los hosts (la máquina o un contenedor); determina qué dirección se inyecta a cada cliente.
• Advertised listener: dirección que Kafka anuncia a sus clientes; debe ser alcanzable desde donde corre el cliente (de ahí el doble listener del compose).
• Puerto efectivo: el puerto real asignado tras resolver colisiones. Los micros declaran su puerto (p. ej. 8080) y MicroLab lo remapea al levantar si hace falta.
• Manifiesto remoto / configuración efectiva: el valor final de cada propiedad de un micro y de qué capa procede (el application.yml del repo, la configuración remota o lo que inyecta MicroLab al arrancar).
• Espacio de trabajo: la carpeta base que contiene los repositorios de los micros.
• .microlab/: la carpeta donde vive la configuración de MicroLab de un proyecto (escenarios, mocks, bases de datos, ajustes locales, estado en tiempo de ejecución).
• Personalización de arranque (run override): ajustes locales, no versionados, del arranque nativo de un micro (propiedades, argumentos, base de datos…).
• Comandos previos (preCommands): lo que se ejecuta antes de arrancar un micro (construir librerías del workspace, instalar módulos hermanos de un multi-módulo Maven…). Viven en el manifiesto: valen para todo el equipo.
• Paquete (bundle): un fichero autocontenido con un escenario (o todo el catálogo) para compartirlo o trasladarlo a otra máquina.
• Capacidad: lo que tu licencia te permite usar: app, cli, mcp, chat.
• Control server: la API HTTP local (con token) que publica el proceso que aloja el motor; es lo que usa el CLI para hablar con un motor ya vivo.
• MCP (Model Context Protocol): el protocolo por el que MicroLab expone una superficie curada de herramientas a los agentes de IA.
• Copiloto: el chat dentro de la app, con las mismas herramientas que el MCP.