# 0002 — Permisos por ítems de menú y acciones

- **Estado:** Aceptada (`PR-02`, 11/11/2026)
- **Fecha:** 11/11/2026
- **Registro:** `docs/revisiones/20261111-02_propuesta-implementacion.md`

## Contexto

Las fuentes dicen dos cosas a la vez:

- El principal define los roles como **conjuntos configurables de ítems de
  menú**, y permite sumar ítems sueltos a un usuario.
- `HR - HojasDeRuta.md`, `RoldeUsuarios.md` y el principal asignan cada
  **acción** a un rol por su nombre: "lo hace un usuario con rol supervisor".

Si las acciones se controlan por el nombre del rol, un rol nuevo creado por el
administrador no podría hacer nada más que ver pantallas, y los ítems
adicionales de un usuario no le darían acciones.

## Opciones

| | Roles fijos en el código | Ítems de menú + roles fijos para acciones | Ítems de menú y acciones (permisos) |
|---|---|---|---|
| Roles configurables (principal) | No | Solo para el menú | Sí |
| Ítems adicionales por usuario | No | Solo para el menú | Sí |
| Complejidad | Baja | Media; dos mecanismos | Media; uno solo |

## Decisión

Un solo mecanismo de **permisos**:

- Un catálogo fijo, definido en el código, de **pantallas** (lo que forma el
  menú, agrupado en submenús) y **acciones** (por ejemplo, `hr.cerrar`,
  `hr.retroceder`, `op.tomar`, `ds.crear`).
- Un **rol** es un código y un conjunto de pantallas y acciones; lo mantiene
  el administrador.
- Un **usuario** tiene uno o más roles y, además, pantallas o acciones
  adicionales.
- El servidor verifica el permiso concreto en cada acción, nunca el nombre del
  rol.
- El seed carga los 5 roles de `RoldeUsuarios.md` (Preparación, Despacho,
  Recepción, Supervisor, Administrador) con los permisos que las fuentes les
  dan.

## Consecuencias

- Cada regla "lo hace el rol X" se traduce en una acción del catálogo,
  asignada al rol X en el seed. El cliente puede después redistribuirlas.
- La pantalla de permisos (`RF-05`) muestra, para un usuario, los permisos
  heredados de sus roles y deja marcar los adicionales.
- La visibilidad por sucursal y depósito (`RN-04`) es aparte: no depende del
  rol, salvo la excepción de los supervisores de la sucursal 10 (`PR-21`).