Files
shopit-back/app/Domains/Staff/documentacion/README.md

21 lines
853 B
Markdown

# Dominio Staff
## Propósito
Administra usuarios de personal de un tenant y las categorías que tienen habilitadas para operar o escanear.
## Componentes
- `AdminAppStaffController`: listado, alta, modificación y baja.
- `StaffService`: aplica el alcance por tenant, busca personal y sincroniza sus datos/asignaciones.
- `StoreStaffRequest` y `UpdateStaffRequest`: validan cada operación.
- `StaffResource`: representación de salida para AdminApp.
## Endpoints
Recurso REST `/v1/adminapp/tenant/staff`, excepto detalle individual, protegido por `auth:sanctum` y `adminapp.tenant`.
## Dependencias y reglas
Usa `Auth/User` como entidad de personal, `Authorization` para su rol, `Catalog/Category` para asignaciones y `Tenant` para aislamiento. Toda búsqueda, edición o borrado debe comprobar que el usuario pertenece al tenant autenticado.