michangarrito/orchestration/_archive/analisis/PLAN-REFINADO-ESTANDARIZACION-2026-01-10.md
Adrian Flores Cortes 2fb9f3f6b5
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
CI/CD Pipeline / Frontend CI (push) Waiting to run
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
CI/CD Pipeline / Mobile CI (push) Waiting to run
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
[ESTANDAR-ORCHESTRATION] refactor: Consolidate to standard structure
- Move 7 non-standard folders to _archive/
- Archive 3 extra root files
- Update _MAP.md with standardized structure

Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0
Level: CONSUMER (L2)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-24 14:38:04 -06:00

15 KiB

PLAN REFINADO DE ESTANDARIZACION DOCUMENTAL

Fecha: 2026-01-10 Fase: FASE 5 - Refinamiento Estado: LISTO PARA EJECUCION Version: 2.0.0 (Refinado) Referencia: VALIDACION-PLAN-ESTANDARIZACION-2026-01-10.md


1. RESUMEN DE CAMBIOS vs PLAN ORIGINAL

Aspecto Plan Original Plan Refinado
Orden de bloques A → B → C → D → E → F C.1 → A → C.2 → B → D → E → F
Verificacion previa No SI (C.1 primero)
Backup antes de sync No SI (recomendado)
Tareas totales 31 31 (sin cambios)

2. ORDEN REFINADO DE EJECUCION

╔═══════════════════════════════════════════════════════════════════╗
║                    ORDEN REFINADO DE EJECUCION                     ║
╠═══════════════════════════════════════════════════════════════════╣
║                                                                    ║
║  ┌─────────────────────────────────────────────────────────────┐  ║
║  │ FASE 6.1: BLOQUE C.1 - VERIFICACION (Ejecutar primero)      │  ║
║  │                                                              │  ║
║  │  C1: Verificar schemas BD (9 vs 12)                         │  ║
║  │  C2: Verificar tablas BD (29 vs 49)                         │  ║
║  │  C3: Verificar modulos backend (12 vs 18)                   │  ║
║  │                                                              │  ║
║  │  Resultado esperado: Datos reales confirmados               │  ║
║  └─────────────────────────────────────────────────────────────┘  ║
║                              │                                     ║
║                              ▼                                     ║
║  ┌─────────────────────────────────────────────────────────────┐  ║
║  │ FASE 6.2: BLOQUE A - ESTRUCTURA OBLIGATORIA                 │  ║
║  │                                                              │  ║
║  │  A1: Crear docs/README.md                                   │  ║
║  │  A2: Crear orchestration/README.md                          │  ║
║  │                                                              │  ║
║  │  Resultado esperado: 2 archivos nuevos                      │  ║
║  └─────────────────────────────────────────────────────────────┘  ║
║                              │                                     ║
║                              ▼                                     ║
║  ┌─────────────────────────────────────────────────────────────┐  ║
║  │ FASE 6.3: BLOQUE C.2 - SINCRONIZACION                       │  ║
║  │                                                              │  ║
║  │  C4: Sincronizar HERENCIA-SIMCO.md                          │  ║
║  │  C5: Sincronizar CONTEXTO-PROYECTO.md                       │  ║
║  │  C6: Sincronizar docs/_MAP.md                               │  ║
║  │  C7: Agregar changelog a MASTER_INVENTORY.yml               │  ║
║  │                                                              │  ║
║  │  Resultado esperado: Datos consistentes                     │  ║
║  └─────────────────────────────────────────────────────────────┘  ║
║                              │                                     ║
║                              ▼                                     ║
║  ┌─────────────────────────────────────────────────────────────┐  ║
║  │ FASE 6.4: BLOQUE B - INTEGRACIONES                          │  ║
║  │                                                              │  ║
║  │  B1: Crear docs/02-integraciones/                           │  ║
║  │  B2: INT-001-whatsapp-meta.md                               │  ║
║  │  B3: INT-002-stripe.md                                      │  ║
║  │  B4: INT-003-openrouter.md                                  │  ║
║  │  B5: INT-004-mercadopago.md                                 │  ║
║  │  B6: _MAP.md integraciones                                  │  ║
║  │                                                              │  ║
║  │  Resultado esperado: 5 archivos nuevos + directorio         │  ║
║  └─────────────────────────────────────────────────────────────┘  ║
║                              │                                     ║
║                              ▼                                     ║
║  ┌─────────────────────────────────────────────────────────────┐  ║
║  │ FASE 6.5: BLOQUE D - ADRs                                   │  ║
║  │                                                              │  ║
║  │  D1: Crear docs/97-adr/                                     │  ║
║  │  D2: ADR-0001-multi-tenant-architecture.md                  │  ║
║  │  D3: ADR-0002-whatsapp-first-approach.md                    │  ║
║  │  D4: ADR-0003-llm-agnostic-strategy.md                      │  ║
║  │  D5: _MAP.md ADRs                                           │  ║
║  │                                                              │  ║
║  │  Resultado esperado: 4 archivos nuevos + directorio         │  ║
║  └─────────────────────────────────────────────────────────────┘  ║
║                              │                                     ║
║                              ▼                                     ║
║  ┌─────────────────────────────────────────────────────────────┐  ║
║  │ FASE 6.6: BLOQUE E - FRONTMATTER (OPCIONAL)                 │  ║
║  │                                                              │  ║
║  │  E1-E3: Agregar frontmatter YAML a documentos existentes    │  ║
║  │                                                              │  ║
║  │  Resultado esperado: Metadatos estandarizados               │  ║
║  └─────────────────────────────────────────────────────────────┘  ║
║                              │                                     ║
║                              ▼                                     ║
║  ┌─────────────────────────────────────────────────────────────┐  ║
║  │ FASE 6.7: BLOQUE F - TESTING (OPCIONAL)                     │  ║
║  │                                                              │  ║
║  │  F1-F4: Ejecutar tests y documentar cobertura               │  ║
║  │                                                              │  ║
║  │  Resultado esperado: Cobertura reportada                    │  ║
║  └─────────────────────────────────────────────────────────────┘  ║
║                                                                    ║
╚═══════════════════════════════════════════════════════════════════╝

3. TAREAS DETALLADAS POR FASE

3.1 FASE 6.1: BLOQUE C.1 - Verificacion

ID Tarea Accion Resultado Esperado
C1 Verificar schemas BD Contar en DATABASE_INVENTORY.yml Numero real de schemas
C2 Verificar tablas BD Contar en DATABASE_INVENTORY.yml Numero real de tablas
C3 Verificar modulos backend Contar en BACKEND_INVENTORY.yml Numero real de modulos

3.2 FASE 6.2: BLOQUE A - Estructura Obligatoria

ID Archivo Contenido Clave
A1 docs/README.md Descripcion, estructura, navegacion, estado
A2 orchestration/README.md Proposito, estructura, guia agentes, SSOT

3.3 FASE 6.3: BLOQUE C.2 - Sincronizacion

ID Archivo Campos a Sincronizar
C4 HERENCIA-SIMCO.md schemas, tablas, modulos
C5 CONTEXTO-PROYECTO.md schemas, tablas, modulos
C6 docs/_MAP.md Estadisticas del proyecto
C7 MASTER_INVENTORY.yml Agregar seccion changelog

3.4 FASE 6.4: BLOQUE B - Integraciones

ID Archivo Integracion Estado
B1 docs/02-integraciones/ Directorio CREAR
B2 INT-001-whatsapp-meta.md WhatsApp Business API CREAR
B3 INT-002-stripe.md Stripe Payments CREAR
B4 INT-003-openrouter.md OpenRouter/LLM CREAR
B5 INT-004-mercadopago.md Mercado Pago CREAR
B6 _MAP.md Indice CREAR

3.5 FASE 6.5: BLOQUE D - ADRs

ID Archivo Titulo Contenido
D1 docs/97-adr/ Directorio CREAR
D2 ADR-0001-multi-tenant-architecture.md Arquitectura Multi-Tenant Decision de aislamiento por tenant_id
D3 ADR-0002-whatsapp-first-approach.md WhatsApp como Canal Principal Estrategia de interfaz
D4 ADR-0003-llm-agnostic-strategy.md LLM Agnostico OpenRouter/fallback strategy
D5 _MAP.md Indice CREAR

4. CRITERIOS DE ACEPTACION

4.1 Por Bloque

Bloque Criterio Metrica
C.1 Datos verificados 3/3 verificaciones
A Archivos creados 2/2 archivos
C.2 Datos sincronizados 0 discrepancias
B Integraciones documentadas 4/4 + _MAP
D ADRs creados 3/3 + _MAP
E Frontmatter agregado 100% archivos (opcional)
F Cobertura documentada % reportado (opcional)

4.2 Global

  • Conformidad SIMCO: >= 95%
  • Archivos nuevos: >= 11
  • Discrepancias: 0

5. ESTADO FINAL ESPERADO

╔════════════════════════════════════════════════════════════╗
║              ESTADO ESPERADO POST-EJECUCION                ║
╠════════════════════════════════════════════════════════════╣
║                                                            ║
║  ESTRUCTURA docs/                                          ║
║  ├── README.md .................... [NUEVO]                ║
║  ├── _MAP.md ...................... [ACTUALIZADO]          ║
║  ├── 00-vision-general/ ........... [SIN CAMBIOS]          ║
║  ├── 01-epicas/ ................... [SIN CAMBIOS]          ║
║  ├── 02-especificaciones/ ......... [SIN CAMBIOS]          ║
║  ├── 02-integraciones/ ............ [NUEVO]                ║
║  │   ├── _MAP.md                                           ║
║  │   ├── INT-001-whatsapp-meta.md                          ║
║  │   ├── INT-002-stripe.md                                 ║
║  │   ├── INT-003-openrouter.md                             ║
║  │   └── INT-004-mercadopago.md                            ║
║  ├── 90-transversal/ .............. [SIN CAMBIOS]          ║
║  └── 97-adr/ ...................... [NUEVO]                ║
║      ├── _MAP.md                                           ║
║      ├── ADR-0001-multi-tenant-architecture.md             ║
║      ├── ADR-0002-whatsapp-first-approach.md               ║
║      └── ADR-0003-llm-agnostic-strategy.md                 ║
║                                                            ║
║  ESTRUCTURA orchestration/                                 ║
║  ├── README.md .................... [NUEVO]                ║
║  ├── 00-guidelines/                                        ║
║  │   ├── CONTEXTO-PROYECTO.md ..... [ACTUALIZADO]          ║
║  │   └── HERENCIA-SIMCO.md ........ [ACTUALIZADO]          ║
║  ├── inventarios/                                          ║
║  │   └── MASTER_INVENTORY.yml ..... [ACTUALIZADO+CHANGELOG]║
║  └── analisis/ .................... [+4 archivos analisis] ║
║                                                            ║
║  TOTALES                                                   ║
║  ────────────────────────────                              ║
║  Archivos nuevos:         11                               ║
║  Archivos actualizados:    4                               ║
║  Directorios nuevos:       2                               ║
║                                                            ║
╚════════════════════════════════════════════════════════════╝

6. SIGUIENTE PASO

Proceder a FASE 6 - Ejecucion del Plan

Ejecutar bloques en orden refinado:

  1. C.1 → A → C.2 → B → D
  2. (Opcional) E → F

Ultima actualizacion: 2026-01-10 Version: 2.0.0 Estado: LISTO PARA EJECUCION