2fb9f3f6b5
Some checks are pending
CI/CD Pipeline / Backend CI (push) Waiting to run
CI/CD Pipeline / Frontend CI (push) Waiting to run
CI/CD Pipeline / WhatsApp Service CI (push) Waiting to run
CI/CD Pipeline / Mobile CI (push) Waiting to run
CI/CD Pipeline / Docker Build (./apps/backend, ./apps/backend/Dockerfile, backend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/frontend, ./apps/frontend/Dockerfile, frontend) (push) Blocked by required conditions
CI/CD Pipeline / Docker Build (./apps/whatsapp-service, ./apps/whatsapp-service/Dockerfile, whatsapp-service) (push) Blocked by required conditions
CI/CD Pipeline / Deploy to Production (push) Blocked by required conditions
- Move 7 non-standard folders to _archive/ - Archive 3 extra root files - Update _MAP.md with standardized structure Standard: SIMCO-ESTANDAR-ORCHESTRATION v1.0.0 Level: CONSUMER (L2) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
869 lines
28 KiB
Markdown
869 lines
28 KiB
Markdown
# 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
|