# omidrezatech/afaghapp architecture

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

- Interactive diagram: https://gitdiagram.com/omidrezatech/afaghapp
- Repository: https://github.com/omidrezatech/afaghapp

## Overview

آفاق‌اپ یک بازارگاه برای اتصال مشتریان به اپراتورها و مؤسسات خدمات اداری است. مسیر اصلی از ثبت‌نام موبایلی و ثبت درخواست می‌گذرد، سپس پذیرش اپراتور، چت و فاکتور، تأیید رسید در امانی، تحویل و تأیید مشتری، و آزادسازی وجه به کیف پول را پوشش می‌دهد؛ شکایت‌ها به داوری می‌روند. گراف قابلیت‌های نرخنامه، مدیریت، پشتیبانی، بلادرنگ و تسویه را هم نشان می‌دهد. ارتباطات مستندشده به README و SOURCE INDEX محدود است؛ پیوندهای فاقد شاهد مستقیمِ پیاده‌سازی حذف شده‌اند.

Main entry points: [`backend/app/routers/orders.py`](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/orders.py) (چرخه سفارش), [`frontend/src/app/app/orders/[id]/page.tsx`](https://github.com/omidrezatech/afaghapp/blob/main/frontend/src/app/app/orders/%5Bid%5D/page.tsx) (فضای مشتری), [`backend/app/routers/payments.py`](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/payments.py) (رسید و پرداخت), [`backend/app/database.py`](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/database.py) (پایگاه داده)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["رابط‌های کاربری"]
  node_customer_ui["فضای مشتری<br/>[page.tsx]"]
  node_operator_ui["پنل اپراتور<br/>[page.tsx]"]
  node_admin_ui["پنل مدیریت<br/>[page.tsx]"]
end

subgraph group_work["سفارش و گفتگو"]
  node_catalog["کاتالوگ خدمات<br/>[services.py]"]
  node_orders["چرخه سفارش<br/>[orders.py]"]
  node_chat["چت سفارش<br/>[chat.py]"]
  node_realtime["رویدادهای بلادرنگ<br/>[socket_server.py]"]
  node_worker["آزادسازی سفارشات معطّل<br/>[jobs_worker.py]"]
end

subgraph group_finance["مالی و داوری"]
  node_payments["رسید و پرداخت<br/>[payments.py]"]
  node_wallet["کیف پول و تسویه<br/>[wallet.py]"]
  node_arbitration["شکایت و داوری<br/>[support.py]"]
  node_admin_ops["مدیریت و نظارت<br/>[admin.py]"]
end

subgraph group_platform["خدمات پلتفرم"]
  node_auth["ورود و ثبت‌نام<br/>[auth.py]"]
  node_upload["مدیریت آپلود<br/>[uploads.py]"]
  node_notify["اعلان‌ها<br/>[notify.py]"]
  node_security["احراز هویت و دسترسی<br/>[security.py]"]
  node_db[("پایگاه داده<br/>[database.py]")]
  node_domain["مدل‌های دامنه<br/>[order.py]"]
end

node_customer(("مشتری"))
node_operator(("اپراتور"))
node_admin(("ادمین و پشتیبان"))
node_sms["درگاه پیامک"]
node_redis[("Redis یا کش حافظه")]

node_customer -->|"ثبت درخواست"| node_customer_ui
node_operator -->|"پذیرش سفارش"| node_operator_ui
node_admin -->|"تأیید رسید"| node_admin_ui
node_customer_ui -.->|"ورود موبایلی"| node_auth
node_customer_ui -.->|"انتخاب خدمت"| node_catalog
node_customer_ui -->|"ثبت سفارش"| node_orders
node_operator_ui -->|"قبول سفارش"| node_orders
node_orders -->|"ایجاد چت اختصاصی"| node_chat
node_orders -->|"صدور فاکتور"| node_payments
node_customer_ui -->|"ارسال رسید"| node_payments
node_admin_ui -->|"تأیید رسید"| node_payments
node_payments -->|"نگهداری امانی"| node_wallet
node_customer_ui -->|"تأیید تحویل"| node_orders
node_orders -->|"آزادسازی وجه"| node_wallet
node_customer_ui -->|"ثبت شکایت"| node_arbitration
node_admin -->|"رسیدگی داوری"| node_arbitration
node_admin_ui -.->|"مدیریت پلتفرم"| node_admin_ops
node_orders -->|"بررسی سفارش معطّل"| node_worker
node_worker -->|"ارسال رویداد"| node_notify
node_worker -->|"خواندن و به‌روزرسانی"| node_db
node_worker -->|"خواندن سفارش و چت"| node_domain
node_orders -->|"اعلان سفارش"| node_notify
node_payments -->|"اجرای مالی"| node_wallet
node_auth -->|"ارسال کد"| node_sms
node_auth -->|"ذخیره کد و محدودسازی"| node_redis
node_auth -->|"ذخیره مدارک"| node_upload
node_auth -->|"ساخت نشست"| node_security
node_security -->|"خواندن کاربر"| node_db
node_catalog -->|"خواندن و تغییر نرخنامه"| node_db
node_orders -->|"خواندن و نوشتن سفارش"| node_db
node_chat -->|"خواندن و نوشتن گفتگو"| node_db
node_realtime -->|"خواندن کاربر"| node_db
node_admin_ops -->|"اجرای مالی"| node_wallet
node_admin_ops -->|"ارسال اعلان"| node_notify
node_arbitration -->|"اجرای رأی مالی"| node_wallet
node_payments -->|"ذخیره رسید"| node_upload

click node_customer_ui "https://github.com/omidrezatech/afaghapp/blob/main/frontend/src/app/app/orders/%5Bid%5D/page.tsx"
click node_operator_ui "https://github.com/omidrezatech/afaghapp/blob/main/frontend/src/app/operator/page.tsx"
click node_admin_ui "https://github.com/omidrezatech/afaghapp/blob/main/frontend/src/app/admin/payments/page.tsx"
click node_auth "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/auth.py"
click node_catalog "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/services.py"
click node_orders "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/orders.py"
click node_chat "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/chat.py"
click node_realtime "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/realtime/socket_server.py"
click node_worker "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/services/jobs_worker.py"
click node_payments "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/payments.py"
click node_wallet "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/services/wallet.py"
click node_arbitration "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/support.py"
click node_admin_ops "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/admin.py"
click node_upload "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/services/uploads.py"
click node_notify "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/services/notify.py"
click node_security "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/core/security.py"
click node_db "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/database.py"
click node_domain "https://github.com/omidrezatech/afaghapp/blob/main/backend/app/models/order.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_customer_ui,node_operator_ui,node_admin_ui toneBlue
class node_catalog,node_orders,node_chat,node_realtime,node_worker,node_redis toneAmber
class node_payments,node_wallet,node_arbitration,node_admin_ops toneMint
class node_auth,node_upload,node_notify,node_security,node_db,node_domain toneRose
class node_customer,node_operator,node_admin,node_sms toneIndigo
```

## Components

### رابط‌های کاربری

- [فضای مشتری](https://github.com/omidrezatech/afaghapp/blob/main/frontend/src/app/app/orders/%5Bid%5D/page.tsx): `frontend/src/app/app/orders/[id]/page.tsx`
- [پنل اپراتور](https://github.com/omidrezatech/afaghapp/blob/main/frontend/src/app/operator/page.tsx): `frontend/src/app/operator/page.tsx`
- [پنل مدیریت](https://github.com/omidrezatech/afaghapp/blob/main/frontend/src/app/admin/payments/page.tsx): `frontend/src/app/admin/payments/page.tsx`

### سفارش و گفتگو

- [کاتالوگ خدمات](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/services.py): `backend/app/routers/services.py`
- [چرخه سفارش](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/orders.py): `backend/app/routers/orders.py`
- [چت سفارش](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/chat.py): `backend/app/routers/chat.py`
- [رویدادهای بلادرنگ](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/realtime/socket_server.py): `backend/app/realtime/socket_server.py`
- [آزادسازی سفارشات معطّل](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/services/jobs_worker.py): `backend/app/services/jobs_worker.py`

### مالی و داوری

- [رسید و پرداخت](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/payments.py): `backend/app/routers/payments.py`
- [کیف پول و تسویه](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/services/wallet.py): `backend/app/services/wallet.py`
- [شکایت و داوری](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/support.py): `backend/app/routers/support.py`
- [مدیریت و نظارت](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/admin.py): `backend/app/routers/admin.py`

### خدمات پلتفرم

- [ورود و ثبت‌نام](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [مدیریت آپلود](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/services/uploads.py): `backend/app/services/uploads.py`
- [اعلان‌ها](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/services/notify.py): `backend/app/services/notify.py`
- [احراز هویت و دسترسی](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [پایگاه داده](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/database.py): `backend/app/database.py`
- [مدل‌های دامنه](https://github.com/omidrezatech/afaghapp/blob/main/backend/app/models/order.py): `backend/app/models/order.py`

### Other components

- **مشتری**
- **اپراتور**
- **ادمین و پشتیبان**
- **درگاه پیامک**
- **Redis یا کش حافظه**

## Connections

- مشتری → فضای مشتری: ثبت درخواست
- اپراتور → پنل اپراتور: پذیرش سفارش
- ادمین و پشتیبان → پنل مدیریت: تأیید رسید
- فضای مشتری → ورود و ثبت‌نام: ورود موبایلی
- فضای مشتری → کاتالوگ خدمات: انتخاب خدمت
- فضای مشتری → چرخه سفارش: ثبت سفارش
- پنل اپراتور → چرخه سفارش: قبول سفارش
- چرخه سفارش → چت سفارش: ایجاد چت اختصاصی
- چرخه سفارش → رسید و پرداخت: صدور فاکتور
- فضای مشتری → رسید و پرداخت: ارسال رسید
- پنل مدیریت → رسید و پرداخت: تأیید رسید
- رسید و پرداخت → کیف پول و تسویه: نگهداری امانی (evidence: `backend/app/routers/payments.py`)
- فضای مشتری → چرخه سفارش: تأیید تحویل
- چرخه سفارش → کیف پول و تسویه: آزادسازی وجه (evidence: `backend/app/routers/orders.py`)
- فضای مشتری → شکایت و داوری: ثبت شکایت
- ادمین و پشتیبان → شکایت و داوری: رسیدگی داوری
- پنل مدیریت → مدیریت و نظارت: مدیریت پلتفرم
- چرخه سفارش → آزادسازی سفارشات معطّل: بررسی سفارش معطّل (evidence: `backend/app/services/jobs_worker.py`)
- آزادسازی سفارشات معطّل → اعلان‌ها: ارسال رویداد (evidence: `backend/app/services/jobs_worker.py`)
- آزادسازی سفارشات معطّل → پایگاه داده: خواندن و به‌روزرسانی (evidence: `backend/app/services/jobs_worker.py`)
- آزادسازی سفارشات معطّل → مدل‌های دامنه: خواندن سفارش و چت (evidence: `backend/app/services/jobs_worker.py`)
- چرخه سفارش → اعلان‌ها: اعلان سفارش (evidence: `backend/app/routers/orders.py`)
- رسید و پرداخت → کیف پول و تسویه: اجرای مالی (evidence: `backend/app/routers/payments.py`)
- ورود و ثبت‌نام → درگاه پیامک: ارسال کد (evidence: `backend/app/routers/auth.py`)
- ورود و ثبت‌نام → Redis یا کش حافظه: ذخیره کد و محدودسازی (evidence: `backend/app/routers/auth.py`)
- ورود و ثبت‌نام → مدیریت آپلود: ذخیره مدارک (evidence: `backend/app/routers/auth.py`)
- ورود و ثبت‌نام → احراز هویت و دسترسی: ساخت نشست (evidence: `backend/app/routers/auth.py`)
- احراز هویت و دسترسی → پایگاه داده: خواندن کاربر (evidence: `backend/app/core/security.py`)
- کاتالوگ خدمات → پایگاه داده: خواندن و تغییر نرخنامه (evidence: `backend/app/routers/services.py`)
- چرخه سفارش → پایگاه داده: خواندن و نوشتن سفارش (evidence: `backend/app/routers/orders.py`)
- چت سفارش → پایگاه داده: خواندن و نوشتن گفتگو (evidence: `backend/app/routers/chat.py`)
- رویدادهای بلادرنگ → پایگاه داده: خواندن کاربر (evidence: `backend/app/realtime/socket_server.py`)
- مدیریت و نظارت → کیف پول و تسویه: اجرای مالی (evidence: `backend/app/routers/admin.py`)
- مدیریت و نظارت → اعلان‌ها: ارسال اعلان (evidence: `backend/app/routers/admin.py`)
- شکایت و داوری → کیف پول و تسویه: اجرای رأی مالی (evidence: `backend/app/routers/support.py`)
- رسید و پرداخت → مدیریت آپلود: ذخیره رسید (evidence: `backend/app/routers/payments.py`)
