# MiChangarrito - Orchestration

## Proposito

Este directorio contiene los archivos de orquestacion para agentes de IA que trabajan en el proyecto MiChangarrito. Incluye lineamientos, inventarios YAML (SSOT), documentos de analisis, reportes y trazas de tareas.

## Estructura

```
orchestration/
├── 00-guidelines/           # Lineamientos y contexto
│   ├── CONTEXTO-PROYECTO.md # Variables y configuracion
│   └── HERENCIA-SIMCO.md    # Directivas SIMCO heredadas
├── analisis/                # Documentos de analisis y planes
│   ├── ANALISIS-*.md
│   ├── PLAN-*.md
│   └── VALIDACION-*.md
├── inventarios/             # SSOT: Single Source of Truth
│   ├── MASTER_INVENTORY.yml
│   ├── DATABASE_INVENTORY.yml
│   ├── BACKEND_INVENTORY.yml
│   └── FRONTEND_INVENTORY.yml
├── environment/             # Configuracion de DevEnv
├── estados/                 # Estado de agentes
├── reportes/                # Reportes de progreso
├── trazas/                  # Trazas de tareas
├── CONTEXT-MAP.yml          # Mapeo de contexto
├── PROJECT-STATUS.md        # Estado actual del proyecto
├── PROXIMA-ACCION.md        # Siguiente accion recomendada
└── PLAN-IMPLEMENTACION.md   # Plan de implementacion
```

## Guia para Agentes

### Al Iniciar Trabajo en el Proyecto

1. **Leer contexto del proyecto:**
   ```
   orchestration/00-guidelines/CONTEXTO-PROYECTO.md
   ```

2. **Revisar directivas heredadas:**
   ```
   orchestration/00-guidelines/HERENCIA-SIMCO.md
   ```

3. **Consultar inventario relevante:**
   ```
   orchestration/inventarios/{TIPO}_INVENTORY.yml
   ```

4. **Verificar estado actual:**
   ```
   orchestration/PROJECT-STATUS.md
   ```

5. **Consultar proxima accion:**
   ```
   orchestration/PROXIMA-ACCION.md
   ```

## Single Source of Truth (SSOT)

Los inventarios YAML son la fuente canonica de verdad para:

| Inventario | Proposito | Contiene |
|------------|-----------|----------|
| MASTER_INVENTORY.yml | Estado consolidado | Fases, epicas, progreso |
| DATABASE_INVENTORY.yml | Estructura BD | 11 schemas, 47 tablas |
| BACKEND_INVENTORY.yml | Modulos API | 17 modulos, 120+ endpoints |
| FRONTEND_INVENTORY.yml | UI Components | 12 paginas, componentes |

### Cuando Actualizar Inventarios

| Evento | Inventario | Accion |
|--------|------------|--------|
| Nueva tabla creada | DATABASE | Agregar entrada |
| Endpoint implementado | BACKEND | Actualizar modulo |
| Pagina completada | FRONTEND | Cambiar estado |
| Fase completada | MASTER | Actualizar progreso |

## Sistema de Estandares

| Sistema | Version | Descripcion |
|---------|---------|-------------|
| SIMCO | v3.7.0 | Sistema de Nomenclatura y Organizacion |
| CCA Protocol | v2.0 | Coordinacion de Agentes |
| CAPVED | v1.0 | Ciclo de Vida de Artefactos |

### Directivas Aplicables

Ver `00-guidelines/HERENCIA-SIMCO.md` para lista completa de directivas:

- @DOC_PROYECTO - Estructura de documentacion
- @NOMENCLATURA - Convenciones de nombres
- @ESTRUCTURA_DOCS - Formato de documentos
- @INVENTARIOS - Formato de inventarios YAML
- @TESTING - Estandares de testing
- @INTEGRACIONES - Documentacion de APIs externas

## Perfiles de Agentes

| Perfil | Responsabilidad |
|--------|-----------------|
| ORQUESTADOR | Coordina y valida trabajo de otros agentes |
| DOCUMENTATION | Crea y actualiza documentacion |
| DOCUMENTATION-VALIDATOR | Valida conformidad con estandares |
| BACKEND | Desarrollo de modulos NestJS |
| FRONTEND | Desarrollo de UI React |
| DATABASE | Diseño y migraciones de BD |

## Archivos Clave

### Para Comprender el Proyecto
- `00-guidelines/CONTEXTO-PROYECTO.md` - Descripcion y proposito
- `../docs/_MAP.md` - Mapa de documentacion

### Para Conocer Estado Actual
- `PROJECT-STATUS.md` - Estado del proyecto
- `PROXIMA-ACCION.md` - Que hacer ahora
- `inventarios/MASTER_INVENTORY.yml` - Progreso por fase

### Para Decisiones Tecnicas
- `../docs/97-adr/` - Architecture Decision Records

## Metricas Actuales

| Metrica | Valor |
|---------|-------|
| Progreso MVP | 95% |
| Schemas BD | 11 |
| Tablas BD | 47 |
| Modulos Backend | 17 |
| Endpoints | 120+ |
| Epicas Completadas | 22 de 28 |

---

**Ultima actualizacion:** 2026-01-10
**Version:** 1.0.0
**Sistema:** SIMCO v3.7.0