How filipdjekic/logistic-system works
This is a multi-company logistics operations application: users authenticate, work within role- and resource-scoped permissions, and coordinate workforce, warehouse, inventory, fleet, and transport activity. The README describes stock operations and transport fulfillment as important business workflows, with auditability, dashboards, notifications, reports, and data exchange providing supporting capabilities. Sampled services confirm authentication, inventory movement, lifecycle validation, dashboards, reporting, and SSE behavior; unsampled subsystem links are limited to documented capabilities and the source tree’s controller/service locations.
Main entry points: TransportOrderController.java Transport orders · useMyTasks.ts Web application · EmployeeController.java Workforce management · TaskController.java Shifts and tasks
Components 23
Access and workforce
- Authentication
backend/src/main/java/rs/logistics/logistics_system/service/implementation/auth/AuthService.java - Auth endpoints
backend/src/main/java/rs/logistics/logistics_system/controller/auth/AuthController.java - Scoped authorization
backend/src/main/java/rs/logistics/logistics_system/security/AuthorizationService.java - Workforce management
backend/src/main/java/rs/logistics/logistics_system/controller/EmployeeController.java - Shifts and tasks
backend/src/main/java/rs/logistics/logistics_system/controller/TaskController.java
Logistics operations
- Lifecycle validation
backend/src/main/java/rs/logistics/logistics_system/lifecycle/LifecycleTransitionEngine.java - Warehouse structure
backend/src/main/java/rs/logistics/logistics_system/controller/WarehouseController.java - Product catalog
backend/src/main/java/rs/logistics/logistics_system/controller/ProductController.java - Inventory and counts
backend/src/main/java/rs/logistics/logistics_system/controller/WarehouseInventoryController.java - Stock movements
backend/src/main/java/rs/logistics/logistics_system/service/implementation/StockMovementService.java - Transport orders
backend/src/main/java/rs/logistics/logistics_system/controller/TransportOrderController.java - Fleet and maintenance
backend/src/main/java/rs/logistics/logistics_system/controller/VehicleController.java - Business records
Visibility and data
- Audit and collaboration
backend/src/main/java/rs/logistics/logistics_system/controller/ActivityTimelineController.java - Notifications and SSE
backend/src/main/java/rs/logistics/logistics_system/service/realtime/NotificationSseService.java - Role dashboards
backend/src/main/java/rs/logistics/logistics_system/service/implementation/dashboard - Reports and exports
backend/src/main/java/rs/logistics/logistics_system/service/implementation/report/InventoryReportService.java - Data exchange
backend/src/main/java/rs/logistics/logistics_system/controller/DataExchangeController.java
Web client
- Web application
frontend/src/features/tasks/hooks/useMyTasks.ts - Task query and update
frontend/src/features/tasks/hooks/useUpdateTaskStatus.ts - Profile request review
frontend/src/features/employee-profile-change-requests/hooks/useReviewEmployeeProfileChangeRequest.ts
Other components
- User
- Operator
Connections 35
- User → Auth endpoints: submits credentials
- Auth endpoints → Authentication: delegates login
- Authentication → Scoped authorization: uses identity scope
- User → Workforce management: manages workforce
- User → Shifts and tasks: organizes work
- User → Warehouse structure: configures warehouses
- User → Product catalog: maintains products
- User → Inventory and counts: counts stock
- User → Stock movements: requests movement
- Stock movements → Business records: updates inventory records
- User → Transport orders: plans fulfillment
- Transport orders → Stock movements: coordinates stock effects
- Transport orders → Fleet and maintenance: assigns transport resources
- Lifecycle validation → Scoped authorization: checks role scope
- Workforce management → Business records: manages workforce records
- Shifts and tasks → Business records: manages work records
- Warehouse structure → Business records: manages warehouse records
- Product catalog → Business records: manages product records
- Inventory and counts → Business records: reads and changes counts
- Transport orders → Business records: manages transport records
- Fleet and maintenance → Business records: manages fleet records
- User → Audit and collaboration: reviews activity
- User → Notifications and SSE: receives updates
- Notifications and SSE → Business records: reads notification records
- User → Role dashboards: views role summary
- Role dashboards → Business records: reads operational summaries
- User → Reports and exports: requests reports
- Reports and exports → Business records: reads inventory and movement data
- User → Data exchange: imports operational data
- Data exchange → Business records: exchanges business records
- Operator → Web application: uses
- Web application → Task query and update: opens task workflows
- Task query and update → Shifts and tasks: requests task operations
- Web application → Profile request review: reviews employee requests
- Profile request review → Workforce management: submits review actions