workspace-v1/orchestration/analisis/DEPENDENCIAS-ESTANDARIZACION-2026-01-10.md
rckrdmrd 3a8a459d91 [SIMCO-V38] feat: Implementar sistema SIMCO v3.8.0 completo
## 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>
2026-01-10 08:55:15 -06:00

14 KiB

ANALISIS DE DEPENDENCIAS - ESTANDARIZACION DOCUMENTACION WORKSPACE

Fecha: 2026-01-10 Fase: 4 - Analisis de Dependencias Estado: COMPLETADO Version: 1.0.0 Referencias:

  • PLAN-ESTANDARIZACION-DOCUMENTACION-WORKSPACE-2026-01-10.md
  • VALIDACION-PLAN-ESTANDARIZACION-2026-01-10.md

1. RESUMEN EJECUTIVO

Alcance del Sistema de Directivas

Metrica Valor
Directivas SIMCO existentes 42
Principios fundamentales 6
Perfiles de agentes 28
Templates 24
Proyectos con HERENCIA-SIMCO 19
Niveles jerarquicos 7
Archivos con referencias cruzadas 146+
Artefactos totales coordinados 413+

Impacto de Nuevas Directivas

Tipo de Cambio Archivos Afectados Prioridad
Agregar 7 directivas SIMCO 26+ archivos CRITICO
Agregar 5 templates 4+ archivos ALTO
Agregar 3 checklists 2+ archivos MEDIO
Actualizar indices 5 archivos CRITICO
Propagar a proyectos 19 instancias ALTO

2. ESTRUCTURA DE HERENCIA

2.1 Cascada de Herencia (4 Niveles)

NIVEL 0: workspace/orchestration/          <- SSOT ABSOLUTO
  |
  +-> NIVEL 1: core/orchestration/         <- Directivas Tecnicas Base
       |
       +-> NIVEL 2A: projects/{standalone}/orchestration/
       |
       +-> NIVEL 2B: projects/{suite}/orchestration/
            |
            +-> NIVEL 3: projects/{suite}/apps/{vertical}/orchestration/

2.2 Proyectos por Tipo

STANDALONE (5):

  • gamilit
  • trading-platform
  • betting-analytics
  • inmobiliaria-analytics
  • platform_marketing_content
  • template-saas

SUITE (1):

  • erp-suite

SUITE-CORE (1):

  • erp-core

VERTICALES (7):

  • construction
  • retail
  • vidrio-templado
  • mecanicas-diesel
  • clinicas (+ clinica-dental, clinica-veterinaria)
  • erp-basico
  • pos-micro

3. ARCHIVOS QUE REQUIEREN ACTUALIZACION

3.1 Tier 1 - SIEMPRE Actualizar

Archivo Ubicacion Proposito Accion
INDICE-DIRECTIVAS-WORKSPACE.yml /orchestration/ Registro maestro AGREGAR 7 entradas
orchestration/README.md /orchestration/ Vision general ACTUALIZAR
orchestration/_MAP.md /orchestration/ Mapa navegacion AGREGAR 15 entradas
orchestration/agents/ALIASES.yml /orchestration/agents/ Mapeo aliases AGREGAR 7 aliases

3.2 Tier 2 - Actualizar Templates

Archivo Ubicacion Accion
HERENCIA-SIMCO.md /orchestration/templates/ AGREGAR referencias
_MAP.md /orchestration/directivas/simco/ AGREGAR 7 directivas
_MAP.md /orchestration/templates/ AGREGAR 5 templates
_MAP.md /orchestration/checklists/ CREAR + 3 checklists

3.3 Tier 3 - Propagar a Proyectos (19 instancias)

Proyecto Archivo Estado Actual
gamilit HERENCIA-SIMCO.md EXISTE - Actualizar
erp-core HERENCIA-SIMCO.md EXISTE - Actualizar
template-saas HERENCIA-SIMCO.md EXISTE (minimo) - Expandir
michangarrito HERENCIA-SIMCO.md NO EXISTE - Crear
erp-suite HERENCIA-SIMCO.md EXISTE - Actualizar
erp-clinicas HERENCIA-SIMCO.md EXISTE - Actualizar
erp-construccion HERENCIA-SIMCO.md EXISTE - Actualizar
erp-mecanicas-diesel HERENCIA-SIMCO.md EXISTE - Actualizar
erp-retail HERENCIA-SIMCO.md EXISTE - Actualizar
erp-vidrio-templado HERENCIA-SIMCO.md EXISTE - Actualizar
betting-analytics HERENCIA-SIMCO.md EXISTE - Actualizar
trading-platform HERENCIA-SIMCO.md EXISTE - Actualizar
inmobiliaria-analytics HERENCIA-SIMCO.md EXISTE - Actualizar
platform_marketing_content HERENCIA-SIMCO.md EXISTE - Actualizar
erp-basico HERENCIA-SIMCO.md EXISTE - Actualizar
pos-micro HERENCIA-SIMCO.md EXISTE - Actualizar
clinica-dental HERENCIA-SIMCO.md IMPLICITO - via erp-clinicas
clinica-veterinaria HERENCIA-SIMCO.md IMPLICITO - via erp-clinicas

4. MAPA DE DEPENDENCIAS POR DIRECTIVA

4.1 A1: SIMCO-DOCUMENTACION-PROYECTO.md

SIMCO-DOCUMENTACION-PROYECTO.md
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> A2: SIMCO-NOMENCLATURA.md
    |   +-> A4: SIMCO-INVENTARIOS.md
    |   +-> B1: TEMPLATE-EPICA-ESTANDAR.md
    |   +-> B2: TEMPLATE-MODULO-ESTANDAR.md
    |   +-> C1: CHECKLIST-DOCUMENTACION-PROYECTO.md
    |
    +-> REFERENCIAS EN:
    |   +-> INDICE-DIRECTIVAS-WORKSPACE.yml
    |   +-> orchestration/agents/ALIASES.yml
    |   +-> orchestration/templates/HERENCIA-SIMCO.md
    |   +-> 19 instancias HERENCIA-SIMCO.md en proyectos
    |
    +-> PERFILES AFECTADOS:
        +-> PERFIL-DOCUMENTATION.md
        +-> PERFIL-ANALYST.md

4.2 A2: SIMCO-NOMENCLATURA.md

SIMCO-NOMENCLATURA.md
    |
    +-> DEPENDE DE:
    |   +-> A1: SIMCO-DOCUMENTACION-PROYECTO.md
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> A3: SIMCO-ESTRUCTURA-DOCS.md
    |   +-> B3: TEMPLATE-MAP-INDICE.md
    |   +-> C3: CHECKLIST-NOMENCLATURA.md
    |
    +-> REFERENCIAS EN:
        +-> Todos los archivos _MAP.md del workspace
        +-> Todos los documentos PLAN-*.md, ANALISIS-*.md

4.3 A3: SIMCO-ESTRUCTURA-DOCS.md

SIMCO-ESTRUCTURA-DOCS.md
    |
    +-> DEPENDE DE:
    |   +-> A1: SIMCO-DOCUMENTACION-PROYECTO.md
    |   +-> A2: SIMCO-NOMENCLATURA.md
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> B1: TEMPLATE-EPICA-ESTANDAR.md
    |   +-> B2: TEMPLATE-MODULO-ESTANDAR.md
    |   +-> C1: CHECKLIST-DOCUMENTACION-PROYECTO.md
    |
    +-> IMPACTO GLOBAL:
        +-> Todos los documentos MD del workspace
        +-> Estructura de frontmatter YAML

4.4 A4: SIMCO-INVENTARIOS.md

SIMCO-INVENTARIOS.md
    |
    +-> DEPENDE DE:
    |   +-> A1: SIMCO-DOCUMENTACION-PROYECTO.md
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> B4: TEMPLATE-INVENTARIO-PROYECTO.md
    |   +-> C2: CHECKLIST-INVENTARIOS.md
    |
    +-> IMPACTO EN:
        +-> MASTER_INVENTORY.yml (19+ archivos)
        +-> DATABASE_INVENTORY.yml (4+ archivos)
        +-> BACKEND_INVENTORY.yml (4+ archivos)
        +-> FRONTEND_INVENTORY.yml (4+ archivos)

4.5 A5: SIMCO-TESTING.md

SIMCO-TESTING.md
    |
    +-> DEPENDE DE:
    |   +-> Ninguna directiva nueva
    |   +-> SIMCO-BACKEND.md (existente)
    |   +-> SIMCO-FRONTEND.md (existente)
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> Ninguno directo
    |
    +-> IMPACTO EN:
        +-> CI/CD pipelines de todos los proyectos
        +-> package.json scripts de testing
        +-> Configuracion pytest/jest

4.6 A6: SIMCO-MIGRACIONES-BD.md

SIMCO-MIGRACIONES-BD.md
    |
    +-> DEPENDE DE:
    |   +-> SIMCO-DDL.md (existente)
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> Ninguno nuevo
    |
    +-> IMPACTO EN:
        +-> scripts de migracion en todos los proyectos
        +-> Estructura de apps/database/
        +-> Procesos de deployment

4.7 A7: SIMCO-INTEGRACIONES-EXTERNAS.md

SIMCO-INTEGRACIONES-EXTERNAS.md
    |
    +-> DEPENDE DE:
    |   +-> Ninguna directiva nueva
    |
    +-> DEPENDIENTES DIRECTOS:
    |   +-> B5: TEMPLATE-INTEGRACION-EXTERNA.md
    |
    +-> IMPACTO EN:
        +-> Documentacion de APIs externas
        +-> Variables de entorno
        +-> Manejo de credenciales

5. ORDEN DE CREACION BASADO EN DEPENDENCIAS

Nivel 0 - Sin Dependencias (Paralelo)

ID Directiva Puede empezar
A1 SIMCO-DOCUMENTACION-PROYECTO.md Inmediato
A5 SIMCO-TESTING.md Inmediato
A7 SIMCO-INTEGRACIONES-EXTERNAS.md Inmediato

Nivel 1 - Depende de Nivel 0

ID Directiva Requiere
A2 SIMCO-NOMENCLATURA.md A1 completado
A4 SIMCO-INVENTARIOS.md A1 completado
A6 SIMCO-MIGRACIONES-BD.md SIMCO-DDL existente
B5 TEMPLATE-INTEGRACION-EXTERNA.md A7 completado

Nivel 2 - Depende de Nivel 1

ID Archivo Requiere
A3 SIMCO-ESTRUCTURA-DOCS.md A1, A2 completados
B3 TEMPLATE-MAP-INDICE.md A2 completado
B4 TEMPLATE-INVENTARIO-PROYECTO.md A4 completado
C2 CHECKLIST-INVENTARIOS.md A4 completado
C3 CHECKLIST-NOMENCLATURA.md A2 completado

Nivel 3 - Depende de Nivel 2

ID Archivo Requiere
B1 TEMPLATE-EPICA-ESTANDAR.md A3 completado
B2 TEMPLATE-MODULO-ESTANDAR.md A3 completado
C1 CHECKLIST-DOCUMENTACION-PROYECTO.md A1, A2, A3 completados

Nivel 4 - Indices (Despues de todo lo anterior)

ID Archivo Requiere
D1 INDICE-DIRECTIVAS-WORKSPACE.yml A1-A7, B1-B5, C1-C3
D2 orchestration/directivas/simco/_MAP.md A1-A7
D3 orchestration/templates/_MAP.md B1-B5
D4 orchestration/checklists/_MAP.md C1-C3
D5 shared/knowledge-base/standards/ Todos anteriores

Nivel 5 - Propagacion a Proyectos

ID Archivo Requiere
E1 gamilit/HERENCIA-SIMCO.md D1-D5
E2 erp-core/HERENCIA-SIMCO.md D1-D5
E3 michangarrito/HERENCIA-SIMCO.md D1-D5 (CREAR)
E4 template-saas/HERENCIA-SIMCO.md D1-D5
E5-E19 Demas proyectos D1-D5

6. ARCHIVOS EXISTENTES QUE REFERENCIAN DIRECTIVAS

6.1 Archivos con Referencias Explicitas a SIMCO

Tipo Patron Cantidad Ubicacion
Planes PLAN-*.md 60+ orchestration/analisis/
Analisis ANALISIS-*.md 50+ orchestration/analisis/
Trazas TRAZA-*.md 20+ orchestration/trazas/
Contexto CONTEXTO-PROYECTO.md 19 projects/*/orchestration/
Herencia HERENCIA-*.md 50+ projects/*/orchestration/

6.2 Archivos de Configuracion

Archivo Ubicacion Referencias SIMCO
CONTEXT-MAP.yml projects/*/orchestration/ 5+
PROJECT-STATUS.md projects/*/orchestration/ 19
PROXIMA-ACCION.md projects/*/orchestration/ 10+

7. IMPACTO EN PERFILES DE AGENTES

7.1 Perfiles a Actualizar

Perfil Directivas Nuevas Relevantes Accion
PERFIL-DOCUMENTATION.md A1, A2, A3 AGREGAR referencias
PERFIL-ANALYST.md A1, A2, C1, C3 AGREGAR referencias
PERFIL-BACKEND.md A5, A6 AGREGAR referencias
PERFIL-DATABASE.md A6 AGREGAR referencias
PERFIL-FRONTEND.md A5 AGREGAR referencias
PERFIL-DEVOPS.md A5, A6 AGREGAR referencias
PERFIL-QA.md A5, C1, C2, C3 AGREGAR referencias

7.2 Nuevos Aliases Requeridos

# Agregar a orchestration/agents/ALIASES.yml

@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

8. RIESGOS Y MITIGACIONES

8.1 Riesgos Identificados

Riesgo Probabilidad Impacto Mitigacion
Inconsistencia en propagacion MEDIA ALTO Usar checklist de propagacion
Conflicto con directivas existentes BAJA MEDIO Validacion previa completada
Olvidar actualizar algun proyecto MEDIA ALTO Automatizar via script
Romper herencia existente BAJA ALTO No modificar estructura, solo agregar

8.2 Dependencias Criticas

Dependencia Tipo Validacion
SIMCO-DDL.md Existente OK - referenciada por A6
SIMCO-BACKEND.md Existente OK - referenciada por A5
SIMCO-FRONTEND.md Existente OK - referenciada por A5
Estructura /orchestration Existente OK - no se modifica

9. PROCEDIMIENTO DE ACTUALIZACION

9.1 Para Cada Nueva Directiva

1. Crear archivo en /orchestration/directivas/simco/SIMCO-{NAME}.md

2. Agregar a INDICE-DIRECTIVAS-WORKSPACE.yml:
   - Entrada en seccion apropiada
   - Actualizar version
   - Agregar a changelog

3. Agregar alias en orchestration/agents/ALIASES.yml

4. Actualizar orchestration/templates/HERENCIA-SIMCO.md

5. Actualizar orchestration/directivas/simco/_MAP.md

6. Si afecta dominio especifico: actualizar PERFIL-{domain}.md

7. Propagar a 19 instancias de HERENCIA-SIMCO.md en proyectos

9.2 Verificacion Post-Actualizacion

- [ ] INDICE-DIRECTIVAS-WORKSPACE.yml version incrementada
- [ ] Alias resuelve correctamente
- [ ] Template HERENCIA-SIMCO.md tiene referencia
- [ ] _MAP.md de directivas actualizado
- [ ] Proyectos criticos (gamilit, erp-core) actualizados
- [ ] Build/lint pasa en proyectos afectados

10. RESUMEN DE ARCHIVOS A MODIFICAR/CREAR

Crear (20 archivos)

Bloque Archivos Ubicacion
A 7 directivas /orchestration/directivas/simco/
B 5 templates /orchestration/templates/
C 3 checklists /orchestration/checklists/
D 1 _MAP.md /orchestration/checklists/

Modificar (30+ archivos)

Archivo Ubicacion Tipo Cambio
INDICE-DIRECTIVAS-WORKSPACE.yml /orchestration/ Agregar entradas
ALIASES.yml /orchestration/agents/ Agregar 7 aliases
HERENCIA-SIMCO.md /orchestration/templates/ Agregar referencias
_MAP.md /orchestration/directivas/simco/ Agregar 7 entradas
_MAP.md /orchestration/templates/ Agregar 5 entradas
orchestration/README.md /orchestration/ Actualizar overview
7 PERFIL-*.md /orchestration/agents/perfiles/ Agregar referencias
19 HERENCIA-SIMCO.md /projects/*/orchestration/ Propagar

Documento generado: 2026-01-10 Resultado: DEPENDENCIAS MAPEADAS Siguiente fase: REFINAMIENTO DEL PLAN