erp-construccion/orchestration/inventarios/MASTER_INVENTORY.yml

858 lines
24 KiB
YAML

# =============================================================================
# MASTER INVENTORY - ERP CONSTRUCCION
# =============================================================================
# Ultima actualizacion: 2025-12-09
# SSOT: Single Source of Truth para metricas del proyecto vertical
# Base: Extiende erp-core (61% reutilizacion)
# Nomenclatura: Ver NAMING-CONVENTIONS.md
# =============================================================================
proyecto:
nombre: ERP Construccion
tipo: Vertical Especializada
giro: Construccion de Vivienda / INFONAVIT
version: 0.1.0
progreso: 35%
fase_actual: documentacion_completa
base_core: erp-core
reutilizacion_core: 61%
# =============================================================================
# CONFIGURACION DE AMBIENTE
# =============================================================================
ambiente:
rango_puertos: 3100
backend:
puerto: 3100
framework: Express.js
runtime: Node.js 20+
frontend_web:
puerto: 5174
framework: React 18 + Vite
frontend_mobile:
framework: Expo 50 + React Native 0.73
database:
puerto: 5433
motor: PostgreSQL 15 + PostGIS
redis:
puerto: 6380
minio:
puerto_api: 9100
puerto_console: 9101
# =============================================================================
# METRICAS CONSOLIDADAS
# =============================================================================
metricas:
documentacion:
archivos_totales: 408
archivos_md: 400+
directivas_especificas: 3
prompts_especializados: 3
templates: 4
modulos:
total: 18
fase_1_mai: 14
fase_2_mae: 3
fase_3_maa: 1
documentados: 18 # Todos documentados incluyendo MAA-017
ddl_implementado: 7 # construction, hr, hse, estimates, infonavit, inventory-ext, purchase-ext
backend_parcial: 4 # construction, hr, hse, core (entidades básicas)
requerimientos:
total_rf: 87 # +8 de MAA-017
fase_1: 64
fase_2: 15
fase_3: 8
especificaciones:
total_et: 78
database: 18
backend: 18
frontend: 42
user_stories:
total_us: 149 # +10 de MAA-017
story_points: 692 # +42 de MAA-017
database:
# Conteo real basado en DDL files (actualizado 2025-12-09)
schemas_implementados: 7 # construction, hr, hse, estimates, infonavit, inventory, purchase
schemas_pendientes: 0 # Todos los schemas de Fase 1 implementados
tablas_implementadas: 110 # 24 construction + 8 hr + 58 hse + 8 estimates + 8 infonavit + 4 inventory + 5 purchase
tablas_documentadas: 110 # Total alineado con DDL
enums: 89 # 22 base + 67 HSE
funciones: 13
triggers: 15
rls_policies: 110 # 1 por tabla implementada
backend:
# Estado actual del código TypeScript (actualizado 2025-12-18)
entidades_implementadas: 70 # construction(6), hr(3), hse(58), core(3)
modulos_con_codigo: 4 # construction, hr, hse, core
servicios: 14 # construction(6), hse(8)
controllers: 14 # construction(6), hse(8)
hse_implementado:
entities: 58
services: 8 # incidente, capacitacion, inspeccion, epp, stps, ambiental, permiso-trabajo, indicador
controllers: 8
estado: "COMPLETO"
fecha: "2025-12-18"
adrs:
total: 12
# =============================================================================
# MODULOS FASE 1: ALCANCE INICIAL (14 modulos)
# =============================================================================
modulos_fase_1:
- codigo: MAI-001
nombre: Fundamentos y Seguridad
estado: documentado
reutilizacion: 100%
rf: 3
et: 3
us: 8
story_points: 50
descripcion: Extiende MGN-001/002/003/004 de erp-core
ubicacion: docs/02-definicion-modulos/MAI-001-fundamentos/
schemas: [] # Usa schemas de core (auth, core_tenants)
- codigo: MAI-002
nombre: Proyectos y Estructura de Obra
estado: documentado
reutilizacion: 40%
rf: 4
et: 4
us: 9
story_points: 55
descripcion: Jerarquia proyecto/fase/manzana/lote
ubicacion: docs/02-definicion-modulos/MAI-002-proyectos-estructura/
schemas:
- construction
tablas:
- fraccionamientos
- etapas
- manzanas
- lotes
- torres
- niveles
- departamentos
- prototipos
- codigo: MAI-003
nombre: Presupuestos y Costos
estado: documentado
reutilizacion: 0%
rf: 4
et: 4
us: 8
story_points: 60
descripcion: Arbol presupuestario, partidas, conceptos
ubicacion: docs/02-definicion-modulos/MAI-003-presupuestos-costos/
schemas:
- construction
- estimates
tablas:
- conceptos
- presupuestos
- presupuesto_partidas
- codigo: MAI-004
nombre: Compras e Inventarios
estado: documentado
reutilizacion: 80%
rf: 4
et: 4
us: 8
story_points: 50
descripcion: Requisiciones, OC, almacenes
ubicacion: docs/02-definicion-modulos/MAI-004-compras-inventarios/
schemas:
- purchase
- inventory
tablas:
- almacenes_proyecto
- requisiciones_obra
- requisicion_lineas
- consumos_obra
- purchase_order_construction
- supplier_construction
- comparativo_cotizaciones
- comparativo_proveedores
- comparativo_productos
- codigo: MAI-005
nombre: Control de Obra
estado: documentado
reutilizacion: 0%
rf: 4
et: 4
us: 8
story_points: 60
descripcion: Avances fisicos, financieros, recursos
ubicacion: docs/02-definicion-modulos/MAI-005-control-obra/
schemas:
- construction
tablas:
- programa_obra
- programa_actividades
- avances_obra
- fotos_avance
- bitacora_obra
- codigo: MAI-006
nombre: Reportes y Analytics
estado: documentado
reutilizacion: 60%
rf: 4
et: 4
us: 8
story_points: 40
descripcion: Dashboards, reportes ejecutivos
ubicacion: docs/02-definicion-modulos/MAI-006-reportes-analytics/
schemas: [] # Sin schema propio, usa vistas
- codigo: MAI-007
nombre: RRHH y Asistencias
estado: documentado
reutilizacion: 50%
rf: 6
et: 6
us: 8
story_points: 45
descripcion: Personal, cuadrillas, biometrico, destajo
ubicacion: docs/02-definicion-modulos/MAI-007-rrhh-asistencias/
schemas:
- hr
tablas:
- employee_construction
- asistencias
- asistencia_biometrico
- geocercas
- destajo
- destajo_detalle
- cuadrillas
- cuadrilla_miembros
apps_moviles:
- checador_biometrico
- capataz
- codigo: MAI-008
nombre: Estimaciones y Facturacion
estado: documentado
reutilizacion: 20%
rf: 5
et: 5
us: 8
story_points: 50
descripcion: Estimaciones, anticipos, retenciones
ubicacion: docs/02-definicion-modulos/MAI-008-estimaciones-facturacion/
directiva: DIRECTIVA-ESTIMACIONES.md
schemas:
- estimates
tablas:
- estimaciones
- estimacion_conceptos
- generadores
- anticipos
- amortizaciones
- retenciones
- fondo_garantia
- estimacion_workflow
- codigo: MAI-009
nombre: Calidad y Postventa
estado: documentado
reutilizacion: 10%
rf: 5
et: 5
us: 8
story_points: 40
descripcion: Inspecciones, no conformidades, garantias
ubicacion: docs/02-definicion-modulos/MAI-009-calidad-postventa/
schemas:
- construction
tablas:
- checklists
- checklist_items
- inspecciones
- inspeccion_resultados
- tickets_postventa
- codigo: MAI-010
nombre: CRM Derechohabientes
estado: documentado
reutilizacion: 40%
rf: 5
et: 5
us: 8
story_points: 45
descripcion: Prospectos, clientes INFONAVIT
ubicacion: docs/02-definicion-modulos/MAI-010-crm-derechohabientes/
schemas:
- infonavit
tablas:
- derechohabientes
apps_moviles:
- app_derechohabiente
- codigo: MAI-011
nombre: Integracion INFONAVIT
estado: documentado
reutilizacion: 0%
rf: 5
et: 5
us: 8
story_points: 45
descripcion: COFINAVIT, registro obra, cumplimiento
ubicacion: docs/02-definicion-modulos/MAI-011-infonavit/
directiva: DIRECTIVA-INTEGRACION-INFONAVIT.md
schemas:
- infonavit
tablas:
- registro_infonavit
- oferta_vivienda
- asignacion_vivienda
- actas
- acta_viviendas
- reportes_infonavit
- historico_puntos
- codigo: MAI-012
nombre: Contratos y Subcontratos
estado: documentado
reutilizacion: 20%
rf: 5
et: 5
us: 8
story_points: 45
descripcion: Contratos obra, destajo, subcontratistas
ubicacion: docs/02-definicion-modulos/MAI-012-contratos-subcontratos/
schemas:
- construction
tablas:
- subcontratistas
- contratos
- contrato_partidas
- codigo: MAI-013
nombre: Administracion
estado: documentado
reutilizacion: 80%
rf: 5
et: 5
us: 8
story_points: 40
descripcion: CxC, CxP, tesoreria basica
ubicacion: docs/02-definicion-modulos/MAI-013-administracion/
schemas: [] # Usa core financial
- codigo: MAI-018
nombre: Preconstruccion y Licitaciones
estado: documentado
reutilizacion: 10%
rf: 5
et: 5
us: 8
story_points: 45
descripcion: Estudios previos, licitaciones, propuestas
ubicacion: docs/02-definicion-modulos/MAI-018-preconstruccion-licitaciones/
schemas: [] # Pendiente definicion
# =============================================================================
# MODULOS FASE 2: ENTERPRISE (3 modulos)
# =============================================================================
modulos_fase_2:
- codigo: MAE-014
nombre: Finanzas y Controlling
estado: documentado
reutilizacion: 70%
rf: 5
et: 5
us: 11
story_points: 80
descripcion: Contabilidad, centro costos, consolidacion
ubicacion: docs/02-definicion-modulos/MAE-014-finanzas-controlling/
schemas: [] # Usa core financial
- codigo: MAE-015
nombre: Activos y Maquinaria
estado: documentado
reutilizacion: 30%
rf: 5
et: 5
us: 8
story_points: 70
descripcion: Control maquinaria, mantenimiento
ubicacion: docs/02-definicion-modulos/MAE-015-activos-maquinaria/
schemas:
- assets # Pendiente DDL
- codigo: MAE-016
nombre: Gestion Documental (DMS)
estado: documentado
reutilizacion: 50%
rf: 5
et: 5
us: 7
story_points: 60
descripcion: Versionado, workflows, aprobaciones
ubicacion: docs/02-definicion-modulos/MAE-016-gestion-documental/
schemas:
- documents # Pendiente DDL
# =============================================================================
# MODULOS FASE 3: AVANZADA (1 modulo)
# =============================================================================
modulos_fase_3:
- codigo: MAA-017
nombre: Seguridad HSE
estado: implementado_completo # DDL + Backend completo
reutilizacion: 20%
rf: 8
et: 7
us: 10
story_points: 42
descripcion: Seguridad industrial, salud ocupacional, medio ambiente
ubicacion: docs/02-definicion-modulos/MAA-017-seguridad-hse/
ddl: database/schemas/03-hse-schema-ddl.sql
backend:
ubicacion: src/modules/hse/
entities: 58
services:
- IncidenteService # RF-MAA017-001
- CapacitacionService # RF-MAA017-002
- InspeccionService # RF-MAA017-003
- EppService # RF-MAA017-004
- StpsService # RF-MAA017-005
- AmbientalService # RF-MAA017-006
- PermisoTrabajoService # RF-MAA017-007
- IndicadorService # RF-MAA017-008
controllers:
- IncidenteController
- CapacitacionController
- InspeccionController
- EppController
- StpsController
- AmbientalController
- PermisoTrabajoController
- IndicadorController
fecha_implementacion: "2025-12-18"
typescript_status: "compila_sin_errores"
schemas:
- hse
tablas_por_rf:
RF-MAA017-001: # Gestion Incidentes
- incidentes
- incidente_involucrados
- incidente_investigacion
- incidente_acciones
- incidente_evidencias
RF-MAA017-002: # Capacitaciones
- capacitaciones
- capacitacion_matriz
- instructores
- capacitacion_sesiones
- capacitacion_asistentes
- constancias_dc3
RF-MAA017-003: # Inspecciones
- tipos_inspeccion
- checklist_items
- programa_inspecciones
- inspecciones
- inspeccion_evaluaciones
- hallazgos
- hallazgo_evidencias
RF-MAA017-004: # EPP
- epp_catalogo
- epp_matriz_puesto
- epp_asignaciones
- epp_inspecciones
- epp_bajas
- epp_inventario
- epp_movimientos
RF-MAA017-005: # STPS
- normas_stps
- norma_requisitos
- cumplimiento_obra
- comision_seguridad
- comision_integrantes
- comision_recorridos
- programa_seguridad
- programa_actividades
- documentos_stps
- auditorias
RF-MAA017-006: # Ambiental
- residuos_catalogo
- residuos_generacion
- almacen_temporal
- proveedores_ambientales
- manifiestos_residuos
- manifiesto_detalle
- impacto_ambiental
- quejas_ambientales
RF-MAA017-007: # Permisos
- tipos_permiso_trabajo
- permisos_trabajo
- permiso_personal
- permiso_autorizaciones
- permiso_checklist
- permiso_monitoreos
- permiso_eventos
- permiso_documentos
RF-MAA017-008: # Indicadores
- indicadores_config
- indicadores_meta_obra
- indicadores_valores
- horas_trabajadas
- dias_sin_accidente
- reportes_programados
- alertas_indicadores
total_tablas: 58
total_enums: 67
# =============================================================================
# APPS MOVILES
# =============================================================================
apps_moviles:
total: 5
framework: React Native 0.73 + Expo 50
offline_first: true
biometria: true
apps:
- id: MOB-001
nombre: App Checador Biometrico
perfil: checador
modulo: MAI-007
funcionalidades:
- registro_asistencia
- reconocimiento_facial
- huella_dactilar
- geolocalizacion
estado: documentado
- id: MOB-002
nombre: App Almacenista
perfil: almacenista
modulo: MAI-004
funcionalidades:
- recepcion_materiales
- movimientos_inventario
- escaneo_codigos
- conteos_fisicos
estado: documentado
- id: MOB-003
nombre: App Supervisor de Obra
perfil: supervisor
modulo: MAI-005
funcionalidades:
- captura_avances
- fotos_evidencia
- inspeccion_calidad
- bitacora_diaria
estado: documentado
- id: MOB-004
nombre: App Capataz/Cuadrilla
perfil: capataz
modulo: MAI-007
funcionalidades:
- registro_cuadrilla
- control_destajo
- asignacion_trabajo
- reporte_productividad
estado: documentado
- id: MOB-005
nombre: App Derechohabiente
perfil: cliente
modulo: MAI-010
funcionalidades:
- consulta_avance_vivienda
- solicitud_inspeccion
- carga_documentos
- contacto_soporte
estado: documentado
# =============================================================================
# SCHEMAS DE BASE DE DATOS (NOMENCLATURA UNIFICADA)
# =============================================================================
# Ver: NAMING-CONVENTIONS.md para detalles completos
schemas:
# Schemas especificos de construccion
- nombre: construction
descripcion: Proyectos, estructura obra, avances, calidad, contratos
tablas: 24
tipo: especifico
ddl: construction-schema-ddl.sql
modulos: [MAI-002, MAI-003, MAI-005, MAI-009, MAI-012]
- nombre: estimates
descripcion: Presupuestos, estimaciones, anticipos, retenciones
tablas: 8
tipo: especifico
ddl: estimates-schema-ddl.sql
modulos: [MAI-003, MAI-008]
- nombre: infonavit
descripcion: Integracion INFONAVIT, RUV, derechohabientes
tablas: 8
tipo: especifico
ddl: infonavit-schema-ddl.sql
modulos: [MAI-010, MAI-011]
# Schemas de extension (extienden ERP Core)
- nombre: hr
descripcion: Extension RRHH - asistencias, destajo, cuadrillas
tablas: 8
tipo: extension
ddl: hr-ext-schema-ddl.sql
modulos: [MAI-007]
extiende: core.hr
- nombre: inventory
descripcion: Extension Inventario - almacenes obra, requisiciones
tablas: 4
tipo: extension
ddl: inventory-ext-schema-ddl.sql
modulos: [MAI-004]
extiende: core.inventory
- nombre: purchase
descripcion: Extension Compras - OC construccion, comparativos
tablas: 5
tipo: extension
ddl: purchase-ext-schema-ddl.sql
modulos: [MAI-004]
extiende: core.purchase
# Schemas pendientes (Fase 2-3)
- nombre: assets
descripcion: Activos, maquinaria, mantenimiento
tablas: 0
tipo: especifico
ddl: pendiente
modulos: [MAE-015]
estado: pendiente
- nombre: documents
descripcion: DMS, versionado, workflows
tablas: 0
tipo: extension
ddl: pendiente
modulos: [MAE-016]
estado: pendiente
- nombre: hse
descripcion: Seguridad industrial, salud ocupacional, medio ambiente
tablas: 58
enums: 67
tipo: especifico
ddl: 03-hse-schema-ddl.sql
modulos: [MAA-017]
estado: implementado
requerimientos:
- RF-MAA017-001 # Gestion Incidentes (5 tablas)
- RF-MAA017-002 # Capacitaciones (6 tablas)
- RF-MAA017-003 # Inspecciones (7 tablas)
- RF-MAA017-004 # EPP (7 tablas)
- RF-MAA017-005 # STPS (11 tablas)
- RF-MAA017-006 # Ambiental (9 tablas)
- RF-MAA017-007 # Permisos (8 tablas)
- RF-MAA017-008 # Indicadores (6 tablas)
# =============================================================================
# NOMENCLATURA DEPRECADA (NO USAR)
# =============================================================================
schemas_deprecados:
- project_management: "usar 'construction'"
- financial_management: "usar 'estimates'"
- hr_management: "usar 'hr'"
- purchasing_management: "usar 'purchase'"
- construction_management: "usar 'construction'"
- quality_management: "integrado en 'construction'"
- contract_management: "integrado en 'construction'"
- crm_management: "integrado en 'infonavit'"
- infonavit_management: "usar 'infonavit'"
- assets_management: "usar 'assets'"
- documents_management: "usar 'documents'"
# =============================================================================
# DIRECTIVAS ESPECIFICAS
# =============================================================================
directivas:
- id: DIR-CONST-001
nombre: DIRECTIVA-INTEGRACION-INFONAVIT.md
alcance: MAI-011
descripcion: Reglas integracion programas INFONAVIT
- id: DIR-CONST-002
nombre: DIRECTIVA-CONTROL-OBRA.md
alcance: MAI-002, MAI-005, MAI-012
descripcion: Jerarquia proyectos, avances, recursos
- id: DIR-CONST-003
nombre: DIRECTIVA-ESTIMACIONES.md
alcance: MAI-008
descripcion: Workflow estimaciones, deducciones
# =============================================================================
# PROMPTS DE AGENTES
# =============================================================================
prompts:
- nombre: PROMPT-CONSTRUCCION-BACKEND-AGENT.md
alcance: Backend MAI-*
especialidad: Node.js, Express, TypeScript
- nombre: PROMPT-CONSTRUCCION-DATABASE-AGENT.md
alcance: Schemas PostgreSQL
especialidad: DDL, RLS, PostGIS
- nombre: PROMPT-CONSTRUCCION-FRONTEND-AGENT.md
alcance: Web y Mobile
especialidad: React, Vite, React Native
# =============================================================================
# ESTADO DE AGENTES
# =============================================================================
agentes:
activos:
- nombre: NEXUS-BACKEND
estado: disponible
tareas_completadas: 1
tareas_pendientes: 5
- nombre: NEXUS-FRONTEND
estado: disponible
tareas_completadas: 1
tareas_pendientes: 4
- nombre: NEXUS-DATABASE
estado: disponible
tareas_completadas: 1
tareas_pendientes: 4
inactivos:
- nombre: NEXUS-INTEGRATION
estado: inactivo
razon: Pendiente documentacion APIs INFONAVIT
subagentes:
activos: 0
max: 15
# =============================================================================
# HITOS Y PROGRESO
# =============================================================================
hitos:
completados:
- nombre: Documentacion RF
fecha: 2025-11-24
descripcion: 79 RF documentados para 17 modulos
- nombre: Documentacion ET
fecha: 2025-11-24
descripcion: 78 ET documentadas (DB, Backend, Frontend)
- nombre: Documentacion US
fecha: 2025-11-24
descripcion: 139 US con criterios de aceptacion
- nombre: Indices Consolidados
fecha: 2025-12-05
descripcion: Indices RF y US creados
- nombre: Inventarios YAML
fecha: 2025-12-06
descripcion: Inventarios alineados con erp-core
- nombre: Nomenclatura Unificada
fecha: 2025-12-06
descripcion: NAMING-CONVENTIONS.md creado, schemas consolidados
- nombre: DDL HSE Completo
fecha: 2025-12-09
descripcion: 58 tablas + 67 enums HSE implementados
- nombre: Backend HSE Completo
fecha: 2025-12-18
descripcion: 8 services + 8 controllers + 58 entities TypeScript
pendientes:
- nombre: Implementacion Fase 1
descripcion: Sprint 0-14
- nombre: TRACEABILITY.yml por modulo
descripcion: Post-implementacion
# =============================================================================
# PROXIMA ACCION
# =============================================================================
proxima_accion:
tarea: Iniciar implementacion Sprint 0
modulos: MAI-001, MAI-002
prerequisitos:
- Setup ambiente desarrollo
- Migracion DDL inicial
- Configuracion multi-tenant
# =============================================================================
# VALIDACION DDL (2025-12-09)
# =============================================================================
validacion_ddl:
fecha: "2025-12-09"
estado: "✅ COMPLETO - Alineado con erp-core"
compatible_erp_core: true
total_archivos_ddl: 5
ddl_files:
- archivo: "01-construction-schema-ddl.sql"
tablas: 24
estado: "implementado"
- archivo: "02-hr-schema-ddl.sql"
tablas: 8
estado: "implementado"
- archivo: "03-hse-schema-ddl.sql"
tablas: 58
estado: "implementado"
- archivo: "04-estimates-schema-ddl.sql"
tablas: 8
estado: "implementado"
- archivo: "05-infonavit-schema-ddl.sql"
tablas: 8
estado: "implementado"
- archivo: "06-inventory-ext-schema-ddl.sql"
tablas: 4
estado: "implementado"
- archivo: "07-purchase-ext-schema-ddl.sql"
tablas: 5
estado: "implementado"
alineacion_erp_core:
rls_variable: "app.current_tenant_id"
fk_tenants: "auth.tenants"
fk_users: "auth.users"
prerequisitos_verificados: true
nota: "Todos los DDL verificados y alineados con erp-core. Variable RLS corregida a app.current_tenant_id"
# =============================================================================
# METADATA
# =============================================================================
metadata:
creado_por: Requirements-Analyst
fecha_creacion: 2025-12-06
ultima_actualizacion: 2025-12-18
version_documento: 1.4.0
cambios_version:
- "1.4.0: HSE Backend completo - 8 services + 8 controllers implementados (2025-12-18)"
- "1.4.0: 58 entidades HSE validadas TypeScript"
- "1.4.0: MAA-017 estado actualizado a implementado_completo"
- "1.3.0: DDL completo - 7 schemas, 110 tablas implementadas (2025-12-09)"
- "1.3.0: Nuevos DDL: estimates, infonavit, inventory-ext, purchase-ext"
- "1.3.0: Variable RLS corregida a app.current_tenant_id (alineado erp-core)"
- "1.2.0: Validacion DDL completada - 50 FK corregidas (2025-12-08)"
- "1.2.0: Prerequisitos DDL actualizados para ERP-Core"
- "1.1.0: Nomenclatura de schemas unificada segun NAMING-CONVENTIONS.md"