# ujjwalkumar6200/aerixon-backend architecture

> Architecture diagram of the GitHub repository ujjwalkumar6200/aerixon-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ujjwalkumar6200/aerixon-backend
- Repository: https://github.com/ujjwalkumar6200/aerixon-backend

## Overview

Aerixon is an emergency-dispatch backend. Its main workflow accepts and validates an emergency, then dispatches manual or priority-based allocation; allocation atomically claims an available ambulance and updates emergency state. Separate API branches handle authentication, retries, audit records, and metrics. The graph preserves the documented capabilities, while several controller-to-service and route-to-controller links rely on SOURCE INDEX references rather than full excerpts; unsampled implementation details are not inferred.

Main entry points: [`src/app.js`](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/app.js) (Express app), [`src/services/allocation.service.js`](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/allocation.service.js) (Atomic allocation), [`server.js`](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/server.js) (Server startup), [`src/routes/allocation.routes.js`](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/allocation.routes.js) (Allocation routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API surface"]
  node_app["Express app<br/>[app.js]"]
  node_emergency_routes["Emergency routes"]
  node_allocation_routes["Allocation routes"]
  node_priority_routes["Priority routes<br/>[priority.routes.js]"]
  node_auto_routes["Auto-allocation routes"]
  node_retry_routes["Retry routes<br/>[retry.routes.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_audit_routes["Audit routes<br/>[audit.routes.js]"]
  node_metrics_routes["Metrics routes<br/>[metrics.routes.js]"]
end

subgraph group_dispatch["Emergency dispatch"]
  node_emergency_controller["Emergency intake"]
  node_emergency_validator["Request validation"]
  node_emergency_model["Emergency records<br/>[emergency.model.js]"]
  node_allocation_controller["Manual allocation"]
  node_allocation_service["Atomic allocation"]
  node_auto_controller["Automatic allocation"]
  node_auto_service["Priority dispatch"]
  node_priority_service["Priority ranking"]
  node_state_machine["State transitions<br/>[stateMachine.js]"]
  node_retry_controller["Retry endpoint"]
  node_retry_service["Retry policy<br/>[retry.service.js]"]
  node_retry_policy["Retry rules<br/>[retryPolicy.js]"]
end

subgraph group_security["Identity and operations"]
  node_auth_middleware["JWT authorization<br/>[auth.middleware.js]"]
  node_auth_controller["Login endpoint<br/>[auth.controller.js]"]
  node_auth_service["Credential service<br/>[auth.service.js]"]
  node_user_model["User records<br/>[user.model.js]"]
  node_audit_controller["Audit endpoint"]
  node_audit_service["Audit logging<br/>[audit.service.js]"]
  node_metrics_controller["Metrics endpoint"]
  node_metrics_service["Metrics aggregation<br/>[metrics.service.js]"]
end

subgraph group_runtime["Runtime and storage"]
  node_server["Server startup<br/>[server.js]"]
  node_db_config["Database connection<br/>[db.js]"]
  node_mongo[("MongoDB")]
  node_ambulance_model["Ambulance records<br/>[ambulance.model.js]"]
end

node_caller(("API client"))

node_caller -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_emergency_routes
node_app -->|"mounts routes"| node_allocation_routes
node_app -->|"mounts routes"| node_priority_routes
node_app -->|"mounts routes"| node_auto_routes
node_app -->|"mounts routes"| node_retry_routes
node_app -->|"mounts routes"| node_auth_routes
node_app -->|"mounts routes"| node_audit_routes
node_app -->|"mounts routes"| node_metrics_routes
node_emergency_routes -->|"routes to"| node_emergency_controller
node_allocation_routes -->|"checks access"| node_auth_middleware
node_allocation_routes -->|"routes to"| node_allocation_controller
node_priority_routes -->|"routes to"| node_priority_service
node_auto_routes -->|"routes to"| node_auto_controller
node_retry_routes -->|"routes to"| node_retry_controller
node_auth_routes -->|"routes to"| node_auth_controller
node_audit_routes -->|"checks access"| node_auth_middleware
node_audit_routes -->|"routes to"| node_audit_controller
node_metrics_routes -->|"checks access"| node_auth_middleware
node_metrics_routes -->|"routes to"| node_metrics_controller
node_emergency_controller -->|"validates input"| node_emergency_validator
node_emergency_controller -->|"stores request"| node_emergency_model
node_allocation_controller -->|"requests allocation"| node_allocation_service
node_allocation_controller -->|"records outcome"| node_audit_service
node_auto_controller -->|"requests dispatch"| node_auto_service
node_auto_service -->|"ranks emergencies"| node_priority_service
node_auto_service -->|"allocates ambulance"| node_allocation_service
node_allocation_service -->|"checks transitions"| node_state_machine
node_retry_controller -.->|"requests retry"| node_retry_service
node_retry_service -->|"retries allocation"| node_allocation_service
node_retry_service -->|"applies rules"| node_retry_policy
node_auth_controller -->|"authenticates user"| node_auth_service
node_auth_service -.->|"reads credentials"| node_user_model
node_audit_controller -.->|"reads audit data"| node_audit_service
node_metrics_controller -->|"requests metrics"| node_metrics_service
node_server -->|"connects database"| node_db_config
node_server -->|"creates indexes"| node_emergency_model
node_server -->|"creates indexes"| node_ambulance_model
node_db_config -->|"connects to"| node_mongo
node_allocation_service -->|"reads and writes"| node_mongo
node_emergency_model -->|"stores records"| node_mongo
node_auth_service -->|"reads users"| node_mongo
node_metrics_service -.->|"aggregates data"| node_mongo

click node_app "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/app.js"
click node_emergency_routes "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/emergency.routes.js"
click node_allocation_routes "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/allocation.routes.js"
click node_priority_routes "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/priority.routes.js"
click node_auto_routes "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/autoAllocation.routes.js"
click node_retry_routes "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/retry.routes.js"
click node_auth_routes "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/auth.routes.js"
click node_audit_routes "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/audit.routes.js"
click node_metrics_routes "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/metrics.routes.js"
click node_emergency_controller "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/emergency.controller.js"
click node_emergency_validator "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/validators/emergency.validator.js"
click node_emergency_model "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/models/emergency.model.js"
click node_allocation_controller "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/allocation.controller.js"
click node_allocation_service "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/allocation.service.js"
click node_auto_controller "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/autoAllocation.controller.js"
click node_auto_service "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/autoAllocation.service.js"
click node_priority_service "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/priority.service.js"
click node_state_machine "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/utils/stateMachine.js"
click node_retry_controller "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/retry.controller.js"
click node_retry_service "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/retry.service.js"
click node_retry_policy "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/utils/retryPolicy.js"
click node_auth_middleware "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/middlewares/auth.middleware.js"
click node_auth_controller "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/auth.controller.js"
click node_auth_service "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/auth.service.js"
click node_user_model "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/models/user.model.js"
click node_audit_controller "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/audit.controller.js"
click node_audit_service "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/audit.service.js"
click node_metrics_controller "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/metrics.controller.js"
click node_metrics_service "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/metrics.service.js"
click node_server "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/server.js"
click node_db_config "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/config/db.js"
click node_ambulance_model "https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/models/ambulance.model.js"

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_app,node_emergency_routes,node_allocation_routes,node_priority_routes,node_auto_routes,node_retry_routes,node_auth_routes,node_audit_routes,node_metrics_routes,node_caller toneBlue
class node_emergency_controller,node_emergency_validator,node_emergency_model,node_allocation_controller,node_allocation_service,node_auto_controller,node_auto_service,node_priority_service,node_state_machine,node_retry_controller,node_retry_service,node_retry_policy toneAmber
class node_auth_middleware,node_auth_controller,node_auth_service,node_user_model,node_audit_controller,node_audit_service,node_metrics_controller,node_metrics_service toneMint
class node_server,node_db_config,node_mongo,node_ambulance_model toneRose
```

## Components

### API surface

- [Express app](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/app.js): `src/app.js`
- [Emergency routes](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/emergency.routes.js): `src/routes/emergency.routes.js`
- [Allocation routes](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/allocation.routes.js): `src/routes/allocation.routes.js`
- [Priority routes](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/priority.routes.js): `src/routes/priority.routes.js`
- [Auto-allocation routes](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/autoAllocation.routes.js): `src/routes/autoAllocation.routes.js`
- [Retry routes](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/retry.routes.js): `src/routes/retry.routes.js`
- [Auth routes](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [Audit routes](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/audit.routes.js): `src/routes/audit.routes.js`
- [Metrics routes](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/routes/metrics.routes.js): `src/routes/metrics.routes.js`

### Emergency dispatch

- [Emergency intake](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/emergency.controller.js): `src/controllers/emergency.controller.js`
- [Request validation](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/validators/emergency.validator.js): `src/validators/emergency.validator.js`
- [Emergency records](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/models/emergency.model.js): `src/models/emergency.model.js`
- [Manual allocation](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/allocation.controller.js): `src/controllers/allocation.controller.js`
- [Atomic allocation](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/allocation.service.js): `src/services/allocation.service.js`
- [Automatic allocation](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/autoAllocation.controller.js): `src/controllers/autoAllocation.controller.js`
- [Priority dispatch](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/autoAllocation.service.js): `src/services/autoAllocation.service.js`
- [Priority ranking](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/priority.service.js): `src/services/priority.service.js`
- [State transitions](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/utils/stateMachine.js): `src/utils/stateMachine.js`
- [Retry endpoint](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/retry.controller.js): `src/controllers/retry.controller.js`
- [Retry policy](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/retry.service.js): `src/services/retry.service.js`
- [Retry rules](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/utils/retryPolicy.js): `src/utils/retryPolicy.js`

### Identity and operations

- [JWT authorization](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/middlewares/auth.middleware.js): `src/middlewares/auth.middleware.js`
- [Login endpoint](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/auth.controller.js): `src/controllers/auth.controller.js`
- [Credential service](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/auth.service.js): `src/services/auth.service.js`
- [User records](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/models/user.model.js): `src/models/user.model.js`
- [Audit endpoint](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/audit.controller.js): `src/controllers/audit.controller.js`
- [Audit logging](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/audit.service.js): `src/services/audit.service.js`
- [Metrics endpoint](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/controllers/metrics.controller.js): `src/controllers/metrics.controller.js`
- [Metrics aggregation](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/services/metrics.service.js): `src/services/metrics.service.js`

### Runtime and storage

- [Server startup](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/server.js): `server.js`
- [Database connection](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/config/db.js): `src/config/db.js`
- **MongoDB**
- [Ambulance records](https://github.com/ujjwalkumar6200/aerixon-backend/blob/main/src/models/ambulance.model.js): `src/models/ambulance.model.js`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests (evidence: `src/app.js`)
- Express app → Emergency routes: mounts routes (evidence: `src/app.js`)
- Express app → Allocation routes: mounts routes (evidence: `src/app.js`)
- Express app → Priority routes: mounts routes (evidence: `src/app.js`)
- Express app → Auto-allocation routes: mounts routes (evidence: `src/app.js`)
- Express app → Retry routes: mounts routes (evidence: `src/app.js`)
- Express app → Auth routes: mounts routes (evidence: `src/app.js`)
- Express app → Audit routes: mounts routes (evidence: `src/app.js`)
- Express app → Metrics routes: mounts routes (evidence: `src/app.js`)
- Emergency routes → Emergency intake: routes to (evidence: `src/controllers/emergency.controller.js`)
- Allocation routes → JWT authorization: checks access (evidence: `src/routes/allocation.routes.js`)
- Allocation routes → Manual allocation: routes to (evidence: `src/routes/allocation.routes.js`)
- Priority routes → Priority ranking: routes to
- Auto-allocation routes → Automatic allocation: routes to (evidence: `src/routes/autoAllocation.routes.js`)
- Retry routes → Retry endpoint: routes to (evidence: `src/routes/retry.routes.js`)
- Auth routes → Login endpoint: routes to (evidence: `src/routes/auth.routes.js`)
- Audit routes → JWT authorization: checks access (evidence: `src/routes/audit.routes.js`)
- Audit routes → Audit endpoint: routes to (evidence: `src/routes/audit.routes.js`)
- Metrics routes → JWT authorization: checks access (evidence: `src/routes/metrics.routes.js`)
- Metrics routes → Metrics endpoint: routes to (evidence: `src/routes/metrics.routes.js`)
- Emergency intake → Request validation: validates input (evidence: `src/controllers/emergency.controller.js`)
- Emergency intake → Emergency records: stores request (evidence: `src/controllers/emergency.controller.js`)
- Manual allocation → Atomic allocation: requests allocation (evidence: `src/controllers/allocation.controller.js`)
- Manual allocation → Audit logging: records outcome (evidence: `src/controllers/allocation.controller.js`)
- Automatic allocation → Priority dispatch: requests dispatch (evidence: `src/controllers/autoAllocation.controller.js`)
- Priority dispatch → Priority ranking: ranks emergencies (evidence: `src/services/autoAllocation.service.js`)
- Priority dispatch → Atomic allocation: allocates ambulance (evidence: `src/services/autoAllocation.service.js`)
- Atomic allocation → State transitions: checks transitions (evidence: `src/services/allocation.service.js`)
- Retry endpoint → Retry policy: requests retry
- Retry policy → Atomic allocation: retries allocation (evidence: `src/services/retry.service.js`)
- Retry policy → Retry rules: applies rules (evidence: `src/services/retry.service.js`)
- Login endpoint → Credential service: authenticates user (evidence: `src/controllers/auth.controller.js`)
- Credential service → User records: reads credentials
- Audit endpoint → Audit logging: reads audit data
- Metrics endpoint → Metrics aggregation: requests metrics (evidence: `src/controllers/metrics.controller.js`)
- Server startup → Database connection: connects database (evidence: `server.js`)
- Server startup → Emergency records: creates indexes (evidence: `server.js`)
- Server startup → Ambulance records: creates indexes (evidence: `server.js`)
- Database connection → MongoDB: connects to (evidence: `src/config/db.js`)
- Atomic allocation → MongoDB: reads and writes (evidence: `src/services/allocation.service.js`)
- Emergency records → MongoDB: stores records (evidence: `src/models/emergency.model.js`)
- Credential service → MongoDB: reads users (evidence: `src/services/auth.service.js`)
- Metrics aggregation → MongoDB: aggregates data
