Saltar a contenido

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.
  • Agent comparte el id con User.
  • La jerarquía usa parent/children y staudenmeir/laravel-adjacency-list.
  • Los roles de Spatie son super-admin, master, agent, cashier y user.

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_user o parent_id).
  • Se crea wallet y transacción inicial.
  • Se emite UserCreated para 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

  • AgentResource muestra el árbol y el detalle.
  • MoveAgentAction cambia el padre.
  • ChangeCommissionsAction ajusta 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 Wallets para cualquier movimiento.
  • Probar con un agente y con un jugador directo.