MMD
bf3c67f405
- نمودار مسیریابی Traefik (/ و /api و /media) جایگزین توضیحات nginx - مستندسازی «همه متن‌ها در دیتابیس» و آپلود تصویر به MinIO - پورت‌های جدید: سایت ۵۱۷۳ (Traefik)، کنسول MinIO ۹۰۰۱ - رفتار seed در ارتقا (فقط جدول‌های خالی) و پروکسی dev فرانت‌اند
98 lines
5.1 KiB
Markdown
98 lines
5.1 KiB
Markdown
# گروه ساختمانی آرامش — پروژه کامل (فرانت‌اند + بک‌اند)
|
|
|
|
مونوریپوی سایت گروه ساختمانی آرامش شامل:
|
|
|
|
- **`frontend/`** — سایت React + Vite + Tailwind (تمام متن‌ها و تصاویر از API خوانده می‌شود)
|
|
- **`backend/`** — بک‌اند FastAPI + SQLAlchemy 2 + PostgreSQL + JWT + MinIO
|
|
|
|
## معماری
|
|
|
|
```
|
|
Traefik (پورت ۵۱۷۳ — تنها نقطه ورود)
|
|
├── / → Caddy (فایل‌های استاتیک SPA)
|
|
├── /api → FastAPI (بک‌اند)
|
|
└── /media → MinIO (باکت aramesh-media — تصاویر آپلودی)
|
|
```
|
|
|
|
- **همه محتوای متنی سایت در PostgreSQL است** — هیچ متنی در کد فرانت‌اند هاردکد نشده؛
|
|
با یک درخواست `GET /api/site` بارگذاری و از پنل مدیریت ویرایش می‌شود
|
|
- **تصاویر آپلودی در MinIO** (Object Storage سازگار با S3) ذخیره می‌شوند و با مسیر نسبی
|
|
`/media/...` برگردانده می‌شوند — بک‌اند ذخیره‌سازی بدون تغییر محتوای دیتابیس قابل تعویض است
|
|
- مسیریابی همه‌چیز روی **Traefik** است (با Docker labels) — nginx در پروژه وجود ندارد
|
|
|
|
## ساختار
|
|
|
|
```
|
|
├── frontend/ # سایت React
|
|
│ ├── src/ # کد منبع (api.tsx = لایه اتصال به بک‌اند)
|
|
│ ├── Dockerfile # بیلد Node + سرو استاتیک با Caddy
|
|
│ └── Caddyfile # فقط سرو فایل‌های استاتیک (مسیریابی روی Traefik است)
|
|
├── backend/ # بک‌اند FastAPI
|
|
│ ├── app/ # کد منبع (آپلود تصویر: app/api/admin.py)
|
|
│ ├── requirements.txt
|
|
│ ├── Dockerfile
|
|
│ └── .env.example
|
|
└── docker-compose.yml # اجرای کامل با یک دستور
|
|
```
|
|
|
|
## اجرا با Docker (ساده‌ترین راه)
|
|
|
|
```bash
|
|
docker compose up --build
|
|
```
|
|
|
|
- سایت: http://localhost:5173 (از طریق Traefik)
|
|
- مستندات API: http://localhost:8001/docs (با `docker-compose.override.yml` محلی)
|
|
- کنسول MinIO: http://localhost:9001 — کاربر/رمز از متغیرهای `MINIO_ROOT_*` در compose
|
|
- دیتابیس PostgreSQL و آبجکت‌استور MinIO هر دو در کانتینر جدا با volume دائمی
|
|
- بک‌اند هنگام شروع، خودش جداول را می‌سازد و **فقط جدول‌های خالی** را seed می‌کند —
|
|
ارتقای نسخه داده‌های فعلی را از بین نمی‌برد
|
|
- در اولین اجرا، سرویس `minio-setup` باکت `aramesh-media` را می‌سازد و خواندن عمومی را فعال می‌کند
|
|
|
|
## اجرای محلی (توسعه)
|
|
|
|
### بک‌اند
|
|
|
|
```bash
|
|
cd backend
|
|
python -m venv .venv
|
|
.venv\Scripts\activate # ویندوز — در لینوکس: source .venv/bin/activate
|
|
pip install -r requirements.txt
|
|
|
|
# فایل .env از روی .env.example بسازید و DATABASE_URL را تنظیم کنید
|
|
python -m app.seed # ساخت جداول + محتوای اولیه
|
|
uvicorn app.main:app --reload
|
|
```
|
|
|
|
### فرانت‌اند
|
|
|
|
```bash
|
|
cd frontend
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
در حالت توسعه، Vite درخواست‌های `/api` و `/media` را به Traefik (پورت ۵۱۷۳) پروکسی می‌کند؛
|
|
پس استک Docker باید در حال اجرا باشد. آدرس بک‌اند در `frontend/src/config.ts` از
|
|
`VITE_API_URL` خوانده می‌شود — پیش‌فرض خالی یعنی درخواست‌های هم‌مبدأ.
|
|
|
|
## امکانات بک‌اند
|
|
|
|
- **API عمومی**: برند، منو، هیرو، خدمات، پروژه‌ها، مقالات، نظرات، سوالات متداول، تیم،
|
|
تایم‌لاین، آمار، دفاتر، مدل‌های سرمایه‌گذاری و... — همه در دیتابیس
|
|
- **فرم تماس** `POST /api/contact` و **خبرنامه** `POST /api/newsletter`
|
|
- **پنل مدیریت** با JWT: ورود `POST /api/auth/login` (پیش‌فرض: `admin` / `aramesh123`)
|
|
و سپس CRUD کامل همه محتواها در `/api/admin/...`
|
|
- **آپلود تصویر** `POST /api/admin/upload` (فقط توکن ادمین، حداکثر ۱۰MB) — فایل در MinIO
|
|
ذخیره و URL نسبی `/media/...` برمی‌گردد
|
|
- همه محتوا در یک درخواست: `GET /api/site`
|
|
|
|
> در محیط واقعی حتماً `SECRET_KEY`، `ADMIN_PASSWORD` و `MINIO_ROOT_PASSWORD` را تغییر دهید.
|
|
|
|
## نکات امنیتی
|
|
|
|
- فایل `.env` هرگز commit نمی‌شود (در `.gitignore` است)
|
|
- رمز عبور ادمین با bcrypt هش می‌شود
|
|
- توکن‌های JWT امضا دارند و مدت اعتبارشان قابل تنظیم است
|
|
- تصاویر باکت MinIO عمومی (فقط خواندن) هستند؛ آپلود فقط با توکن ادمین ممکن است
|