# channrith/scheduled-mobility architecture

> Architecture diagram of the GitHub repository channrith/scheduled-mobility, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/channrith/scheduled-mobility
- Repository: https://github.com/channrith/scheduled-mobility

## Overview

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: [`core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java`](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java) (Driver onboarding), [`core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java`](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java) (Authentication), [`core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java`](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java) (Driver documents), [`core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java`](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java) (Driver administration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth_api["OTP and session API"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_otp["OTP verification<br/>[OtpService.java]"]
  node_sms["SMS sender<br/>[SmsSender.java]"]
  node_user_store[("User accounts")]
  node_refresh["Refresh sessions"]
end

subgraph group_driver["Driver operations"]
  node_driver_admin["Driver administration"]
  node_onboarding["Driver onboarding"]
  node_driver_record[("Driver profile<br/>[Driver.java]")]
  node_documents["Driver documents"]
  node_vehicles["Vehicle management"]
end

subgraph group_ride["Ride services"]
  node_corporate["Corporate clients"]
  node_places["Places"]
  node_pricing["Ride pricing"]
  node_booking["Scheduled bookings"]
  node_dispatch["Ride dispatch"]
  node_payment["Payments"]
  node_notification["Notifications"]
  node_safety["Safety"]
  node_support["Customer support"]
end

subgraph group_platform["Shared platform"]
  node_audit["Audit records<br/>[AuditLog.java]"]
  node_storage["Encrypted file storage"]
  node_crypto["PII protection<br/>[PiiCrypto.java]"]
end

subgraph group_location["Live location"]
  node_location_service["GPS and live location"]
end

node_passenger(("Passenger or staff"))
node_driver_phone(("Driver device"))

node_passenger -->|"requests login"| node_auth_api
node_auth_api -->|"delegates auth"| node_auth_service
node_auth_service -->|"requests or verifies"| node_otp
node_otp -->|"sends code"| node_sms
node_otp -->|"delivers code"| node_passenger
node_auth_service -->|"reads and registers"| node_user_store
node_auth_service -->|"issues or rotates"| node_refresh
node_driver_admin -->|"invokes workflow"| node_onboarding
node_driver_admin -->|"manages documents"| node_documents
node_driver_admin -->|"manages vehicles"| node_vehicles
node_onboarding -->|"persists profile"| node_driver_record
node_onboarding -->|"ensures driver account"| node_user_store
node_onboarding -->|"protects PII"| node_crypto
node_onboarding -->|"records actions"| node_audit
node_documents -->|"stores files"| node_storage
node_documents -->|"validates vehicle"| node_vehicles
node_documents -->|"records review"| node_audit
node_vehicles -->|"records changes"| node_audit
node_driver_phone -->|"sends GPS pings"| node_location_service

click node_auth_api "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/auth/AuthController.java"
click node_auth_service "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java"
click node_otp "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/otp/OtpService.java"
click node_sms "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/otp/SmsSender.java"
click node_user_store "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/user/UserRepository.java"
click node_refresh "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/token/RefreshTokenService.java"
click node_driver_admin "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java"
click node_onboarding "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java"
click node_driver_record "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/profile/Driver.java"
click node_documents "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java"
click node_vehicles "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/vehicle/VehicleService.java"
click node_audit "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/audit/AuditLog.java"
click node_storage "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/shared/storage/StorageService.java"
click node_crypto "https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/shared/crypto/PiiCrypto.java"
click node_corporate "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/corporate"
click node_places "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/place"
click node_pricing "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/pricing"
click node_booking "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/booking"
click node_dispatch "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/dispatch"
click node_payment "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/payment"
click node_notification "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/notification"
click node_safety "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/safety"
click node_support "https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/support"
click node_location_service "https://github.com/channrith/scheduled-mobility/blob/main/location-service/src/main/java/com/mobility/location/LocationServiceApplication.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_auth_service,node_otp,node_sms,node_user_store,node_refresh toneBlue
class node_driver_admin,node_onboarding,node_driver_record,node_documents,node_vehicles toneAmber
class node_corporate,node_places,node_pricing,node_booking,node_dispatch,node_payment,node_notification,node_safety,node_support toneMint
class node_audit,node_storage,node_crypto toneRose
class node_location_service,node_passenger,node_driver_phone toneIndigo
```

## Components

### Identity and access

- [OTP and session API](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/auth/AuthController.java): `core-app/src/main/java/com/mobility/core/identity/auth/AuthController.java`
- [Authentication](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java): `core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java`
- [OTP verification](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/otp/OtpService.java): `core-app/src/main/java/com/mobility/core/identity/otp/OtpService.java`
- [SMS sender](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/otp/SmsSender.java): `core-app/src/main/java/com/mobility/core/identity/otp/SmsSender.java`
- [User accounts](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/user/UserRepository.java): `core-app/src/main/java/com/mobility/core/identity/user/UserRepository.java`
- [Refresh sessions](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/identity/token/RefreshTokenService.java): `core-app/src/main/java/com/mobility/core/identity/token/RefreshTokenService.java`

### Driver operations

- [Driver administration](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java): `core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java`
- [Driver onboarding](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java): `core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java`
- [Driver profile](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/profile/Driver.java): `core-app/src/main/java/com/mobility/core/driver/profile/Driver.java`
- [Driver documents](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java): `core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java`
- [Vehicle management](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/driver/vehicle/VehicleService.java): `core-app/src/main/java/com/mobility/core/driver/vehicle/VehicleService.java`

### Ride services

- [Corporate clients](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/corporate): `core-app/src/main/java/com/mobility/core/corporate`
- [Places](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/place): `core-app/src/main/java/com/mobility/core/place`
- [Ride pricing](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/pricing): `core-app/src/main/java/com/mobility/core/pricing`
- [Scheduled bookings](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/booking): `core-app/src/main/java/com/mobility/core/booking`
- [Ride dispatch](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/dispatch): `core-app/src/main/java/com/mobility/core/dispatch`
- [Payments](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/payment): `core-app/src/main/java/com/mobility/core/payment`
- [Notifications](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/notification): `core-app/src/main/java/com/mobility/core/notification`
- [Safety](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/safety): `core-app/src/main/java/com/mobility/core/safety`
- [Customer support](https://github.com/channrith/scheduled-mobility/tree/main/core-app/src/main/java/com/mobility/core/support): `core-app/src/main/java/com/mobility/core/support`

### Shared platform

- [Audit records](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/audit/AuditLog.java): `core-app/src/main/java/com/mobility/core/audit/AuditLog.java`
- [Encrypted file storage](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/shared/storage/StorageService.java): `core-app/src/main/java/com/mobility/core/shared/storage/StorageService.java`
- [PII protection](https://github.com/channrith/scheduled-mobility/blob/main/core-app/src/main/java/com/mobility/core/shared/crypto/PiiCrypto.java): `core-app/src/main/java/com/mobility/core/shared/crypto/PiiCrypto.java`

### Live location

- [GPS and live location](https://github.com/channrith/scheduled-mobility/blob/main/location-service/src/main/java/com/mobility/location/LocationServiceApplication.java): `location-service/src/main/java/com/mobility/location/LocationServiceApplication.java`

### Other components

- **Passenger or staff**
- **Driver device**

## Connections

- Passenger or staff → OTP and session API: requests login (evidence: `README.md`)
- OTP and session API → Authentication: delegates auth (evidence: `core-app/src/main/java/com/mobility/core/identity/auth/AuthController.java`)
- Authentication → OTP verification: requests or verifies (evidence: `core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java`)
- OTP verification → SMS sender: sends code (evidence: `core-app/src/main/java/com/mobility/core/identity/otp/OtpService.java`)
- OTP verification → Passenger or staff: delivers code (evidence: `README.md`)
- Authentication → User accounts: reads and registers (evidence: `core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java`)
- Authentication → Refresh sessions: issues or rotates (evidence: `core-app/src/main/java/com/mobility/core/identity/auth/AuthService.java`)
- Driver administration → Driver onboarding: invokes workflow (evidence: `core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java`)
- Driver administration → Driver documents: manages documents (evidence: `core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java`)
- Driver administration → Vehicle management: manages vehicles (evidence: `core-app/src/main/java/com/mobility/core/driver/profile/AdminDriverController.java`)
- Driver onboarding → Driver profile: persists profile (evidence: `core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java`)
- Driver onboarding → User accounts: ensures driver account (evidence: `core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java`)
- Driver onboarding → PII protection: protects PII (evidence: `core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java`)
- Driver onboarding → Audit records: records actions (evidence: `core-app/src/main/java/com/mobility/core/driver/profile/DriverOnboardingService.java`)
- Driver documents → Encrypted file storage: stores files (evidence: `core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java`)
- Driver documents → Vehicle management: validates vehicle (evidence: `core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java`)
- Driver documents → Audit records: records review (evidence: `core-app/src/main/java/com/mobility/core/driver/document/DocumentService.java`)
- Vehicle management → Audit records: records changes (evidence: `core-app/src/main/java/com/mobility/core/driver/vehicle/VehicleService.java`)
- Driver device → GPS and live location: sends GPS pings (evidence: `README.md`)
