- 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>
5.2 KiB
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