226 lines
5.9 KiB
Markdown
226 lines
5.9 KiB
Markdown
# 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
|