0012. Usuarios con root protegido y permisos por acción¶
Estado: Aceptado
Fecha: 2026-10-27
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin): dominio usuarios y permisos
Evidencia: commits 36e7093 (2026-10-27, usuarios) y a7ff402 (2026-11-04, permisos)
Contexto¶
El panel crea usuarios de cualquier empresa y les asigna permisos sobre la
navegación de cada tenant. El usuario root es la cuenta de administración
global y no puede tratarse como un usuario común. Un modelo de permisos por rol
obligaría a crear un rol nuevo por cada combinación de acciones y empresas.
Decisión¶
/usuarios/admin gestiona tipo, entidad, contraseña temporal y empresas
asignadas; root no se crea, ni se edita, ni se elimina. Los permisos son
acciones directas por empresa: se consultan en /acciones?empresa_id y se
guardan con un PUT que envía el conjunto final. El árbol se valida en el
backend (/permisos/empresas, /permisos/arbol); los nodos no-hoja son solo
atajos de selección y nunca se envían.
| Uso | Superficie |
|---|---|
| Usuarios | /usuarios/admin |
| Acciones de una empresa | GET /acciones?empresa_id |
| Guardar permisos | PUT con el conjunto final |
| Validación del árbol | /permisos/empresas, /permisos/arbol |
Alternativas descartadas¶
- Permisos por rol — un rol fijo no expresa la combinación de acciones que cada empresa necesita y obliga a crear roles nuevos por cada variación.
Consecuencias¶
Guardar siempre el conjunto final evita deltas y hace la operación idempotente; a
cambio, el cliente debe conocer el estado completo antes de enviar. root queda
fuera del CRUD, lo que impide bloquear la administración global desde la propia
UI.
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).