michangarrito/orchestration/_archive/analisis/PLAN-MAESTRO-REESTRUCTURACION-DOCUMENTAL-2026-01-10.md

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