erp-construccion/orchestration/README.md

104 lines
3.2 KiB
Markdown

# Sistema de Orquestación - ERP Construcción (Vertical)
## Descripción
Sistema de orquestación de agentes NEXUS para el proyecto ERP Construcción. Este proyecto **extiende erp-core** y tiene documentación específica para 15 módulos MAI-* y 3 épicas MAE-*.
## Estructura de Directorios
```
orchestration/
├── 00-guidelines/ # Contexto y directivas
│ ├── CONTEXTO-PROYECTO.md # Configuración del proyecto
│ └── HERENCIA-DIRECTIVAS.md # Mapeo de directivas heredadas
├── 01-analisis/ # Fase 1: Análisis
├── 02-planeacion/ # Fase 2: Planeación
├── 03-tareas/ # Descomposición de work
├── 04-ejecucion-logs/ # Fase 4: Logs
├── 05-validaciones/ # Validaciones (pre/durante/post)
│ ├── pre/
│ ├── durante/
│ └── post/
├── 06-subagentes/ # Gestión de subagentes
├── agentes/ # Ejecuciones por agente
├── directivas/ # Directivas específicas de construcción
├── estados/ # Estado de agentes
├── inventarios/ # Inventarios YAML
├── prompts/ # Prompts específicos
├── reportes/ # Reportes de ciclos
├── templates/ # Templates
├── trazas/ # Historial de tareas
├── PROXIMA-ACCION.md # Siguiente tarea
└── README.md # Este archivo
```
## Herencia de Directivas
Este proyecto hereda directivas en orden:
1. **Globales:** `/home/isem/workspace/core/orchestration/directivas/`
2. **ERP-Suite:** `/home/isem/workspace/projects/erp-suite/orchestration/directivas/`
3. **ERP-Core:** `../../../erp-core/orchestration/directivas/`
4. **Construcción:** `./directivas/`
## Documentación Disponible
Este proyecto cuenta con **403+ archivos** de documentación técnica:
```
/docs/
├── 01-fase-alcance-inicial/ # 15 módulos MAI-*
│ ├── MAI-001-fundamentos/
│ ├── MAI-002-proyectos/
│ ├── ...
│ └── MAI-013-administracion/
├── 02-fase-enterprise/ # 3 épicas MAE-*
│ ├── MAE-014-finanzas/
│ ├── MAE-015-activos/
│ └── MAE-016-dms/
├── 02-modelado/
│ └── database-design/schemas/ # 11 archivos SQL
└── 03-fase-avanzada/ # MAA-017 HSE
```
## Uso Rápido
```bash
# Ver siguiente tarea
cat PROXIMA-ACCION.md
# Ver contexto
cat 00-guidelines/CONTEXTO-PROYECTO.md
# Ver directivas heredadas
cat 00-guidelines/HERENCIA-DIRECTIVAS.md
# Ver módulos disponibles
ls ../docs/01-fase-alcance-inicial/
# Ver schemas SQL
ls ../docs/02-modelado/database-design/schemas/
```
## Flujo de 5 Fases
Toda tarea debe seguir:
1. Análisis → `01-analisis/`
2. Planeación → `02-planeacion/`
3. Validación → `05-validaciones/pre/`
4. Ejecución → `04-ejecucion-logs/`
5. Cierre → `05-validaciones/post/`
## Referencias
- [Contexto del Proyecto](00-guidelines/CONTEXTO-PROYECTO.md)
- [Herencia de Directivas](00-guidelines/HERENCIA-DIRECTIVAS.md)
- [ERP-Core](../../../erp-core/)
- [Documentación](../docs/)
---
*Sistema NEXUS - ERP Construcción (Vertical)*