# =============================================================================
# TRAZABILIDAD: MAI-013 - ADMINISTRACION Y SEGURIDAD
# =============================================================================
# Modulo: MAI-013 Administracion y Seguridad
# Fecha: 2025-11-25
# Version: 1.0.0
# Reutilizacion ERP Generico: 80%
# =============================================================================

metadata:
  modulo: MAI-013
  nombre: Administracion y Seguridad
  descripcion: Configuracion del sistema, parametros, logs, notificaciones y seguridad
  fecha_actualizacion: 2025-11-25
  responsable: Architecture-Analyst
  mapeo_generico: MGN-001 + MGN-012
  porcentaje_reutilizacion: 80

# =============================================================================
# REQUERIMIENTOS FUNCIONALES
# =============================================================================
requerimientos:
  - id: RF-ADMIN-001
    nombre: Configuracion de Tenant
    prioridad: P0
    estado: por_documentar
    tablas_bd:
      - auth.tenants
      - auth.companies
    endpoints_api:
      - GET /api/v1/admin/tenant
      - PATCH /api/v1/admin/tenant
      - GET /api/v1/admin/companies
      - POST /api/v1/admin/companies
    componentes_frontend:
      - TenantSettings
      - CompanySettings
      - BrandingConfig

  - id: RF-ADMIN-002
    nombre: Parametros del Sistema
    prioridad: P0
    estado: por_documentar
    endpoints_api:
      - GET /api/v1/admin/settings
      - PATCH /api/v1/admin/settings
      - GET /api/v1/admin/settings/{category}
    componentes_frontend:
      - SystemSettings
      - SettingsForm

  - id: RF-ADMIN-003
    nombre: Logs y Auditoria
    prioridad: P1
    estado: por_documentar
    endpoints_api:
      - GET /api/v1/admin/logs
      - GET /api/v1/admin/audit-trail
      - GET /api/v1/admin/audit-trail/{entity}/{id}
    componentes_frontend:
      - LogViewer
      - AuditTrail

  - id: RF-ADMIN-004
    nombre: Notificaciones
    prioridad: P1
    estado: por_documentar
    endpoints_api:
      - GET /api/v1/notifications
      - PATCH /api/v1/notifications/{id}/read
      - GET /api/v1/notifications/settings
      - PATCH /api/v1/notifications/settings
    componentes_frontend:
      - NotificationList
      - NotificationBell
      - NotificationSettings

  - id: RF-ADMIN-005
    nombre: Seguridad Avanzada
    prioridad: P2
    estado: por_documentar
    descripcion: 2FA, politicas de password, sesiones activas
    endpoints_api:
      - POST /api/v1/admin/2fa/enable
      - POST /api/v1/admin/2fa/verify
      - GET /api/v1/admin/sessions
      - DELETE /api/v1/admin/sessions/{id}
      - PATCH /api/v1/admin/password-policy
    componentes_frontend:
      - TwoFactorSetup
      - ActiveSessions
      - PasswordPolicy

# =============================================================================
# DEPENDENCIAS
# =============================================================================
dependencias:
  modulos_requeridos:
    - MAI-001
  modulos_dependientes: []  # Modulo transversal

metricas:
  total_rf: 5
  total_et: 0
  total_tablas: 2
  cobertura_documentacion: 20%
  cobertura_implementacion: 0%

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