Saltar a contenido

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).