Saltar al contenido principal

SOL-002 Aprobación Multinivel (Fase 2)

Implementación completa de la aprobación multinivel: cadenas configurables por monto/categoría/área, trazabilidad por nivel, notificación al siguiente aprobador y bloqueo de despacho sin todas las aprobaciones.

Qué cambió y por qué​

La aprobación era de un solo nivel (id_aprobador sin historial). Ahora cada solicitud resuelve su cadena al crearse (1–3 niveles), cada decisión queda registrada con usuario/fecha/comentario, se notifica al siguiente rol y el despacho exige la cadena completa.

Impacto​

  • Solicitudes baratas (<1M): 1 nivel (sin fricción nueva).
  • Medias (1–5M): 2 niveles; altas (≥5M): 3 niveles.
  • Emergencias: 1 nivel (vía rápida).
  • Históricas: siguen con 1 nivel y flujo intacto.

Archivos clave​

  • Backend: src/domains/aprobaciones/ (entidades, DTOs, servicio, controlador, módulo), src/database/migrations/015-create-aprobacion-multinivel.ts, src/domains/solicitudes/solicitudes.service.ts (aplicarCadenaAprobacion, aprobarNivel, rechazarNivel, guard RF-05 en updateEstado), solicitudes.controller.ts (aprobar-nivel, rechazar-nivel), app.module.ts.
  • Frontend: src/api/aprobaciones.ts, src/components/requests/approval-timeline.tsx, request-detail.tsx (timeline + bloqueo), src/models/request.entity.ts.
  • Framework: ARCHITECTURE.md (ADR-013), DATABASE_SCHEMA.md (§7, relaciones, reglas, historial, migraciones).
  • Manual: docs/manuales/solicitudes/aprobacion-multinivel.md.

Verificación​

  • npx tsc --noEmit EXIT 0 (api + web).
  • migration:run → 015 aplicada (2 tablas + 3 columnas + 3 reglas semilla).
  • npm test solicitudes + aprobaciones → 30/30 verdes (5 nuevos de resolución de reglas).