Saltar a contenido

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, /juridicas es 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).