rckrdmrd
928eb795e6
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Cambios en backend y frontend Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
142 lines
4.2 KiB
Markdown
142 lines
4.2 KiB
Markdown
# 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
|