# ============================================================================= # 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"