How channrith/scheduled-mobility works
Mobility is a scheduled and contracted mobility platform for corporate clients and hotels, with airport transfers. The principal evidenced workflow is phone-based OTP authentication into a session; a staff-facing driver workflow registers drivers, manages documents and vehicles, and advances onboarding through approval. The README also identifies ride-domain modules and a separate GPS/WebSocket location deployable, but their runtime calls were not sampled, so those subsystems are shown without guessed connections. Relationships below are limited to sampled source references or explicit README statements.
Main entry points: DriverOnboardingService.java Driver onboarding · AuthService.java Authentication · DocumentService.java Driver documents · AdminDriverController.java Driver administration
Components 26
Identity and access
- OTP and session API
core-app/src/main/java/com/mobility/core/identity/auth/AuthController.java - Authentication
core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java - OTP verification
core-app/src/main/java/com/mobility/core/identity/otp/OtpService.java - SMS sender
core-app/src/main/java/com/mobility/core/identity/otp/SmsSender.java - User accounts
core-app/src/main/java/com/mobility/core/identity/user/UserRepository.java - Refresh sessions
core-app/src/main/java/com/mobility/core/identity/token/RefreshTokenService.java
Driver operations
- Driver administration
core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java - Driver onboarding
core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java - Driver profile
core-app/src/main/java/com/mobility/core/driver/profile/Driver.java - Driver documents
core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java - Vehicle management
core-app/src/main/java/com/mobility/core/driver/vehicle/VehicleService.java
Ride services
- Corporate clients
core-app/src/main/java/com/mobility/core/corporate - Places
core-app/src/main/java/com/mobility/core/place - Ride pricing
core-app/src/main/java/com/mobility/core/pricing - Scheduled bookings
core-app/src/main/java/com/mobility/core/booking - Ride dispatch
core-app/src/main/java/com/mobility/core/dispatch - Payments
core-app/src/main/java/com/mobility/core/payment - Notifications
core-app/src/main/java/com/mobility/core/notification - Safety
core-app/src/main/java/com/mobility/core/safety - Customer support
core-app/src/main/java/com/mobility/core/support
Shared platform
- Audit records
core-app/src/main/java/com/mobility/core/audit/AuditLog.java - Encrypted file storage
core-app/src/main/java/com/mobility/core/shared/storage/StorageService.java - PII protection
core-app/src/main/java/com/mobility/core/shared/crypto/PiiCrypto.java
Live location
- GPS and live location
location-service/src/main/java/com/mobility/location/LocationServiceApplication.java
Other components
- Passenger or staff
- Driver device
Connections 19
- Passenger or staff → OTP and session API: requests login
README.md - OTP and session API → Authentication: delegates auth
core-app/src/main/java/com/mobility/core/identity/auth/AuthController.java - Authentication → OTP verification: requests or verifies
core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java - OTP verification → SMS sender: sends code
core-app/src/main/java/com/mobility/core/identity/otp/OtpService.java - OTP verification → Passenger or staff: delivers code
README.md - Authentication → User accounts: reads and registers
core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java - Authentication → Refresh sessions: issues or rotates
core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java - Driver administration → Driver onboarding: invokes workflow
core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java - Driver administration → Driver documents: manages documents
core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java - Driver administration → Vehicle management: manages vehicles
core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java - Driver onboarding → Driver profile: persists profile
core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java - Driver onboarding → User accounts: ensures driver account
core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java - Driver onboarding → PII protection: protects PII
core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java - Driver onboarding → Audit records: records actions
core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java - Driver documents → Encrypted file storage: stores files
core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java - Driver documents → Vehicle management: validates vehicle
core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java - Driver documents → Audit records: records review
core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java - Vehicle management → Audit records: records changes
core-app/src/main/java/com/mobility/core/driver/vehicle/VehicleService.java - Driver device → GPS and live location: sends GPS pings
README.md