Usuarios y agentes¶
Un solo modelo, varios roles¶
User es el mismo modelo para jugadores, agentes y usuarios de BackOffice.
- Si tiene registro en
agents, es agente. Agentcomparte elidconUser.- La jerarquía usa
parent/childrenystaudenmeir/laravel-adjacency-list. - Los roles de Spatie son
super-admin,master,agent,cashieryuser.
Creación¶
| Flujo | Action / Page |
|---|---|
| Crear jugador | CreatePlayerAction, CreateUser |
| Crear agente | CreateAgentAction |
| Crear usuario de BackOffice | ListUsers (CreateAction) |
Reglas sensibles:
- Un agente no puede crear un usuario con saldo mayor al de su propia wallet.
- El creador descuenta el saldo inicial de su wallet, salvo
super-admin. - El nuevo usuario se vincula al agente autenticado (
agent_useroparent_id). - Se crea wallet y transacción inicial.
- Se emite
UserCreatedpara la alerta.
Edición y estado¶
| Acción | Efecto |
|---|---|
ToggleStatusAction |
Activa o bloquea la cuenta |
ToggleHiddenAction |
Oculta o muestra en listados |
ToggleLevelAction |
Cambia el nivel |
ToggleBalanceBlockedAction |
Bloquea operaciones de saldo |
ChangePasswordAction |
Cambia la contraseña |
BlockProvidersAction |
Bloquea proveedores |
Los cambios de estado, contraseña y roles emiten UserUpdated y generan alerta.
Jerarquía¶
AgentResourcemuestra el árbol y el detalle.MoveAgentActioncambia el padre.ChangeCommissionsActionajusta comisiones.- Los reportes filtran por
descendantsAndSelf().
Jugadores temporales¶
TemporaryUser representa un alta pendiente de activación. Se listan en
TemporaryUserResource y se gestionan con TemporaryUserPolicy.
Reglas para cambios¶
- No romper el filtrado por moneda (
registration_currency,session('currency')). - Validar pertenencia a la red del agente.
- Usar
Walletspara cualquier movimiento. - Probar con un agente y con un jugador directo.