Saltar a contenido

0060. rel_empresa_aplicacion conserva historial (único parcial)

Estado: Aceptado Fecha: 2026-11-05 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/empresas/, app/domains/navegacion/, alembic/versions/, tests/, docs/adr/

Contexto

rel_empresa_aplicacion tenía un UNIQUE(empresa_id, aplicacion_id) total. Desvincular una aplicación (ADR 0033) es un borrado lógico, así que volver a vincularla chocaba con la fila borrada y terminaba en un IntegrityError (500). El ADR 0059 lo esquivaba reactivando la fila borrada, pero eso mezcla la historia de la vinculación con su estado actual. rel_usuario_accion ya resolvió el mismo problema con índices únicos parciales.

Decisión

Se aplica el mismo criterio que rel_usuario_accion:

  • El único pasa a ser el índice único parcial uq_rel_empresa_aplicacion_empresa_id sobre (empresa_id, aplicacion_id) WHERE deleted_at IS NULL.
  • Desvincular = borrado lógico: deleted_at = now() e is_activo = false.
  • Vincular sin fila vigente (no borrada) inserta una fila nueva; las borradas quedan como historia y nunca se reactivan.
  • Pausada = fila vigente con is_activo = false: vincular la reactiva (is_activo = true), sin insertar.
  • Vincular con una fila vigente y activa responde 409, como hasta ahora.
  • asegurar_aplicacion_habilitada (navegación) sigue las mismas reglas: existente (vigente y activa), reactivada (sólo pausada) o creada. Las consultas ignoran las filas borradas, de las que ahora puede haber varias.

Ninguna tabla referencia rel_empresa_aplicacion.id; los módulos, menús, acciones y permisos dependen de (empresa_id, aplicacion_id), por lo que al volver a vincular reaparecen solos.

Nuevo endpoint administrativo para el panel: GET /api/v1/empresas/admin/{empresa_id}/aplicaciones/vinculos, que lista las relaciones no borradas de la empresa (activas y pausadas) con aplicacion_id e is_activo.

La migración 20261105_001 reemplaza el único total por el parcial. Falla con un error claro si hubiera duplicados entre filas vigentes. El downgrade vuelve al único total sólo si ningún par tiene más de una fila; de lo contrario falla.

Consecuencias

  • Re-vincular tras desvincular funciona y se conserva la historia.
  • Esta decisión reemplaza lo dicho en el ADR 0059 sobre reactivar filas borradas.
  • Pueden existir varias filas borradas por par: ninguna consulta debe usar scalar_one_or_none sobre filas que incluyan borradas.