0013. Superficie /admin con token de administración¶
Estado: Aceptado (enmendado por el ADR 0067 de identidad)
Fecha: 2026-10-30
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin) contra core-svc-identidad
Evidencia: commit 158e2c8 (2026-10-30) y las superficies listadas abajo
Nota (ADR 0067 de identidad): en la fila de Entidades,
/juridicases hoy/comerciales(/entidades/admin/comerciales). Este ADR conserva los nombres de su fecha.
Contexto¶
El panel debe administrar cualquier empresa. Los endpoints de negocio resuelven la empresa del token y aplican RLS, así que un token de administración no puede operar sobre otro tenant por esa vía: la seguridad del servicio es correcta, pero inservible para una consola global.
Decisión¶
Todo el CRUD del panel pega a rutas /admin, que solo aceptan token root y
operan con BYPASSRLS para administrar cualquier tenant. El panel no usa
endpoints de tenant.
| Recurso | Superficie |
|---|---|
| Empresas | /empresas/admin |
| Sucursales | /sucursales/admin |
| Catálogos | /catalogos/admin/* |
| Entidades | /entidades/admin (+ /personas, /juridicas, /existe/{id}) |
| Usuarios | /usuarios/admin |
| Tipos de usuario | /tipos-usuario/admin |
| Navegación | /navegacion/admin/* |
| Perfil | /usuarios/admin/perfil (+ /cambiar-password, /password-historial, /sesiones, /inicios-sesion) |
Alternativas descartadas¶
- Reutilizar los endpoints de tenant con el token de root — el RLS filtra por la empresa del token y no permite administrar cualquier tenant.
Consecuencias¶
El panel y los servicios de negocio tienen superficies de API distintas y dos tokens distintos; no se puede reutilizar una llamada del panel en un servicio de negocio. Los contratos se alinearon a la reestructuración de identidad en ese mismo commit.
Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).