michangarrito/orchestration/analisis/PLAN-EJECUCION-CONSOLIDADO-2026-01-10.md
rckrdmrd 928eb795e6 [SIMCO-V38] feat: Actualizar a SIMCO v3.8.0 + cambios apps
- 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>
2026-01-10 08:53:05 -06:00

12 KiB

PLAN DE EJECUCION CONSOLIDADO

Proyecto: MiChangarrito Fecha: 2026-01-10 Estado: LISTO PARA EJECUCION Version: 1.0.0 Fases Cubiertas: FASE 2-5 (Consolidadas)


RESUMEN DE DISCREPANCIAS A CORREGIR

Totales por Severidad

Severidad Cantidad Sprint Asignado
CRITICA 12 Sprint 2-3
ALTA 14 Sprint 2-6
MEDIA 8 Sprint 4-7
TOTAL 34 -

SPRINT 1: PREPARACION Y BACKUP

Tareas

ID Tarea Accion Validacion
S1-001 Crear backup completo cp -r docs/ backup-docs-2026-01-10/ Directorio existe
S1-002 Verificar historico/ ls orchestration/analisis/historico/ 5 archivos presentes
S1-003 Crear checkpoint git git add . && git commit Commit creado

Criterios de Exito

  • backup-docs-2026-01-10/ creado
  • historico/ verificado con archivos
  • Commit de checkpoint creado

SPRINT 2: ARQUITECTURA Y ESPECIFICACIONES (F-001)

Discrepancias a Corregir

ID Discrepancia Archivo Lineas Correccion
S2-001 React 18 → React 19.2.0 ARQUITECTURA-TECNICA.md Seccion Stack Actualizar version
S2-002 React Router 6 → 7.11.0 ARQUITECTURA-TECNICA.md Seccion Stack Actualizar version
S2-003 Vite no especificado → 7.2.4 ARQUITECTURA-TECNICA.md Seccion Stack Agregar version
S2-004 TailwindCSS sin version ARQUITECTURA-TECNICA.md Seccion Stack Agregar version
S2-005 shadcn/ui documentado pero NO existe ARQUITECTURA-TECNICA.md Seccion UI REMOVER referencia
S2-006 Recharts documentado pero NO existe ARQUITECTURA-TECNICA.md Seccion Charts REMOVER referencia
S2-007 ReportsModule NO existe ARQUITECTURA-TECNICA.md Seccion Modulos REMOVER referencia
S2-008 NotificationsModule NO existe ARQUITECTURA-TECNICA.md Seccion Modulos REMOVER referencia
S2-009 Agregar dependencias reales ARQUITECTURA-TECNICA.md Seccion Deps axios, clsx, lucide-react

Acciones Detalladas

S2-001 a S2-004: Actualizar versiones

# En ARQUITECTURA-TECNICA.md, seccion Stack Frontend:

ANTES:
- React 18
- React Router 6

DESPUES:
- React 19.2.0
- React Router 7.11.0
- Vite 7.2.4
- TailwindCSS 4.0.x

S2-005, S2-006: Remover librerias inexistentes

# REMOVER cualquier mencion de:
- shadcn/ui (no instalado)
- Recharts (no instalado)

S2-007, S2-008: Remover modulos inexistentes

# REMOVER de lista de modulos:
- ReportsModule (no existe en codigo)
- NotificationsModule (no existe en codigo)

Criterios de Exito Sprint 2

  • Versiones de React, Router, Vite correctas
  • Sin referencias a shadcn/ui ni Recharts
  • Sin referencias a ReportsModule/NotificationsModule
  • Dependencias reales documentadas

SPRINT 3: BASE DE DATOS (F-002)

Discrepancias a Corregir

ID Discrepancia Accion
S3-001 Schema integrations NO documentado Agregar a ARQUITECTURA-DATABASE.md
S3-002 Schema billing NO documentado (5 tablas) Agregar schema completo
S3-003 Schema marketplace NO documentado (6 tablas) Agregar schema completo
S3-004 4 tablas sales adicionales Documentar en seccion sales
S3-005 3 tablas subscriptions adicionales Documentar en seccion subscriptions
S3-006 2 tablas public adicionales Documentar en seccion public
S3-007 10 funciones NO documentadas Agregar a seccion Funciones
S3-008 ~10 triggers adicionales Agregar a seccion Triggers

Contenido a Agregar

S3-001: Schema integrations

### Schema: integrations

| Tabla | Descripcion |
|-------|-------------|
| tenant_integration_credentials | Credenciales por tenant |
| tenant_whatsapp_numbers | Numeros WhatsApp por tenant |

ENUMs:
- integration_type
- credential_status

S3-002: Schema billing

### Schema: billing

| Tabla | Descripcion |
|-------|-------------|
| tax_configs | Configuraciones fiscales |
| invoices | Facturas |
| invoice_items | Items de factura |
| invoice_item_taxes | Impuestos por item |
| invoice_history | Historial de facturas |

S3-003: Schema marketplace

### Schema: marketplace

| Tabla | Descripcion |
|-------|-------------|
| suppliers | Proveedores |
| supplier_products | Productos de proveedores |
| supplier_orders | Pedidos a proveedores |
| supplier_order_items | Items de pedido |
| supplier_reviews | Resenas de proveedores |
| supplier_favorites | Favoritos |

S3-007: Funciones a documentar

### Funciones Adicionales

| Funcion | Schema | Proposito |
|---------|--------|-----------|
| orders.generate_order_number() | orders | Generar numero de orden |
| inventory.update_stock_on_sale() | inventory | Actualizar stock en venta |
| subscriptions.generate_referral_code() | subscriptions | Generar codigo referido |
| subscriptions.get_referral_stats() | subscriptions | Estadisticas referidos |
| sales.generate_codi_reference() | sales | Referencia CoDi |
| sales.get_codi_spei_summary() | sales | Resumen CoDi/SPEI |
| billing.get_next_invoice_folio() | billing | Siguiente folio factura |
| billing.get_invoice_summary() | billing | Resumen factura |
| marketplace.update_supplier_rating() | marketplace | Rating proveedor |
| marketplace.find_suppliers_by_zone() | marketplace | Buscar proveedores |

Criterios de Exito Sprint 3

  • Schema integrations documentado
  • Schema billing documentado (5 tablas)
  • Schema marketplace documentado (6 tablas)
  • Tablas adicionales de sales documentadas
  • 10 funciones documentadas
  • Conteo actualizado: 12 schemas, ~49 tablas

SPRINT 4: BACKEND (F-003)

Discrepancias a Corregir

ID Discrepancia Accion
S4-001 InvoicesModule NO documentado (9 endpoints) Agregar a ESPECIFICACION-COMPONENTES.md
S4-002 WidgetsModule NO documentado (4 endpoints) Agregar a ESPECIFICACION-COMPONENTES.md
S4-003 ~70 endpoints NO documentados Documentar por modulo
S4-004 Actualizar conteo modulos: 17→18 Corregir en documentacion

Contenido a Agregar

S4-001: InvoicesModule

### InvoicesModule

**Controller:** invoices.controller.ts
**Endpoints:** 9

| Metodo | Ruta | Descripcion |
|--------|------|-------------|
| POST | /invoices | Crear factura |
| GET | /invoices | Listar facturas |
| GET | /invoices/:id | Obtener factura |
| PUT | /invoices/:id | Actualizar factura |
| DELETE | /invoices/:id | Eliminar factura |
| POST | /invoices/:id/stamp | Timbrar CFDI |
| POST | /invoices/:id/cancel | Cancelar CFDI |
| GET | /invoices/:id/pdf | Descargar PDF |
| GET | /invoices/:id/xml | Descargar XML |

S4-002: WidgetsModule

### WidgetsModule

**Controller:** widgets.controller.ts
**Endpoints:** 4

| Metodo | Ruta | Descripcion |
|--------|------|-------------|
| GET | /widgets | Listar widgets |
| POST | /widgets | Crear widget |
| PUT | /widgets/:id | Actualizar widget |
| DELETE | /widgets/:id | Eliminar widget |

Criterios de Exito Sprint 4

  • InvoicesModule documentado
  • WidgetsModule documentado
  • Conteo de modulos actualizado a 18
  • Endpoints faltantes documentados

SPRINT 5: FRONTEND (F-004)

Discrepancias a Corregir

ID Discrepancia Accion
S5-001 Register.tsx NO documentada Agregar a ESPECIFICACION-COMPONENTES.md
S5-002 Reports.tsx documentada pero NO existe REMOVER de documentacion
S5-003 Sales.tsx confundida con Products.tsx Corregir referencia
S5-004 Componentes inline NO documentados Documentar principales

Acciones Detalladas

S5-001: Agregar Register.tsx

### Paginas Frontend

| Pagina | Ruta | Componente |
|--------|------|------------|
| Register | /register | Register.tsx |

S5-002: Remover Reports.tsx

# REMOVER de lista de paginas:
- Reports.tsx (/reports) - NO EXISTE EN CODIGO

Criterios de Exito Sprint 5

  • Register.tsx documentada
  • Reports.tsx removida de documentacion
  • Sin confusiones Sales/Products
  • Conteo de paginas: 12

SPRINT 6: INTEGRACIONES Y EPICAS (F-005, F-006)

Discrepancias Integraciones

ID Discrepancia Accion
S6-001 SAT CFDI solo modelo (5% impl) Documentar estado real
S6-002 SPEI/STP mock (40% impl) Documentar como mock
S6-003 CoDi mock (40% impl) Documentar como mock
S6-004 Firebase FCM solo docs (0% impl) Marcar como pendiente

Discrepancias Epicas

ID Epica Estado Doc Estado Real Accion
S6-005 MCH-024 CoDi/SPEI Pendiente Completado (Base) Actualizar estado
S6-006 MCH-026 Multi-idioma Pendiente Completado (Base) Actualizar estado
S6-007 MCH-027 SAT Pendiente Completado (Base) Actualizar estado
S6-008 MCH-028 Marketplace Pendiente Completado (Base) Actualizar estado
S6-009 MCH-012 Chat LLM Dueno Completado Pendiente Corregir estado
S6-010 MCH-013 Chat LLM Cliente Completado Pendiente Corregir estado

Acciones en Archivos

INTEGRACIONES-EXTERNAS.md

# Actualizar estado de implementacion:

| Integracion | Estado Real |
|-------------|-------------|
| SAT CFDI 4.0 | MODELO SOLO (5%) - Requiere PAC |
| SPEI/STP | MOCK (40%) - Requiere STP.mx |
| CoDi | MOCK (40%) - Requiere Banxico |
| Firebase FCM | PENDIENTE (0%) |

Epicas MCH-024 a MCH-028

# En cada archivo de epica:
Estado: Completado (Implementacion Base)
Notas: Infraestructura creada, integracion real pendiente

Criterios de Exito Sprint 6

  • Estados de integracion reflejan realidad
  • Epicas MCH-024-028 marcadas "Completado (Base)"
  • Epicas MCH-012, MCH-013 corregidas a "Pendiente"

SPRINT 7: INDICES Y MAPAS (F-007)

Discrepancias a Corregir

ID Discrepancia Archivo Accion
S7-001 CALCULADORA-CAMBIO.md no listado docs/_MAP.md Agregar o crear archivo
S7-002 ESPECIFICACION-COMPONENTES.md no en tabla docs/02-especificaciones/_MAP.md Agregar a tabla
S7-003 Omite 2 archivos existentes docs/02-especificaciones/_MAP.md Agregar archivos
S7-004 Dice "25+ tablas" pero son 49 docs/02-especificaciones/_MAP.md Corregir conteo
S7-005 Dice "27 tablas" pero son 49 docs/INDICE-ARQUITECTURA.md Corregir conteo

Acciones Detalladas

S7-001 a S7-003: Actualizar mapas

# En docs/_MAP.md agregar:
- Verificar CALCULADORA-CAMBIO.md existe o crear

# En docs/02-especificaciones/_MAP.md agregar:
- ESPECIFICACION-COMPONENTES.md
- Archivos faltantes

S7-004, S7-005: Corregir conteos

# Conteos correctos:
- Schemas: 12
- Tablas: ~49
- Funciones: 15
- Triggers: 20+

Criterios de Exito Sprint 7

  • docs/_MAP.md completo
  • docs/02-especificaciones/_MAP.md actualizado
  • Conteos de tablas correctos
  • Cero archivos huerfanos
  • Cero referencias rotas

FASE 7: VALIDACION FINAL

Checklist de Validacion

Categoria Criterio Metodo
Arquitectura Versiones correctas Comparar package.json
Database 12 schemas documentados Contar en ARQUITECTURA-DATABASE.md
Database ~49 tablas documentadas Contar en ARQUITECTURA-DATABASE.md
Backend 18 modulos documentados Contar en ESPECIFICACION-COMPONENTES.md
Frontend 12 paginas documentadas Contar en ESPECIFICACION-COMPONENTES.md
Integraciones Estados reales Comparar con codigo
Epicas 28 con estado correcto Revisar _MAP.md
Indices Cero huerfanos Verificar archivos
Indices Cero rotas grep referencias

Metricas Objetivo

Metrica Antes Despues
Discrepancias CRITICAS 12 0
Discrepancias ALTAS 14 0
Discrepancias MEDIAS 8 0
Referencias rotas 0 0
Archivos huerfanos 2 0
Cobertura schemas 92% 100%
Cobertura modulos 94% 100%

ORDEN DE EJECUCION

Sprint 1 (Preparacion)
    |
    v
Sprint 2 (Arquitectura)
    |
    v
Sprint 3 (Database)
    |
    v
Sprint 4 (Backend)
    |
    v
Sprint 5 (Frontend)
    |
    v
Sprint 6 (Integraciones + Epicas)
    |
    v
Sprint 7 (Indices)
    |
    v
FASE 7 (Validacion)

ESTADO ACTUAL

Plan: COMPLETADO Y VALIDADO Siguiente: EJECUTAR SPRINT 1


Generado por: Orquestador Fecha: 2026-01-10 Version: 1.0.0