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>
345 lines
9.6 KiB
Markdown
345 lines
9.6 KiB
Markdown
# PLAN REFINADO: Integracion Documentacion-Desarrollo
|
|
|
|
**Proyecto:** MiChangarrito
|
|
**Fecha:** 2026-01-10
|
|
**Fase:** FASE 4 - Refinamiento
|
|
**Estado:** LISTO PARA EJECUCION
|
|
**Version:** 2.0.0
|
|
|
|
---
|
|
|
|
## CAMBIOS RESPECTO AL PLAN ORIGINAL
|
|
|
|
| Aspecto | Plan Original | Plan Refinado |
|
|
|---------|---------------|---------------|
|
|
| Tareas | 4 principales | 7 principales + 3 post-ejecucion |
|
|
| Backups | Implicito | Explicito como T0 |
|
|
| Inventarios | No incluido | Incluido como T5-T8 |
|
|
| Epicas individuales | No incluido | Incluido como T9 |
|
|
| Validacion YAML | No incluido | Incluido en cada paso |
|
|
|
|
---
|
|
|
|
## ORDEN DE EJECUCION REFINADO
|
|
|
|
### BLOQUE 0: PREPARACION
|
|
|
|
#### T0: Crear Backups
|
|
**Prioridad:** P0 - CRITICO
|
|
**Dependencias:** Ninguna
|
|
|
|
**Acciones:**
|
|
```bash
|
|
# Crear directorio de backup
|
|
mkdir -p orchestration/analisis/backup-integracion-2026-01-10
|
|
|
|
# Copiar documentos a modificar
|
|
cp docs/02-especificaciones/ARQUITECTURA-DATABASE.md orchestration/analisis/backup-integracion-2026-01-10/
|
|
cp docs/02-especificaciones/INTEGRACIONES-EXTERNAS.md orchestration/analisis/backup-integracion-2026-01-10/
|
|
cp docs/02-especificaciones/ESPECIFICACION-COMPONENTES.md orchestration/analisis/backup-integracion-2026-01-10/
|
|
cp orchestration/CONTEXT-MAP.yml orchestration/analisis/backup-integracion-2026-01-10/
|
|
```
|
|
|
|
**Validacion:** Verificar 4 archivos en backup
|
|
|
|
---
|
|
|
|
### BLOQUE 1: DOCUMENTACION PRINCIPAL
|
|
|
|
#### T1: Actualizar ARQUITECTURA-DATABASE.md
|
|
**Prioridad:** P0 - CRITICO
|
|
**Dependencias:** T0
|
|
**Lineas a agregar:** ~400
|
|
|
|
**Sub-tareas detalladas:**
|
|
|
|
| Sub-tarea | Ubicacion | Lineas | Contenido |
|
|
|-----------|-----------|--------|-----------|
|
|
| T1.1 | Linea 13-26 | 2 | Actualizar tabla de schemas (9→11) |
|
|
| T1.2 | Despues L123 | 50 | Agregar tenant_integration_credentials |
|
|
| T1.3 | Despues L123 | 40 | Agregar tenant_whatsapp_numbers |
|
|
| T1.4 | Despues L519 | 120 | Agregar 4 tablas CoDi/SPEI |
|
|
| T1.5 | Despues L953 | 80 | Agregar 3 tablas referrals |
|
|
| T1.6 | Despues L1066 | 150 | Agregar schema billing (5 tablas) |
|
|
| T1.7 | Despues billing | 180 | Agregar schema marketplace (6 tablas) |
|
|
| T1.8 | Despues L1139 | 60 | Agregar 10 funciones |
|
|
| T1.9 | L1249-1262 | 5 | Actualizar orden de ejecucion SQL |
|
|
|
|
**Validacion post-tarea:**
|
|
- [ ] 11 schemas en tabla inicial
|
|
- [ ] 47 tablas documentadas
|
|
- [ ] 15 funciones documentadas
|
|
- [ ] Referencias internas correctas
|
|
|
|
---
|
|
|
|
#### T2: Actualizar INTEGRACIONES-EXTERNAS.md
|
|
**Prioridad:** P0 - CRITICO
|
|
**Dependencias:** T1
|
|
**Lineas a agregar:** ~150
|
|
|
|
**Sub-tareas detalladas:**
|
|
|
|
| Sub-tarea | Ubicacion | Lineas | Contenido |
|
|
|-----------|-----------|--------|-----------|
|
|
| T2.1 | Despues seccion 7 | 60 | Agregar seccion SPEI |
|
|
| T2.2 | Despues SPEI | 80 | Agregar seccion SAT/CFDI |
|
|
| T2.3 | Seccion 3 | 15 | Agregar Azure OpenAI a LLM |
|
|
| T2.4 | Actualizar indice | 2 | Agregar SPEI y SAT al indice |
|
|
|
|
**Validacion post-tarea:**
|
|
- [ ] 11 integraciones en indice
|
|
- [ ] SPEI documentado
|
|
- [ ] SAT/CFDI documentado
|
|
- [ ] LLM providers actualizado
|
|
|
|
---
|
|
|
|
#### T3: Actualizar ESPECIFICACION-COMPONENTES.md
|
|
**Prioridad:** P0 - CRITICO
|
|
**Dependencias:** T1, T2
|
|
**Lineas a agregar:** ~200
|
|
|
|
**Sub-tareas detalladas:**
|
|
|
|
| Sub-tarea | Ubicacion | Lineas | Contenido |
|
|
|-----------|-----------|--------|-----------|
|
|
| T3.1 | Tabla modulos | 10 | Agregar 9 modulos backend |
|
|
| T3.2 | Despues modulos | 150 | Agregar endpoints por modulo |
|
|
| T3.3 | Tabla paginas | 6 | Agregar 5 paginas frontend |
|
|
| T3.4 | Tabla componentes | 5 | Actualizar versiones |
|
|
| T3.5 | Tabla modulos | -1 | Remover UsersModule |
|
|
|
|
**Validacion post-tarea:**
|
|
- [ ] 17 modulos en tabla
|
|
- [ ] 11 paginas en tabla
|
|
- [ ] Versiones actualizadas (React 19, Vite 7.2)
|
|
- [ ] UsersModule removido
|
|
|
|
---
|
|
|
|
#### T4: Actualizar CONTEXT-MAP.yml
|
|
**Prioridad:** P1 - ALTO
|
|
**Dependencias:** T1, T2, T3
|
|
**Lineas a modificar:** ~30
|
|
|
|
**Sub-tareas detalladas:**
|
|
|
|
| Sub-tarea | Epica | Cambio |
|
|
|-----------|-------|--------|
|
|
| T4.1 | MCH-023 | estado: pendiente → completado |
|
|
| T4.2 | MCH-024 | estado: pendiente → completado |
|
|
| T4.3 | MCH-025 | estado: pendiente → completado |
|
|
| T4.4 | MCH-027 | estado: pendiente → completado |
|
|
| T4.5 | MCH-028 | estado: pendiente → completado |
|
|
|
|
**Validacion post-tarea:**
|
|
- [ ] YAML valido (parser test)
|
|
- [ ] 5 epicas actualizadas
|
|
- [ ] Referencias correctas
|
|
|
|
---
|
|
|
|
### BLOQUE 2: SINCRONIZACION DE INVENTARIOS
|
|
|
|
#### T5: Actualizar DATABASE_INVENTORY.yml
|
|
**Prioridad:** P1 - ALTO
|
|
**Dependencias:** T1
|
|
|
|
**Cambios:**
|
|
- Agregar schemas: billing, marketplace
|
|
- Agregar 20 tablas nuevas
|
|
- Actualizar conteos
|
|
|
|
---
|
|
|
|
#### T6: Actualizar BACKEND_INVENTORY.yml
|
|
**Prioridad:** P1 - ALTO
|
|
**Dependencias:** T3
|
|
|
|
**Cambios:**
|
|
- Agregar 9 modulos nuevos
|
|
- Agregar ~70 endpoints
|
|
- Actualizar conteos
|
|
|
|
---
|
|
|
|
#### T7: Actualizar FRONTEND_INVENTORY.yml
|
|
**Prioridad:** P1 - ALTO
|
|
**Dependencias:** T3
|
|
|
|
**Cambios:**
|
|
- Agregar 5 paginas nuevas
|
|
- Actualizar conteos
|
|
|
|
---
|
|
|
|
#### T8: Actualizar MASTER_INVENTORY.yml
|
|
**Prioridad:** P1 - ALTO
|
|
**Dependencias:** T5, T6, T7
|
|
|
|
**Cambios:**
|
|
- Consolidar todos los cambios
|
|
- Actualizar metricas globales
|
|
|
|
---
|
|
|
|
### BLOQUE 3: VERIFICACION DE EPICAS
|
|
|
|
#### T9: Verificar Epicas Individuales
|
|
**Prioridad:** P2 - MEDIO
|
|
**Dependencias:** T4
|
|
|
|
**Archivos a verificar:**
|
|
|
|
| Archivo | Verificar |
|
|
|---------|-----------|
|
|
| docs/01-epicas/MCH-023-programa-referidos.md | Estado consistente |
|
|
| docs/01-epicas/MCH-024-codi-spei.md | Estado consistente |
|
|
| docs/01-epicas/MCH-025-facturacion-electronica.md | Estado consistente |
|
|
| docs/01-epicas/MCH-027-integracion-sat.md | Estado consistente |
|
|
| docs/01-epicas/MCH-028-marketplace-proveedores.md | Estado consistente |
|
|
|
|
---
|
|
|
|
### BLOQUE 4: VALIDACION FINAL
|
|
|
|
#### T10: Validacion de Coherencia
|
|
**Prioridad:** P0 - CRITICO
|
|
**Dependencias:** Todas las anteriores
|
|
|
|
**Checklist:**
|
|
- [ ] 11 schemas en ARQUITECTURA-DATABASE = 11 en inventario
|
|
- [ ] 17 modulos en ESPECIFICACION = 17 en inventario
|
|
- [ ] 11 paginas en ESPECIFICACION = 11 en inventario
|
|
- [ ] 11 integraciones documentadas
|
|
- [ ] 28 epicas con estados correctos
|
|
- [ ] Sin referencias rotas
|
|
- [ ] YAML sin errores de sintaxis
|
|
|
|
---
|
|
|
|
## CRONOGRAMA DE EJECUCION
|
|
|
|
```
|
|
BLOQUE 0: Preparacion
|
|
└── T0: Backups ────────────────────────── [5 min]
|
|
|
|
BLOQUE 1: Documentacion Principal (en paralelo no recomendado)
|
|
├── T1: ARQUITECTURA-DATABASE.md ───────── [30 min]
|
|
├── T2: INTEGRACIONES-EXTERNAS.md ──────── [15 min]
|
|
├── T3: ESPECIFICACION-COMPONENTES.md ──── [20 min]
|
|
└── T4: CONTEXT-MAP.yml ────────────────── [10 min]
|
|
|
|
BLOQUE 2: Inventarios (en paralelo posible)
|
|
├── T5: DATABASE_INVENTORY.yml ─────────── [10 min]
|
|
├── T6: BACKEND_INVENTORY.yml ──────────── [10 min]
|
|
├── T7: FRONTEND_INVENTORY.yml ─────────── [5 min]
|
|
└── T8: MASTER_INVENTORY.yml ───────────── [5 min]
|
|
|
|
BLOQUE 3: Epicas
|
|
└── T9: Verificacion ───────────────────── [10 min]
|
|
|
|
BLOQUE 4: Validacion
|
|
└── T10: Validacion final ──────────────── [15 min]
|
|
```
|
|
|
|
---
|
|
|
|
## METRICAS DE EXITO
|
|
|
|
### Cobertura Documentacion
|
|
|
|
| Metrica | Antes | Despues | Exito |
|
|
|---------|-------|---------|-------|
|
|
| Schemas documentados | 9 | 11 | 100% |
|
|
| Tablas documentadas | 27 | 47 | 100% |
|
|
| Funciones documentadas | 5 | 15 | 100% |
|
|
| Modulos documentados | 9 | 17 | 100% |
|
|
| Endpoints documentados | ~50 | ~120 | 100% |
|
|
| Paginas documentadas | 7 | 11 | 100% |
|
|
| Integraciones documentadas | 9 | 11 | 100% |
|
|
| Epicas correctamente marcadas | 22 | 27 | 100% |
|
|
|
|
### Calidad
|
|
|
|
| Metrica | Umbral | Medicion |
|
|
|---------|--------|----------|
|
|
| Referencias rotas | 0 | Validar links |
|
|
| Errores YAML | 0 | Parser test |
|
|
| Inconsistencias | 0 | Cross-check |
|
|
|
|
---
|
|
|
|
## PUNTOS DE CONTROL (CHECKPOINTS)
|
|
|
|
### CP1: Despues de T1
|
|
- Validar ARQUITECTURA-DATABASE.md
|
|
- Verificar 11 schemas
|
|
- Verificar estructura markdown
|
|
|
|
### CP2: Despues de T4
|
|
- Validar todos los documentos principales
|
|
- Verificar YAML syntax
|
|
- Verificar referencias cruzadas
|
|
|
|
### CP3: Despues de T8
|
|
- Validar inventarios sincronizados
|
|
- Verificar conteos
|
|
|
|
### CP4: Final (T10)
|
|
- Validacion completa
|
|
- Crear reporte de ejecucion
|
|
|
|
---
|
|
|
|
## PLAN DE ROLLBACK
|
|
|
|
### Si falla cualquier tarea:
|
|
1. Detener ejecucion
|
|
2. Restaurar desde backup (T0)
|
|
3. Analizar fallo
|
|
4. Corregir plan
|
|
5. Reintentar
|
|
|
|
### Comandos de rollback:
|
|
```bash
|
|
# Restaurar todos los archivos
|
|
cp orchestration/analisis/backup-integracion-2026-01-10/ARQUITECTURA-DATABASE.md docs/02-especificaciones/
|
|
cp orchestration/analisis/backup-integracion-2026-01-10/INTEGRACIONES-EXTERNAS.md docs/02-especificaciones/
|
|
cp orchestration/analisis/backup-integracion-2026-01-10/ESPECIFICACION-COMPONENTES.md docs/02-especificaciones/
|
|
cp orchestration/analisis/backup-integracion-2026-01-10/CONTEXT-MAP.yml orchestration/
|
|
```
|
|
|
|
---
|
|
|
|
## RESUMEN DE TAREAS
|
|
|
|
| ID | Tarea | Prioridad | Dependencias | Estimado |
|
|
|----|-------|-----------|--------------|----------|
|
|
| T0 | Backups | P0 | - | 5 min |
|
|
| T1 | ARQUITECTURA-DATABASE.md | P0 | T0 | 30 min |
|
|
| T2 | INTEGRACIONES-EXTERNAS.md | P0 | T1 | 15 min |
|
|
| T3 | ESPECIFICACION-COMPONENTES.md | P0 | T1,T2 | 20 min |
|
|
| T4 | CONTEXT-MAP.yml | P1 | T1-T3 | 10 min |
|
|
| T5 | DATABASE_INVENTORY.yml | P1 | T1 | 10 min |
|
|
| T6 | BACKEND_INVENTORY.yml | P1 | T3 | 10 min |
|
|
| T7 | FRONTEND_INVENTORY.yml | P1 | T3 | 5 min |
|
|
| T8 | MASTER_INVENTORY.yml | P1 | T5-T7 | 5 min |
|
|
| T9 | Verificar Epicas | P2 | T4 | 10 min |
|
|
| T10 | Validacion Final | P0 | Todas | 15 min |
|
|
|
|
**Total estimado:** ~2 horas
|
|
|
|
---
|
|
|
|
## ESTADO
|
|
|
|
**Plan Refinado:** APROBADO
|
|
**Listo para:** FASE 5 - Ejecucion
|
|
|
|
---
|
|
|
|
**Ultima actualizacion:** 2026-01-10
|
|
**Version:** 2.0.0
|