Getting Started — Monorepo Timeliber

Tutorial base del cuadrante 01_TUTORIALS (nivel raíz). Requisito previo: haber corrido el setup de máquina de CONTRIBUTING.md (./manage.sh bootstrap).

Este recorrido lleva de "máquina lista" a "una vertical corriendo y verificada", usando Travel como ejemplo — el mismo patrón aplica a cualquier otra vertical (gastro, main, ai, rag, operis, ...).

Pasos

1. Levanta solo la vertical que vas a tocar, con hot-reload:

   ./manage.sh dev travel
   

2. Verifica que los contenedores estén arriba:

   ./manage.sh status
   

3. Audita que las APIs respondan 200 OK:

   ./manage.sh health
   

4. Abre la documentación interactiva del backend de Travel: http://localhost:8001/docs.
5. Abre el admin panel (Nido) en http://localhost:5173 (o el puerto que indique ./manage.sh status) y confirma que el login funcione contra el backend recién levantado.
6. Cuando termines de tocar código, actualiza la documentación en el docs/ correspondiente (Diátaxis) — regla de CONTRIBUTING.md §Modelo de Colaboración Humano-IA.

Elegir otra vertical

El mismo patrón (./manage.sh dev <vertical> → status → health) aplica a cualquier servicio definido en manage.sh (gastro, main, ai, rag, operis, omnicortex, o all para levantar el ecosistema completo).

Dónde seguir después

• Reglas de operación de la vertical elegida: apps/{vertical}/AGENTS.md.
• Mapa de recursos técnicos (dominios, modelos, rutas, tests): apps/{vertical}/*/MAP.md.
• Deuda técnica conocida: apps/{vertical}/*/TECH_DEBT.md.