mohmdsdgandCursor
345a4a4708
Ship 4-digit OTP with rate-limit attempts, Tehran-safe expiry/rass math, larger JSON body limit for check images, and safer order pricing/status guards. Include rebuilt dist for prebuilt deploy. Co-authored-by: Cursor <cursoragent@cursor.com>
107 lines
3.1 KiB
Markdown
107 lines
3.1 KiB
Markdown
# Fabric Trade Server
|
|
|
|
بک‌اند NestJS + Prisma + PostgreSQL برای اپ کاربر و پنل ادمین تجارت پارچه.
|
|
|
|
## پیش‌نیاز
|
|
|
|
- Node.js 20+
|
|
- Docker (برای PostgreSQL)
|
|
|
|
اگر به Docker دسترسی ندارید:
|
|
|
|
```bash
|
|
sudo usermod -aG docker "$USER"
|
|
# سپس یک‌بار logout/login کنید
|
|
```
|
|
|
|
## راه‌اندازی سریع (لوکال بدون Docker برای API)
|
|
|
|
```bash
|
|
cd fabric_trade_server
|
|
docker compose up -d postgres
|
|
npm install
|
|
npx prisma migrate deploy
|
|
npm run prisma:seed
|
|
npm run start:dev
|
|
```
|
|
|
|
## دیپلوی با Docker Compose (پیشنهادی برای سرور)
|
|
|
|
روی سرور داخل `fabric_trade_server`:
|
|
|
|
```bash
|
|
# اولین بار با دیتای فیک:
|
|
RUN_SEED=true docker compose up -d --build
|
|
|
|
# بعداً بدون seed:
|
|
docker compose up -d --build
|
|
```
|
|
|
|
اگر بیلد به‌خاطر رجیستری npm یا Alpine خطا داد (رایج روی سرورهای ایران):
|
|
|
|
```bash
|
|
# پیش‌فرض Dockerfile از میرور npmmirror استفاده می‌کند.
|
|
# در صورت نیاز:
|
|
docker compose build --build-arg NPM_REGISTRY=https://registry.npmmirror.com
|
|
RUN_SEED=true docker compose up -d
|
|
```
|
|
|
|
- API روی `127.0.0.1:3000` بالا می‌آید
|
|
- مایگریشن موقع استارت کانتینر اجرا می‌شود
|
|
- LiteSpeed را Reverse Proxy کنید به `http://127.0.0.1:3000`
|
|
|
|
مثال مسیر LiteSpeed: `https://domain.com/api/` → `http://127.0.0.1:3000/api/`
|
|
|
|
- API: http://localhost:3000/api
|
|
- Swagger: http://localhost:3000/api/docs
|
|
|
|
## حساب‌های تست (پس از seed)
|
|
|
|
| نقش | ورود | رمز / OTP |
|
|
|------|------|-----------|
|
|
| ادمین | `09121112222` | `admin123` |
|
|
| مشتری | `09121234567` | OTP پیامکی (۴ رقم) — با `SMS_ENABLED=false` کد ثابت: `1234` |
|
|
|
|
## متغیرهای محیطی
|
|
|
|
فایل `.env`:
|
|
|
|
```
|
|
DATABASE_URL=postgresql://fabric:fabric123@localhost:5432/fabric_trade?schema=public
|
|
JWT_SECRET=fabric-trade-dev-secret-change-me
|
|
JWT_EXPIRES_IN=7d
|
|
PORT=3000
|
|
MOCK_OTP_CODE=1234
|
|
OTP_TTL_MINUTES=5
|
|
SMS_ENABLED=true
|
|
SMS_API_URL=http://185.231.112.101/api/createsms
|
|
SMS_SECRET_KEY=...
|
|
SMS_PLATFORM=rayegansms
|
|
SMS_HOST=پارچه
|
|
SMS_APP_NAME=پارچه
|
|
```
|
|
|
|
## اسکریپت‌ها
|
|
|
|
| دستور | کار |
|
|
|--------|-----|
|
|
| `npm run db:up` | بالا آوردن Postgres |
|
|
| `npm run prisma:migrate` | مایگریشن توسعه |
|
|
| `npm run prisma:seed` | دیتای فیک |
|
|
| `npm run start:dev` | سرور با watch |
|
|
| `npm run db:reset` | ریست کامل دیتابیس |
|
|
|
|
## ساختار API (خلاصه)
|
|
|
|
### کاربر (Bearer JWT مشتری)
|
|
- `POST /api/auth/otp/request` / `verify`
|
|
- `GET /api/auth/me` · `PATCH /api/auth/profile`
|
|
- `GET /api/companies` · catalogs · products · bank-accounts
|
|
- `GET/POST /api/carts` …
|
|
- `GET/POST /api/orders` · `POST /api/orders/:id/cash-receipt`
|
|
|
|
### ادمین (Bearer JWT ادمین)
|
|
- `POST /api/admin/auth/login`
|
|
- `GET /api/admin/dashboard` · `/admin/reports` · `/admin/settings`
|
|
- CRUD: companies, catalogs, products, customers, users, orders, checks, cash-payments, shipments
|