# 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