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:
- C.1 → A → C.2 → B → D
- (Opcional) E → F
Ultima actualizacion: 2026-01-10
Version: 2.0.0
Estado: LISTO PARA EJECUCION
rckrdmrd
928eb795e6