rckrdmrd
928eb795e6
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Cambios en backend y frontend Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
240 lines
15 KiB
Markdown
240 lines
15 KiB
Markdown
# 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
|