# PLAN MAESTRO - Reestructuracion Documental Completa

**Proyecto:** MiChangarrito
**Codigo:** MCH
**Fecha:** 2026-01-10
**Version:** 1.0.0
**Estado:** EN PLANIFICACION
**Orquestador:** Claude Opus 4.5
**Perfil:** PERFIL-ORQUESTADOR + PERFIL-DOCUMENTATION-VALIDATOR

---

## RESUMEN EJECUTIVO

### Contexto

El proyecto MiChangarrito ha evolucionado significativamente durante el desarrollo (95% MVP completado), generando discrepancias entre la documentacion y el desarrollo real. Se requiere una reestructuracion completa para:

1. **Purgar** documentacion desactualizada y duplicada
2. **Homologar** definiciones con el desarrollo actual
3. **Integrar** todas las dependencias y relaciones
4. **Detectar** y eliminar duplicidades
5. **Mantener** un historico resumido de la progresion

### Hallazgos Clave (Analisis Previo)

| Metrica | Valor | Severidad |
|---------|-------|-----------|
| Discrepancias criticas | 12 | ALTA |
| Archivos con duplicados | 4 | MEDIA |
| Archivos obsoletos | 5 | MEDIA |
| Contenido duplicado total | 41% | ALTA |
| Schemas BD no documentados | 2 | CRITICA |
| Modulos Backend no documentados | 8 | CRITICA |
| Epicas implementadas marcadas pendientes | 5 | ALTA |

---

## ESTRUCTURA DEL PLAN

```
FASE 0: Preparacion y Segmentacion de Tareas
    |
    v
FASE 1: Analisis y Planeacion Inicial (por funcionalidad)
    |
    v
FASE 2: Analisis Detallado (por funcionalidad)
    |
    v
FASE 3: Planeacion basada en Analisis Detallado
    |
    v
FASE 4: Validacion de Planeacion + Analisis de Dependencias
    |
    v
FASE 5: Refinamiento del Plan
    |
    v
FASE 6: Ejecucion del Plan
    |
    v
FASE 7: Validacion de la Ejecucion
```

---

## SEGMENTACION POR FUNCIONALIDAD

### F-001: ARQUITECTURA Y ESPECIFICACIONES TECNICAS

**Objetivo:** Consolidar toda la documentacion de arquitectura en fuentes unicas canonicas.

**Archivos Involucrados:**
- docs/00-vision-general/ARQUITECTURA-TECNICA.md
- docs/02-especificaciones/ARQUITECTURA-DATABASE.md
- docs/02-especificaciones/ESPECIFICACION-COMPONENTES.md
- docs/02-especificaciones/INTEGRACIONES-EXTERNAS.md
- docs/90-transversal/ARQUITECTURA-MULTI-TENANT-INTEGRACIONES.md

**Problemas Detectados:**
1. ARQUITECTURA-TECNICA indica 8 schemas, pero son 9
2. Tabla de servicios WhatsApp tiene nombres inconsistentes
3. Almacenamiento de credenciales no documentado claramente
4. Schemas billing y marketplace NO documentados

**Dependencias:**
- Requiere validacion contra codigo real (database/schemas/*.sql)
- Requiere validacion contra backend (apps/backend/src/modules/)

---

### F-002: BASE DE DATOS - SCHEMAS Y TABLAS

**Objetivo:** Documentar completamente todos los schemas, tablas, funciones y triggers.

**Archivos Involucrados:**
- docs/02-especificaciones/ARQUITECTURA-DATABASE.md
- database/schemas/*.sql (referencia)
- orchestration/inventarios/DATABASE_INVENTORY.yml

**Problemas Detectados:**

#### Schemas NO Documentados (2):
| Schema | Tablas | Ubicacion SQL |
|--------|--------|---------------|
| billing | 5 | 15-invoices.sql |
| marketplace | 6 | 16-marketplace.sql |

#### Tablas NO Documentadas (20):
| Schema | Tabla | Archivo SQL |
|--------|-------|-------------|
| public | tenant_integration_credentials | 12-integrations.sql |
| public | tenant_whatsapp_numbers | 12-integrations.sql |
| sales | virtual_accounts | 14-codi-spei.sql |
| sales | codi_transactions | 14-codi-spei.sql |
| sales | spei_transactions | 14-codi-spei.sql |
| sales | payment_config | 14-codi-spei.sql |
| subscriptions | referral_codes | 13-referrals.sql |
| subscriptions | referrals | 13-referrals.sql |
| subscriptions | referral_rewards | 13-referrals.sql |
| billing | tax_configs | 15-invoices.sql |
| billing | invoices | 15-invoices.sql |
| billing | invoice_items | 15-invoices.sql |
| billing | invoice_item_taxes | 15-invoices.sql |
| billing | invoice_history | 15-invoices.sql |
| marketplace | suppliers | 16-marketplace.sql |
| marketplace | supplier_products | 16-marketplace.sql |
| marketplace | supplier_orders | 16-marketplace.sql |
| marketplace | supplier_order_items | 16-marketplace.sql |
| marketplace | supplier_reviews | 16-marketplace.sql |
| marketplace | supplier_favorites | 16-marketplace.sql |

#### Funciones NO Documentadas (10):
| Funcion | Schema | Archivo SQL |
|---------|--------|-------------|
| generate_referral_code() | subscriptions | 13-referrals.sql |
| get_referral_stats() | subscriptions | 13-referrals.sql |
| generate_codi_reference() | sales | 14-codi-spei.sql |
| get_codi_spei_summary() | sales | 14-codi-spei.sql |
| get_next_invoice_folio() | billing | 15-invoices.sql |
| get_invoice_summary() | billing | 15-invoices.sql |
| update_supplier_rating() | marketplace | 16-marketplace.sql |
| update_supplier_orders_count() | marketplace | 16-marketplace.sql |
| find_suppliers_by_zone() | marketplace | 16-marketplace.sql |
| get_marketplace_stats() | marketplace | 16-marketplace.sql |

**Dependencias:**
- F-001 (Arquitectura) debe estar validada primero
- Afecta F-003 (Backend) - endpoints relacionados

---

### F-003: BACKEND - MODULOS Y ENDPOINTS

**Objetivo:** Documentar todos los modulos, controllers, services y endpoints.

**Archivos Involucrados:**
- docs/02-especificaciones/ESPECIFICACION-COMPONENTES.md
- orchestration/inventarios/BACKEND_INVENTORY.yml
- apps/backend/src/modules/* (referencia)

**Problemas Detectados:**

#### Modulos NO Documentados (8):
| Modulo | Controller | Endpoints |
|--------|------------|-----------|
| CategoriesModule | categories.controller.ts | 6 |
| PaymentsModule | payments.controller.ts | 5 |
| BillingModule | billing.controller.ts | 8 |
| IntegrationsModule | integrations.controller.ts | 10 |
| ReferralsModule | referrals.controller.ts | 9 |
| CodiSpeiModule | codi-spei.controller.ts | 9 |
| WidgetsModule | widgets.controller.ts | 4 |
| MarketplaceModule | marketplace.controller.ts | 13 |
| InvoicesModule | invoices.controller.ts | 9 |

#### Total Endpoints NO Documentados: ~70

**Dependencias:**
- Requiere F-002 (Database) para entidades
- Afecta F-004 (Frontend) - servicios API

---

### F-004: FRONTEND - PAGINAS Y COMPONENTES

**Objetivo:** Documentar todas las paginas, componentes y servicios API.

**Archivos Involucrados:**
- docs/02-especificaciones/ESPECIFICACION-COMPONENTES.md
- orchestration/inventarios/FRONTEND_INVENTORY.yml
- apps/frontend/src/* (referencia)

**Problemas Detectados:**

#### Paginas NO Documentadas (4):
| Pagina | Ruta | Componente |
|--------|------|------------|
| Login | /login | Login.tsx |
| Register | /register | Register.tsx |
| Invoices | /invoices | Invoices.tsx |
| Marketplace | /marketplace | Marketplace.tsx |
| Referrals | /referrals | Referrals.tsx |

#### Componentes Adicionales NO Documentados:
- Layout.tsx
- ClabeDisplay.tsx (payments)
- CodiQR.tsx (payments)
- TaxConfigModal
- NewInvoiceModal
- SupplierCard
- CartModal

#### Servicios API NO Documentados:
- referralsApi (10 metodos)
- codiSpeiApi (8 metodos)
- invoicesApi (10 metodos)
- marketplaceApi (15 metodos)

**Dependencias:**
- Requiere F-003 (Backend) para endpoints

---

### F-005: INTEGRACIONES EXTERNAS

**Objetivo:** Documentar todas las integraciones con servicios externos.

**Archivos Involucrados:**
- docs/02-especificaciones/INTEGRACIONES-EXTERNAS.md
- docs/90-transversal/ARQUITECTURA-MULTI-TENANT-INTEGRACIONES.md

**Problemas Detectados:**

#### Integraciones NO Documentadas:
| Integracion | Estado | Tipo |
|-------------|--------|------|
| SPEI | Implementado | Pagos |
| SAT/CFDI | Implementado | Facturacion |

#### Integraciones INCOMPLETAS:
| Integracion | Faltante |
|-------------|----------|
| LLM/OpenRouter | Azure OpenAI, Ollama, Multi-tenant |
| CoDi | virtual_accounts, webhooks SPEI |

**Dependencias:**
- Afecta F-002 (Database) - tablas de integracion
- Afecta F-003 (Backend) - modulos de integracion

---

### F-006: EPICAS Y PLANEACION

**Objetivo:** Sincronizar estado de epicas con el desarrollo real.

**Archivos Involucrados:**
- docs/01-epicas/*.md (28 archivos)
- docs/01-epicas/_MAP.md
- docs/_MAP.md
- orchestration/PLAN-IMPLEMENTACION.md
- orchestration/CONTEXT-MAP.yml

**Problemas Detectados:**

#### Epicas Implementadas pero Marcadas Pendientes (5):
| Epica | Nombre | Estado Doc | Estado Real |
|-------|--------|------------|-------------|
| MCH-023 | Programa Referidos | Pendiente | Implementado |
| MCH-024 | CoDi/SPEI | Pendiente | Implementado |
| MCH-025 | Widgets Atajos | Pendiente | Implementado |
| MCH-027 | Integracion SAT | Pendiente | Implementado |
| MCH-028 | Marketplace Proveedores | Pendiente | Implementado |

#### Discrepancias en CONTEXT-MAP.yml:
- IDs de epicas desplazados a partir de MCH-012
- 7 epicas faltan completamente (MCH-022 a MCH-028)

**Dependencias:**
- Depende de F-001 a F-005 para validar implementacion real

---

### F-007: INDICES Y MAPAS DE NAVEGACION

**Objetivo:** Actualizar todos los indices y mapas para reflejar estructura real.

**Archivos Involucrados:**
- docs/_MAP.md
- docs/01-epicas/_MAP.md
- docs/02-especificaciones/_MAP.md
- orchestration/CONTEXT-MAP.yml
- docs/INDICE-ARQUITECTURA.md

**Problemas Detectados:**

#### En docs/02-especificaciones/_MAP.md:
- 5 archivos listados que NO EXISTEN
- 5 archivos reales que NO estan listados

| Listado (NO Existe) | Real (NO Listado) |
|--------------------|-------------------|
| CATALOGO-PRODUCTOS.md | ARQUITECTURA-DATABASE.md |
| TEMPLATE-PRODUCTOS.md | ESPECIFICACION-COMPONENTES.md |
| POS-BASICO.md | INTEGRACIONES-EXTERNAS.md |
| VENTAS-DIARIAS.md | INVESTIGACION-REFERENCIAS.md |
| CALCULADORA-CAMBIO.md | PLAN-DESARROLLO.md |

**Dependencias:**
- Depende de todas las funcionalidades anteriores

---

### F-008: ARCHIVOS OBSOLETOS Y DUPLICADOS

**Objetivo:** Archivar documentacion obsoleta y eliminar duplicados.

**Archivos a ARCHIVAR (5):
| Archivo | Destino |
|---------|---------|
| ANALISIS-FASE1-2026-01-06.md | historico/ |
| DEPENDENCIAS-ARCHIVOS-2026-01-06.md | historico/ |
| PLAN-FASE2-DETALLADO-2026-01-06.md | historico/ |
| PLAN-REFINADO-FINAL-2026-01-06.md | historico/ |
| VALIDACION-PLAN-VS-ANALISIS-2026-01-06.md | historico/ |

**Archivos a ELIMINAR (tras fusion):
| Archivo | Razon |
|---------|-------|
| (ninguno pendiente - ya se fusionaron anteriormente) | - |

**Dependencias:**
- Ninguna - puede ejecutarse en paralelo

---

### F-009: DOCUMENTACION FALTANTE

**Objetivo:** Crear documentacion critica que no existe.

**Documentos a CREAR:**
| Documento | Contenido | Prioridad |
|-----------|-----------|-----------|
| CALCULADORA-CAMBIO.md | Logica de cambio, denominaciones MX | CRITICA |

**Dependencias:**
- Ninguna

---

## FASES DETALLADAS

---

## FASE 0: PREPARACION Y SEGMENTACION

### Objetivo
Preparar el ambiente y segmentar todas las tareas.

### Tareas

| ID | Tarea | Subagente | Estado |
|----|-------|-----------|--------|
| P-001 | Crear estructura de carpetas para backup | Bash | Pendiente |
| P-002 | Crear backup de documentacion actual | Bash | Pendiente |
| P-003 | Validar que carpeta historico/ existe | Bash | Pendiente |
| P-004 | Crear este Plan Maestro | Orquestador | Completado |

### Criterios de Exito
- [ ] Backup creado en orchestration/backup-reestructuracion/
- [ ] Carpeta historico/ verificada
- [ ] Plan Maestro creado y validado

---

## FASE 1: ANALISIS Y PLANEACION INICIAL (Por Funcionalidad)

### Objetivo
Realizar analisis inicial de cada funcionalidad para identificar alcance.

### Tareas por Funcionalidad

#### F-001: Arquitectura
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-001 | Leer ARQUITECTURA-TECNICA.md completo | Explore |
| A1-002 | Comparar schemas documentados vs database/schemas/*.sql | Explore |
| A1-003 | Identificar discrepancias de servicios | Explore |
| A1-004 | Documentar hallazgos | Documentation |

#### F-002: Base de Datos
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-005 | Leer todos los archivos SQL en database/schemas/ | Explore |
| A1-006 | Comparar con ARQUITECTURA-DATABASE.md | Explore |
| A1-007 | Listar tablas, funciones y triggers faltantes | Explore |
| A1-008 | Documentar hallazgos | Documentation |

#### F-003: Backend
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-009 | Listar todos los modulos en apps/backend/src/modules/ | Explore |
| A1-010 | Comparar con ESPECIFICACION-COMPONENTES.md | Explore |
| A1-011 | Identificar endpoints no documentados | Explore |
| A1-012 | Documentar hallazgos | Documentation |

#### F-004: Frontend
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-013 | Listar todas las paginas en apps/frontend/src/pages/ | Explore |
| A1-014 | Comparar con documentacion | Explore |
| A1-015 | Identificar componentes y servicios faltantes | Explore |
| A1-016 | Documentar hallazgos | Documentation |

#### F-005: Integraciones
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-017 | Leer INTEGRACIONES-EXTERNAS.md | Explore |
| A1-018 | Buscar integraciones en codigo backend | Explore |
| A1-019 | Identificar integraciones no documentadas | Explore |
| A1-020 | Documentar hallazgos | Documentation |

#### F-006: Epicas
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-021 | Leer todas las epicas en docs/01-epicas/ | Explore |
| A1-022 | Comparar estados con codigo real | Explore |
| A1-023 | Identificar epicas desactualizadas | Explore |
| A1-024 | Documentar hallazgos | Documentation |

#### F-007: Indices
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-025 | Leer todos los archivos _MAP.md | Explore |
| A1-026 | Verificar que archivos listados existan | Explore |
| A1-027 | Verificar que archivos reales esten listados | Explore |
| A1-028 | Documentar hallazgos | Documentation |

#### F-008: Obsoletos
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-029 | Identificar archivos en orchestration/analisis/ | Explore |
| A1-030 | Clasificar por vigencia (vigente/obsoleto) | Requirements-Analyst |
| A1-031 | Documentar archivos a archivar | Documentation |

#### F-009: Faltantes
| ID | Tarea | Subagente |
|----|-------|-----------|
| A1-032 | Verificar documentos criticos faltantes | Explore |
| A1-033 | Definir contenido minimo requerido | Requirements-Analyst |
| A1-034 | Documentar especificacion | Documentation |

### Entregable
- ANALISIS-INICIAL-F001-ARQUITECTURA.md
- ANALISIS-INICIAL-F002-DATABASE.md
- ANALISIS-INICIAL-F003-BACKEND.md
- ANALISIS-INICIAL-F004-FRONTEND.md
- ANALISIS-INICIAL-F005-INTEGRACIONES.md
- ANALISIS-INICIAL-F006-EPICAS.md
- ANALISIS-INICIAL-F007-INDICES.md
- ANALISIS-INICIAL-F008-OBSOLETOS.md
- ANALISIS-INICIAL-F009-FALTANTES.md

---

## FASE 2: ANALISIS DETALLADO (Por Funcionalidad)

### Objetivo
Profundizar en cada funcionalidad identificando exactamente que cambios se requieren.

### Tareas por Funcionalidad

#### F-001: Arquitectura
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-001 | Comparar linea por linea ARQUITECTURA-TECNICA vs codigo | Cada seccion |
| A2-002 | Documentar cada discrepancia con ubicacion exacta | Lineas afectadas |
| A2-003 | Proponer correccion para cada discrepancia | Contenido nuevo |
| A2-004 | Validar que correccion sea correcta | Contra codigo |

#### F-002: Base de Datos
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-005 | Leer cada archivo SQL y extraer estructura | CREATE TABLE, FUNCTION, TRIGGER |
| A2-006 | Comparar con cada seccion de ARQUITECTURA-DATABASE.md | Tabla por tabla |
| A2-007 | Documentar exactamente que falta | DDL exacto |
| A2-008 | Proponer formato de documentacion | Siguiendo patron existente |

#### F-003: Backend
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-009 | Analizar cada modulo no documentado | Estructura completa |
| A2-010 | Extraer endpoints de cada controller | Metodo, ruta, descripcion |
| A2-011 | Analizar DTOs y validaciones | Campos requeridos |
| A2-012 | Proponer documentacion siguiendo patron existente | Formato actual |

#### F-004: Frontend
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-013 | Analizar cada pagina no documentada | Componentes, rutas |
| A2-014 | Analizar servicios API | Metodos, endpoints |
| A2-015 | Documentar flujos de datos | Context, State |
| A2-016 | Proponer documentacion | Formato actual |

#### F-005: Integraciones
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-017 | Analizar SPEI - codigo completo | Endpoints, webhooks |
| A2-018 | Analizar SAT/CFDI - codigo completo | Timbrado, cancelacion |
| A2-019 | Completar LLM multi-tenant | Providers, configuracion |
| A2-020 | Proponer documentacion completa | Formato actual |

#### F-006: Epicas
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-021 | Validar cada epica MCH-023 a MCH-028 | Contra codigo |
| A2-022 | Documentar estado real de implementacion | Porcentaje, modulos |
| A2-023 | Proponer actualizacion de estado | Completado/Parcial |
| A2-024 | Corregir CONTEXT-MAP.yml | IDs correctos |

#### F-007: Indices
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-025 | Generar lista completa de archivos reales | Por carpeta |
| A2-026 | Comparar con cada _MAP.md | Diferencias exactas |
| A2-027 | Proponer contenido correcto | Actualizado |

#### F-008: Obsoletos
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-028 | Revisar contenido de cada archivo obsoleto | Algo rescatable? |
| A2-029 | Extraer informacion valiosa si existe | Consolidar |
| A2-030 | Confirmar archivado | Sin perdida |

#### F-009: Faltantes
| ID | Tarea | Detalle |
|----|-------|---------|
| A2-031 | Especificar contenido de CALCULADORA-CAMBIO.md | Estructura completa |
| A2-032 | Identificar cualquier otro documento faltante | Lista |

### Entregable
- ANALISIS-DETALLADO-F001-ARQUITECTURA.md
- ANALISIS-DETALLADO-F002-DATABASE.md
- ANALISIS-DETALLADO-F003-BACKEND.md
- ANALISIS-DETALLADO-F004-FRONTEND.md
- ANALISIS-DETALLADO-F005-INTEGRACIONES.md
- ANALISIS-DETALLADO-F006-EPICAS.md
- ANALISIS-DETALLADO-F007-INDICES.md
- ANALISIS-DETALLADO-F008-OBSOLETOS.md
- ANALISIS-DETALLADO-F009-FALTANTES.md

---

## FASE 3: PLANEACION BASADA EN ANALISIS DETALLADO

### Objetivo
Crear plan de ejecucion preciso basado en analisis detallado.

### Tareas

| ID | Tarea | Detalle |
|----|-------|---------|
| P3-001 | Consolidar hallazgos de todos los analisis detallados | Un documento |
| P3-002 | Priorizar cambios por criticidad | CRITICA/ALTA/MEDIA/BAJA |
| P3-003 | Definir orden de ejecucion considerando dependencias | Secuencia |
| P3-004 | Crear tareas atomicas de ejecucion | Una por cambio |
| P3-005 | Asignar subagente a cada tarea | Perfil adecuado |
| P3-006 | Definir criterios de aceptacion por tarea | Verificables |
| P3-007 | Estimar impacto de cada cambio | Archivos afectados |

### Entregable
- PLAN-EJECUCION-DETALLADO-2026-01-10.md
  - Lista de tareas atomicas
  - Orden de ejecucion
  - Dependencias entre tareas
  - Criterios de aceptacion

---

## FASE 4: VALIDACION DE PLANEACION + DEPENDENCIAS

### Objetivo
Validar que el plan cubre todos los hallazgos y las dependencias estan correctas.

### Tareas

| ID | Tarea | Detalle |
|----|-------|---------|
| V4-001 | Comparar plan vs analisis F-001 | Todas las discrepancias cubiertas |
| V4-002 | Comparar plan vs analisis F-002 | Todas las tablas cubiertas |
| V4-003 | Comparar plan vs analisis F-003 | Todos los modulos cubiertos |
| V4-004 | Comparar plan vs analisis F-004 | Todas las paginas cubiertas |
| V4-005 | Comparar plan vs analisis F-005 | Todas las integraciones cubiertas |
| V4-006 | Comparar plan vs analisis F-006 | Todas las epicas cubiertas |
| V4-007 | Comparar plan vs analisis F-007 | Todos los indices cubiertos |
| V4-008 | Comparar plan vs analisis F-008 | Archivos obsoletos listados |
| V4-009 | Comparar plan vs analisis F-009 | Documentos faltantes incluidos |
| V4-010 | Validar dependencias de archivos | Orden correcto |
| V4-011 | Detectar posibles conflictos | Ediciones simultaneas |
| V4-012 | Validar que no se pierde informacion | Contenido preservado |

### Criterios de Validacion

| Criterio | Descripcion | Peso |
|----------|-------------|------|
| Cobertura | 100% de discrepancias cubiertas | 30% |
| Dependencias | Orden de ejecucion correcto | 25% |
| Sin perdida | Toda informacion valiosa preservada | 25% |
| Atomicidad | Tareas son independientes y verificables | 20% |

### Entregable
- VALIDACION-PLANEACION-2026-01-10.md
  - Checklist de cobertura por funcionalidad
  - Matriz de dependencias validada
  - Lista de conflictos potenciales
  - Resultado: GO / NO-GO con razones

---

## FASE 5: REFINAMIENTO DEL PLAN

### Objetivo
Ajustar el plan basado en la validacion.

### Tareas

| ID | Tarea | Detalle |
|----|-------|---------|
| R5-001 | Incorporar feedback de validacion | Ajustes necesarios |
| R5-002 | Resolver conflictos identificados | Reordenar si necesario |
| R5-003 | Agregar tareas faltantes | Si se detectaron |
| R5-004 | Optimizar orden de ejecucion | Eficiencia |
| R5-005 | Actualizar criterios de aceptacion | Mas precisos |
| R5-006 | Generar plan refinado final | Version ejecutable |

### Entregable
- PLAN-REFINADO-FINAL-2026-01-10.md
  - Plan ajustado y optimizado
  - Listo para ejecucion

---

## FASE 6: EJECUCION DEL PLAN

### Objetivo
Ejecutar todos los cambios planeados.

### Estructura de Ejecucion

La ejecucion se dividira en SPRINTS por funcionalidad:

#### SPRINT 1: Preparacion y Archivado (F-008)
| ID | Tarea | Subagente |
|----|-------|-----------|
| E6-001 | Crear backup completo | Bash |
| E6-002 | Mover archivos obsoletos a historico/ | Bash |
| E6-003 | Verificar integridad de backup | Documentation-Validator |

#### SPRINT 2: Arquitectura y Database (F-001, F-002)
| ID | Tarea | Subagente |
|----|-------|-----------|
| E6-004 | Actualizar ARQUITECTURA-TECNICA.md | Documentation |
| E6-005 | Agregar schemas faltantes a ARQUITECTURA-DATABASE.md | Database-Agent |
| E6-006 | Agregar tablas faltantes | Database-Agent |
| E6-007 | Agregar funciones faltantes | Database-Agent |
| E6-008 | Validar coherencia | Documentation-Validator |

#### SPRINT 3: Backend (F-003)
| ID | Tarea | Subagente |
|----|-------|-----------|
| E6-009 | Documentar modulo CategoriesModule | Backend-Agent |
| E6-010 | Documentar modulo PaymentsModule | Backend-Agent |
| E6-011 | Documentar modulo BillingModule | Backend-Agent |
| E6-012 | Documentar modulo IntegrationsModule | Backend-Agent |
| E6-013 | Documentar modulo ReferralsModule | Backend-Agent |
| E6-014 | Documentar modulo CodiSpeiModule | Backend-Agent |
| E6-015 | Documentar modulo WidgetsModule | Backend-Agent |
| E6-016 | Documentar modulo MarketplaceModule | Backend-Agent |
| E6-017 | Documentar modulo InvoicesModule | Backend-Agent |
| E6-018 | Actualizar ESPECIFICACION-COMPONENTES.md | Documentation |
| E6-019 | Validar coherencia | Documentation-Validator |

#### SPRINT 4: Frontend (F-004)
| ID | Tarea | Subagente |
|----|-------|-----------|
| E6-020 | Documentar paginas faltantes | Frontend-Agent |
| E6-021 | Documentar componentes adicionales | Frontend-Agent |
| E6-022 | Documentar servicios API | Frontend-Agent |
| E6-023 | Actualizar ESPECIFICACION-COMPONENTES.md | Documentation |
| E6-024 | Validar coherencia | Documentation-Validator |

#### SPRINT 5: Integraciones (F-005)
| ID | Tarea | Subagente |
|----|-------|-----------|
| E6-025 | Documentar SPEI | Documentation |
| E6-026 | Documentar SAT/CFDI | Documentation |
| E6-027 | Completar LLM multi-tenant | Documentation |
| E6-028 | Actualizar INTEGRACIONES-EXTERNAS.md | Documentation |
| E6-029 | Validar coherencia | Documentation-Validator |

#### SPRINT 6: Epicas (F-006)
| ID | Tarea | Subagente |
|----|-------|-----------|
| E6-030 | Actualizar MCH-023-programa-referidos.md | Documentation |
| E6-031 | Actualizar MCH-024-codi-spei.md | Documentation |
| E6-032 | Actualizar MCH-025-widgets-atajos.md | Documentation |
| E6-033 | Actualizar MCH-027-integracion-sat.md | Documentation |
| E6-034 | Actualizar MCH-028-marketplace-proveedores.md | Documentation |
| E6-035 | Corregir CONTEXT-MAP.yml | Documentation |
| E6-036 | Validar coherencia | Documentation-Validator |

#### SPRINT 7: Indices y Finalizacion (F-007, F-009)
| ID | Tarea | Subagente |
|----|-------|-----------|
| E6-037 | Actualizar docs/_MAP.md | Documentation |
| E6-038 | Actualizar docs/01-epicas/_MAP.md | Documentation |
| E6-039 | Actualizar docs/02-especificaciones/_MAP.md | Documentation |
| E6-040 | Crear CALCULADORA-CAMBIO.md | Documentation |
| E6-041 | Validar todos los indices | Documentation-Validator |
| E6-042 | Validacion final completa | Documentation-Validator |

### Criterios de Aceptacion por Sprint
Cada sprint debe cumplir:
- [ ] Todas las tareas completadas
- [ ] Validacion de coherencia PASS
- [ ] Sin referencias rotas
- [ ] Sin duplicados introducidos
- [ ] Backup preservado

---

## FASE 7: VALIDACION DE LA EJECUCION

### Objetivo
Validar que todos los cambios se aplicaron correctamente.

### Tareas

| ID | Tarea | Detalle |
|----|-------|---------|
| V7-001 | Validar docs/_MAP.md refleja archivos reales | grep + ls |
| V7-002 | Validar ARQUITECTURA-DATABASE.md vs schemas/*.sql | Comparacion |
| V7-003 | Validar ESPECIFICACION-COMPONENTES.md vs modulos | Comparacion |
| V7-004 | Validar INTEGRACIONES-EXTERNAS.md esta completo | Checklist |
| V7-005 | Validar epicas reflejan estado real | Por epica |
| V7-006 | Validar CONTEXT-MAP.yml correcto | IDs y nombres |
| V7-007 | Validar cero archivos obsoletos en activos | ls historico/ |
| V7-008 | Validar CALCULADORA-CAMBIO.md existe y completo | Contenido |
| V7-009 | Ejecutar busqueda de referencias rotas | grep links |
| V7-010 | Generar reporte final de validacion | Documento |

### Metricas de Exito

| Metrica | Valor Esperado |
|---------|----------------|
| Archivos duplicados | 0 |
| Referencias rotas | 0 |
| Coherencia epicas | 100% |
| Archivos obsoletos en activos | 0 |
| Documentacion faltante critica | 0 |
| Schemas documentados | 9/9 |
| Modulos documentados | 17/17 |

### Entregable
- REPORTE-VALIDACION-FINAL-2026-01-10.md
  - Resultado por criterio
  - Metricas alcanzadas
  - Problemas residuales (si hay)
  - Estado: COMPLETADO / CON OBSERVACIONES

---

## MATRIZ DE DEPENDENCIAS ENTRE FUNCIONALIDADES

```
F-008 Obsoletos ----+
                    |
F-009 Faltantes ---+|
                   ||
                   vv
              [EJECUTAR EN PARALELO]
                   ||
                   vv
F-001 Arquitectura --+
                     |
                     v
F-002 Database ------+
                     |
                     v
F-003 Backend -------+
                     |
                     v
F-004 Frontend ------+
                     |
                     v
F-005 Integraciones -+
                     |
                     v
F-006 Epicas --------+
                     |
                     v
F-007 Indices -------+
                     |
                     v
              [VALIDACION FINAL]
```

---

## ASIGNACION DE SUBAGENTES

| Funcionalidad | Perfil Principal | Perfil Secundario |
|---------------|------------------|-------------------|
| F-001 Arquitectura | Documentation | Architecture-Analyst |
| F-002 Database | Database-Agent | Documentation |
| F-003 Backend | Backend-Agent | Documentation |
| F-004 Frontend | Frontend-Agent | Documentation |
| F-005 Integraciones | Documentation | Backend-Agent |
| F-006 Epicas | Documentation | Requirements-Analyst |
| F-007 Indices | Documentation | Documentation-Validator |
| F-008 Obsoletos | Bash | Documentation |
| F-009 Faltantes | Documentation | Requirements-Analyst |

---

## CRONOGRAMA DE SPRINTS

| Sprint | Funcionalidades | Tareas | Prioridad |
|--------|-----------------|--------|-----------|
| Sprint 1 | F-008 | 3 | P0 |
| Sprint 2 | F-001, F-002 | 5 | P0 |
| Sprint 3 | F-003 | 11 | P0 |
| Sprint 4 | F-004 | 5 | P1 |
| Sprint 5 | F-005 | 5 | P1 |
| Sprint 6 | F-006 | 7 | P1 |
| Sprint 7 | F-007, F-009 | 6 | P1 |
| Validacion | Todas | 10 | P0 |

---

## RIESGOS Y MITIGACIONES

| Riesgo | Probabilidad | Impacto | Mitigacion |
|--------|--------------|---------|------------|
| Perder informacion al editar | Baja | Alto | Backup antes de cada sprint |
| Referencias rotas | Media | Medio | Validar despues de cada sprint |
| Inconsistencia temporal | Media | Bajo | Ejecutar en orden de dependencias |
| Olvidar algun archivo | Baja | Medio | Checklists por funcionalidad |
| Conflicto de ediciones | Baja | Medio | Un archivo a la vez |

---

## SIGUIENTE ACCION

**Estado Actual:** FASE 0 - Plan Maestro creado

**Accion Inmediata:**
1. Validar este plan con el usuario
2. Confirmar alcance y prioridades
3. Iniciar FASE 1 (Analisis y Planeacion Inicial)

---

**Creado por:** Orquestador (Claude Opus 4.5)
**Fecha:** 2026-01-10
**Version:** 1.0.0
**Sistema:** SIMCO + CAPVED