# deeep095/rapid_delivery_service architecture

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

- Interactive diagram: https://gitdiagram.com/deeep095/rapid_delivery_service
- Repository: https://github.com/deeep095/rapid_delivery_service

## Overview

Rapid Delivery Service is a multi-warehouse ordering platform. Buyers and warehouse managers use the Flutter app; buyers discover nearby stock across warehouses, consolidate a cart, place an order, and receive asynchronous fulfillment. The backend separates availability, transactional order placement, and stock deduction, with Redis, OpenSearch, PostgreSQL, and a message broker serving distinct roles. The README documents monitoring dashboards and demand prediction, but their implementation files are absent from the supplied tree. Backend relationships below follow the documented architecture; the app's Dart sources were not supplied.

Main entry points: [`availability-service/main.py`](https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py) (Availability API), [`order-service/main.py`](https://github.com/deeep095/rapid_delivery_service/blob/main/order-service/main.py) (Order API), [`rapid_delivery_app`](https://github.com/deeep095/rapid_delivery_service/tree/main/rapid_delivery_app) (Flutter App), [`fulfillment-worker/main.py`](https://github.com/deeep095/rapid_delivery_service/blob/main/fulfillment-worker/main.py) (Fulfillment Worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client App"]
  node_app["Flutter App"]
end

subgraph group_discovery["Availability"]
  node_availability["Availability API<br/>[main.py]"]
  node_geo["Warehouse Search<br/>[main.py]"]
  node_inventory["Stock Aggregation<br/>[main.py]"]
  node_redis[("Redis Stock")]
  node_opensearch[("OpenSearch Geo")]
end

subgraph group_orders["Order Fulfillment"]
  node_order_api["Order API<br/>[main.py]"]
  node_consolidation["Order Splitting<br/>[main.py]"]
  node_postgres[("PostgreSQL")]
  node_broker["Kafka / SQS"]
  node_worker["Fulfillment Worker<br/>[main.py]"]
end

subgraph group_operations["Operations"]
  node_metrics["Metrics<br/>[main.py]"]
  node_monitoring["Prometheus + Grafana"]
  node_demand["Demand Prediction<br/>[main.py]"]
end

node_buyer(("Buyer"))
node_manager(("Warehouse Manager"))

node_buyer -->|"uses"| node_app
node_manager -->|"uses"| node_app
node_app -->|"requests stock"| node_availability
node_availability -->|"searches warehouses"| node_geo
node_geo -->|"queries locations"| node_opensearch
node_availability -->|"aggregates stock"| node_inventory
node_inventory -->|"reads stock"| node_redis
node_app -->|"places orders"| node_order_api
node_order_api -->|"splits orders"| node_consolidation
node_order_api -->|"stores orders"| node_postgres
node_order_api -->|"dispatches orders"| node_broker
node_broker -->|"delivers messages"| node_worker
node_worker -->|"deducts stock"| node_redis
node_worker -->|"records metrics"| node_metrics
node_metrics -->|"exports metrics"| node_monitoring
node_availability -->|"serves endpoint"| node_demand

click node_app "https://github.com/deeep095/rapid_delivery_service/tree/main/rapid_delivery_app"
click node_availability "https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py"
click node_geo "https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py"
click node_inventory "https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py"
click node_order_api "https://github.com/deeep095/rapid_delivery_service/blob/main/order-service/main.py"
click node_consolidation "https://github.com/deeep095/rapid_delivery_service/blob/main/order-service/main.py"
click node_worker "https://github.com/deeep095/rapid_delivery_service/blob/main/fulfillment-worker/main.py"
click node_metrics "https://github.com/deeep095/rapid_delivery_service/blob/main/fulfillment-worker/main.py"
click node_demand "https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py"

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 toneBlue
class node_availability,node_geo,node_inventory,node_redis,node_opensearch toneAmber
class node_order_api,node_consolidation,node_postgres,node_broker,node_worker toneMint
class node_metrics,node_monitoring,node_demand toneRose
class node_buyer,node_manager toneIndigo
```

## Components

### Client App

- [Flutter App](https://github.com/deeep095/rapid_delivery_service/tree/main/rapid_delivery_app): `rapid_delivery_app`

### Availability

- [Availability API](https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py): `availability-service/main.py`
- [Warehouse Search](https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py): `availability-service/main.py`
- [Stock Aggregation](https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py): `availability-service/main.py`
- **Redis Stock**
- **OpenSearch Geo**

### Order Fulfillment

- [Order API](https://github.com/deeep095/rapid_delivery_service/blob/main/order-service/main.py): `order-service/main.py`
- [Order Splitting](https://github.com/deeep095/rapid_delivery_service/blob/main/order-service/main.py): `order-service/main.py`
- **PostgreSQL**
- **Kafka / SQS**
- [Fulfillment Worker](https://github.com/deeep095/rapid_delivery_service/blob/main/fulfillment-worker/main.py): `fulfillment-worker/main.py`

### Operations

- [Metrics](https://github.com/deeep095/rapid_delivery_service/blob/main/fulfillment-worker/main.py): `fulfillment-worker/main.py`
- **Prometheus + Grafana**
- [Demand Prediction](https://github.com/deeep095/rapid_delivery_service/blob/main/availability-service/main.py): `availability-service/main.py`

### Other components

- **Buyer**
- **Warehouse Manager**

## Connections

- Buyer → Flutter App: uses (evidence: `README.md`)
- Warehouse Manager → Flutter App: uses (evidence: `README.md`)
- Flutter App → Availability API: requests stock (evidence: `README.md`)
- Availability API → Warehouse Search: searches warehouses (evidence: `README.md`)
- Warehouse Search → OpenSearch Geo: queries locations (evidence: `README.md`)
- Availability API → Stock Aggregation: aggregates stock (evidence: `README.md`)
- Stock Aggregation → Redis Stock: reads stock (evidence: `README.md`)
- Flutter App → Order API: places orders (evidence: `README.md`)
- Order API → Order Splitting: splits orders (evidence: `README.md`)
- Order API → PostgreSQL: stores orders (evidence: `README.md`)
- Order API → Kafka / SQS: dispatches orders (evidence: `README.md`)
- Kafka / SQS → Fulfillment Worker: delivers messages (evidence: `README.md`)
- Fulfillment Worker → Redis Stock: deducts stock (evidence: `README.md`)
- Fulfillment Worker → Metrics: records metrics (evidence: `README.md`)
- Metrics → Prometheus + Grafana: exports metrics (evidence: `README.md`)
- Availability API → Demand Prediction: serves endpoint (evidence: `README.md`)
