# =============================================================================
# TRAZABILIDAD: MAI-009 - CALIDAD, POSTVENTA Y GARANTIAS
# =============================================================================
# Modulo: MAI-009 Calidad, Postventa y Garantias
# Fecha: 2025-11-25
# Version: 1.0.0
# Reutilizacion ERP Generico: 10%
# =============================================================================

metadata:
  modulo: MAI-009
  nombre: Calidad, Postventa y Garantias
  descripcion: Checklists de calidad, inspecciones, punchlists y tickets de garantia
  fecha_actualizacion: 2025-11-25
  responsable: Architecture-Analyst
  mapeo_generico: null  # Mayormente especifico
  porcentaje_reutilizacion: 10

# =============================================================================
# REQUERIMIENTOS FUNCIONALES
# =============================================================================
requerimientos:
  - id: RF-QA-001
    nombre: Checklists de Calidad
    prioridad: P0
    estado: por_documentar
    tablas_bd:
      - construction.checklists
      - construction.checklist_items
    endpoints_api:
      - GET /api/v1/checklists
      - POST /api/v1/checklists
      - GET /api/v1/checklists/{id}
      - GET /api/v1/checklists/{id}/items
      - POST /api/v1/checklists/{id}/items
    componentes_frontend:
      - ChecklistList
      - ChecklistEditor
      - ChecklistItemForm

  - id: RF-QA-002
    nombre: Inspecciones de Calidad
    prioridad: P0
    estado: por_documentar
    tablas_bd:
      - construction.inspecciones
      - construction.inspeccion_resultados
    endpoints_api:
      - GET /api/v1/inspecciones
      - POST /api/v1/inspecciones
      - GET /api/v1/inspecciones/{id}
      - POST /api/v1/inspecciones/{id}/resultados
      - POST /api/v1/inspecciones/{id}/approve
    componentes_frontend:
      - InspeccionList
      - InspeccionForm
      - InspeccionMobile
      - InspeccionResults

  - id: RF-QA-003
    nombre: Tickets de Postventa
    prioridad: P0
    estado: por_documentar
    tablas_bd:
      - construction.tickets_postventa
    endpoints_api:
      - GET /api/v1/tickets-postventa
      - POST /api/v1/tickets-postventa
      - GET /api/v1/tickets-postventa/{id}
      - PATCH /api/v1/tickets-postventa/{id}
      - POST /api/v1/tickets-postventa/{id}/resolve
    componentes_frontend:
      - TicketList
      - TicketForm
      - TicketKanban
      - TicketTimeline

  - id: RF-QA-004
    nombre: Reportes de Calidad
    prioridad: P1
    estado: por_documentar
    endpoints_api:
      - GET /api/v1/reportes/calidad/{fraccionamiento_id}
      - GET /api/v1/reportes/tickets-abiertos
      - GET /api/v1/reportes/tiempo-resolucion

# =============================================================================
# DEPENDENCIAS
# =============================================================================
dependencias:
  modulos_requeridos:
    - MAI-001
    - MAI-002
    - MAI-005
  modulos_dependientes:
    - MAI-010

metricas:
  total_rf: 4
  total_et: 0
  total_tablas: 5
  cobertura_documentacion: 25%
  cobertura_implementacion: 0%

# =============================================================================
# FIN DEL ARCHIVO
# =============================================================================
