How kheangsenghorng/smartpos_identity-service works
SmartPOS Identity Service provides authentication, account management, RBAC, POS PIN verification, and device/session security through a versioned API. The main workflow starts with a client request, passes through Laravel routing and authentication, then performs the requested identity operation and returns a response; the graph also preserves the service’s authorization, audit, email-verification, and profile capabilities. Evidence is limited to the README, source index references, and shown excerpts; several documented subsystems have unsampled implementations.
Main entry points: AuthController.php Authentication · User.php User accounts · Role.php Roles · RbacCacheService.php RBAC cache
Components 23
API entry
- API routes
routes/api.php - Auth routes
routes/api/auth.php
Identity workflows
- Authentication
app/Http/Controllers/Api/AuthController.php - User management
app/Http/Controllers/Api/UserController.php - User accounts
app/Models/User.php - Email change
app/Http/Controllers/Api/EmailChangeController.php - Email verification
app/Http/Controllers/Api/EmailVerificationController.php - Verification mail
app/Mail/EmailChangeVerificationMail.php - POS PIN
app/Http/Controllers/Api/UserPosPinController.php
Access control
- Role management
app/Http/Controllers/Api/RoleController.php - Permission management
app/Http/Controllers/Api/PermissionController.php - Roles
app/Models/Role.php - Permissions
app/Models/Permission.php - RBAC cache
app/Services/RbacCacheService.php - Role provisioning
app/Services/RoleProvisionService.php
Session security
- Session management
app/Http/Controllers/Api/UserSessionController.php - User sessions
app/Models/UserSession.php - Device management
app/Http/Controllers/Api/UserDeviceController.php - User devices
app/Models/UserDevice.php
Audit and profile
- Login audit
app/Http/Controllers/Api/LoginAttemptController.php - Security events
app/Services/SecurityEventService.php - Avatar processing
app/Services/AvatarService.php
Other components
- API client
Connections 23
- API client → API routes: sends request
- API routes → Auth routes: routes auth
routes/api/auth.php - Auth routes → Authentication: dispatches to
routes/api/auth.php - Authentication → User accounts: authenticates
app/Http/Controllers/Api/AuthController.php - Authentication → User devices: finds or creates
app/Http/Controllers/Api/AuthController.php - Authentication → User sessions: manages sessions
app/Http/Controllers/Api/AuthController.php - Authentication → Security events: records events
app/Http/Controllers/Api/AuthController.php - User management → User accounts: manages accounts
- User management → Avatar processing: processes uploads
- Email change → User accounts: updates pending email
app/Http/Controllers/Api/EmailChangeController.php - Email change → Verification mail: sends verification
app/Http/Controllers/Api/EmailChangeController.php - Email verification → User accounts: verifies address
app/Http/Controllers/Api/EmailVerificationController.php - POS PIN → User accounts: serves PIN workflow
- Role management → Roles: manages roles
- Permission management → Permissions: manages permissions
- Roles → Permissions: attaches permissions
app/Models/Role.php - User accounts → RBAC cache: checks access
app/Models/User.php - RBAC cache → Roles: reads role data
app/Services/RbacCacheService.php - Role provisioning → RBAC cache: invalidates cache
app/Services/RoleProvisionService.php - Session management → User sessions: lists and revokes
app/Http/Controllers/Api/UserSessionController.php - Device management → User devices: manages devices
- Login audit → Security events: exposes audit
- Authentication → Login audit: records attempts
app/Http/Controllers/Api/AuthController.php