erp-vidrio-templado-database-v2/HERENCIA-ERP-CORE.md

Herencia de Base de Datos - ERP Core -> Vidrio Templado

Fecha: 2025-12-08 Versión: 1.0 Vertical: Vidrio Templado Nivel: 2B.2

---

RESUMEN

La vertical de Vidrio Templado hereda los schemas base del ERP Core y extiende con schemas específicos del dominio de producción de vidrio.

Ubicación DDL Core: apps/erp-core/database/ddl/

---

ARQUITECTURA DE HERENCIA

┌─────────────────────────────────────────────────────────────────┐
│                        ERP CORE (Base)                          │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐   │
│  │  auth   │ │  core   │ │financial│ │inventory│ │ purchase │   │
│  │ 26 tbl  │ │ 12 tbl  │ │ 15 tbl  │ │ 15 tbl  │ │  8 tbl   │   │
│  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘   │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐                           │
│  │ sales   │ │analytics│ │ system   │                           │
│  │  6 tbl  │ │  5 tbl  │ │ 10 tbl   │                           │
│  └─────────┘ └─────────┘ └─────────┘                            │
│                        TOTAL: ~97 tablas heredadas              │
└─────────────────────────────────────────────────────────────────┘
                              │
                              │ HEREDA
                              ▼
┌─────────────────────────────────────────────────────────────────┐
│                VIDRIO TEMPLADO (Extensiones)                    │
│  ┌───────────────┐ ┌───────────────┐ ┌───────────────┐         │
│  │  production   │ │    quality    │ │    glass      │         │
│  │  management   │ │   control     │ │  inventory    │         │
│  │   (hornos)    │ │ (inspección)  │ │   (lotes)     │         │
│  └───────────────┘ └───────────────┘ └───────────────┘         │
│                   EXTENSIONES: ~25 tablas (planificadas)        │
└─────────────────────────────────────────────────────────────────┘

---

SCHEMAS HEREDADOS DEL CORE

Schema	Tablas	Uso en Vidrio Templado
auth	26	Autenticación, usuarios, roles, permisos
core	12	Partners (clientes), catálogos
financial	15	Facturas, cuentas contables
inventory	15	Base para materia prima y producto terminado
purchase	8	Compras de materiales
sales	6	Cotizaciones, órdenes de venta
analytics	5	Centros de costo
system	10	Mensajes, notificaciones

Total heredado: ~97 tablas

---

SCHEMAS ESPECÍFICOS DE VIDRIO TEMPLADO (Planificados)

1. Schema production (estimado 10+ tablas)

Propósito: Gestión de producción y hornos de templado

-- Tablas principales planificadas:
production.production_orders      -- Órdenes de producción
production.production_lines       -- Líneas de producción (hornos)
production.work_orders           -- Órdenes de trabajo
production.cutting_plans         -- Planes de corte
production.oven_schedules        -- Programación de hornos
production.temperature_logs      -- Registros de temperatura

2. Schema quality (estimado 8+ tablas)

Propósito: Control de calidad y trazabilidad

-- Tablas principales planificadas:
quality.inspections              -- Inspecciones de calidad
quality.defect_types             -- Catálogo de defectos
quality.quality_tests            -- Pruebas de calidad
quality.certifications           -- Certificaciones de producto
quality.non_conformities         -- No conformidades

3. Schema glass (estimado 7+ tablas)

Propósito: Inventario especializado de vidrio

-- Extiende: inventory schema del core
glass.glass_types                -- Tipos de vidrio
glass.glass_lots                 -- Lotes de producción
glass.glass_dimensions           -- Dimensiones estándar
glass.raw_materials              -- Materia prima

---

SPECS DEL CORE APLICABLES

Documento detallado: orchestration/00-guidelines/HERENCIA-SPECS-CORE.md

Correcciones de DDL Core (2025-12-08)

El DDL del ERP-Core fue corregido para resolver FK inválidas:

1. stock_valuation_layers: Campos journal_entry_id y journal_entry_line_id (antes account_move_*)
2. stock_move_consume_rel: Nueva tabla de trazabilidad (antes move_line_consume_rel)
3. category_stock_accounts: FK corregida a core.product_categories
4. product_categories: ALTERs ahora apuntan a schema core

SPECS Obligatorias

Spec Core	Aplicación en Vidrio Templado	SP	Estado
SPEC-SISTEMA-SECUENCIAS	Foliado de órdenes y lotes	8	✅ DDL LISTO
SPEC-VALORACION-INVENTARIO	Costeo de materia prima y producto	21	✅ DDL LISTO
SPEC-SEGURIDAD-API-KEYS-PERMISOS	Control de acceso	31	✅ DDL LISTO
SPEC-TRAZABILIDAD-LOTES-SERIES	Lotes de producción de vidrio	13	✅ DDL LISTO
SPEC-PRICING-RULES	Precios por dimensiones y tipo	8	PENDIENTE
SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN	Control de producción	13	PENDIENTE
SPEC-MAIL-THREAD-TRACKING	Historial de órdenes	13	PENDIENTE
SPEC-WIZARD-TRANSIENT-MODEL	Wizards de corte y templado	8	PENDIENTE

SPECS Opcionales

Spec Core	Decisión	Razón
SPEC-INVENTARIOS-CICLICOS	EVALUAR	Útil para materia prima
SPEC-FIRMA-ELECTRONICA-NOM151	EVALUAR	Certificados de calidad

SPECS No Aplican

Spec Core	Razón
SPEC-INTEGRACION-CALENDAR	No requiere calendario externo
SPEC-CONSOLIDACION-FINANCIERA	Negocio de una sola planta

---

ORDEN DE EJECUCIÓN DDL (Futuro)

# PASO 1: Cargar ERP Core (base)
cd apps/erp-core/database
./scripts/reset-database.sh --force

# PASO 2: Cargar extensiones de Vidrio Templado
cd apps/verticales/vidrio-templado/database
psql $DATABASE_URL -f init/00-extensions.sql
psql $DATABASE_URL -f init/01-create-schemas.sql
psql $DATABASE_URL -f init/02-production-tables.sql
psql $DATABASE_URL -f init/03-quality-tables.sql
psql $DATABASE_URL -f init/04-glass-inventory.sql

---

MAPEO DE NOMENCLATURA

Core	Vidrio Templado
core.partners	Clientes, proveedores
inventory.products	Producto terminado base
inventory.locations	Almacenes de vidrio
sales.sale_orders	Pedidos de vidrio
purchase.purchase_orders	Compras de materia prima

---

REFERENCIAS

• ERP Core DDL: apps/erp-core/database/ddl/
• ERP Core README: apps/erp-core/database/README.md
• Directivas: orchestration/directivas/
• Inventarios: orchestration/inventarios/

---

Documento de herencia oficial Última actualización: 2025-12-08