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