cb4c0681d3
New projects created: - michangarrito (marketplace mobile) - template-saas (SaaS template) - clinica-dental (dental ERP) - clinica-veterinaria (veterinary ERP) Architecture updates: - Move catalog from core/ to shared/ - Add MCP servers structure and templates - Add git management scripts - Update SUBREPOSITORIOS.md with 15 new repos - Update .gitignore for new projects Repository infrastructure: - 4 main repositories - 11 subrepositorios - Gitea remotes configured 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
305 lines
8.8 KiB
Markdown
305 lines
8.8 KiB
Markdown
# USAGE: Orquestacion Avanzada de Propagacion
|
|
|
|
**Version:** 1.0.0
|
|
**Sistema:** NEXUS v3.4 + SIMCO + CAPVED
|
|
**EPIC:** EPIC-012
|
|
**Fecha:** 2026-01-04
|
|
|
|
---
|
|
|
|
## Proposito
|
|
|
|
Este documento describe como usar el sistema de orquestacion avanzada de propagacion implementado en EPIC-012. El sistema permite:
|
|
|
|
1. Propagacion por niveles jerarquicos
|
|
2. Generacion automatica de tareas SCRUM
|
|
3. Coordinacion entre agentes
|
|
4. Validacion de integridad
|
|
|
|
---
|
|
|
|
## Componentes del Sistema
|
|
|
|
### Archivos de Configuracion
|
|
|
|
| Archivo | Ubicacion | Proposito |
|
|
|---------|-----------|-----------|
|
|
| NIVELES-PROPAGACION.yml | propagacion/ | Define jerarquia de niveles |
|
|
| PROTOCOLO-COORDINACION.yml | propagacion/ | Define flujo entre agentes |
|
|
| PERFIL-KB-MANAGER.md | core/orchestration/agents/perfiles/ | Perfil del agente coordinador |
|
|
|
|
### Scripts
|
|
|
|
| Script | Ubicacion | Proposito |
|
|
|--------|-----------|-----------|
|
|
| propagate-module-update.sh | devtools/scripts/propagation/ | Iniciar propagacion |
|
|
| generate-scrum-tasks.sh | devtools/scripts/propagation/ | Generar tareas SCRUM |
|
|
| cascade-propagation.sh | devtools/scripts/propagation/ | Propagacion por niveles |
|
|
| validate-propagation-chain.sh | devtools/scripts/propagation/ | Validar integridad |
|
|
|
|
---
|
|
|
|
## Casos de Uso
|
|
|
|
### Caso 1: Propagacion Simple
|
|
|
|
**Escenario:** Correcion de bug en modulo `auth-jwt-nestjs` desde proyecto `gamilit`.
|
|
|
|
```bash
|
|
# 1. Ejecutar propagacion basica
|
|
cd /home/isem/workspace-v1/devtools/scripts/propagation
|
|
./propagate-module-update.sh auth-jwt-nestjs 2.2.0 gamilit
|
|
|
|
# 2. Revisar output y tareas generadas
|
|
|
|
# 3. Ejecutar en cada proyecto destino manualmente
|
|
```
|
|
|
|
---
|
|
|
|
### Caso 2: Propagacion con Tareas SCRUM
|
|
|
|
**Escenario:** Nueva feature que debe propagarse a multiples proyectos con tracking formal.
|
|
|
|
```bash
|
|
# 1. Generar tareas SCRUM
|
|
./propagate-module-update.sh stripe-payments 3.0.0 trading-platform --scrum --tipo feature
|
|
|
|
# 2. O con EPIC contenedora
|
|
./propagate-module-update.sh stripe-payments 3.0.0 trading-platform --scrum --scrum-epic --tipo feature
|
|
|
|
# 3. Revisar tareas en ./propagacion-tasks/
|
|
ls ./propagacion-tasks/
|
|
# EPIC-PROP-2026-001.md
|
|
# TASK-PROP-2026-001-gamilit.md
|
|
# TASK-PROP-2026-001-erp-core.md
|
|
```
|
|
|
|
---
|
|
|
|
### Caso 3: Propagacion en Cascada
|
|
|
|
**Escenario:** Actualizacion que debe ir de core a todos los niveles.
|
|
|
|
```bash
|
|
# 1. Ejecutar cascada completa (niveles 0-3)
|
|
./cascade-propagation.sh websocket-client 1.5.0
|
|
|
|
# 2. O empezar desde nivel 1 (si ya esta actualizado en core)
|
|
./cascade-propagation.sh websocket-client 1.5.0 --start-level 1
|
|
|
|
# 3. Detener en nivel 2 (no propagar a verticales)
|
|
./cascade-propagation.sh websocket-client 1.5.0 --stop-level 2
|
|
```
|
|
|
|
---
|
|
|
|
### Caso 4: Security Fix Urgente
|
|
|
|
**Escenario:** Vulnerabilidad critica que debe propagarse en menos de 24h.
|
|
|
|
```bash
|
|
# 1. Propagacion con maxima prioridad
|
|
./propagate-module-update.sh auth-jwt-nestjs 2.2.1 gamilit \
|
|
--scrum --scrum-epic \
|
|
--tipo security-fix \
|
|
--cascade
|
|
|
|
# 2. Verificar tareas generadas
|
|
cat ./propagacion-tasks/EPIC-PROP-*.md
|
|
|
|
# 3. Asignar inmediatamente a @PERFIL_PROJECT_AGENT
|
|
|
|
# 4. Validar cuando completen
|
|
./validate-propagation-chain.sh PROP-2026-XXX
|
|
```
|
|
|
|
---
|
|
|
|
### Caso 5: Validacion Post-Propagacion
|
|
|
|
**Escenario:** Verificar que una propagacion se completo correctamente.
|
|
|
|
```bash
|
|
# 1. Validar propagacion especifica
|
|
./validate-propagation-chain.sh PROP-2026-001
|
|
|
|
# 2. Ver ultima propagacion
|
|
./validate-propagation-chain.sh --last
|
|
|
|
# 3. Listar todas las propagaciones
|
|
./validate-propagation-chain.sh --all
|
|
```
|
|
|
|
---
|
|
|
|
## Flujo Completo de Orquestacion
|
|
|
|
```
|
|
+-------------------+
|
|
| Desarrollador |
|
|
| detecta mejora |
|
|
+--------+----------+
|
|
|
|
|
v
|
|
+-------------------------------------------------------------------+
|
|
| @KB_MANAGER |
|
|
| |
|
|
| 1. Recibe notificacion |
|
|
| 2. Carga contexto (SIMCO-PROPAGACION-MEJORAS.md) |
|
|
| 3. Analiza con CAPVED |
|
|
| 4. Decide: Propagar / No propagar |
|
|
| |
|
|
| Si propagar: |
|
|
| - Actualiza shared/catalog (nivel 0) |
|
|
| - Sincroniza knowledge-base (nivel 1) |
|
|
| - Genera tareas SCRUM |
|
|
| - Notifica a @PROJECT_AGENT |
|
|
+-------------------------------------------------------------------+
|
|
|
|
|
+--------------+---------------+
|
|
| |
|
|
v v
|
|
+-------------------------+ +-------------------------+
|
|
| @PROJECT_AGENT | | @PROJECT_AGENT |
|
|
| (Proyecto A) | | (Proyecto B) |
|
|
| | | |
|
|
| 1. Recibe tarea SCRUM | | 1. Recibe tarea SCRUM |
|
|
| 2. Ejecuta propagacion | | 2. Ejecuta propagacion |
|
|
| 3. Valida (build+tests) | | 3. Valida (build+tests) |
|
|
| 4. Reporta a KB_MANAGER | | 4. Reporta a KB_MANAGER |
|
|
+-------------------------+ +-------------------------+
|
|
| |
|
|
+--------------+---------------+
|
|
|
|
|
v
|
|
+-------------------------------------------------------------------+
|
|
| @KB_MANAGER |
|
|
| |
|
|
| Validacion final: |
|
|
| ./validate-propagation-chain.sh <PROP-ID> |
|
|
| |
|
|
| Actualiza: |
|
|
| - REGISTRO-PROPAGACIONES.yml |
|
|
| - TRAZABILIDAD-PROYECTOS.yml |
|
|
| |
|
|
| Cierra propagacion |
|
|
+-------------------------------------------------------------------+
|
|
```
|
|
|
|
---
|
|
|
|
## Estructura de Niveles
|
|
|
|
```
|
|
Nivel 0: shared/catalog/
|
|
|
|
|
v (propaga a)
|
|
Nivel 1: shared/knowledge-base/
|
|
|
|
|
v (propaga a)
|
|
Nivel 2: projects/ (base)
|
|
|-- gamilit
|
|
|-- trading-platform
|
|
|-- erp-core
|
|
|
|
|
v (propaga a)
|
|
Nivel 3: projects/ (hoja)
|
|
|-- erp-suite/verticales/*
|
|
|-- betting-analytics
|
|
|-- inmobiliaria-analytics
|
|
```
|
|
|
|
---
|
|
|
|
## Formato de Tarea SCRUM Generada
|
|
|
|
```markdown
|
|
---
|
|
id: TASK-PROP-2026-001-gamilit
|
|
title: "Propagar auth-jwt-nestjs v2.2.0 a gamilit"
|
|
type: Task
|
|
status: "To Do"
|
|
priority: Alta
|
|
assignee: "@PERFIL_PROJECT_AGENT"
|
|
parent: "EPIC-PROP-2026-001"
|
|
---
|
|
|
|
# TASK: Propagar auth-jwt-nestjs v2.2.0 a gamilit
|
|
|
|
## Descripcion
|
|
Actualizar el modulo `auth-jwt-nestjs` a la version `2.2.0`.
|
|
|
|
## Pasos de Implementacion
|
|
1. [ ] Verificar version actual
|
|
2. [ ] Actualizar dependencia
|
|
3. [ ] Ejecutar build
|
|
4. [ ] Ejecutar tests
|
|
5. [ ] Commit con referencia
|
|
|
|
## Criterios de Aceptacion
|
|
- [ ] Modulo actualizado
|
|
- [ ] Build exitoso
|
|
- [ ] Tests pasando
|
|
```
|
|
|
|
---
|
|
|
|
## Comandos Rapidos
|
|
|
|
```bash
|
|
# Ver ayuda de cualquier script
|
|
./propagate-module-update.sh --help
|
|
./generate-scrum-tasks.sh --help
|
|
./cascade-propagation.sh --help
|
|
./validate-propagation-chain.sh --help
|
|
|
|
# Dry-run (simular sin cambios)
|
|
./propagate-module-update.sh modulo version origen --dry-run
|
|
./cascade-propagation.sh modulo version --dry-run
|
|
./generate-scrum-tasks.sh modulo version tipo --dry-run
|
|
```
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Error: "Modulo no encontrado en catalogo"
|
|
|
|
```bash
|
|
# Verificar que el modulo existe
|
|
grep "nombre:" /home/isem/workspace-v1/shared/knowledge-base/CATALOGO-MODULOS.yml | grep "<modulo>"
|
|
```
|
|
|
|
### Error: "No se encontraron proyectos que usen el modulo"
|
|
|
|
```bash
|
|
# Verificar trazabilidad
|
|
grep -A10 "<modulo>" /home/isem/workspace-v1/shared/knowledge-base/TRAZABILIDAD-PROYECTOS.yml
|
|
```
|
|
|
|
### Validacion falla por archivos faltantes
|
|
|
|
```bash
|
|
# Verificar estructura
|
|
ls -la /home/isem/workspace-v1/shared/knowledge-base/propagacion/
|
|
ls -la /home/isem/workspace-v1/devtools/scripts/propagation/
|
|
```
|
|
|
|
---
|
|
|
|
## Referencias
|
|
|
|
| Alias | Archivo |
|
|
|-------|---------|
|
|
| @PROPAGACION | core/orchestration/directivas/simco/SIMCO-PROPAGACION-MEJORAS.md |
|
|
| @KB_MANAGER | core/orchestration/agents/perfiles/PERFIL-KB-MANAGER.md |
|
|
| @NIVELES_PROP | shared/knowledge-base/propagacion/NIVELES-PROPAGACION.yml |
|
|
| @PROTOCOLO_PROP | shared/knowledge-base/propagacion/PROTOCOLO-COORDINACION.yml |
|
|
| @USAGE_PROP | shared/knowledge-base/propagacion/USAGE.md |
|
|
|
|
---
|
|
|
|
**Documento creado por:** EPIC-012
|
|
**Sistema:** NEXUS v3.4 + SIMCO + CAPVED
|