rckrdmrd
928eb795e6
- 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>
167 lines
5.2 KiB
Markdown
167 lines
5.2 KiB
Markdown
# PLAN MAESTRO: Integracion Documentacion-Desarrollo
|
|
|
|
**Proyecto:** MiChangarrito
|
|
**Fecha:** 2026-01-10
|
|
**Estado:** FASE 0 - EN PROGRESO
|
|
**Responsable:** Arquitecto de Integracion
|
|
**Version:** 1.0.0
|
|
|
|
---
|
|
|
|
## OBJETIVO
|
|
|
|
Validar y asegurar que todos los cambios realizados en la documentacion durante la purga documental se integren correctamente con el desarrollo actual del proyecto, garantizando coherencia total entre especificaciones y codigo.
|
|
|
|
---
|
|
|
|
## ALCANCE
|
|
|
|
### Documentacion a Validar (Fuentes Canonicas)
|
|
|
|
| Documento | Contenido | Ubicacion |
|
|
|-----------|-----------|-----------|
|
|
| ARQUITECTURA-DATABASE.md | 9 schemas, 27+ tablas, triggers, funciones | docs/02-especificaciones/ |
|
|
| ARQUITECTURA-TECNICA.md | Stack, puertos, componentes | docs/00-vision-general/ |
|
|
| ESPECIFICACION-COMPONENTES.md | Modulos backend, paginas frontend | docs/02-especificaciones/ |
|
|
| INTEGRACIONES-EXTERNAS.md | Stripe, WhatsApp, LLM, etc. | docs/02-especificaciones/ |
|
|
| CONTEXT-MAP.yml | 28 epicas, 7 fases | orchestration/ |
|
|
| CALCULADORA-CAMBIO.md | Logica de cambio efectivo | docs/02-especificaciones/ |
|
|
|
|
### Codigo a Validar
|
|
|
|
| Componente | Ubicacion | Elementos |
|
|
|------------|-----------|-----------|
|
|
| Backend | apps/backend/src/ | Modulos, Controllers, Services |
|
|
| Frontend | apps/frontend/src/ | Paginas, Componentes |
|
|
| Mobile | apps/mobile/src/ | Pantallas, Componentes |
|
|
| Database | database/ | Scripts SQL, Migraciones |
|
|
| MCP Server | apps/mcp-server/ | Herramientas, Handlers |
|
|
|
|
---
|
|
|
|
## FASES DE EJECUCION
|
|
|
|
### FASE 0: Analisis y Planeacion para Analisis Detallado
|
|
**Objetivo:** Definir estructura y metodologia del analisis
|
|
|
|
**Tareas:**
|
|
- [ ] 0.1 Crear plan maestro (este documento)
|
|
- [ ] 0.2 Identificar areas de validacion
|
|
- [ ] 0.3 Definir criterios de exito
|
|
- [ ] 0.4 Mapear dependencias entre documentos y codigo
|
|
- [ ] 0.5 Establecer matriz de trazabilidad
|
|
|
|
**Entregable:** PLAN-ANALISIS-DETALLADO-2026-01-10.md
|
|
|
|
---
|
|
|
|
### FASE 1: Analisis Detallado Documentacion vs Desarrollo
|
|
**Objetivo:** Comparar exhaustivamente documentacion con codigo real
|
|
|
|
**Sub-tareas:**
|
|
- [ ] 1.1 Analisis Database: Scripts SQL vs ARQUITECTURA-DATABASE.md
|
|
- [ ] 1.2 Analisis Backend: Modulos vs ESPECIFICACION-COMPONENTES.md
|
|
- [ ] 1.3 Analisis Frontend: Paginas vs ESPECIFICACION-COMPONENTES.md
|
|
- [ ] 1.4 Analisis Integraciones: Codigo vs INTEGRACIONES-EXTERNAS.md
|
|
- [ ] 1.5 Analisis Mobile: Pantallas vs documentacion
|
|
- [ ] 1.6 Analisis MCP Server: Herramientas vs documentacion
|
|
|
|
**Entregable:** ANALISIS-DETALLADO-DOC-DEV-2026-01-10.md
|
|
|
|
---
|
|
|
|
### FASE 2: Planeacion Basada en Analisis Detallado
|
|
**Objetivo:** Crear plan de accion para cada discrepancia encontrada
|
|
|
|
**Tareas:**
|
|
- [ ] 2.1 Categorizar discrepancias por severidad
|
|
- [ ] 2.2 Definir acciones correctivas
|
|
- [ ] 2.3 Establecer orden de ejecucion
|
|
- [ ] 2.4 Identificar riesgos y mitigaciones
|
|
|
|
**Entregable:** PLAN-CORRECCION-INTEGRACION-2026-01-10.md
|
|
|
|
---
|
|
|
|
### FASE 3: Validacion de Plan contra Analisis y Dependencias
|
|
**Objetivo:** Asegurar cobertura completa y analisis de dependencias
|
|
|
|
**Tareas:**
|
|
- [ ] 3.1 Verificar que cada discrepancia tiene accion
|
|
- [ ] 3.2 Analizar dependencias de archivos a modificar
|
|
- [ ] 3.3 Validar que no se romperan funcionalidades
|
|
- [ ] 3.4 Crear matriz de impacto
|
|
|
|
**Entregable:** VALIDACION-PLAN-INTEGRACION-2026-01-10.md
|
|
|
|
---
|
|
|
|
### FASE 4: Refinamiento del Plan
|
|
**Objetivo:** Optimizar plan basado en validaciones
|
|
|
|
**Tareas:**
|
|
- [ ] 4.1 Incorporar hallazgos de validacion
|
|
- [ ] 4.2 Ajustar prioridades
|
|
- [ ] 4.3 Detallar pasos de ejecucion
|
|
- [ ] 4.4 Definir checkpoints de validacion
|
|
|
|
**Entregable:** PLAN-REFINADO-INTEGRACION-2026-01-10.md
|
|
|
|
---
|
|
|
|
### FASE 5: Ejecucion del Plan
|
|
**Objetivo:** Implementar correcciones planificadas
|
|
|
|
**Tareas:**
|
|
- [ ] 5.1 Ejecutar correcciones de documentacion
|
|
- [ ] 5.2 Ejecutar correcciones de codigo (si aplica)
|
|
- [ ] 5.3 Actualizar inventarios
|
|
- [ ] 5.4 Documentar cambios realizados
|
|
|
|
**Entregable:** REPORTE-EJECUCION-INTEGRACION-2026-01-10.md
|
|
|
|
---
|
|
|
|
### FASE 6: Validacion de Ejecucion
|
|
**Objetivo:** Verificar que todas las correcciones fueron exitosas
|
|
|
|
**Tareas:**
|
|
- [ ] 6.1 Validar coherencia documentacion-codigo
|
|
- [ ] 6.2 Ejecutar pruebas de integracion
|
|
- [ ] 6.3 Verificar referencias cruzadas
|
|
- [ ] 6.4 Crear reporte final
|
|
|
|
**Entregable:** VALIDACION-FINAL-INTEGRACION-2026-01-10.md
|
|
|
|
---
|
|
|
|
## CRITERIOS DE EXITO
|
|
|
|
| Criterio | Metrica | Umbral |
|
|
|----------|---------|--------|
|
|
| Cobertura de schemas | Schemas documentados vs implementados | 100% |
|
|
| Cobertura de endpoints | Endpoints documentados vs implementados | 95%+ |
|
|
| Cobertura de paginas | Paginas documentadas vs implementadas | 100% |
|
|
| Referencias validas | Referencias sin errores | 100% |
|
|
| Nomenclatura | Nombres consistentes | 100% |
|
|
|
|
---
|
|
|
|
## MATRIZ DE TRAZABILIDAD
|
|
|
|
| Documento | Valida Contra | Dependencias |
|
|
|-----------|---------------|--------------|
|
|
| ARQUITECTURA-DATABASE.md | database/*.sql | Modulos backend |
|
|
| ESPECIFICACION-COMPONENTES.md | apps/backend/src/, apps/frontend/src/ | Epicas |
|
|
| INTEGRACIONES-EXTERNAS.md | Modulos de integracion | ARQUITECTURA-TECNICA.md |
|
|
| CONTEXT-MAP.yml | docs/01-epicas/*.md | Todos los documentos |
|
|
|
|
---
|
|
|
|
**Siguiente Accion:** Lanzar analisis exploratorio paralelo de cada area
|
|
|
|
---
|
|
|
|
**Ultima actualizacion:** 2026-01-10
|
|
**Version:** 1.0.0
|