66161b1566
Sistema NEXUS v3.4 migrado con: Estructura principal: - core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles) - core/catalog: Catalogo de funcionalidades reutilizables - shared/knowledge-base: Base de conocimiento compartida - devtools/scripts: Herramientas de desarrollo - control-plane/registries: Control de servicios y CI/CD - orchestration/: Configuracion de orquestacion de agentes Proyectos incluidos (11): - gamilit (submodule -> GitHub) - trading-platform (OrbiquanTIA) - erp-suite con 5 verticales: - erp-core, construccion, vidrio-templado - mecanicas-diesel, retail, clinicas - betting-analytics - inmobiliaria-analytics - platform_marketing_content - pos-micro, erp-basico Configuracion: - .gitignore completo para Node.js/Python/Docker - gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git) - Sistema de puertos estandarizado (3005-3199) Generated with NEXUS v3.4 Migration System EPIC-010: Configuracion Git y Repositorios
303 lines
8.8 KiB
Markdown
303 lines
8.8 KiB
Markdown
# CHECKLIST DE PROPAGACION
|
|
|
|
**Version:** 1.0.0
|
|
**Sistema:** SIMCO v2.2.0
|
|
**Proposito:** Verificar propagacion completa de documentacion entre niveles
|
|
|
|
---
|
|
|
|
## CUANDO USAR ESTE CHECKLIST
|
|
|
|
Ejecutar este checklist DESPUES de completar cualquier tarea que:
|
|
- Crea archivos nuevos (DDL, Entity, Component)
|
|
- Modifica estructura existente
|
|
- Documenta especificaciones
|
|
- Completa una HU
|
|
|
|
---
|
|
|
|
## CHECKLIST POR NIVEL
|
|
|
|
### Nivel 2A: Proyecto Standalone
|
|
|
|
```markdown
|
|
## Propagacion - Proyecto Standalone
|
|
|
|
### Nivel Local (Obligatorio)
|
|
- [ ] Inventario actualizado
|
|
- [ ] MASTER_INVENTORY.yml con nuevo artefacto
|
|
- [ ] {CAPA}_INVENTORY.yml actualizado (DATABASE/BACKEND/FRONTEND)
|
|
- [ ] Traza registrada
|
|
- [ ] TRAZA-TAREAS-{CAPA}.md con entrada de hoy
|
|
- [ ] PROXIMA-ACCION.md actualizado (si aplica)
|
|
|
|
### Nivel Workspace (Obligatorio)
|
|
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
|
|
- [ ] Seccion del proyecto actualizada
|
|
- [ ] Fecha de ultima actividad correcta
|
|
- [ ] workspace/orchestration/referencias/PROYECTOS-ACTIVOS.yml
|
|
- [ ] ultima_actividad actualizada (si cambio significativo)
|
|
|
|
### Validacion
|
|
- [ ] Todas las rutas verificadas (archivos existen)
|
|
- [ ] Fechas consistentes entre archivos
|
|
- [ ] Build pasa (si aplica)
|
|
- [ ] No hay referencias rotas
|
|
```
|
|
|
|
---
|
|
|
|
### Nivel 2B.2: Vertical (en Suite)
|
|
|
|
```markdown
|
|
## Propagacion - Vertical en Suite
|
|
|
|
### Nivel Local - Vertical (Obligatorio)
|
|
- [ ] Inventario actualizado
|
|
- [ ] MASTER_INVENTORY.yml con nuevo artefacto
|
|
- [ ] {CAPA}_INVENTORY.yml actualizado
|
|
- [ ] Traza registrada
|
|
- [ ] TRAZA-TAREAS-{CAPA}.md con entrada de hoy
|
|
|
|
### Nivel Suite (Obligatorio)
|
|
- [ ] projects/{suite}/orchestration/inventarios/
|
|
- [ ] SUITE_MASTER_INVENTORY.yml actualizado
|
|
- [ ] STATUS.yml con estado del vertical
|
|
- [ ] REFERENCIAS.yml con puntero al artefacto
|
|
- [ ] projects/{suite}/orchestration/trazas/
|
|
- [ ] TRAZA-SUITE.md con entrada de propagacion
|
|
|
|
### Nivel Workspace (Obligatorio)
|
|
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
|
|
- [ ] Seccion de suite actualizada
|
|
- [ ] Metricas de vertical actualizadas
|
|
|
|
### Validacion
|
|
- [ ] Ruta completa verificada (vertical → suite → workspace)
|
|
- [ ] No hay duplicacion de contenido (solo referencias)
|
|
- [ ] Fechas consistentes
|
|
```
|
|
|
|
---
|
|
|
|
### Nivel 2B.1: Suite Core
|
|
|
|
```markdown
|
|
## Propagacion - Suite Core
|
|
|
|
### Nivel Local - Core (Obligatorio)
|
|
- [ ] Inventario actualizado
|
|
- [ ] MASTER_INVENTORY.yml con artefacto
|
|
- [ ] CORE_{CAPA}_INVENTORY.yml actualizado
|
|
- [ ] Traza registrada
|
|
- [ ] TRAZA-CORE.md con entrada
|
|
|
|
### Nivel Suite (Obligatorio)
|
|
- [ ] projects/{suite}/orchestration/inventarios/
|
|
- [ ] SUITE_MASTER_INVENTORY.yml seccion core actualizada
|
|
- [ ] STATUS.yml con estado del core
|
|
- [ ] projects/{suite}/orchestration/trazas/
|
|
- [ ] TRAZA-SUITE.md con entrada
|
|
|
|
### Notificar Verticales (Si aplica)
|
|
- [ ] Si el cambio afecta a verticales:
|
|
- [ ] Notificar en SUITE_MASTER_INVENTORY.yml
|
|
- [ ] Marcar como "NUEVO - Revisar herencia"
|
|
|
|
### Nivel Workspace (Obligatorio)
|
|
- [ ] workspace/orchestration/WORKSPACE-STATUS.md actualizado
|
|
|
|
### Validacion
|
|
- [ ] Verticales pueden encontrar el nuevo artefacto
|
|
- [ ] Referencias no estan rotas
|
|
```
|
|
|
|
---
|
|
|
|
### Nivel 3: Catalogo
|
|
|
|
```markdown
|
|
## Propagacion - Catalogo de Funcionalidades
|
|
|
|
### Nivel Local - Catalogo (Obligatorio)
|
|
- [ ] core/catalog/{funcionalidad}/ actualizado
|
|
- [ ] CATALOG-INDEX.yml actualizado
|
|
- [ ] README.md de funcionalidad actualizado
|
|
|
|
### Nivel Core (Obligatorio)
|
|
- [ ] core/orchestration/inventarios/ actualizado
|
|
- [ ] Entrada en CATALOG-USAGE-TRACKING.yml
|
|
|
|
### Notificar Consumidores (Si aplica)
|
|
- [ ] Si hay proyectos usando esta funcionalidad:
|
|
- [ ] Notificar cambio en CATALOG-USAGE-TRACKING.yml
|
|
- [ ] Marcar version nueva
|
|
|
|
### Nivel Workspace (Obligatorio)
|
|
- [ ] workspace/orchestration/WORKSPACE-STATUS.md
|
|
- [ ] Seccion de catalogo actualizada
|
|
|
|
### Validacion
|
|
- [ ] Funcionalidad es accesible via @CATALOG
|
|
- [ ] Consumidores pueden encontrar nueva version
|
|
```
|
|
|
|
---
|
|
|
|
## FORMATO DE REGISTRO EN TRAZAS
|
|
|
|
### Entrada de Traza Local
|
|
|
|
```markdown
|
|
## [{fecha}] {codigo_tarea}: {descripcion_breve}
|
|
|
|
**Agente:** {nombre_agente}
|
|
**Tipo:** {CREAR|MODIFICAR|DOCUMENTAR}
|
|
**Prioridad:** {P0|P1|P2}
|
|
|
|
### Objetivo
|
|
{descripcion_de_lo_que_se_hizo}
|
|
|
|
### Archivos Afectados
|
|
- {ruta_archivo_1}
|
|
- {ruta_archivo_2}
|
|
|
|
### Impacto
|
|
- {impacto_1}
|
|
- {impacto_2}
|
|
|
|
### Propagado a
|
|
- [ ] Nivel superior: {si/no}
|
|
- [ ] Archivo: {ruta_si_aplica}
|
|
```
|
|
|
|
### Entrada de Traza de Suite
|
|
|
|
```markdown
|
|
## [{fecha}] {origen}: {descripcion}
|
|
|
|
**Nivel:** {2B.1|2B.2}
|
|
**Vertical/Core:** {nombre}
|
|
**Capa:** {DATABASE|BACKEND|FRONTEND}
|
|
|
|
### Propagacion
|
|
- **Origen:** {ruta_completa_archivo_original}
|
|
- **Tipo:** {Nuevo|Actualizado|Eliminado}
|
|
- **Impacto en suite:** {descripcion}
|
|
|
|
### Accion Requerida
|
|
- [ ] Ninguna (informativo)
|
|
- [ ] Verticales deben revisar herencia
|
|
- [ ] Actualizar dependencias
|
|
```
|
|
|
|
---
|
|
|
|
## ERRORES COMUNES
|
|
|
|
### Error 1: Inventario no actualizado
|
|
|
|
```yaml
|
|
Sintoma: Artefacto creado pero no aparece en busquedas
|
|
Causa: MASTER_INVENTORY.yml no incluye el nuevo artefacto
|
|
Solucion: Siempre actualizar inventario INMEDIATAMENTE despues de crear
|
|
```
|
|
|
|
### Error 2: Traza sin entrada
|
|
|
|
```yaml
|
|
Sintoma: No hay registro de cuando se creo algo
|
|
Causa: Olvidar registrar en TRAZA-TAREAS-*.md
|
|
Solucion: Agregar entrada antes de marcar tarea como Done
|
|
```
|
|
|
|
### Error 3: Propagacion parcial
|
|
|
|
```yaml
|
|
Sintoma: Nivel local OK pero nivel superior no sabe del cambio
|
|
Causa: Solo actualizar nivel local
|
|
Solucion: SIEMPRE propagar a TODOS los niveles en PROPAGATE_TO
|
|
```
|
|
|
|
### Error 4: Duplicacion de contenido
|
|
|
|
```yaml
|
|
Sintoma: Mismo contenido en multiples archivos
|
|
Causa: Copiar en lugar de referenciar
|
|
Solucion: Usar REFERENCIAS.yml con punteros, no copiar contenido
|
|
```
|
|
|
|
### Error 5: Fechas inconsistentes
|
|
|
|
```yaml
|
|
Sintoma: Archivo dice 2025-12-07 pero traza dice 2025-12-08
|
|
Causa: No sincronizar fechas
|
|
Solucion: Usar misma fecha en todos los archivos relacionados
|
|
```
|
|
|
|
---
|
|
|
|
## VALIDACION AUTOMATICA (Conceptual)
|
|
|
|
```bash
|
|
# Script futuro para validar propagacion
|
|
./validate-propagation.sh
|
|
|
|
Verifica:
|
|
✓ Inventarios tienen artefactos recientes
|
|
✓ Trazas tienen entradas de hoy
|
|
✓ Referencias apuntan a archivos existentes
|
|
✓ Fechas son consistentes
|
|
✓ No hay duplicacion de contenido
|
|
✓ Niveles superiores tienen referencias
|
|
|
|
Output:
|
|
PASS: Propagacion completa
|
|
FAIL: Lista de gaps encontrados
|
|
```
|
|
|
|
---
|
|
|
|
## QUICK REFERENCE
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────┐
|
|
│ PROPAGACION OBLIGATORIA │
|
|
├─────────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ DESPUES de crear/modificar artefacto: │
|
|
│ │
|
|
│ 1. NIVEL LOCAL: │
|
|
│ - [ ] Actualizar MASTER_INVENTORY.yml │
|
|
│ - [ ] Registrar en TRAZA-TAREAS-{CAPA}.md │
|
|
│ │
|
|
│ 2. NIVEL SUPERIOR (para cada nivel en PROPAGATE_TO): │
|
|
│ - [ ] Agregar referencia (NO copiar contenido) │
|
|
│ - [ ] Actualizar STATUS.yml │
|
|
│ - [ ] Registrar en traza superior │
|
|
│ │
|
|
│ 3. VALIDAR: │
|
|
│ - [ ] Rutas existen │
|
|
│ - [ ] Fechas consistentes │
|
|
│ - [ ] No hay duplicacion │
|
|
│ - [ ] Build pasa │
|
|
│ │
|
|
│ REGLA DE ORO: │
|
|
│ "Si no esta en inventario, no existe para otros agentes" │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## REFERENCIAS
|
|
|
|
- `SIMCO-PROPAGACION.md` - Protocolo completo de propagacion
|
|
- `SIMCO-NIVELES.md` - Definicion de niveles jerarquicos
|
|
- `SIMCO-DOCUMENTAR.md` - Directivas de documentacion
|
|
|
|
---
|
|
|
|
*Sistema SIMCO v2.2.0*
|
|
*Creado: 2025-12-08*
|