rckrdmrd/erp-construccion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1b19b82073
erp-construccion/orchestration/00-guidelines/HERENCIA-SPECS-ERP-CORE.md

5.9 KiB
Raw Blame History

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