[SIMCO-V4] feat: Actualizar a SIMCO v4.0.0 con SCRUM

- Actualizar HERENCIA-SIMCO.md a v4.0.0 - Agregar directivas SCRUM (DoR, DoD, Sprint Execution) - Agregar alias @SPRINT_EXECUTION, @AGILE_METRICS - Configurar nomenclatura v2 Workspace: v2.0.0 | SIMCO: v4.0.0
2026-01-10 12:06:08 -06:00 · 2026-01-10 12:06:08 -06:00 · f50a2ef941
commit f50a2ef941
parent 97f407c661
1 changed files with 138 additions and 272 deletions
--- a/orchestration/00-guidelines/HERENCIA-SIMCO.md
+++ b/orchestration/00-guidelines/HERENCIA-SIMCO.md
@ -1,6 +1,6 @@
-# Herencia SIMCO - MiChangarrito
+# Herencia SIMCO - michangarrito

-**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
+**Sistema:** SIMCO v4.0.0 + CAPVED + SCRUM
 **Fecha:** 2026-01-10

 ---
@ -9,317 +9,183 @@

 | Propiedad | Valor |
 |-----------|-------|
-| **Proyecto** | MiChangarrito - POS Inteligente para Micro-negocios |
-| **Código** | MCH |
-| **Nivel** | STANDALONE (Nivel 2A) |
-| **Padre** | workspace/orchestration |
-| **SIMCO Version** | 3.8.0 |
+| **Proyecto** | Mi Changarrito - Sistema POS para Pequenos Comercios |
+| **Código v2** | MCH |
+| **SIMCO Version** | 4.0.0 |
 | **CAPVED** | Habilitado |
-| **CCA Protocol** | Habilitado |
+| **SCRUM** | Habilitado |

-## Jerarquía de Herencia
+---
+
+## Metodología CAPVED+SCRUM
+
+Este proyecto utiliza la metodología integrada CAPVED+SCRUM definida en SIMCO v4.0.0.
+
+### Ciclo CAPVED dentro de Sprint

 ```
-Nivel 0: workspace/orchestration/               <- WORKSPACE (directivas globales)
-    |
-    +-- STANDALONE: michangarrito/orchestration/   <- ESTE PROYECTO
-                    michangarrito/docs/            <- DOCUMENTACION
+Sprint Start
+    │
+    ├── Sprint Planning (usar @TPL_SPRINT_PLANNING)
+    │
+    └── Por cada HU:
+        ├── [C] Contexto    → Cargar directivas, verificar DoR
+        ├── [A] Análisis    → Analizar requerimientos
+        ├── [P] Plan        → Planificar implementación
+        ├── [V] Validación  → Validar plan técnico
+        ├── [E] Ejecución   → Implementar código
+        └── [D] Documentar  → Actualizar docs, verificar DoD
+    │
+    ├── Sprint Review
+    └── Sprint Retrospective (usar @TPL_RETROSPECTIVA)
 ```

-**Regla:** Las directivas locales pueden EXTENDER las del workspace, nunca REDUCIRLAS.
-
-**Estado del Proyecto:** MVP En desarrollo
-
 ---

-## Directivas Heredadas de WORKSPACE (OBLIGATORIAS)
+## Directivas SCRUM (SIMCO v4.0.0)

-Ubicación: `workspace/orchestration/`
+### Ejecución de Sprint

-| Alias | Archivo | Propósito |
-|-------|---------|-----------|
-| `@CARGA-CONTEXTO` | `directivas/DIRECTIVA-CARGA-CONTEXTO.md` | Como cargar contexto según nivel |
-| `@INDICE` | `INDICE-DIRECTIVAS-WORKSPACE.yml` | Indice maestro de directivas |
+| Alias | Directiva | Propósito |
+|-------|-----------|-----------|
+| `@SPRINT_EXECUTION` | `SIMCO-SPRINT-EXECUTION.md` | Ciclo completo de Sprint |
+| `@AGILE_METRICS` | `SIMCO-AGILE-METRICS.md` | Métricas Velocity, Burndown |
+| `@SCRUM_INTEGRATION` | `SIMCO-SCRUM-INTEGRATION.md` | Integración CAPVED+SCRUM |

---
+### Definition of Ready (DoR)

-## Directivas de Ciclo de Vida (USAR SIEMPRE)
+| Criterio | Descripción |
+|----------|-------------|
+| ID asignado | `MCH-US-NNN` |
+| Historia completa | Como/Quiero/Para |
+| Criterios de aceptación | 3-8 criterios |
+| Story Points | Fibonacci (1,2,3,5,8,13) |
+| Dependencias identificadas | Sin bloqueos |
+| PO aprobado | ✓ |

-| Alias | Archivo | Propósito |
-|-------|---------|-----------|
-| `@TAREA` | `directivas/simco/SIMCO-TAREA.md` | Punto de entrada para toda HU |
-| `@CAPVED` | `directivas/principios/PRINCIPIO-CAPVED.md` | Ciclo de 6 fases |
-| `@INICIALIZACION` | `directivas/simco/SIMCO-INICIALIZACION.md` | Bootstrap de agentes |
-| `@DOC-DEFINITIVA` | `directivas/DIRECTIVA-DOCUMENTACION-DEFINITIVA.md` | Docs como estado final |
+### Definition of Done (DoD)

---
+| Criterio | Descripción |
+|----------|-------------|
+| Código implementado | Según especificación |
+| Build pasa | Sin errores |
+| Tests pasando | Unitarios + integración |
+| Code review | Completado |
+| Documentación | Actualizada |
+| TRACEABILITY.yml | Actualizado |

-## Operaciones Universales
-
-| Alias | Archivo | Propósito |
-|-------|---------|-----------|
-| `@CREAR` | `SIMCO-CREAR.md` | Crear archivos nuevos |
-| `@MODIFICAR` | `SIMCO-MODIFICAR.md` | Modificar existentes |
-| `@VALIDAR` | `SIMCO-VALIDAR.md` | Validar código |
-| `@DOCUMENTAR` | `SIMCO-DOCUMENTAR.md` | Documentar trabajo |
-| `@BUSCAR` | `SIMCO-BUSCAR.md` | Buscar información |
-| `@DELEGAR` | `SIMCO-DELEGACION.md` | Delegar a subagentes |
-
---
-
-## Principios Fundamentales (5)
-
-| Alias | Resumen |
-|-------|---------|
-| `@CAPVED` | Toda tarea pasa por 6 fases |
-| `@DOC_PRIMERO` | Consultar docs/ antes de implementar |
-| `@ANTI_DUP` | Verificar que no existe antes de crear |
-| `@VALIDACION` | Build y lint DEBEN pasar |
-| `@TOKENS` | Desglosar tareas grandes |
-
---
-
-## Directivas por Dominio Técnico
-
-| Alias | Aplica | Notas |
-|-------|--------|-------|
-| `@OP_DDL` | **SÍ** | 11 schemas, 47 tablas |
-| `@OP_BACKEND` | **SÍ** | NestJS, 17 módulos |
-| `@OP_FRONTEND` | **SÍ** | React + Vite |
-| `@OP_MOBILE` | **SÍ** | React Native (Expo) |
-| `@OP_ML` | NO | (LLM via MCP, no ML propio) |
-
---
-
-## Directivas de Documentación (SIMCO v3.7)
-
-Ubicación: `workspace/orchestration/directivas/simco/`
-
-**Directivas de estandarización de documentación:**
-
-| Alias | Directiva | Propósito | Aplica |
-|-------|-----------|-----------|--------|
-| `@DOC_PROYECTO` | `SIMCO-DOCUMENTACION-PROYECTO.md` | Estructura base de documentación | **SÍ** |
-| `@NOMENCLATURA` | `SIMCO-NOMENCLATURA.md` | Convenciones de nomenclatura (MCH-) | **SÍ** |
-| `@ESTRUCTURA_DOCS` | `SIMCO-ESTRUCTURA-DOCS.md` | Estructura interna de documentos | **SÍ** |
-| `@INVENTARIOS` | `SIMCO-INVENTARIOS.md` | Estándares de inventarios YAML | **SÍ** |
-| `@TESTING` | `SIMCO-TESTING.md` | Cobertura y estándares de testing | **SÍ** |
-| `@MIGRACIONES` | `SIMCO-MIGRACIONES-BD.md` | Migraciones y DDL | **SÍ** |
-| `@INTEGRACIONES` | `SIMCO-INTEGRACIONES-EXTERNAS.md` | Documentación de integraciones | **SÍ** |
-
-### Checklists Asociados
-
-| Alias | Checklist | Items |
-|-------|-----------|-------|
-| `@CHK_DOCUMENTACION` | `CHECKLIST-DOCUMENTACION-PROYECTO.md` | 44 |
-| `@CHK_INVENTARIOS` | `CHECKLIST-INVENTARIOS.md` | 63 |
-| `@CHK_NOMENCLATURA` | `CHECKLIST-NOMENCLATURA.md` | 40 |
-
-### Templates Disponibles
+### Templates SCRUM

 | Alias | Template | Uso |
 |-------|----------|-----|
-| `@TPL_INVENTARIO` | `TEMPLATE-INVENTARIO-PROYECTO.md` | Crear inventarios YAML |
-| `@TPL_INTEGRACION` | `TEMPLATE-INTEGRACION-EXTERNA.md` | Documentar integraciones (WhatsApp, Stripe, etc.) |
-| `@TPL_MODULO_ESTANDAR` | `TEMPLATE-MODULO-ESTANDAR.md` | Documentar módulos |
+| `@TPL_DEFINICION_READY` | `TEMPLATE-DEFINICION-READY.md` | Validar DoR de HU |
+| `@TPL_SPRINT_BACKLOG` | `TEMPLATE-SPRINT-BACKLOG.yml` | Tracking de Sprint |
+| `@TPL_RETROSPECTIVA` | `TEMPLATE-RETROSPECTIVA.yml` | Retro Start-Stop-Continue |
+| `@TPL_SPRINT_PLANNING` | `TEMPLATE-ACTA-SPRINT-PLANNING.md` | Acta de Planning |

---
-
-## Directivas de Mantenimiento de Documentación (SIMCO v3.8)
-
-Ubicación: `workspace/orchestration/directivas/simco/`
-
-**Nuevas directivas agregadas en v3.8 para mantenimiento, purga y sincronización de documentación:**
-
-| Alias | Directiva | Propósito | Aplica |
-|-------|-----------|-----------|--------|
-| `@MANTENIMIENTO_DOCS` | `SIMCO-MANTENIMIENTO-DOCUMENTACION.md` | Ciclo de mantenimiento, purga y deprecación | **SÍ** |
-| `@SYNC_BD` | `SIMCO-SINCRONIZACION-BD.md` | Sincronización BD ↔ Código ↔ Docs | **SÍ** |
-
-### Checklists de Mantenimiento
+### Checklist DoD/DoR

 | Alias | Checklist | Items |
 |-------|-----------|-------|
-| `@CHK_MANTENIMIENTO` | `CHECKLIST-MANTENIMIENTO-DOCS.md` | 80 |
-| `@CHK_SYNC_BD` | `CHECKLIST-SINCRONIZACION-BD.md` | 70 |
-
-### Templates y Perfiles
-
-| Alias | Archivo | Uso |
-|-------|---------|-----|
-| `@TPL_DEPRECACION` | `TEMPLATE-DEPRECACION.md` | Marcar documentos como deprecados |
-| `@PERFIL_DOC_MAINT` | `PERFIL-DOCUMENTATION-MAINTAINER.md` | Perfil especializado en mantenimiento |
-
-### Cuándo Usar
-
-| Evento | Acción |
-|--------|--------|
-| Tarea completada (código) | `@MANTENIMIENTO_DOCS` nivel básico |
-| Cambio en DDL | `@SYNC_BD` + `@CHK_SYNC_BD` |
-| Fin de sprint/fase | `@CHK_MANTENIMIENTO` completo |
-| Deprecar documentos | `@TPL_DEPRECACION` |
+| `@CHK_DOD_DOR` | `CHECKLIST-DOD-DOR.md` | 32 items |

 ---

-## Patrones Aplicables
+## Directivas CAPVED (Heredadas)

-| Patrón | Uso en MiChangarrito |
-|--------|----------------------|
-| `MAPEO-TIPOS-DDL-TYPESCRIPT.md` | 9 schemas -> Entities |
-| `PATRON-VALIDACION.md` | class-validator en DTOs |
-| `PATRON-EXCEPTION-HANDLING.md` | Filtros NestJS |
-| `PATRON-TESTING.md` | Jest + e2e tests |
-| `PATRON-SEGURIDAD.md` | JWT, multi-tenant RLS |
-| `PATRON-TRANSACCIONES.md` | TypeORM transactions |
-| `ANTIPATRONES.md` | Evitar siempre |
+### Ciclo de Vida
+
+| Alias | Archivo | Propósito |
+|-------|---------|-----------|
+| `@TAREA` | `SIMCO-TAREA.md` | Punto de entrada |
+| `@CAPVED` | `PRINCIPIO-CAPVED.md` | Ciclo de 6 fases |
+| `@INICIALIZACION` | `SIMCO-INICIALIZACION.md` | Bootstrap de agentes |
+
+### Operaciones
+
+| Alias | Archivo | Propósito |
+|-------|---------|-----------|
+| `@CREAR` | `SIMCO-CREAR.md` | Crear archivos |
+| `@MODIFICAR` | `SIMCO-MODIFICAR.md` | Modificar archivos |
+| `@VALIDAR` | `SIMCO-VALIDAR.md` | Validar código |
+| `@DOCUMENTAR` | `SIMCO-DOCUMENTAR.md` | Documentar trabajo |
+| `@BUSCAR` | `SIMCO-BUSCAR.md` | Buscar información |

 ---

-## Variables de Contexto CCA
+## Directivas de Documentación

-```yaml
-# Identificación del Proyecto
-PROJECT_NAME: "michangarrito"
-PROJECT_CODE: "MCH"
-PROJECT_LEVEL: "STANDALONE"
-PROJECT_ROOT: "/home/isem/workspace-v1/projects/michangarrito"
-
-# Rutas principales
-APPS_ROOT: "apps"
-DOCS_ROOT: "docs"
-ORCHESTRATION: "orchestration"
-
-# Base de Datos
-DB_NAME: "michangarrito"
-DB_DDL_PATH: "database/schemas"
-DB_SCRIPTS_PATH: "database"
-DB_SEEDS_PATH: "database/seeds"
-
-# Backend (NestJS)
-BACKEND_ROOT: "apps/backend"
-BACKEND_SRC: "apps/backend/src"
-BACKEND_FRAMEWORK: "NestJS"
-ORM: "TypeORM"
-
-# Frontend (React)
-FRONTEND_ROOT: "apps/frontend"
-FRONTEND_SRC: "apps/frontend/src"
-FRONTEND_FRAMEWORK: "React"
-BUILD_TOOL: "Vite"
-
-# Mobile (React Native)
-MOBILE_ROOT: "apps/mobile"
-MOBILE_FRAMEWORK: "React Native (Expo)"
-
-# Servicios Adicionales
-MCP_SERVER_ROOT: "apps/mcp-server"
-WHATSAPP_SERVICE_ROOT: "apps/whatsapp-service"
-
-# Multi-tenant
-TENANT_COLUMN: "tenant_id"
-RLS_CONTEXT: "app.current_tenant_id"
-
-# Inventarios
-MASTER_INVENTORY: "orchestration/inventarios/MASTER_INVENTORY.yml"
-```
+| Alias | Directiva | Propósito |
+|-------|-----------|-----------|
+| `@DOC_PROYECTO` | `SIMCO-DOCUMENTACION-PROYECTO.md` | Estructura docs/ |
+| `@NOMENCLATURA` | `SIMCO-NOMENCLATURA.md` | Convenciones de IDs |
+| `@ESTRUCTURA_DOCS` | `SIMCO-ESTRUCTURA-DOCS.md` | Estructura interna |
+| `@INVENTARIOS` | `SIMCO-INVENTARIOS.md` | Inventarios YAML |
+| `@MANTENIMIENTO_DOCS` | `SIMCO-MANTENIMIENTO-DOCUMENTACION.md` | Ciclo mantenimiento |
+| `@SYNC_BD` | `SIMCO-SINCRONIZACION-BD.md` | Sincronización BD↔Docs |

 ---

-## Schemas de Base de Datos (9)
+## Trazabilidad v2

-| Schema | Descripción | Tablas |
-|--------|-------------|--------|
-| `auth` | Autenticación, tokens | ~4 |
-| `users` | Usuarios y roles | ~3 |
-| `tenants` | Multi-tenancy | ~3 |
-| `catalog` | Productos, categorías | ~4 |
-| `sales` | Ventas, transacciones | ~4 |
-| `inventory` | Stock, movimientos | ~3 |
-| `payments` | Pagos, integraciones | ~3 |
-| `ai` | Tokens IA, conversaciones | ~2 |
-| `whatsapp` | Mensajes, sesiones | ~3 |
+### TRACEABILITY-MASTER.yml

-**Total:** 29 tablas
+Ubicación: `docs/04-modelado/trazabilidad/TRACEABILITY-MASTER.yml`

---
+Este archivo consolida:
+- Mapeo de nomenclatura v1 → v2
+- Lista de épicas con estados
+- Grafo de dependencias
+- Health score del proyecto

-## Integraciones Externas (Usar @INTEGRACIONES)
-
-| Integración | Proveedor | Estado | Documentar con |
-|-------------|-----------|--------|----------------|
-| WhatsApp | Meta Business API | Implementado | `@TPL_INTEGRACION` |
-| Pagos | Stripe | Implementado | `@TPL_INTEGRACION` |
-| Terminal | Mercado Pago | Pendiente | `@TPL_INTEGRACION` |
-| Terminal | Clip | Pendiente | `@TPL_INTEGRACION` |
-| CoDi | Banxico | Pendiente | `@TPL_INTEGRACION` |
-| LLM Gateway | OpenRouter | Implementado | `@TPL_INTEGRACION` |
-| OCR | Google Vision/Tesseract | Pendiente | `@TPL_INTEGRACION` |
-| Audio | Whisper | Pendiente | `@TPL_INTEGRACION` |
-
---
-
-## Perfiles de Agentes más usados
-
-| Perfil | Especialización | Frecuencia |
-|--------|-----------------|------------|
-| `PERFIL-DATABASE.md` | PostgreSQL, 9 schemas | Alta |
-| `PERFIL-BACKEND.md` | NestJS, TypeORM | Alta |
-| `PERFIL-FRONTEND.md` | React, Vite | Alta |
-| `PERFIL-MOBILE.md` | React Native, Expo | Alta |
-| `PERFIL-CODE-REVIEWER.md` | Revisión de código | Media |
-
---
-
-## Flujo de Trabajo para Desarrollo
-
-```yaml
-# PASO 1: Cargar contexto (CCA)
-CARGAR:
-  - @TAREA
-  - @CAPVED
-  - @INICIALIZACION
-  - ./CONTEXTO-PROYECTO.md
-
-# PASO 2: Seleccionar operación
-OPERACION:
-  - @OP_DDL         # 9 schemas
-  - @OP_BACKEND     # NestJS
-  - @OP_FRONTEND    # React
-  - @OP_MOBILE      # React Native
-
-# PASO 3: Aplicar patrones
-PATRONES:
-  - @PATRON-VALIDACION
-  - @PATRON-EXCEPTION-HANDLING
-  - @PATRON-SEGURIDAD
-
-# PASO 4: Validar
-VALIDAR:
-  - npm run build
-  - npm run lint
-  - npm run test
-
-# PASO 5: Documentar
-CIERRE:
-  - @DOCUMENTAR
-  - Actualizar inventarios
-```
-
---
-
-## Nomenclatura del Proyecto
-
-Prefijo: **MCH-**
+### Nomenclatura v2

 | Tipo | Formato | Ejemplo |
 |------|---------|---------|
-| Épicas | MCH-E{NN} | MCH-E01-auth |
-| Requerimientos | MCH-RF-{NNN} | MCH-RF-001 |
-| Specs | MCH-ET-{TIPO}-{NNN} | MCH-ET-API-001 |
-| Historias | MCH-US-{NNN} | MCH-US-001 |
+| Épica | `MCH-EP-NNN` | MCH-EP-001 |
+| Requerimiento | `MCH-RF-NNN` | MCH-RF-001 |
+| User Story | `MCH-US-NNN` | MCH-US-001 |
+| Tarea | `MCH-TT-NNN` | MCH-TT-001 |
+| Bug | `MCH-BG-NNN` | MCH-BG-001 |

 ---

-**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs
-**Nivel:** STANDALONE (2A)
+## Flujo de Trabajo Sprint
+
+```yaml
+# Sprint Planning
+1. Cargar: @SPRINT_EXECUTION
+2. Seleccionar HUs del backlog
+3. Validar DoR con @CHK_DOD_DOR
+4. Estimar con Planning Poker
+5. Crear Sprint Backlog con @TPL_SPRINT_BACKLOG
+
+# Durante Sprint (por HU)
+1. Cargar: @TAREA + @CAPVED
+2. Ejecutar ciclo CAPVED
+3. Validar DoD con @CHK_DOD_DOR
+4. Actualizar TRACEABILITY.yml
+
+# Sprint Review
+1. Demo de funcionalidades
+2. Actualizar @AGILE_METRICS
+
+# Sprint Retrospective
+1. Usar @TPL_RETROSPECTIVA
+2. Registrar Start-Stop-Continue
+3. Crear action items
+```
+
+---
+
+## Referencias
+
+- Directivas SIMCO: `workspace-v2/orchestration/directivas/simco/`
+- Templates SCRUM: `workspace-v2/orchestration/templates/scrum/`
+- Checklists: `workspace-v2/orchestration/checklists/`
+- TRACEABILITY-MASTER: `docs/04-modelado/trazabilidad/TRACEABILITY-MASTER.yml`
+
+---
+
+**Sistema:** SIMCO v4.0.0 + CAPVED + SCRUM
 **Última actualización:** 2026-01-10