diff --git a/DOCKER.md b/DOCKER.md
new file mode 100644
index 0000000..072a0ed
--- /dev/null
+++ b/DOCKER.md
@@ -0,0 +1,62 @@
+# راهنمای استفاده از Docker در پروژه Gold Bank Monorepo
+
+این پروژه به منظور استقرار (Deployment) در محیط عملیاتی و همچنین استفاده در محیط توسعه (در صورت نیاز) به صورت کامل **داکرایز (Dockerized)** شده است. در اینجا از معماری **Turborepo** به همراه مدیر بسته‌ی **pnpm** استفاده می‌شود، لذا استراتژی داکرایز کردن به گونه‌ای طراحی شده تا با کش (Cache) هوشمند و استفاده از `turbo prune` بالاترین سرعت بیلد و کمترین حجم نهایی ایمیج‌ها را به همراه داشته باشد.
+
+## معماری و ساختار ایمیج‌ها
+
+برای هر یک از سرویس‌های پروژه یک فایل `Dockerfile` چند‌مرحله‌ای (Multi-stage) ایجاد شده است:
+
+### 1. بک‌اند (`apps/api`)
+- **تکنولوژی:** NestJS + Prisma
+- **مسیر:** `apps/api/Dockerfile`
+- **شرح استیج‌ها:**
+  - **Builder:** با استفاده از `turbo prune api --docker`، کدهای مربوط به این اپلیکیشن و وابستگی‌های آن از مونو‌ریپو ایزوله می‌شود.
+  - **Installer:** پکیج‌ها به وسیله‌ی `pnpm install` روی کدهای ایزوله‌شده نصب می‌گردند.
+  - **Build:** پس از تولید Prisma Client، اپلیکیشن با دستور `turbo run build` کامپایل می‌گردد.
+  - **Runner:** کدهای کامپایل‌شده (پوشه `dist`) در یک کانتینر سبُک `node:20-alpine` کپی شده و اپلیکیشن از طریق فایل `dist/main.js` روی پورت `3000` سرو می‌شود. کانتینر در این استیج به دلایل امنیتی با یوزر `nestjs` (غیر از root) اجرا می‌شود.
+
+### 2. پنل ادمین (`apps/admin-panel`)
+- **تکنولوژی:** Vue 3 + Vite
+- **مسیر:** `apps/admin-panel/Dockerfile`
+- **شرح استیج‌ها:**
+  پس از طی شدن مراحل ایزوله کردن و کامپایل کد (مشابه API)، فایل‌های استاتیک نهایی به یک ایمیج `nginx:alpine` منتقل می‌گردند تا با پرفورمنس بالا سرو شوند (پورت `8080`).
+
+### 3. سمت کاربر (`apps/user-app`)
+- **تکنولوژی:** Vue 3 + Vite (PWA)
+- **مسیر:** `apps/user-app/Dockerfile`
+- **شرح استیج‌ها:**
+  دقیقاً مشابه پنل ادمین، پس از بیلد شدن، کدهای استاتیک PWA به وسیله‌ی وب‌سرور Nginx (روی پورت `8081`) در دسترس قرار می‌گیرند.
+
+## پیکربندی Nginx (مسیردهی SPA)
+فایل `nginx-spa.conf` در مسیر روت پروژه قرار دارد. وظیفه اصلی آن هدایت تمام درخواست‌هایی است که Route متناظر برای آن‌ها یافت نمی‌شود به `index.html`. این کار برای کارکرد صحیح Vue Router (به صورت History Mode) ضروری است. این فایل به صورت خودکار در ایمیج‌های فرانت‌اند کپی می‌شود.
+
+---
+
+## نحوه‌ی اجرا (Docker Compose)
+
+یک فایل `docker-compose.yml` در مسیر اصلی ریپازیتوری جهت هماهنگ‌سازی (Orchestration) تمام سرویس‌ها در کنار هم قرار داده شده است.
+
+### 1. تنظیم فایل `.env`
+در روت پروژه فایلی با نام `.env.example` وجود دارد. قبل از اجرا، یک کپی از آن با نام `.env` بگیرید. 
+متغیرهای درون این فایل شامل تنظیمات دیتابیس (مانند `POSTGRES_USER` و `POSTGRES_PASSWORD`) است که هم در دیتابیس و هم در `DATABASE_URL` استفاده می‌شود.
+
+### 2. راه‌اندازی (Build & Up)
+کافیست دستور زیر را اجرا کنید تا داکر به صورت خودکار تمام ایمیج‌ها را ساخته و کانتینرها را استارت کند:
+```bash
+docker-compose up --build -d
+```
+پس از اجرای موفقیت‌آمیز، سرویس‌ها به این ترتیب در دسترس خواهند بود:
+- دیتابیس (PostgreSQL): `localhost:5432`
+- رابط کاربری ادمین (Admin Panel): `http://localhost:8080`
+- اپلیکیشن کاربران (User App): `http://localhost:8081`
+- سرویس بک‌اند (API): `http://localhost:3000`
+
+### 3. اجرای مایگریشن‌های دیتابیس
+در صورت بالا آمدن کانتینرها برای اولین بار، دیتابیس شما خالی است. لازم است تا با استفاده از Prisma مایگریشن‌ها را روی دیتابیس اجرا کنید:
+```bash
+# از روی سیستم اصلی و در مسیر روت پروژه:
+pnpm --filter api exec prisma migrate deploy
+# یا استفاده از:
+pnpm --filter api exec prisma db push
+```
+*(توجه: آدرس `DATABASE_URL` در فایل `.env` باید به صورت لوکال به `localhost:5432` اشاره کند تا از خارج کانتینر نیز در دسترس باشد)*.