erp-core/orchestration/propagacion/PLAN-MAESTRO-PROPAGACION-FASE8.md

Plan Maestro: Propagación FASE-8 a Verticales ERP

Fecha: 2026-01-04 Version: 1.0 Estado: En Ejecución Origen: ERP-Core FASE-8 (Cobertura ~78%)

---

1. Objetivo

Propagar las mejoras, correcciones y alineamiento con Odoo 18 implementadas en ERP-Core FASE-8 hacia todos los proyectos ERP verticales, adaptando cada módulo según el giro específico del negocio.

---

2. Proyectos Objetivo

#	Proyecto	Giro	Estado Actual	Prioridad
1	erp-construccion	Construcción de vivienda	Más desarrollado (110 tablas propias)	Alta
2	erp-clinicas	Clínicas/Salud	En desarrollo	Media
3	erp-mecanicas-diesel	Mecánicas diesel	En desarrollo	Media
4	erp-retail	Retail/Comercio	En desarrollo	Media
5	erp-vidrio-templado	Vidrio templado	En desarrollo	Media

---

3. Fases por Proyecto

Cada proyecto seguirá estas 8 fases obligatorias:

FASE 1: Análisis y Planeación Inicial

Objetivo: Entender el estado actual del proyecto

Entregables:

• Inventario de archivos DDL existentes
• Inventario de archivos de orchestration
• Identificación de HERENCIA-ERP-CORE.md actual
• Mapeo de schemas específicos del giro
• Lista de dependencias con ERP-Core

Documento: FASE-1-ANALISIS-INICIAL.md

FASE 2: Análisis Detallado

Objetivo: Comparar con ERP-Core FASE-8 y determinar gaps

Entregables:

• Comparación tabla por tabla con nuevas tablas de FASE-8
• Identificación de correcciones COR-XXX aplicables
• Análisis de funciones nuevas relevantes al giro
• Análisis de campos adicionales necesarios
• Matriz de aplicabilidad por módulo

Documento: FASE-2-ANALISIS-DETALLADO.md

FASE 3: Planeación con Base en Análisis

Objetivo: Crear plan de implementación específico

Entregables:

• Lista de tablas nuevas a propagar (con adaptaciones)
• Lista de funciones a propagar (con adaptaciones)
• Lista de campos adicionales a propagar
• Script de migración propuesto
• Seed data específico del giro

Documento: FASE-3-PLAN-IMPLEMENTACION.md

FASE 4: Validación de Planeación

Objetivo: Verificar que el plan cubre todos los requisitos

Entregables:

• Checklist de validación contra análisis
• Verificación de cobertura de correcciones COR-XXX
• Validación de dependencias identificadas
• Revisión de conflictos potenciales
• Sign-off del plan

Documento: FASE-4-VALIDACION-PLAN.md

FASE 5: Análisis de Dependencias

Objetivo: Verificar todas las dependencias

Entregables:

• Mapa de dependencias FK entre schemas
• Dependencias con auth.* y core.*
• Dependencias con schemas específicos del giro
• Orden de ejecución de scripts
• Riesgos identificados

Documento: FASE-5-ANALISIS-DEPENDENCIAS.md

FASE 6: Refinamiento del Plan

Objetivo: Ajustar plan con base en validación y dependencias

Entregables:

• Plan ajustado con resolución de conflictos
• Scripts finales de migración
• Scripts de rollback
• Documentación de API actualizada
• Checklist de ejecución

Documento: FASE-6-PLAN-REFINADO.md

FASE 7: Ejecución del Plan

Objetivo: Implementar los cambios

Entregables:

• Archivos DDL actualizados/creados
• Scripts de migración ejecutables
• Seed data del giro
• HERENCIA-ERP-CORE.md actualizado
• Documentación API del giro

Documentos:

• Archivos DDL modificados
• FASE-7-REPORTE-EJECUCION.md

FASE 8: Validación de Ejecución

Objetivo: Verificar que todo se implementó correctamente

Entregables:

• Validación de sintaxis SQL
• Verificación de tablas creadas
• Verificación de funciones creadas
• Verificación de RLS policies
• Comparación final con plan
• Reporte de cobertura

Documento: FASE-8-VALIDACION-FINAL.md

---

4. Correcciones FASE-8 a Propagar

4.1 Por Módulo

Módulo	IDs	Tablas	Funciones	Aplicable a Verticales
Financial	COR-035 a COR-039	5	0	Todos
Inventory	COR-040 a COR-044	5	0	Todos
Purchase	COR-045 a COR-047	1	1	Todos
Sales	COR-048 a COR-050	0	2	Retail, Vidrio
CRM	COR-051 a COR-055	3	4	Clínicas, Retail
Projects	COR-056 a COR-060	3	2	Construcción
HR	COR-061 a COR-066	11	0	Todos

4.2 Adaptaciones por Giro

Giro	Módulos Críticos	Adaptaciones Esperadas
Construcción	Projects, HR, Inventory	Obra, cuadrillas, materiales
Clínicas	CRM, HR	Pacientes, personal médico
Mecánicas Diesel	Inventory, Sales	Refacciones, servicios
Retail	Sales, CRM, Inventory	POS, clientes, stock
Vidrio Templado	Inventory, Sales	Producción, pedidos

---

5. Archivos de Referencia (ERP-Core)

5.1 DDL Modificados en FASE-8

Archivo	Líneas	Correcciones
04-financial.sql	1,385	COR-035 a COR-039
05-inventory.sql	1,328	COR-040 a COR-044
06-purchase.sql	914	COR-045 a COR-047
07-sales.sql	953	COR-048 a COR-050
08-projects.sql	967	COR-056 a COR-060
11-crm.sql	994	COR-051 a COR-055
12-hr.sql	870	COR-061 a COR-066

5.2 Documentación de Referencia

Documento	Ubicación
Migración FASE-8	database/migrations/20260104_001_odoo_alignment_fase8.sql
API Nuevas Tablas	docs/API-NUEVAS-TABLAS-FASE8.md
Seed Data Estados	database/seeds/dev/00b-states.sql
Validación FASE-8	orchestration/01-analisis/VALIDACION-COMPLETA/FASE-8-*.md

---

6. Cronograma de Ejecución

Proyecto	Inicio	Fases 1-4	Fases 5-6	Fases 7-8
erp-construccion	Inmediato	Análisis	Dependencias	Ejecución
erp-clinicas	Después de construcción	-	-	-
erp-mecanicas-diesel	Después de clínicas	-	-	-
erp-retail	Después de mecánicas	-	-	-
erp-vidrio-templado	Último	-	-	-

---

7. Criterios de Éxito por Proyecto

• HERENCIA-ERP-CORE.md actualizado con referencias a FASE-8
• Script de migración específico creado
• Todas las tablas aplicables propagadas
• Funciones relevantes al giro implementadas
• Seed data del giro creado
• Documentación API actualizada
• Validación de sintaxis SQL exitosa
• Validación de dependencias exitosa

---

8. Riesgos y Mitigaciones

Riesgo	Impacto	Mitigación
Conflictos de FK	Alto	Análisis de dependencias previo
Schemas duplicados	Medio	Verificar antes de crear
Datos incompatibles	Medio	Seed data específico por giro
Falta de contexto	Bajo	Documentación detallada

---

Generado: 2026-01-04 Metodología: SCRUM/SIMCO Herramienta: Claude Code