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_idsobre(empresa_id, aplicacion_id)WHERE deleted_at IS NULL. - Desvincular = borrado lógico:
deleted_at = now()eis_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) ocreada. 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_nonesobre filas que incluyan borradas.