## Directivas SIMCO v3.7.0 - Estandarizacion de Documentacion (7) - SIMCO-DOCUMENTACION-PROYECTO.md - SIMCO-NOMENCLATURA.md - SIMCO-ESTRUCTURA-DOCS.md - SIMCO-INVENTARIOS.md - SIMCO-TESTING.md - SIMCO-MIGRACIONES-BD.md - SIMCO-INTEGRACIONES-EXTERNAS.md ## Directivas SIMCO v3.8.0 - Mantenimiento de Documentacion (2) - SIMCO-MANTENIMIENTO-DOCUMENTACION.md - SIMCO-SINCRONIZACION-BD.md ## Templates (4) - TEMPLATE-INVENTARIO-PROYECTO.md - TEMPLATE-INTEGRACION-EXTERNA.md - TEMPLATE-MODULO-ESTANDAR.md - TEMPLATE-DEPRECACION.md ## Checklists (6) - CHECKLIST-DOCUMENTACION-PROYECTO.md - CHECKLIST-INVENTARIOS.md - CHECKLIST-NOMENCLATURA.md - CHECKLIST-MANTENIMIENTO-DOCS.md - CHECKLIST-SINCRONIZACION-BD.md - _MAP.md ## Perfil de Agente (1) - PERFIL-DOCUMENTATION-MAINTAINER.md ## Indices - INDICE-DIRECTIVAS-WORKSPACE.yml actualizado a v3.8.0 ## Submodulos actualizados (14) - gamilit, erp-core, michangarrito, template-saas - erp-suite, erp-construccion, erp-clinicas - erp-mecanicas-diesel, erp-retail, erp-vidrio-templado - trading-platform, betting-analytics - inmobiliaria-analytics, platform_marketing_content Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
673 lines
22 KiB
Markdown
673 lines
22 KiB
Markdown
# INFORME DE PROPAGACIÓN - SIMCO v3.7.0
|
|
**Fecha:** 2026-01-10
|
|
**Tipo:** Propagación de Estándares de Documentación
|
|
**Estado:** COMPLETADO
|
|
**Versión del Informe:** 1.0.0
|
|
|
|
---
|
|
|
|
## RESUMEN EJECUTIVO
|
|
|
|
Este informe documenta la propagación de las nuevas directivas de documentación SIMCO v3.7.0 a los proyectos del workspace. Cada agente asignado a un proyecto debe usar este informe para validar que los cambios fueron implementados correctamente.
|
|
|
|
### Alcance de la Propagación
|
|
|
|
| Proyecto | Tipo de Cambio | Archivo Modificado |
|
|
|----------|----------------|-------------------|
|
|
| **workspace** | Origen - Nuevas directivas | INDICE-DIRECTIVAS-WORKSPACE.yml |
|
|
| **gamilit** | Actualización | HERENCIA-SIMCO.md |
|
|
| **erp-core** | Actualización | HERENCIA-SIMCO.md |
|
|
| **michangarrito** | Creación nueva | HERENCIA-SIMCO.md |
|
|
| **template-saas** | Expansión | HERENCIA-SIMCO.md |
|
|
|
|
---
|
|
|
|
## PARTE 1: CAMBIOS A NIVEL WORKSPACE
|
|
|
|
### 1.1 Nuevas Directivas SIMCO (7 archivos)
|
|
|
|
**Ubicación:** `workspace-v1/orchestration/directivas/simco/`
|
|
|
|
| # | Archivo | Alias | Propósito | Líneas |
|
|
|---|---------|-------|-----------|--------|
|
|
| 1 | `SIMCO-DOCUMENTACION-PROYECTO.md` | `@DOC_PROYECTO` | Estructura base de documentación de proyectos | 211 |
|
|
| 2 | `SIMCO-NOMENCLATURA.md` | `@NOMENCLATURA` | Convenciones de nomenclatura (RF-, ET-, US-, etc.) | 288 |
|
|
| 3 | `SIMCO-ESTRUCTURA-DOCS.md` | `@ESTRUCTURA_DOCS` | Estructura interna de documentos markdown | 501 |
|
|
| 4 | `SIMCO-INVENTARIOS.md` | `@INVENTARIOS` | Estándares para inventarios YAML | 386 |
|
|
| 5 | `SIMCO-TESTING.md` | `@TESTING` | Cobertura mínima y estándares de testing | 366 |
|
|
| 6 | `SIMCO-MIGRACIONES-BD.md` | `@MIGRACIONES` | Estándares de migraciones y DDL | 349 |
|
|
| 7 | `SIMCO-INTEGRACIONES-EXTERNAS.md` | `@INTEGRACIONES` | Documentación de integraciones externas | 419 |
|
|
|
|
### 1.2 Nuevos Templates (3 archivos)
|
|
|
|
**Ubicación:** `workspace-v1/orchestration/templates/`
|
|
|
|
| # | Archivo | Alias | Propósito | Líneas |
|
|
|---|---------|-------|-----------|--------|
|
|
| 1 | `TEMPLATE-INVENTARIO-PROYECTO.md` | `@TPL_INVENTARIO` | Crear inventarios YAML estandarizados | 370 |
|
|
| 2 | `TEMPLATE-INTEGRACION-EXTERNA.md` | `@TPL_INTEGRACION` | Documentar integraciones con servicios externos | 351 |
|
|
| 3 | `TEMPLATE-MODULO-ESTANDAR.md` | `@TPL_MODULO_ESTANDAR` | Documentar módulos de proyecto | 265 |
|
|
|
|
### 1.3 Nuevos Checklists (4 archivos)
|
|
|
|
**Ubicación:** `workspace-v1/orchestration/checklists/`
|
|
|
|
| # | Archivo | Alias | Items | Propósito |
|
|
|---|---------|-------|-------|-----------|
|
|
| 1 | `CHECKLIST-DOCUMENTACION-PROYECTO.md` | `@CHK_DOCUMENTACION` | 59 | Validar estructura de documentación |
|
|
| 2 | `CHECKLIST-INVENTARIOS.md` | `@CHK_INVENTARIOS` | 78 | Validar inventarios YAML |
|
|
| 3 | `CHECKLIST-NOMENCLATURA.md` | `@CHK_NOMENCLATURA` | 58 | Validar nomenclatura de archivos |
|
|
| 4 | `_MAP.md` | - | - | Índice de checklists |
|
|
|
|
### 1.4 Índice Principal Actualizado
|
|
|
|
**Archivo:** `workspace-v1/orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml`
|
|
|
|
**Cambios realizados:**
|
|
- Versión: `3.6.0` → `3.7.0`
|
|
- Nueva sección: `operaciones_documentacion`
|
|
- Nuevos aliases: 15+
|
|
- Metadata actualizada:
|
|
- `total_directivas_simco`: 42 → 49
|
|
- `total_templates`: 24 → 27
|
|
- `total_checklists`: 5 → 8
|
|
|
|
---
|
|
|
|
## PARTE 2: VALIDACIÓN POR PROYECTO
|
|
|
|
---
|
|
|
|
### 2.1 PROYECTO: GAMILIT
|
|
|
|
**Archivo modificado:** `projects/gamilit/orchestration/00-guidelines/HERENCIA-SIMCO.md`
|
|
|
|
#### Cambios Implementados
|
|
|
|
| Campo | Valor Anterior | Valor Nuevo |
|
|
|-------|----------------|-------------|
|
|
| Sistema | SIMCO v2.3.0 | SIMCO v3.7.0 + Estándares Documentación |
|
|
| Fecha | 2025-12-18 | 2026-01-10 |
|
|
| SIMCO Version (tabla) | 2.3.0 | 3.7.0 |
|
|
| Última actualización | 2025-12-08 | 2026-01-10 |
|
|
|
|
#### Nueva Sección Agregada
|
|
|
|
Se agregó la sección **"Directivas de Documentación (SIMCO v3.7)"** después de "Directivas por Dominio Técnico" con:
|
|
|
|
**Directivas (7):**
|
|
```
|
|
@DOC_PROYECTO → SIMCO-DOCUMENTACION-PROYECTO.md
|
|
@NOMENCLATURA → SIMCO-NOMENCLATURA.md
|
|
@ESTRUCTURA_DOCS → SIMCO-ESTRUCTURA-DOCS.md
|
|
@INVENTARIOS → SIMCO-INVENTARIOS.md
|
|
@TESTING → SIMCO-TESTING.md
|
|
@MIGRACIONES → SIMCO-MIGRACIONES-BD.md
|
|
@INTEGRACIONES → SIMCO-INTEGRACIONES-EXTERNAS.md
|
|
```
|
|
|
|
**Checklists (3):**
|
|
```
|
|
@CHK_DOCUMENTACION → CHECKLIST-DOCUMENTACION-PROYECTO.md (44 items)
|
|
@CHK_INVENTARIOS → CHECKLIST-INVENTARIOS.md (63 items)
|
|
@CHK_NOMENCLATURA → CHECKLIST-NOMENCLATURA.md (40 items)
|
|
```
|
|
|
|
**Templates (3):**
|
|
```
|
|
@TPL_INVENTARIO → TEMPLATE-INVENTARIO-PROYECTO.md
|
|
@TPL_INTEGRACION → TEMPLATE-INTEGRACION-EXTERNA.md
|
|
@TPL_MODULO_ESTANDAR → TEMPLATE-MODULO-ESTANDAR.md
|
|
```
|
|
|
|
#### Checklist de Validación para Agente GAMILIT
|
|
|
|
```markdown
|
|
## Validación HERENCIA-SIMCO.md - GAMILIT
|
|
|
|
### Metadata
|
|
- [ ] Cabecera muestra: "SIMCO v3.7.0 + CAPVED + CCA Protocol + Estándares Documentación"
|
|
- [ ] Fecha cabecera: 2026-01-10
|
|
- [ ] Tabla configuración muestra: SIMCO Version = 3.7.0
|
|
- [ ] Pie de página muestra: SIMCO v3.7.0
|
|
|
|
### Sección Directivas de Documentación
|
|
- [ ] Existe sección "Directivas de Documentación (SIMCO v3.7)"
|
|
- [ ] Lista 7 directivas con columnas: Alias | Directiva | Propósito | Aplica
|
|
- [ ] Todas las directivas tienen "Aplica = SÍ"
|
|
- [ ] Subsección "Checklists Asociados" existe con 3 entries
|
|
- [ ] Subsección "Templates Disponibles" existe con 3 entries
|
|
|
|
### Consistencia
|
|
- [ ] Total de líneas aproximado: ~351
|
|
- [ ] No hay errores de sintaxis markdown
|
|
- [ ] Todas las versiones son consistentes (3.7.0)
|
|
```
|
|
|
|
#### Comandos de Validación
|
|
|
|
```bash
|
|
# Verificar versión
|
|
grep -E "SIMCO v[0-9]" projects/gamilit/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar sección v3.7
|
|
grep -c "Directivas de Documentación (SIMCO v3.7)" projects/gamilit/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Contar aliases v3.7
|
|
grep -cE "@DOC_PROYECTO|@NOMENCLATURA|@ESTRUCTURA_DOCS|@INVENTARIOS|@TESTING|@MIGRACIONES|@INTEGRACIONES" projects/gamilit/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar líneas
|
|
wc -l projects/gamilit/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
```
|
|
|
|
#### Aplicabilidad de Directivas para GAMILIT
|
|
|
|
| Directiva | Aplica | Justificación |
|
|
|-----------|--------|---------------|
|
|
| @DOC_PROYECTO | SÍ | Estructura /docs y /orchestration existente |
|
|
| @NOMENCLATURA | SÍ | Prefijos RF-, ET-, US- en uso |
|
|
| @ESTRUCTURA_DOCS | SÍ | 1,434 archivos MD |
|
|
| @INVENTARIOS | SÍ | 4 inventarios YAML existentes |
|
|
| @TESTING | SÍ | Jest configurado |
|
|
| @MIGRACIONES | SÍ | DDL en apps/database/ddl |
|
|
| @INTEGRACIONES | SÍ | OAuth (5 proveedores) |
|
|
|
|
---
|
|
|
|
### 2.2 PROYECTO: ERP-CORE
|
|
|
|
**Archivo modificado:** `projects/erp-core/orchestration/00-guidelines/HERENCIA-SIMCO.md`
|
|
|
|
#### Cambios Implementados
|
|
|
|
| Campo | Valor Anterior | Valor Nuevo |
|
|
|-------|----------------|-------------|
|
|
| Sistema | SIMCO v2.2.0 | SIMCO v3.7.0 + Estándares Documentación |
|
|
| Fecha | 2025-12-08 | 2026-01-10 |
|
|
| SIMCO Version (tabla) | 2.2.0 | 3.7.0 |
|
|
| Última actualización | 2026-01-04 | 2026-01-10 |
|
|
|
|
#### Nueva Sección Agregada
|
|
|
|
Se agregó la sección **"Directivas de Documentación (SIMCO v3.7)"** después de "Directivas por Dominio Técnico".
|
|
|
|
Contenido idéntico a GAMILIT con nota especial:
|
|
```
|
|
**IMPORTANTE para ERP Core:** Estas directivas aplican también a todas las verticales.
|
|
```
|
|
|
|
#### Checklist de Validación para Agente ERP-CORE
|
|
|
|
```markdown
|
|
## Validación HERENCIA-SIMCO.md - ERP-CORE
|
|
|
|
### Metadata
|
|
- [ ] Cabecera muestra: "SIMCO v3.7.0 + CAPVED + CCA Protocol + Estándares Documentación"
|
|
- [ ] Fecha cabecera: 2026-01-10
|
|
- [ ] Tabla configuración muestra: SIMCO Version = 3.7.0
|
|
- [ ] Pie de página muestra: SIMCO v3.7.0
|
|
- [ ] Nivel = SUITE_CORE (2)
|
|
|
|
### Sección Directivas de Documentación
|
|
- [ ] Existe sección "Directivas de Documentación (SIMCO v3.7)"
|
|
- [ ] Lista 7 directivas correctamente
|
|
- [ ] Incluye nota sobre verticales
|
|
- [ ] @INTEGRACIONES menciona "Odoo"
|
|
- [ ] Subsección "Checklists Asociados" existe
|
|
- [ ] Subsección "Templates Disponibles" existe
|
|
|
|
### Consistencia
|
|
- [ ] Total de líneas aproximado: ~378
|
|
- [ ] No hay errores de sintaxis markdown
|
|
- [ ] Todas las versiones son consistentes (3.7.0)
|
|
|
|
### Impacto en Verticales
|
|
- [ ] Documentar que cambios aplican a: construccion, vidrio-templado, mecanicas-diesel, retail, clinicas
|
|
```
|
|
|
|
#### Comandos de Validación
|
|
|
|
```bash
|
|
# Verificar versión
|
|
grep -E "SIMCO v[0-9]" projects/erp-core/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar sección v3.7
|
|
grep -c "Directivas de Documentación (SIMCO v3.7)" projects/erp-core/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar nota de verticales
|
|
grep -c "IMPORTANTE para ERP Core" projects/erp-core/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar líneas
|
|
wc -l projects/erp-core/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
```
|
|
|
|
#### Aplicabilidad de Directivas para ERP-CORE
|
|
|
|
| Directiva | Aplica | Justificación |
|
|
|-----------|--------|---------------|
|
|
| @DOC_PROYECTO | SÍ | Estructura documentada |
|
|
| @NOMENCLATURA | SÍ | Prefijos MGN- en uso |
|
|
| @ESTRUCTURA_DOCS | SÍ | 881 archivos MD |
|
|
| @INVENTARIOS | SÍ | Inventarios YAML existentes |
|
|
| @TESTING | SÍ | Jest, cobertura 80% |
|
|
| @MIGRACIONES | SÍ | TypeORM migrations |
|
|
| @INTEGRACIONES | SÍ | Odoo connector |
|
|
|
|
#### Propagación a Verticales (Pendiente)
|
|
|
|
Las siguientes verticales heredan de ERP-Core y deben ser notificadas:
|
|
|
|
| Vertical | Acción Requerida |
|
|
|----------|------------------|
|
|
| construccion | Actualizar HERENCIA-SIMCO.md |
|
|
| vidrio-templado | Actualizar HERENCIA-SIMCO.md |
|
|
| mecanicas-diesel | Actualizar HERENCIA-SIMCO.md |
|
|
| retail | Actualizar HERENCIA-SIMCO.md |
|
|
| clinicas | Actualizar HERENCIA-SIMCO.md |
|
|
|
|
---
|
|
|
|
### 2.3 PROYECTO: MICHANGARRITO
|
|
|
|
**Archivo creado:** `projects/michangarrito/orchestration/00-guidelines/HERENCIA-SIMCO.md`
|
|
|
|
#### Tipo de Cambio: CREACIÓN NUEVA
|
|
|
|
Este proyecto NO tenía archivo HERENCIA-SIMCO.md. Se creó uno completo desde cero.
|
|
|
|
#### Estructura del Archivo Creado
|
|
|
|
```
|
|
# Herencia SIMCO - MiChangarrito
|
|
├── Configuración del Proyecto (tabla)
|
|
├── Jerarquía de Herencia (diagrama)
|
|
├── Directivas Heredadas de WORKSPACE
|
|
├── Directivas de Ciclo de Vida
|
|
├── Operaciones Universales
|
|
├── Principios Fundamentales (5)
|
|
├── Directivas por Dominio Técnico
|
|
├── Directivas de Documentación (SIMCO v3.7) ← NUEVA
|
|
├── Patrones Aplicables
|
|
├── Variables de Contexto CCA
|
|
├── Schemas de Base de Datos (9)
|
|
├── Integraciones Externas
|
|
├── Perfiles de Agentes
|
|
├── Flujo de Trabajo
|
|
└── Nomenclatura del Proyecto
|
|
```
|
|
|
|
#### Checklist de Validación para Agente MICHANGARRITO
|
|
|
|
```markdown
|
|
## Validación HERENCIA-SIMCO.md - MICHANGARRITO
|
|
|
|
### Existencia
|
|
- [ ] Archivo existe en: orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
- [ ] Archivo NO existía antes de 2026-01-10
|
|
|
|
### Metadata
|
|
- [ ] Sistema: SIMCO v3.7.0 + CAPVED + CCA Protocol + Estándares Documentación
|
|
- [ ] Código proyecto: MCH
|
|
- [ ] Nivel: STANDALONE (Nivel 2A)
|
|
- [ ] SIMCO Version: 3.7.0
|
|
|
|
### Contenido Específico del Proyecto
|
|
- [ ] Schemas de BD: 9 schemas listados
|
|
- [ ] Total tablas: 29
|
|
- [ ] Stack: NestJS, React Native (Expo), PostgreSQL
|
|
- [ ] Puertos documentados implícitamente via referencia a CONTEXTO-PROYECTO.md
|
|
|
|
### Integraciones Documentadas
|
|
- [ ] WhatsApp (Meta Business API) - Implementado
|
|
- [ ] Stripe - Implementado
|
|
- [ ] Mercado Pago - Pendiente
|
|
- [ ] Clip - Pendiente
|
|
- [ ] CoDi - Pendiente
|
|
- [ ] OpenRouter - Implementado
|
|
|
|
### Nomenclatura
|
|
- [ ] Prefijo: MCH-
|
|
- [ ] Formato épicas: MCH-E{NN}
|
|
- [ ] Formato RF: MCH-RF-{NNN}
|
|
- [ ] Formato ET: MCH-ET-{TIPO}-{NNN}
|
|
- [ ] Formato US: MCH-US-{NNN}
|
|
|
|
### Sección Directivas v3.7
|
|
- [ ] 7 directivas listadas
|
|
- [ ] 3 checklists listados
|
|
- [ ] 3 templates listados
|
|
|
|
### Consistencia
|
|
- [ ] Total líneas: ~289
|
|
- [ ] Todas las versiones = 3.7.0
|
|
```
|
|
|
|
#### Comandos de Validación
|
|
|
|
```bash
|
|
# Verificar existencia
|
|
ls -la projects/michangarrito/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar versión
|
|
grep -E "SIMCO v[0-9]" projects/michangarrito/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar código proyecto
|
|
grep "PROJECT_CODE:" projects/michangarrito/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar schemas
|
|
grep -c "Schema" projects/michangarrito/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar integraciones
|
|
grep -E "WhatsApp|Stripe|Mercado Pago|Clip|CoDi|OpenRouter" projects/michangarrito/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar líneas
|
|
wc -l projects/michangarrito/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
```
|
|
|
|
#### Aplicabilidad de Directivas para MICHANGARRITO
|
|
|
|
| Directiva | Aplica | Justificación |
|
|
|-----------|--------|---------------|
|
|
| @DOC_PROYECTO | SÍ | Estructura /docs existente |
|
|
| @NOMENCLATURA | SÍ | Prefijos MCH- definidos |
|
|
| @ESTRUCTURA_DOCS | SÍ | 93 archivos MD |
|
|
| @INVENTARIOS | SÍ | Inventarios en orchestration/inventarios |
|
|
| @TESTING | SÍ | Jest configurado |
|
|
| @MIGRACIONES | SÍ | DDL en database/schemas |
|
|
| @INTEGRACIONES | SÍ | 8+ integraciones externas |
|
|
|
|
---
|
|
|
|
### 2.4 PROYECTO: TEMPLATE-SAAS
|
|
|
|
**Archivo modificado:** `projects/template-saas/orchestration/00-guidelines/HERENCIA-SIMCO.md`
|
|
|
|
#### Cambios Implementados
|
|
|
|
| Campo | Valor Anterior | Valor Nuevo |
|
|
|-------|----------------|-------------|
|
|
| Version SIMCO | 3.4 | 3.7.0 |
|
|
| Última actualización | 2026-01-07 | 2026-01-10 |
|
|
|
|
#### Nueva Sección Agregada
|
|
|
|
Se agregó la sección **"Directivas de Documentación (SIMCO v3.7) - NUEVO"** después de "Directivas de Contexto".
|
|
|
|
Incluye nota especial:
|
|
```
|
|
**Nota:** Como proyecto TEMPLATE, estos estándares son obligatorios para proyectos derivados.
|
|
```
|
|
|
|
#### Checklist de Validación para Agente TEMPLATE-SAAS
|
|
|
|
```markdown
|
|
## Validación HERENCIA-SIMCO.md - TEMPLATE-SAAS
|
|
|
|
### Metadata
|
|
- [ ] Version SIMCO: 3.7.0
|
|
- [ ] Última actualización: 2026-01-10
|
|
- [ ] Tipo: STANDALONE
|
|
|
|
### Sección Directivas de Documentación
|
|
- [ ] Título incluye "- NUEVO" para identificar la sección agregada
|
|
- [ ] 7 directivas listadas
|
|
- [ ] @NOMENCLATURA menciona prefijo "SAAS-"
|
|
- [ ] 3 checklists listados
|
|
- [ ] 3 templates listados
|
|
- [ ] Nota sobre proyectos derivados presente
|
|
|
|
### Consistencia
|
|
- [ ] Total líneas: ~168
|
|
- [ ] Versión consistente en todo el archivo
|
|
|
|
### Rol como Template
|
|
- [ ] Documentar que nuevos proyectos SaaS deben heredar estas directivas
|
|
```
|
|
|
|
#### Comandos de Validación
|
|
|
|
```bash
|
|
# Verificar versión
|
|
grep -E "Version SIMCO|SIMCO v[0-9]" projects/template-saas/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar sección nueva
|
|
grep -c "SIMCO v3.7" projects/template-saas/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar nota de template
|
|
grep -c "proyecto TEMPLATE" projects/template-saas/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar actualización
|
|
grep "Actualizado:" projects/template-saas/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
|
|
# Verificar líneas
|
|
wc -l projects/template-saas/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
```
|
|
|
|
#### Aplicabilidad de Directivas para TEMPLATE-SAAS
|
|
|
|
| Directiva | Aplica | Justificación |
|
|
|-----------|--------|---------------|
|
|
| @DOC_PROYECTO | SÍ | Template de estructura |
|
|
| @NOMENCLATURA | SÍ | Prefijos SAAS- |
|
|
| @ESTRUCTURA_DOCS | SÍ | 34 archivos MD |
|
|
| @INVENTARIOS | SÍ | Templates de inventarios |
|
|
| @TESTING | SÍ | Configuración base |
|
|
| @MIGRACIONES | SÍ | Patrones de migración |
|
|
| @INTEGRACIONES | SÍ | Stripe, auth providers |
|
|
|
|
---
|
|
|
|
## PARTE 3: MATRIZ DE REFERENCIAS CRUZADAS
|
|
|
|
### 3.1 Directivas → Proyectos
|
|
|
|
| Directiva | gamilit | erp-core | michangarrito | template-saas |
|
|
|-----------|---------|----------|---------------|---------------|
|
|
| @DOC_PROYECTO | ✓ | ✓ | ✓ | ✓ |
|
|
| @NOMENCLATURA | ✓ | ✓ | ✓ | ✓ |
|
|
| @ESTRUCTURA_DOCS | ✓ | ✓ | ✓ | ✓ |
|
|
| @INVENTARIOS | ✓ | ✓ | ✓ | ✓ |
|
|
| @TESTING | ✓ | ✓ | ✓ | ✓ |
|
|
| @MIGRACIONES | ✓ | ✓ | ✓ | ✓ |
|
|
| @INTEGRACIONES | ✓ | ✓ | ✓ | ✓ |
|
|
|
|
### 3.2 Prefijos de Nomenclatura por Proyecto
|
|
|
|
| Proyecto | Prefijo Principal | Ejemplos |
|
|
|----------|-------------------|----------|
|
|
| gamilit | RF-, ET-, US- | RF-AUTH-001, ET-API-001, US-001 |
|
|
| erp-core | MGN- | MGN-001-auth, MGN-002-users |
|
|
| michangarrito | MCH- | MCH-E01, MCH-RF-001, MCH-US-001 |
|
|
| template-saas | SAAS- | SAAS-001-core, SAAS-ADR-001 |
|
|
|
|
### 3.3 Integraciones Externas por Proyecto
|
|
|
|
| Proyecto | Integraciones Principales |
|
|
|----------|---------------------------|
|
|
| gamilit | OAuth (Google, Facebook, Apple, GitHub), Email |
|
|
| erp-core | Odoo connector |
|
|
| michangarrito | WhatsApp, Stripe, Mercado Pago, Clip, CoDi, OpenRouter |
|
|
| template-saas | Stripe (billing), Auth providers |
|
|
|
|
---
|
|
|
|
## PARTE 4: INSTRUCCIONES PARA AGENTES
|
|
|
|
### 4.1 Flujo de Validación Recomendado
|
|
|
|
```
|
|
1. Leer este informe completo
|
|
2. Localizar la sección de tu proyecto (PARTE 2)
|
|
3. Ejecutar los comandos de validación
|
|
4. Completar el checklist de validación
|
|
5. Reportar cualquier discrepancia
|
|
6. Si todo está correcto, marcar como VALIDADO
|
|
```
|
|
|
|
### 4.2 Acciones Post-Validación
|
|
|
|
**Si la validación es exitosa:**
|
|
1. Documentar validación en el archivo de trazas del proyecto
|
|
2. Comenzar a usar las nuevas directivas según aplique
|
|
|
|
**Si se encuentran discrepancias:**
|
|
1. Documentar la discrepancia específica
|
|
2. Escalar al agente coordinador
|
|
3. No modificar archivos hasta recibir instrucciones
|
|
|
|
### 4.3 Uso de las Nuevas Directivas
|
|
|
|
Para usar una directiva en tu proyecto:
|
|
|
|
```yaml
|
|
# Referencia rápida
|
|
CARGAR_CONTEXTO:
|
|
- @DOC_PROYECTO # Antes de crear estructura de docs
|
|
- @NOMENCLATURA # Antes de nombrar nuevos archivos
|
|
- @ESTRUCTURA_DOCS # Antes de crear documentos markdown
|
|
- @INVENTARIOS # Antes de crear/modificar inventarios YAML
|
|
- @TESTING # Antes de configurar tests
|
|
- @MIGRACIONES # Antes de crear migraciones de BD
|
|
- @INTEGRACIONES # Antes de documentar integración externa
|
|
```
|
|
|
|
### 4.4 Uso de Checklists
|
|
|
|
```bash
|
|
# Para validar documentación de proyecto
|
|
@CHK_DOCUMENTACION → orchestration/checklists/CHECKLIST-DOCUMENTACION-PROYECTO.md
|
|
|
|
# Para validar inventarios
|
|
@CHK_INVENTARIOS → orchestration/checklists/CHECKLIST-INVENTARIOS.md
|
|
|
|
# Para validar nomenclatura
|
|
@CHK_NOMENCLATURA → orchestration/checklists/CHECKLIST-NOMENCLATURA.md
|
|
```
|
|
|
|
### 4.5 Uso de Templates
|
|
|
|
```bash
|
|
# Para crear nuevo inventario YAML
|
|
@TPL_INVENTARIO → orchestration/templates/TEMPLATE-INVENTARIO-PROYECTO.md
|
|
|
|
# Para documentar integración externa
|
|
@TPL_INTEGRACION → orchestration/templates/TEMPLATE-INTEGRACION-EXTERNA.md
|
|
|
|
# Para documentar módulo
|
|
@TPL_MODULO_ESTANDAR → orchestration/templates/TEMPLATE-MODULO-ESTANDAR.md
|
|
```
|
|
|
|
---
|
|
|
|
## PARTE 5: MÉTRICAS DE LA PROPAGACIÓN
|
|
|
|
### 5.1 Resumen Cuantitativo
|
|
|
|
| Métrica | Valor |
|
|
|---------|-------|
|
|
| Proyectos actualizados | 4 |
|
|
| Archivos creados (workspace) | 14 |
|
|
| Archivos modificados (proyectos) | 3 |
|
|
| Archivos creados (proyectos) | 1 |
|
|
| Total líneas generadas | 4,193 |
|
|
| Nuevos aliases disponibles | 15+ |
|
|
|
|
### 5.2 Cobertura de Estándares
|
|
|
|
| Estándar | Antes | Después |
|
|
|----------|-------|---------|
|
|
| Directivas SIMCO | 42 | 49 |
|
|
| Templates | 24 | 27 |
|
|
| Checklists | 5 | 8 |
|
|
| Proyectos con HERENCIA v3.7 | 0 | 4 |
|
|
|
|
---
|
|
|
|
## PARTE 6: ANEXOS
|
|
|
|
### Anexo A: Rutas Completas de Archivos
|
|
|
|
```
|
|
# Directivas SIMCO (workspace)
|
|
workspace-v1/orchestration/directivas/simco/SIMCO-DOCUMENTACION-PROYECTO.md
|
|
workspace-v1/orchestration/directivas/simco/SIMCO-NOMENCLATURA.md
|
|
workspace-v1/orchestration/directivas/simco/SIMCO-ESTRUCTURA-DOCS.md
|
|
workspace-v1/orchestration/directivas/simco/SIMCO-INVENTARIOS.md
|
|
workspace-v1/orchestration/directivas/simco/SIMCO-TESTING.md
|
|
workspace-v1/orchestration/directivas/simco/SIMCO-MIGRACIONES-BD.md
|
|
workspace-v1/orchestration/directivas/simco/SIMCO-INTEGRACIONES-EXTERNAS.md
|
|
|
|
# Templates (workspace)
|
|
workspace-v1/orchestration/templates/TEMPLATE-INVENTARIO-PROYECTO.md
|
|
workspace-v1/orchestration/templates/TEMPLATE-INTEGRACION-EXTERNA.md
|
|
workspace-v1/orchestration/templates/TEMPLATE-MODULO-ESTANDAR.md
|
|
|
|
# Checklists (workspace)
|
|
workspace-v1/orchestration/checklists/CHECKLIST-DOCUMENTACION-PROYECTO.md
|
|
workspace-v1/orchestration/checklists/CHECKLIST-INVENTARIOS.md
|
|
workspace-v1/orchestration/checklists/CHECKLIST-NOMENCLATURA.md
|
|
workspace-v1/orchestration/checklists/_MAP.md
|
|
|
|
# Índice (workspace)
|
|
workspace-v1/orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml
|
|
|
|
# HERENCIA-SIMCO.md (proyectos)
|
|
workspace-v1/projects/gamilit/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
workspace-v1/projects/erp-core/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
workspace-v1/projects/michangarrito/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
workspace-v1/projects/template-saas/orchestration/00-guidelines/HERENCIA-SIMCO.md
|
|
```
|
|
|
|
### Anexo B: Comando de Validación Global
|
|
|
|
```bash
|
|
#!/bin/bash
|
|
# Script de validación global
|
|
|
|
echo "=== VALIDACIÓN SIMCO v3.7.0 ==="
|
|
|
|
# 1. Verificar directivas
|
|
echo "1. Directivas SIMCO..."
|
|
for f in SIMCO-DOCUMENTACION-PROYECTO SIMCO-NOMENCLATURA SIMCO-ESTRUCTURA-DOCS SIMCO-INVENTARIOS SIMCO-TESTING SIMCO-MIGRACIONES-BD SIMCO-INTEGRACIONES-EXTERNAS; do
|
|
[ -f "orchestration/directivas/simco/${f}.md" ] && echo " OK: $f" || echo " ERROR: $f"
|
|
done
|
|
|
|
# 2. Verificar templates
|
|
echo "2. Templates..."
|
|
for f in TEMPLATE-INVENTARIO-PROYECTO TEMPLATE-INTEGRACION-EXTERNA TEMPLATE-MODULO-ESTANDAR; do
|
|
[ -f "orchestration/templates/${f}.md" ] && echo " OK: $f" || echo " ERROR: $f"
|
|
done
|
|
|
|
# 3. Verificar checklists
|
|
echo "3. Checklists..."
|
|
for f in CHECKLIST-DOCUMENTACION-PROYECTO CHECKLIST-INVENTARIOS CHECKLIST-NOMENCLATURA _MAP; do
|
|
[ -f "orchestration/checklists/${f}.md" ] && echo " OK: $f" || echo " ERROR: $f"
|
|
done
|
|
|
|
# 4. Verificar HERENCIA por proyecto
|
|
echo "4. HERENCIA-SIMCO.md por proyecto..."
|
|
for p in gamilit erp-core michangarrito template-saas; do
|
|
[ -f "projects/$p/orchestration/00-guidelines/HERENCIA-SIMCO.md" ] && echo " OK: $p" || echo " ERROR: $p"
|
|
done
|
|
|
|
# 5. Verificar versión del índice
|
|
echo "5. Versión del índice..."
|
|
grep -q 'version: "3.7.0"' orchestration/INDICE-DIRECTIVAS-WORKSPACE.yml && echo " OK: v3.7.0" || echo " ERROR: versión incorrecta"
|
|
|
|
echo "=== VALIDACIÓN COMPLETA ==="
|
|
```
|
|
|
|
---
|
|
|
|
## REGISTRO DE CAMBIOS
|
|
|
|
| Versión | Fecha | Descripción |
|
|
|---------|-------|-------------|
|
|
| 1.0.0 | 2026-01-10 | Creación inicial del informe |
|
|
|
|
---
|
|
|
|
**Generado:** 2026-01-10
|
|
**Autor:** Agente Coordinador - SIMCO
|
|
**Referencia:** VALIDACION-FINAL-ESTANDARIZACION-2026-01-10.md
|