From f34aadef41a9b2bb2a910531eebde77deca094fd Mon Sep 17 00:00:00 2001 From: rckrdmrd Date: Sat, 10 Jan 2026 08:53:21 -0600 Subject: [PATCH] [SIMCO-V38] docs: Actualizar a SIMCO v3.8.0 - HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Actualizado erp-basico y pos-micro Co-Authored-By: Claude Opus 4.5 --- .../00-guidelines/HERENCIA-SIMCO.md | 80 ++++++++++++++++-- .../00-guidelines/HERENCIA-SIMCO.md | 82 +++++++++++++++++-- orchestration/00-guidelines/HERENCIA-SIMCO.md | 82 +++++++++++++++++-- 3 files changed, 229 insertions(+), 15 deletions(-) diff --git a/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md b/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md index 4710ae8..a572fab 100644 --- a/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md +++ b/apps/products/erp-basico/orchestration/00-guidelines/HERENCIA-SIMCO.md @@ -1,7 +1,7 @@ # Herencia SIMCO - ERP Básico -**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol -**Fecha:** 2025-12-08 +**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs +**Fecha:** 2026-01-10 --- @@ -12,7 +12,7 @@ | **Proyecto** | ERP Básico - Producto Simplificado | | **Nivel** | PRODUCT (Nivel 2) | | **Padre** | erp-suite | -| **SIMCO Version** | 2.2.0 | +| **SIMCO Version** | 3.8.0 | | **CAPVED** | Habilitado | | **CCA Protocol** | Habilitado | | **Estado** | Por iniciar | @@ -80,6 +80,76 @@ Todos los patrones de `core/orchestration/patrones/` aplican. --- +## 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 | **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 + +| Alias | Template | Uso | +|-------|----------|-----| +| `@TPL_INVENTARIO` | `TEMPLATE-INVENTARIO-PROYECTO.md` | Crear inventarios YAML | +| `@TPL_INTEGRACION` | `TEMPLATE-INTEGRACION-EXTERNA.md` | Documentar integraciones | +| `@TPL_MODULO_ESTANDAR` | `TEMPLATE-MODULO-ESTANDAR.md` | Documentar módulos | + +--- + +## Directivas de Mantenimiento de Documentación (SIMCO v3.8) + +Ubicación: `workspace/orchestration/directivas/simco/` + +**Directivas de mantenimiento, purga y sincronizació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 + +| 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` | + +--- + ## Variables de Contexto CCA ```yaml @@ -111,6 +181,6 @@ SIMPLIFIED: true --- -**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs **Nivel:** PRODUCT (2) -**Última actualización:** 2025-12-08 +**Última actualización:** 2026-01-10 diff --git a/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md b/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md index 8c5d749..0088e83 100644 --- a/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md +++ b/apps/products/pos-micro/orchestration/00-guidelines/HERENCIA-SIMCO.md @@ -1,7 +1,7 @@ # Herencia SIMCO - POS Micro -**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol -**Fecha:** 2025-12-08 +**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs +**Fecha:** 2026-01-10 --- @@ -12,7 +12,7 @@ | **Proyecto** | POS Micro - Punto de Venta Simplificado | | **Nivel** | PRODUCT (Nivel 2) | | **Padre** | erp-suite | -| **SIMCO Version** | 2.2.0 | +| **SIMCO Version** | 3.8.0 | | **CAPVED** | Habilitado | | **CCA Protocol** | Habilitado | | **Estado** | Por iniciar | @@ -85,6 +85,78 @@ Todos los patrones de `core/orchestration/patrones/` aplican. --- +## 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 | **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 + +| Alias | Template | Uso | +|-------|----------|-----| +| `@TPL_INVENTARIO` | `TEMPLATE-INVENTARIO-PROYECTO.md` | Crear inventarios YAML | +| `@TPL_INTEGRACION` | `TEMPLATE-INTEGRACION-EXTERNA.md` | Documentar integraciones | +| `@TPL_MODULO_ESTANDAR` | `TEMPLATE-MODULO-ESTANDAR.md` | Documentar módulos | + +--- + +## Directivas de Mantenimiento de Documentación (SIMCO v3.8) + +Ubicación: `workspace/orchestration/directivas/simco/` + +**Directivas de mantenimiento, purga y sincronizació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 + +| 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` | + +**Nota para POS:** Las transacciones de venta requieren `@SYNC_BD` inmediato. + +--- + ## Variables de Contexto CCA ```yaml @@ -125,6 +197,6 @@ OFFLINE_CAPABLE: true --- -**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs **Nivel:** PRODUCT (2) -**Última actualización:** 2025-12-08 +**Última actualización:** 2026-01-10 diff --git a/orchestration/00-guidelines/HERENCIA-SIMCO.md b/orchestration/00-guidelines/HERENCIA-SIMCO.md index 79e107e..e3f0d55 100644 --- a/orchestration/00-guidelines/HERENCIA-SIMCO.md +++ b/orchestration/00-guidelines/HERENCIA-SIMCO.md @@ -1,7 +1,7 @@ # Herencia SIMCO - ERP Suite -**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol -**Fecha:** 2025-12-08 +**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs +**Fecha:** 2026-01-10 --- @@ -12,7 +12,7 @@ | **Proyecto** | ERP Suite - Sistema ERP Multi-Vertical | | **Nivel** | SUITE (Nivel 1) | | **Padre** | core/orchestration | -| **SIMCO Version** | 2.2.0 | +| **SIMCO Version** | 3.8.0 | | **CAPVED** | Habilitado | | **CCA Protocol** | Habilitado | @@ -137,6 +137,78 @@ Ubicación: `core/orchestration/patrones/` --- +## 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 | **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 + +| Alias | Template | Uso | +|-------|----------|-----| +| `@TPL_INVENTARIO` | `TEMPLATE-INVENTARIO-PROYECTO.md` | Crear inventarios YAML | +| `@TPL_INTEGRACION` | `TEMPLATE-INTEGRACION-EXTERNA.md` | Documentar integraciones | +| `@TPL_MODULO_ESTANDAR` | `TEMPLATE-MODULO-ESTANDAR.md` | Documentar módulos | + +--- + +## Directivas de Mantenimiento de Documentación (SIMCO v3.8) + +Ubicación: `workspace/orchestration/directivas/simco/` + +**Directivas de mantenimiento, purga y sincronizació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 + +| 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` | + +**IMPORTANTE para Suite:** Estos estándares aplican a todos los productos y verticales. + +--- + ## Impactos y Dependencias | Documento | Consultar Cuando | @@ -307,6 +379,6 @@ Ver directiva completa: @PROPAGACION --- -**Sistema:** SIMCO v2.2.0 + CAPVED + CCA Protocol +**Sistema:** SIMCO v3.8.0 + CAPVED + CCA Protocol + Estándares Documentación + Mantenimiento Docs **Nivel:** SUITE (1) -**Última actualización:** 2026-01-04 +**Última actualización:** 2026-01-10