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