How nichom01/delivery works
This is a full-stack, multi-depot delivery operations platform. Depot staff and administrators use the React UI to manage orders, routing, goods receiving, manifests, and operational dashboards; external systems can also submit orders through the API. The Spring API applies business logic and persists operational data. README-documented flows establish the UI/API and database boundaries; source excerpts confirm selected manifest, order-routing, and dashboard behavior. Several subsystem links use directory-level nodes because their individual source was not sampled.
Main entry points: v1 REST endpoints · repository Data access · OrderService.java Order management · apiClient.ts HTTP client
Components 18
Operations UI
- Operations pages
delivery-ui/src/pages - API services
delivery-ui/src/api/services - HTTP client
delivery-ui/src/api/apiClient.ts
Delivery API
- Authentication
delivery-api/src/main/java/com/deliverysystem/controller/auth/AuthController.java - REST endpoints
delivery-api/src/main/java/com/deliverysystem/controller/api/v1 - Manifest endpoint
delivery-api/src/main/java/com/deliverysystem/controller/api/v1/ManifestController.java
Operations workflows
- Order management
delivery-api/src/main/java/com/deliverysystem/service/OrderService.java - Postcode routing
delivery-api/src/main/java/com/deliverysystem/service/PostcodeRoutingService.java - Manifest workflow
delivery-api/src/main/java/com/deliverysystem/service/ManifestService.java - Dashboard metrics
delivery-api/src/main/java/com/deliverysystem/service/DashboardService.java - Route operations
delivery-api/src/main/java/com/deliverysystem/service/RouteService.java - Audit logging
delivery-api/src/main/java/com/deliverysystem/service/AuditService.java
Persistence and security
- Data access
delivery-api/src/main/java/com/deliverysystem/repository - Operational records
delivery-api/src/main/java/com/deliverysystem/domain - Authentication controls
delivery-api/src/main/java/com/deliverysystem/security
Other components
- Depot staff
- Order systems
- PostgreSQL
Connections 21
- Depot staff → Operations pages: uses
README.md - Operations pages → API services: requests data
- API services → HTTP client: calls
delivery-ui/src/api/services/routeService.ts - HTTP client → REST endpoints: sends REST requests
README.md - Order systems → REST endpoints: submits orders
README.md - REST endpoints → Order management: delegates
- REST endpoints → Dashboard metrics: requests metrics
- REST endpoints → Route operations: requests route data
- Manifest endpoint → Manifest workflow: delegates
delivery-api/src/main/java/com/deliverysystem/controller/api/v1/ManifestController.java - Order management → Postcode routing: resolves postcode
delivery-api/src/main/java/com/deliverysystem/service/OrderService.java - Order management → Audit logging: records changes
delivery-api/src/main/java/com/deliverysystem/service/OrderService.java - Manifest workflow → Audit logging: records changes
delivery-api/src/main/java/com/deliverysystem/service/ManifestService.java - Route operations → Audit logging: records changes
delivery-api/src/main/java/com/deliverysystem/service/RouteService.java - Dashboard metrics → Data access: reads metrics data
delivery-api/src/main/java/com/deliverysystem/service/DashboardService.java - Route operations → Data access: reads route data
delivery-api/src/main/java/com/deliverysystem/service/RouteService.java - Manifest workflow → Data access: reads and writes
delivery-api/src/main/java/com/deliverysystem/service/ManifestService.java - Order management → Data access: reads and writes
delivery-api/src/main/java/com/deliverysystem/service/OrderService.java - Data access → Operational records: persists records
delivery-api/src/main/java/com/deliverysystem/repository/PostcodeRuleRepository.java - Operational records → PostgreSQL: stored in
README.md - Authentication → Authentication controls: issues tokens
delivery-api/src/main/java/com/deliverysystem/controller/auth/AuthController.java - HTTP client → Authentication controls: sends JWT
README.md