# ============================================================================= # TRAZABILIDAD: MAI-005 - CONTROL DE OBRA Y AVANCES # ============================================================================= # Modulo: MAI-005 Control de Obra y Avances # Fecha: 2025-11-25 # Version: 1.0.0 # Reutilizacion ERP Generico: 0% (100% Especifico) # ============================================================================= metadata: modulo: MAI-005 nombre: Control de Obra y Avances descripcion: Programacion, captura de avances, evidencias, bitacora y reportes fecha_actualizacion: 2025-11-25 responsable: Architecture-Analyst mapeo_generico: null # 100% especifico de construccion porcentaje_reutilizacion: 0 # ============================================================================= # REQUERIMIENTOS FUNCIONALES # ============================================================================= requerimientos: - id: RF-PROG-001 nombre: Programacion y Curva S archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/requerimientos/RF-PROG-001-programacion-curva-s.md prioridad: P0 estado: documentado descripcion: Programa maestro de obra con curva S programada especificaciones: - id: ET-PROG-001 nombre: Implementacion Programacion y Curva S tipo: backend archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/especificaciones/ET-PROG-001-implementacion-programacion-curva-s.md estado: documentado tablas_bd: - construction.programa_obra - construction.programa_actividades endpoints_api: - GET /api/v1/programas - POST /api/v1/programas - GET /api/v1/programas/{id} - GET /api/v1/programas/{id}/actividades - POST /api/v1/programas/{id}/actividades - GET /api/v1/programas/{id}/curva-s - POST /api/v1/programas/{id}/import componentes_frontend: - ProgramaList - ProgramaEditor - GanttChart - CurvaSChart - ActividadForm - WBSTree - id: RF-PROG-002 nombre: Captura de Avances Fisicos archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/requerimientos/RF-PROG-002-captura-avances-fisicos.md prioridad: P0 estado: documentado descripcion: Captura de avances por lote/departamento y concepto especificaciones: - id: ET-PROG-002 nombre: Implementacion Captura Avances tipo: backend archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/especificaciones/ET-PROG-002-implementacion-captura-avances.md estado: documentado tablas_bd: - construction.avances_obra endpoints_api: - GET /api/v1/avances - POST /api/v1/avances - GET /api/v1/avances/{id} - PATCH /api/v1/avances/{id} - POST /api/v1/avances/{id}/approve - POST /api/v1/avances/{id}/reject - GET /api/v1/lotes/{id}/avances - GET /api/v1/fraccionamientos/{id}/avances-consolidado componentes_frontend: - AvanceCapture - AvanceMobile - AvanceGrid - AvanceApproval - AvanceByLote - AvanceTimeline - id: RF-PROG-003 nombre: Evidencias y Checklists archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/requerimientos/RF-PROG-003-evidencias-checklists.md prioridad: P0 estado: documentado descripcion: Evidencias fotograficas georeferenciadas y checklists de avance especificaciones: - id: ET-PROG-003 nombre: Implementacion Evidencias y Checklists tipo: backend archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/especificaciones/ET-PROG-003-implementacion-evidencias-checklists.md estado: documentado tablas_bd: - construction.fotos_avance - construction.bitacora_obra endpoints_api: - POST /api/v1/avances/{id}/fotos - GET /api/v1/avances/{id}/fotos - DELETE /api/v1/fotos/{id} - GET /api/v1/bitacora - POST /api/v1/bitacora - GET /api/v1/bitacora/{id} componentes_frontend: - FotoUpload - FotoGallery - FotoGeoMap - BitacoraList - BitacoraForm - BitacoraTimeline - id: RF-PROG-004 nombre: Dashboard y Reportes de Avances archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/requerimientos/RF-PROG-004-dashboard-reportes-avances.md prioridad: P0 estado: documentado descripcion: Dashboard de avance fisico vs financiero y reportes oficiales especificaciones: - id: ET-PROG-004 nombre: Implementacion Dashboard y Reportes tipo: backend archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/especificaciones/ET-PROG-004-implementacion-dashboard-reportes.md estado: documentado tablas_bd: - construction.avances_obra - construction.programa_obra endpoints_api: - GET /api/v1/dashboard/avances/{fraccionamiento_id} - GET /api/v1/reportes/avance-fisico/{fraccionamiento_id} - GET /api/v1/reportes/avance-vs-programa/{fraccionamiento_id} - GET /api/v1/reportes/curva-s-real/{fraccionamiento_id} - GET /api/v1/reportes/semaforo-obra/{fraccionamiento_id} componentes_frontend: - DashboardDirector - DashboardResidente - AvanceFisicoChart - AvanceVsProgramaChart - CurvaSRealChart - SemaforoObra - ReporteExport # ============================================================================= # HISTORIAS DE USUARIO # ============================================================================= historias_usuario: - id: US-PROG-001 nombre: Crear Programa de Obra archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/historias-usuario/US-PROG-001-crear-programa-obra.md requerimientos: [RF-PROG-001] - id: US-PROG-002 nombre: Seguimiento de Curva S archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/historias-usuario/US-PROG-002-seguimiento-curva-s.md requerimientos: [RF-PROG-001] - id: US-PROG-003 nombre: Capturar Avances de Obra archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/historias-usuario/US-PROG-003-capturar-avances-obra.md requerimientos: [RF-PROG-002] - id: US-PROG-004 nombre: Aprobar Avances archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/historias-usuario/US-PROG-004-aprobar-avances.md requerimientos: [RF-PROG-002] - id: US-PROG-005 nombre: Evidencias Fotograficas archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/historias-usuario/US-PROG-005-evidencias-fotograficas.md requerimientos: [RF-PROG-003] - id: US-PROG-006 nombre: Checklists de Calidad archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/historias-usuario/US-PROG-006-checklists-calidad.md requerimientos: [RF-PROG-003] - id: US-PROG-007 nombre: Dashboard Ejecutivo archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/historias-usuario/US-PROG-007-dashboard-ejecutivo.md requerimientos: [RF-PROG-004] - id: US-PROG-008 nombre: Reportes Oficiales archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/historias-usuario/US-PROG-008-reportes-oficiales.md requerimientos: [RF-PROG-004] # ============================================================================= # ARCHIVOS SQL/RLS # ============================================================================= archivos_implementacion: - tipo: rls_policies archivo: 01-fase-alcance-inicial/MAI-005-control-obra-avances/implementacion/ET-WORK-rls-policies.sql # ============================================================================= # DEPENDENCIAS # ============================================================================= dependencias: modulos_requeridos: - MAI-001 # Autenticacion - MAI-002 # Proyectos (lotes, departamentos) - MAI-003 # Conceptos modulos_dependientes: - MAI-006 # Reportes consolidan avances - MAI-008 # Estimaciones usan avances - MAI-009 # Calidad valida avances - MAI-011 # INFONAVIT reporta avances # ============================================================================= # METRICAS DE COBERTURA # ============================================================================= metricas: total_rf: 4 total_et: 4 total_us: 8 total_tablas: 4 cobertura_documentacion: 100% cobertura_implementacion: 0% # ============================================================================= # FIN DEL ARCHIVO # =============================================================================