Permisos y políticas
Enum de permisos
Sección titulada «Enum de permisos»Los permisos viven en app/Enums/Permissions/CashboxPermission.php. La clave del módulo es cashbox. Siempre se consultan con el enum, nunca con textos sueltos:
$user->tokenCan(CashboxPermission::MovementCreate->fullKey());| Grupo | Casos |
|---|---|
| Generales | View, Create, Edit, Delete, Export |
| Configuración | ConfigurationView, ConfigurationCreate, ConfigurationEdit, ConfigurationDelete |
| Aperturas | OpeningView, OpeningCreate, OpeningEdit, OpeningDelete |
| Movimientos | MovementView, MovementCreate, MovementEdit, MovementDelete, MovementAnulate |
| Cuentas | AccountView, AccountCreate, AccountEdit, AccountDelete, AccountAssign |
| Conciliación | AccountConciliationView, AccountConciliationCreate, AccountConciliationEdit, AccountConciliationDelete, AccountConciliationRevert |
| Cierre de mes | AccountClosureCreate, AccountClosureDelete |
En el frontend, el espejo es @permission/cashbox.permissions (src/app/core/permissions/cashbox.permissions.ts); debe coincidir byte a byte con fullKey() (ver AGENTS.md).
Reglas de CashboxMovementPolicy
Sección titulada «Reglas de CashboxMovementPolicy»| Método | Regla |
|---|---|
create |
Requiere MovementCreate. |
update |
Requiere MovementEdit, y que el usuario sea quien creó el movimiento (create_user_id), y que no esté anulado ni conciliado. Mensajes de rechazo en español, uno por causa. |
updateTransfer |
Mismas tres condiciones que update. |
delete, restore, forceDelete |
Requieren MovementDelete. |
anulate |
El movimiento no está anulado y el usuario tiene MovementAnulate. |
export |
Requiere Export (cashbox.export), aparte de poder ver los reportes en pantalla. |
En CashboxMovementController, la autorización se hace con Gate::authorize('<método>', $cashboxMovement) dentro de cada acción (por ejemplo, viewAny en index(), update y updateTransfer al editar, anulate al anular).
