Saltar a contenido

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 .../aplicaciones lista las cat_aplicaciones activas habilitadas, ordenadas por nombre. Empresa inexistente o inactiva → 404 «Empresa no encontrada». El JOIN vive en el repository, que cruza rel_empresa_aplicacion con cat_aplicaciones del dominio navegación (sólo lectura, como el resto de las referencias entre dominios).
  • POST .../aplicaciones habilita una aplicación con body {"aplicacion_id": uuid} → 201 con 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 CatAplicacionesRead del dominio navegación (no se duplica); la relación creada se proyecta con el RelEmpresaAplicacionRead ya existente. RelEmpresaAplicacionCreate tipa el body.
  • Nuevas excepciones del service siguiendo el patrón de nombres del dominio: EmpresaNoEncontradaError, AplicacionNoEncontradaError, RelacionAplicacionDuplicadaError y RelacionAplicacionNoEncontradaError.

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 AuditMixin y el patrón de borrado lógico de todos los slices del servicio.
  • Continuar con el estilo None del 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 predicado deleted_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 con IntegrityError en la base. Es la misma limitación que arrastran rel_usuario_empresa (ADR 0028) y rel_usuario_sucursal (ADR 0032) y queda para un slice futuro: una migración que reemplace el constraint por un índice único parcial con deleted_at IS NULL, como ya hace rel_usuario_accion (ADR 0029).
  • OpenAPI del servicio suma 3 endpoints bajo /api/v1/empresas.
  • EmpresaRepository, EmpresaService y el router de empresas suman métodos y el repository empieza a cruzar el dominio navegación (sólo lectura); schemas.py agrega RelEmpresaAplicacionCreate y CatAplicacionesRead del dominio navegación queda como contrato de lectura compartido.