How fabianoic/roster works
Roster is a standalone employee scheduling REST service, separate from the order, kitchen, and inventory event flow. Its principal workflow is an authenticated client request, permission and ownership checks, controller validation, domain service processing, and persistence. The domain includes staffing, shifts and stores, availability, time-off, and shift swaps; role-permission administration and self-issued JWT authentication support that workflow. The README documents the layered design and major capabilities; some controller and service links below rely on that documentation because their implementations were not sampled.
Main entry points: controller REST controllers · EmployeeService.java Employee management · model Scheduling domain · ShiftService.java Shift scheduling
Components 18
Access and security
- Login API
src/main/java/com/ficsolution/roster/web/controller/AuthController.java - JWT security
src/main/java/com/ficsolution/roster/config/JwtConfig.java - Request authorization
src/main/java/com/ficsolution/roster/config/SecurityConfig.java - Ownership checks
src/main/java/com/ficsolution/roster/security/SecurityUtil.java - REST controllers
src/main/java/com/ficsolution/roster/web/controller - Request and response DTOs
src/main/java/com/ficsolution/roster/web/dto - Exception mapping
src/main/java/com/ficsolution/roster/web/handler/GlobalExceptionHandler.java
People and policy
- Employee management
src/main/java/com/ficsolution/roster/service/EmployeeService.java - Role permissions
src/main/java/com/ficsolution/roster/service/RoleService.java
Scheduling operations
- Availability
src/main/java/com/ficsolution/roster/service/AvailabilityService.java - Shift scheduling
src/main/java/com/ficsolution/roster/service/ShiftService.java - Shift swaps
src/main/java/com/ficsolution/roster/service/ShiftSwapRequestService.java - Time-off requests
src/main/java/com/ficsolution/roster/service/TimeOffRequestService.java - Store management
src/main/java/com/ficsolution/roster/service/StoreService.java
Domain and persistence
- Scheduling domain
src/main/java/com/ficsolution/roster/model - JPA repositories
src/main/java/com/ficsolution/roster/repository - PostgreSQL
Other components
- HTTP client
Connections 29
- HTTP client → Request authorization: sends request
- Request authorization → REST controllers: routes authorized
- HTTP client → Login API: submits login
- Login API → JWT security: issues token
- REST controllers → Request and response DTOs: validates and maps
src/main/java/com/ficsolution/roster/web/controller/EmployeeController.java - REST controllers → Employee management: delegates
src/main/java/com/ficsolution/roster/web/controller/EmployeeController.java - REST controllers → Availability: delegates
src/main/java/com/ficsolution/roster/web/controller/AvailabilityController.java - REST controllers → Time-off requests: delegates
src/main/java/com/ficsolution/roster/web/controller/TimeOffRequestController.java - REST controllers → Shift swaps: delegates
src/main/java/com/ficsolution/roster/web/controller/ShiftSwapRequestController.java - REST controllers → Role permissions: delegates
src/main/java/com/ficsolution/roster/web/controller/RoleController.java - REST controllers → Ownership checks: checks ownership
src/main/java/com/ficsolution/roster/web/controller/EmployeeController.java - Employee management → Role permissions: resolves role
src/main/java/com/ficsolution/roster/service/EmployeeService.java - Shift swaps → Shift scheduling: approves via
src/main/java/com/ficsolution/roster/service/ShiftSwapRequestService.java - Shift scheduling → Employee management: resolves assignee
src/main/java/com/ficsolution/roster/service/ShiftService.java - Shift scheduling → Store management: resolves location
src/main/java/com/ficsolution/roster/service/ShiftService.java - Availability → Employee management: resolves employee
src/main/java/com/ficsolution/roster/service/AvailabilityService.java - Time-off requests → Employee management: uses employee
src/main/java/com/ficsolution/roster/service/TimeOffRequestService.java - Employee management → Scheduling domain: operates on
src/main/java/com/ficsolution/roster/service/EmployeeService.java - Role permissions → Scheduling domain: operates on
src/main/java/com/ficsolution/roster/service/RoleService.java - Shift scheduling → Scheduling domain: operates on
src/main/java/com/ficsolution/roster/service/ShiftService.java - Availability → Scheduling domain: operates on
src/main/java/com/ficsolution/roster/service/AvailabilityService.java - Shift swaps → Scheduling domain: operates on
src/main/java/com/ficsolution/roster/service/ShiftSwapRequestService.java - Time-off requests → Scheduling domain: operates on
src/main/java/com/ficsolution/roster/service/TimeOffRequestService.java - Store management → Scheduling domain: operates on
src/main/java/com/ficsolution/roster/service/StoreService.java - Employee management → JPA repositories: queries and saves
src/main/java/com/ficsolution/roster/service/EmployeeService.java - Role permissions → JPA repositories: queries and saves
src/main/java/com/ficsolution/roster/service/RoleService.java - Shift scheduling → JPA repositories: queries and saves
src/main/java/com/ficsolution/roster/service/ShiftService.java - JPA repositories → PostgreSQL: persists entities
- REST controllers → Exception mapping: bubbles domain errors