# Herencia de Especificaciones - ERP Core -> Construccion

**Fecha:** 2025-12-08
**Version:** 1.0
**Vertical:** Construccion
**Nivel:** 2B.2

---

## RESUMEN

Este documento define las especificaciones transversales del ERP Core que la vertical de Construccion debe heredar e implementar.

**Ubicacion specs core:** `apps/erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/`

---

## ESPECIFICACIONES A HEREDAR

### 1. SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN.md

**Prioridad:** ALTA
**Relevancia:** Gestion de proyectos de construccion

**Funcionalidades heredadas:**
- Dependencias entre tareas (Finish-to-Start, Start-to-Start, etc.)
- Burndown charts con snapshots diarios
- Calculo de fechas criticas y holguras
- Visualizacion de progreso

**Adaptacion para construccion:**
- Tareas = Partidas de obra
- Dependencias = Secuencia constructiva
- Burndown = Avance de obra vs planificado

**Modulos afectados:**
- MAI-002 (Proyectos de Construccion)
- MAI-005 (Control de Obra)

---

### 2. SPEC-MAIL-THREAD-TRACKING.md

**Prioridad:** ALTA
**Relevancia:** Tracking de cambios en documentos de obra

**Funcionalidades heredadas:**
- Decorador `@Tracked` para seguimiento de cambios
- Sistema de mensajes (mail_messages)
- Followers y notificaciones automaticas
- Actividades y recordatorios
- Chatter UI para discusiones

**Adaptacion para construccion:**
- Tracking de cambios en presupuestos
- Historial de modificaciones en partidas
- Notificaciones de aprobaciones
- Comunicacion en bitacora de obra

**Modulos afectados:**
- MAI-003 (Presupuestos)
- MAI-005 (Control de Obra)
- MAI-008 (Bitacora de Obra)
- MAE-014 (Finanzas Avanzadas)

---

### 3. SPEC-WIZARD-TRANSIENT-MODEL.md

**Prioridad:** ALTA
**Relevancia:** Asistentes para operaciones complejas

**Funcionalidades heredadas:**
- Modelos transitorios (wizard_registry)
- Wizards de un paso y multi-paso
- Operaciones masivas (batch)
- Limpieza automatica de datos temporales

**Adaptacion para construccion:**
- Wizard de creacion de estimaciones
- Wizard de aprobacion de presupuestos
- Wizard de cierre de partidas
- Wizard de generacion de reportes INFONAVIT

**Modulos afectados:**
- MAI-003 (Presupuestos)
- MAI-005 (Control de Obra)
- MAI-011 (INFONAVIT)
- MAE-014 (Finanzas)

---

### 4. SPEC-VALORACION-INVENTARIO.md

**Prioridad:** MEDIA
**Relevancia:** Valoracion de materiales de construccion

**Funcionalidades heredadas:**
- Metodos de valoracion (FIFO, Average Cost)
- Capas de valoracion (stock_valuation_layers)
- Asientos contables automaticos
- Reconciliacion de inventario

**Adaptacion para construccion:**
- Materiales de construccion
- Almacenes de obra
- Control de mermas
- Transferencias entre obras

**Modulos afectados:**
- MAI-004 (Compras y Materiales)
- MAI-006 (Almacen de Obra)

---

### 5. SPEC-TRAZABILIDAD-LOTES-SERIES.md

**Prioridad:** MEDIA
**Relevancia:** Trazabilidad de materiales criticos

**Funcionalidades heredadas:**
- Gestion de lotes (stock_lots)
- Numeros de serie
- Trazabilidad upstream/downstream
- Fechas de vencimiento

**Adaptacion para construccion:**
- Lotes de concreto (resistencia, fecha de elaboracion)
- Certificados de acero (coladas)
- Materiales con garantia
- Trazabilidad para auditorias de calidad

**Modulos afectados:**
- MAI-004 (Compras)
- MAI-006 (Almacen)
- MAI-009 (Control de Calidad)

---

### 6. SPEC-TAREAS-RECURRENTES.md

**Prioridad:** MEDIA
**Relevancia:** Tareas periodicas de supervision

**Funcionalidades heredadas:**
- Recurrencia (diaria, semanal, mensual)
- Templates ocultos
- Generacion automatica via cron
- Patrones RRULE

**Adaptacion para construccion:**
- Supervisiones periodicas de obra
- Reportes semanales de avance
- Inspecciones de seguridad
- Mantenimiento de equipos

**Modulos afectados:**
- MAI-005 (Control de Obra)
- MAI-009 (Control de Calidad)
- MAI-010 (Seguridad en Obra)

---

## ESPECIFICACIONES ADICIONALES RECOMENDADAS

Las siguientes especificaciones del core pueden ser utiles para construccion:

| Especificacion | Relevancia | Prioridad |
|----------------|------------|-----------|
| SPEC-REPORTES-FINANCIEROS.md | Estados financieros por proyecto | Media |
| SPEC-ALERTAS-PRESUPUESTO.md | Alertas de sobre-costo en partidas | Media |
| SPEC-FIRMA-ELECTRONICA-NOM151.md | Firma de contratos y estimaciones | Baja |
| SPEC-INTEGRACION-CALENDAR.md | Calendario de obra | Baja |

---

## MATRIZ DE HERENCIA

| Spec Core | Modulos Construccion | Prioridad | Estado |
|-----------|---------------------|-----------|--------|
| SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN | MAI-002, MAI-005 | ALTA | Pendiente |
| SPEC-MAIL-THREAD-TRACKING | MAI-003, MAI-005, MAI-008, MAE-014 | ALTA | Pendiente |
| SPEC-WIZARD-TRANSIENT-MODEL | MAI-003, MAI-005, MAI-011, MAE-014 | ALTA | Pendiente |
| SPEC-VALORACION-INVENTARIO | MAI-004, MAI-006 | MEDIA | Pendiente |
| SPEC-TRAZABILIDAD-LOTES-SERIES | MAI-004, MAI-006, MAI-009 | MEDIA | Pendiente |
| SPEC-TAREAS-RECURRENTES | MAI-005, MAI-009, MAI-010 | MEDIA | Pendiente |

---

## IMPLEMENTACION

### Orden Sugerido

1. **Fase 1 - Tracking y Wizards**
   - SPEC-MAIL-THREAD-TRACKING (base para tracking)
   - SPEC-WIZARD-TRANSIENT-MODEL (base para asistentes)

2. **Fase 2 - Proyectos**
   - SPEC-PROYECTOS-DEPENDENCIAS-BURNDOWN (gestion de proyectos)
   - SPEC-TAREAS-RECURRENTES (supervisiones)

3. **Fase 3 - Inventario**
   - SPEC-VALORACION-INVENTARIO (materiales)
   - SPEC-TRAZABILIDAD-LOTES-SERIES (calidad)

### Consideraciones

- Cada spec del core debe **adaptarse** a la terminologia de construccion
- Los modelos de datos deben **extender** los del core, no duplicar
- Las APIs deben **reutilizar** los servicios del core
- Los tests deben **validar** comportamiento heredado + extensiones

---

## REFERENCIAS

- Specs Core: `apps/erp-core/docs/04-modelado/especificaciones-tecnicas/transversal/`
- Gap Analysis: `apps/erp-core/orchestration/01-analisis/ANALISIS-GAPS-CONSOLIDADO.md`
- Herencia Directivas: `./HERENCIA-DIRECTIVAS.md`

---

**Documento generado por:** Requirements-Analyst
**Fecha:** 2025-12-08
**Version:** 1.0