# iamyasinb/meydounbar architecture

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

- Interactive diagram: https://gitdiagram.com/iamyasinb/meydounbar
- Repository: https://github.com/iamyasinb/meydounbar

## Overview

Midoun Bar is a Persian RTL produce-commerce SPA backed by a separate Django REST service. The main customer journey is browse products, manage a server-backed cart, quote delivery and discounts at checkout, create an order, and complete/verify payment; staff and drivers manage fulfillment, while notifications and reporting support operations. The graph combines sampled frontend routing/auth and backend service relationships with README-documented capabilities. Several feature implementations were not sampled, so their internal call paths are not inferred.

Main entry points: [`backend/apps/orders/services.py`](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/orders/services.py) (Order processing), [`backend/config/urls.py`](https://github.com/iamyasinb/meydounbar/blob/master/backend/config/urls.py) (Django REST API), [`src/features/checkout/pages/CheckoutPage.tsx`](https://github.com/iamyasinb/meydounbar/blob/master/src/features/checkout/pages/CheckoutPage.tsx) (Checkout and address), [`backend/apps/payments/services.py`](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/payments/services.py) (Payment processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend shell"]
  node_app["App shell and routes<br/>[App.tsx]"]
  node_authui["Authentication screens"]
end

subgraph group_customer["Customer commerce"]
  node_catalog["Product discovery"]
  node_cart["Shopping cart<br/>[CartPage.tsx]"]
  node_checkout["Checkout and address<br/>[CheckoutPage.tsx]"]
  node_orderui["Order history and tracking<br/>[OrdersPages.tsx]"]
  node_paymentui["Payment return"]
end

subgraph group_operations["Fulfillment operations"]
  node_staffui["Staff management"]
  node_areamap["Service area editor"]
  node_driverui["Driver orders<br/>[DriverPages.tsx]"]
end

subgraph group_backend["Backend domain services"]
  node_django["Django REST API<br/>[urls.py]"]
  node_products["Product services<br/>[services.py]"]
  node_discounts["Discount rules<br/>[services.py]"]
  node_delivery["Delivery quoting<br/>[services.py]"]
  node_orders["Order processing<br/>[services.py]"]
  node_payments["Payment processing<br/>[services.py]"]
  node_notifications["Notification delivery<br/>[services.py]"]
  node_reports["Sales reporting<br/>[services.py]"]
  node_orderdata[("Order records<br/>[models.py]")]
  node_errors["API error envelope<br/>[exceptions.py]"]
end

subgraph group_platform["Integration and state"]
  node_api["API adapter<br/>[adapter.ts]"]
  node_authprovider["Session provider<br/>[AuthProvider.tsx]"]
  node_realtime["Realtime notifications"]
end

node_shopper(("Customer"))
node_staffuser(("Cashier / Admin"))
node_driveruser(("Driver"))
node_postgres[("PostgreSQL")]
node_gateway["Payment gateway"]

node_app -->|"hosts routes"| node_authprovider
node_app -->|"provides adapter"| node_api
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_authui
node_shopper -.->|"browses"| node_catalog
node_shopper -.->|"signs in"| node_authui
node_shopper -.->|"manages items"| node_cart
node_cart -.->|"continues to"| node_checkout
node_checkout -->|"requests commerce data"| node_api
node_checkout -.->|"requests quote"| node_delivery
node_checkout -.->|"validates code"| node_discounts
node_checkout -.->|"submits order"| node_orders
node_orders -->|"calls quote service"| node_delivery
node_orders -->|"calls discount service"| node_discounts
node_orders -->|"creates notifications"| node_notifications
node_orders -->|"persists orders"| node_orderdata
node_orderui -.->|"retries payment"| node_paymentui
node_paymentui -.->|"verifies return"| node_payments
node_payments -->|"uses gateway"| node_gateway
node_payments -->|"sends events"| node_notifications
node_staffuser -.->|"manages store"| node_staffui
node_staffui -->|"edits boundary"| node_areamap
node_staffui -.->|"views reports"| node_reports
node_driveruser -.->|"updates deliveries"| node_driverui
node_authprovider -->|"calls auth methods"| node_api
node_realtime -.->|"shares app session"| node_api
node_django -->|"routes requests"| node_products
node_django -->|"routes requests"| node_orders
node_django -->|"routes requests"| node_payments
node_django -->|"routes requests"| node_notifications
node_reports -->|"reads order data"| node_orderdata
node_payments -->|"reads order data"| node_orderdata
node_products -->|"raises business errors"| node_errors
node_discounts -->|"raises business errors"| node_errors
node_delivery -->|"raises business errors"| node_errors
node_django -.->|"stores domain data"| node_postgres

click node_app "https://github.com/iamyasinb/meydounbar/blob/master/src/app/App.tsx"
click node_authui "https://github.com/iamyasinb/meydounbar/tree/master/src/features/auth/pages"
click node_catalog "https://github.com/iamyasinb/meydounbar/tree/master/src/features/products/pages"
click node_cart "https://github.com/iamyasinb/meydounbar/blob/master/src/features/cart/pages/CartPage.tsx"
click node_checkout "https://github.com/iamyasinb/meydounbar/blob/master/src/features/checkout/pages/CheckoutPage.tsx"
click node_orderui "https://github.com/iamyasinb/meydounbar/blob/master/src/features/orders/pages/OrdersPages.tsx"
click node_paymentui "https://github.com/iamyasinb/meydounbar/blob/master/src/features/payments/pages/PaymentReturnPage.tsx"
click node_staffui "https://github.com/iamyasinb/meydounbar/tree/master/src/features/staff/pages"
click node_areamap "https://github.com/iamyasinb/meydounbar/blob/master/src/features/staff/components/ServiceAreaEditor.tsx"
click node_driverui "https://github.com/iamyasinb/meydounbar/blob/master/src/features/driver/pages/DriverPages.tsx"
click node_api "https://github.com/iamyasinb/meydounbar/blob/master/src/api/adapter.ts"
click node_authprovider "https://github.com/iamyasinb/meydounbar/blob/master/src/app/providers/AuthProvider.tsx"
click node_realtime "https://github.com/iamyasinb/meydounbar/blob/master/src/app/providers/RealtimeProvider.tsx"
click node_django "https://github.com/iamyasinb/meydounbar/blob/master/backend/config/urls.py"
click node_products "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/products/services.py"
click node_discounts "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/discounts/services.py"
click node_delivery "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/delivery/services.py"
click node_orders "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/orders/services.py"
click node_payments "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/payments/services.py"
click node_notifications "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/notifications/services.py"
click node_reports "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/reports/services.py"
click node_orderdata "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/orders/models.py"
click node_errors "https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/common/exceptions.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,node_authui toneBlue
class node_catalog,node_cart,node_checkout,node_orderui,node_paymentui,node_postgres toneAmber
class node_staffui,node_areamap,node_driverui toneMint
class node_django,node_products,node_discounts,node_delivery,node_orders,node_payments,node_notifications,node_reports,node_orderdata,node_errors toneRose
class node_api,node_authprovider,node_realtime,node_shopper,node_staffuser,node_driveruser,node_gateway toneIndigo
```

## Components

### Frontend shell

- [App shell and routes](https://github.com/iamyasinb/meydounbar/blob/master/src/app/App.tsx): `src/app/App.tsx`
- [Authentication screens](https://github.com/iamyasinb/meydounbar/tree/master/src/features/auth/pages): `src/features/auth/pages`

### Customer commerce

- [Product discovery](https://github.com/iamyasinb/meydounbar/tree/master/src/features/products/pages): `src/features/products/pages`
- [Shopping cart](https://github.com/iamyasinb/meydounbar/blob/master/src/features/cart/pages/CartPage.tsx): `src/features/cart/pages/CartPage.tsx`
- [Checkout and address](https://github.com/iamyasinb/meydounbar/blob/master/src/features/checkout/pages/CheckoutPage.tsx): `src/features/checkout/pages/CheckoutPage.tsx`
- [Order history and tracking](https://github.com/iamyasinb/meydounbar/blob/master/src/features/orders/pages/OrdersPages.tsx): `src/features/orders/pages/OrdersPages.tsx`
- [Payment return](https://github.com/iamyasinb/meydounbar/blob/master/src/features/payments/pages/PaymentReturnPage.tsx): `src/features/payments/pages/PaymentReturnPage.tsx`

### Fulfillment operations

- [Staff management](https://github.com/iamyasinb/meydounbar/tree/master/src/features/staff/pages): `src/features/staff/pages`
- [Service area editor](https://github.com/iamyasinb/meydounbar/blob/master/src/features/staff/components/ServiceAreaEditor.tsx): `src/features/staff/components/ServiceAreaEditor.tsx`
- [Driver orders](https://github.com/iamyasinb/meydounbar/blob/master/src/features/driver/pages/DriverPages.tsx): `src/features/driver/pages/DriverPages.tsx`

### Backend domain services

- [Django REST API](https://github.com/iamyasinb/meydounbar/blob/master/backend/config/urls.py): `backend/config/urls.py`
- [Product services](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/products/services.py): `backend/apps/products/services.py`
- [Discount rules](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/discounts/services.py): `backend/apps/discounts/services.py`
- [Delivery quoting](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/delivery/services.py): `backend/apps/delivery/services.py`
- [Order processing](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/orders/services.py): `backend/apps/orders/services.py`
- [Payment processing](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/payments/services.py): `backend/apps/payments/services.py`
- [Notification delivery](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/notifications/services.py): `backend/apps/notifications/services.py`
- [Sales reporting](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/reports/services.py): `backend/apps/reports/services.py`
- [Order records](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/orders/models.py): `backend/apps/orders/models.py`
- [API error envelope](https://github.com/iamyasinb/meydounbar/blob/master/backend/apps/common/exceptions.py): `backend/apps/common/exceptions.py`

### Integration and state

- [API adapter](https://github.com/iamyasinb/meydounbar/blob/master/src/api/adapter.ts): `src/api/adapter.ts`
- [Session provider](https://github.com/iamyasinb/meydounbar/blob/master/src/app/providers/AuthProvider.tsx): `src/app/providers/AuthProvider.tsx`
- [Realtime notifications](https://github.com/iamyasinb/meydounbar/blob/master/src/app/providers/RealtimeProvider.tsx): `src/app/providers/RealtimeProvider.tsx`

### Other components

- **Customer**
- **Cashier / Admin**
- **Driver**
- **PostgreSQL**
- **Payment gateway**

## Connections

- App shell and routes → Session provider: hosts routes
- App shell and routes → API adapter: provides adapter
- App shell and routes → Product discovery: routes to
- App shell and routes → Authentication screens: routes to
- Customer → Product discovery: browses (evidence: `README.md`)
- Customer → Authentication screens: signs in (evidence: `README.md`)
- Customer → Shopping cart: manages items (evidence: `README.md`)
- Shopping cart → Checkout and address: continues to (evidence: `README.md`)
- Checkout and address → API adapter: requests commerce data (evidence: `src/features/checkout/pages/CheckoutPage.tsx`)
- Checkout and address → Delivery quoting: requests quote (evidence: `README.md`)
- Checkout and address → Discount rules: validates code (evidence: `README.md`)
- Checkout and address → Order processing: submits order (evidence: `README.md`)
- Order processing → Delivery quoting: calls quote service (evidence: `backend/apps/orders/services.py`)
- Order processing → Discount rules: calls discount service (evidence: `backend/apps/orders/services.py`)
- Order processing → Notification delivery: creates notifications (evidence: `backend/apps/orders/services.py`)
- Order processing → Order records: persists orders (evidence: `backend/apps/orders/services.py`)
- Order history and tracking → Payment return: retries payment (evidence: `README.md`)
- Payment return → Payment processing: verifies return (evidence: `README.md`)
- Payment processing → Payment gateway: uses gateway (evidence: `backend/apps/payments/services.py`)
- Payment processing → Notification delivery: sends events (evidence: `backend/apps/payments/services.py`)
- Cashier / Admin → Staff management: manages store (evidence: `README.md`)
- Staff management → Service area editor: edits boundary (evidence: `src/features/staff/pages/StaffProductsPage.tsx`)
- Staff management → Sales reporting: views reports (evidence: `README.md`)
- Driver → Driver orders: updates deliveries (evidence: `README.md`)
- Session provider → API adapter: calls auth methods (evidence: `src/app/providers/AuthProvider.tsx`)
- Realtime notifications → API adapter: shares app session (evidence: `README.md`)
- Django REST API → Product services: routes requests (evidence: `backend/config/urls.py`)
- Django REST API → Order processing: routes requests (evidence: `backend/config/urls.py`)
- Django REST API → Payment processing: routes requests (evidence: `backend/config/urls.py`)
- Django REST API → Notification delivery: routes requests (evidence: `backend/config/urls.py`)
- Sales reporting → Order records: reads order data (evidence: `backend/apps/reports/services.py`)
- Payment processing → Order records: reads order data (evidence: `backend/apps/payments/services.py`)
- Product services → API error envelope: raises business errors (evidence: `backend/apps/products/services.py`)
- Discount rules → API error envelope: raises business errors (evidence: `backend/apps/discounts/services.py`)
- Delivery quoting → API error envelope: raises business errors (evidence: `backend/apps/delivery/services.py`)
- Django REST API → PostgreSQL: stores domain data (evidence: `README.md`)
