How sep490-gfa26se68/loadmaster_be works
LoadMaster is a logistics platform whose main workflow manages transport data in the Spring service, validates trips and submits asynchronous 3D packing jobs to the FastAPI service, then returns plans and progress for operational use. The README documents further execution, billing, identity, and support capabilities. Sampled code confirms FastAPI routing, trip validation, job submission, persistence, and notifications; links for broader Spring workflows and unsampled optimization features follow README documentation rather than inspected call sites.
Main entry points: optimization Optimization API · loadmaster_be Core API · async_optimization_runner.py Async runner · optimization_job_service.py Job management
Components 22
Business management
- Core API
LoadMasterService/src/main/java/fu/se184491/loadmaster_be - Fleet and cargo
LoadMasterService/src/main/java/fu/se184491/loadmaster_be/entity - Orders and trips
LoadMasterService/src/main/java/fu/se184491/loadmaster_be/entity/order - Core data
LoadMasterService/src/main/java/fu/se184491/loadmaster_be/entity
Optimization workflow
- Optimization API
OptimizeService/app/controller/optimization - Trip validation
OptimizeService/app/service/optimize/trip_validation_service.py - Job management
OptimizeService/app/service/optimize/optimization_job_service.py - Async runner
OptimizeService/app/service/optimize/async_optimization_runner.py - Engine client
OptimizeService/app/service/optimize/optimization_client.py - 3D packing
OptimizeService/app/service/optimize - Plan persistence
OptimizeService/app/service/optimize/optimization_result_persistence_service.py - Optimization data
OptimizeService/app/repository/optimization - Job notifications
OptimizeService/app/service/optimize/job_notification_service.py - Plan review
OptimizeService/app/service/optimize/load_plan_service.py
Logistics operations
- LIFO approval
OptimizeService/app/controller/optimization/load_plan_router.py - Warehouse loading
LoadMasterService/src/main/java/fu/se184491/loadmaster_be/entity/optimization/LoadingExecution.java - Delivery execution
LoadMasterService/src/main/java/fu/se184491/loadmaster_be/entity/trip/DeliveryStop.java
Accounts and commerce
- Identity and access
LoadMasterService/src/main/java/fu/se184491/loadmaster_be/config/WebSecurityConfig.java - Subscriptions and billing
LoadMasterService/src/main/java/fu/se184491/loadmaster_be/entity/billing/Subscription.java - Customer support
LoadMasterService/src/main/java/fu/se184491/loadmaster_be/entity/support/SupportTicket.java
Other components
- Frontend user
- WebSocket client
Connections 23
- Frontend user → Core API: manages logistics
- Core API → Fleet and cargo: manages master data
- Core API → Orders and trips: manages dispatch
- Core API → Core data: reads and writes
- Core API → Optimization API: submits jobs
- Optimization API → Trip validation: validates trips
- Optimization API → Job management: creates jobs
- Optimization API → Async runner: dispatches background
- Async runner → Engine client: requests computation
- Engine client → 3D packing: sends packing problem
- Async runner → Plan persistence: persists results
- Plan persistence → Optimization data: writes plans
- Job management → Optimization data: reads and writes jobs
- Async runner → Job notifications: publishes status
- WebSocket client → Job notifications: receives updates
- Frontend user → Optimization API: requests plans
- Optimization API → Plan review: retrieves plans
- Plan review → LIFO approval: supports approval
- Frontend user → Warehouse loading: executes loading
- Frontend user → Delivery execution: confirms deliveries
- Frontend user → Identity and access: authenticates
- Frontend user → Subscriptions and billing: manages subscription
- Frontend user → Customer support: opens tickets