0033. CRUD de aplicaciones de la empresa (rel_empresa_aplicacion)¶
Estado: Aceptado Fecha: 2026-09-30 Autor: Duval Alcivar Módulo(s) afectado(s): app/domains/empresas/, tests/unit/empresas/, docs/adr/
Contexto¶
mae_empresas (ADR 0016) y cat_aplicaciones (ADR 0020) ya existen, y también
la tabla que las relaciona: rel_empresa_aplicacion vino migrada desde las
tablas iniciales, con empresa_id (FK a mae_empresas), aplicacion_id (FK a
cat_aplicaciones), un UNIQUE(empresa_id, aplicacion_id) y RLS. Lo que falta
es la API para administrar qué aplicaciones tiene habilitadas cada empresa:
exactamente el mismo hueco que cerraron los ADR 0028 y 0032 para las relaciones
del usuario, pero con la empresa como sujeto.
Decisión¶
Se implementa el CRUD de las aplicaciones de la empresa bajo
/api/v1/empresas/{empresa_id}/aplicaciones, replicando el patrón de los
slices de relación del dominio usuarios (ADR 0028 y 0032):
router -> service -> repository (ADR 0001 transversal), reutilizando
EmpresaRepository, EmpresaService y el router del CRUD de empresas
(ADR 0016):
GET .../aplicacioneslista lascat_aplicacionesactivas habilitadas, ordenadas por nombre. Empresa inexistente o inactiva →404«Empresa no encontrada». ElJOINvive en el repository, que cruzarel_empresa_aplicacionconcat_aplicacionesdel dominio navegación (sólo lectura, como el resto de las referencias entre dominios).POST .../aplicacioneshabilita una aplicación con body{"aplicacion_id": uuid}→201con la relación creada. Validaciones en orden: empresa inexistente o inactiva →404«Empresa no encontrada»; aplicación inexistente o inactiva →404«Aplicación no encontrada»; relación activa ya existente →409«La empresa ya tiene habilitada esa aplicación».DELETE .../aplicaciones/{aplicacion_id}deshabilita con borrado lógico (deleted_at+is_activo = False) →204. Empresa inexistente →404; relación inexistente o ya inactiva →404«La empresa no tiene habilitada esa aplicación».- El contrato de lectura reutiliza
CatAplicacionesReaddel dominio navegación (no se duplica); la relación creada se proyecta con elRelEmpresaAplicacionReadya existente.RelEmpresaAplicacionCreatetipa el body. - Nuevas excepciones del service siguiendo el patrón de nombres del dominio:
EmpresaNoEncontradaError,AplicacionNoEncontradaError,RelacionAplicacionDuplicadaErroryRelacionAplicacionNoEncontradaError.
El sujeto es la empresa, no la aplicación, por simetría con
rel_usuario_empresa (ADR 0028) y rel_usuario_sucursal (ADR 0032): la
relación cuelga de /empresas/{id} como un sub-recurso. La ruta inversa
(/aplicaciones/{id}/empresas) rompería esa simetría sin aportar casos de uso:
el consumidor conoce a la empresa y pide sus aplicaciones.
El slice usa excepciones propias y no el estilo None del CRUD de empresas
a propósito. El CRUD devuelve None para «no encontrado» y el router lo
traduce, porque sus operaciones tienen un solo motivo de no-encontrado; la
relación, en cambio, tiene tres motivos distintos (empresa, aplicación o
relación inexistente, y duplicado) que deben traducirse a códigos HTTP
distintos (404 vs 409). Lanzar excepciones tipadas es el patrón que ya
fijaron los ADR 0028 y 0032, y deja el router con try/except explícito en
lugar de None ambiguos.
Alternativas descartadas¶
- Router, service y repository propios para la relación — el slice es un sub-recurso de la empresa y comparte validaciones y repository con el CRUD de empresas; tres clases más por capa no aportan aislamiento y sí duplican la armada de dependencias (misma razón que en los ADR 0028 y 0032).
- Colgar las rutas del router de navegación — invertiría el sujeto: el CRUD de navegación (ADR 0020) ya administra el catálogo de aplicaciones y la relación es de la empresa; además duplicaría las validaciones de empresa en otro router.
- Deshabilitar borrando la fila — rompería el calendario de auditoría del
AuditMixiny el patrón de borrado lógico de todos los slices del servicio. - Continuar con el estilo
Nonedel CRUD de empresas — no permitiría distinguir los tres motivos de error de la relación sin inspeccionar el estado, y rompería la simetría con los slices de relación del dominio usuarios.
Consecuencias¶
- Limitación conocida:
UNIQUE(empresa_id, aplicacion_id)es un constraint plano, sin predicadodeleted_at IS NULL. Tras deshabilitar una aplicación (borrado lógico), la fila inactiva sigue ocupando el par en el UNIQUE, así que rehabilitarla reventaría conIntegrityErroren la base. Es la misma limitación que arrastranrel_usuario_empresa(ADR 0028) yrel_usuario_sucursal(ADR 0032) y queda para un slice futuro: una migración que reemplace el constraint por un índice único parcial condeleted_at IS NULL, como ya hacerel_usuario_accion(ADR 0029). - OpenAPI del servicio suma 3 endpoints bajo
/api/v1/empresas. EmpresaRepository,EmpresaServicey el router de empresas suman métodos y el repository empieza a cruzar el dominio navegación (sólo lectura);schemas.pyagregaRelEmpresaAplicacionCreateyCatAplicacionesReaddel dominio navegación queda como contrato de lectura compartido.