How lavanya0613/ambulance works
This repository is an ambulance booking and tracking product with a Java/Spring backend and a React web client; the README also documents a Flutter patient/driver app, whose runtime feature code is not present in this tree. The patient workflow runs from booking and payment through dispatch/queue processing to live tracking, while separate admin and dispatcher workflows cover monitoring, request management and audit/DLQ operations. Edges are limited to relationships visible in excerpts or the README; mobile internals and unsampled backend wiring are not inferred.
Main entry points: App.tsx Web router · DispatcherService.java Dispatch service · RedisQueueService.java Redis queue · AmbulanceRequestRepository.java Request repository
Components 25
Web portals
- Web router
web/src/App.tsx - Patient pages
web/src/pages - Admin pages
web/src/pages - Mobile clients
mobile
Booking and payment
- Patient API
backend-java/src/main/java/com/callhealth/ambulance/controller/PatientRequestController.java - Request and payment
backend-java/src/main/java/com/callhealth/ambulance/service/PatientRequestService.java - Booking records
backend-java/src/main/java/com/callhealth/ambulance/model/entity/AmbulanceRequest.java - Request repository
backend-java/src/main/java/com/callhealth/ambulance/repository/AmbulanceRequestRepository.java
Dispatch and tracking
- Dispatcher API
backend-java/src/main/java/com/callhealth/ambulance/controller/DispatcherController.java - Dispatch service
backend-java/src/main/java/com/callhealth/ambulance/service/DispatcherService.java - Redis queue
backend-java/src/main/java/com/callhealth/ambulance/queue/service/RedisQueueService.java - Booking worker
backend-java/src/main/java/com/callhealth/ambulance/queue/worker/BookingQueueWorker.java - Tracking worker
backend-java/src/main/java/com/callhealth/ambulance/queue/worker/TrackingQueueWorker.java - Tracking positions
backend-java/src/main/java/com/callhealth/ambulance/model/entity/TrackingPosition.java - WebSocket gateway
backend-java/src/main/java/com/callhealth/ambulance/gateway/WebSocketGateway.java - Realtime clients
Administration
- Admin API
backend-java/src/main/java/com/callhealth/ambulance/controller/AdminController.java - Admin service
backend-java/src/main/java/com/callhealth/ambulance/service/AdminService.java - Audit logs
backend-java/src/main/java/com/callhealth/ambulance/model/entity/SystemAuditLog.java - Failed job recovery
backend-java/src/main/java/com/callhealth/ambulance/service/DlqService.java - Dead letter jobs
backend-java/src/main/java/com/callhealth/ambulance/model/entity/DlqJob.java - Vendor API
backend-java/src/main/java/com/callhealth/ambulance/controller/VendorController.java
Other components
- Patient
- Dispatcher
- Administrator
Connections 27
- Patient → Web router: opens portal
web/src/App.tsx - Dispatcher → Web router: opens portal
web/src/App.tsx - Administrator → Web router: opens portal
web/src/App.tsx - Web router → Patient pages: routes to
web/src/App.tsx - Web router → Admin pages: routes to
web/src/App.tsx - Patient pages → Patient API: uses API
- Admin pages → Admin API: uses API
- Mobile clients → Patient API: uses API
- Mobile clients → WebSocket gateway: realtime updates
- Patient API → Request and payment: delegates
backend-java/src/main/java/com/callhealth/ambulance/controller/PatientRequestController.java - Request and payment → Request repository: reads and writes
backend-java/src/main/java/com/callhealth/ambulance/service/PatientRequestService.java - Request repository → Booking records: persists
backend-java/src/main/java/com/callhealth/ambulance/repository/AmbulanceRequestRepository.java - Dispatcher API → Dispatch service: delegates
- Dispatch service → Request repository: queries
backend-java/src/main/java/com/callhealth/ambulance/service/DispatcherService.java - Dispatch service → Redis queue: enqueues tracking
backend-java/src/main/java/com/callhealth/ambulance/service/DispatcherService.java - Redis queue → Booking worker: dispatches jobs
- Redis queue → Tracking worker: dispatches jobs
backend-java/src/main/java/com/callhealth/ambulance/queue/worker/TrackingQueueWorker.java - Dispatch service → WebSocket gateway: emits location
backend-java/src/main/java/com/callhealth/ambulance/service/DispatcherService.java - WebSocket gateway → Realtime clients: pushes updates
- Tracking worker → Tracking positions: records positions
backend-java/src/main/java/com/callhealth/ambulance/queue/worker/TrackingQueueWorker.java - Admin API → Admin service: delegates
- Admin service → Request repository: queries bookings
backend-java/src/main/java/com/callhealth/ambulance/service/AdminService.java - Admin service → Audit logs: reads audit logs
backend-java/src/main/java/com/callhealth/ambulance/service/AdminService.java - Failed job recovery → Dead letter jobs: stores and retries
backend-java/src/main/java/com/callhealth/ambulance/service/DlqService.java - Failed job recovery → Redis queue: requeues jobs
backend-java/src/main/java/com/callhealth/ambulance/service/DlqService.java - Failed job recovery → Audit logs: records recovery
backend-java/src/main/java/com/callhealth/ambulance/service/DlqService.java - Vendor API → Booking records: vendor workflow