224 lines
8.4 KiB
YAML
224 lines
8.4 KiB
YAML
# =============================================================================
|
|
# 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
|
|
# =============================================================================
|