# 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
```

## دیپلوی: بیلد روی سیستم خودت، اجرا روی سرور

روی سرور هیچ `npm` و هیچ دستور `prisma` اجرا نمی‌شود. سه چیز از قبل ساخته و روی
گیت هستند: `dist`، `prisma-client.tar.gz` (کلاینت Prisma) و
`deploy-bundle.tar.gz` (`node_modules` پروداکشن).

**۱) روی سیستم خودت:**

```bash
cd fabric_trade_server
npm run deploy:build
git add dist prisma-client.tar.gz && git commit -m "..." && git push
```

**۲) روی سرور:**

```bash
cd /opt/parche/server
git pull
docker compose up -d --build
docker compose logs -f api
```

`Dockerfile` باندل را باز می‌کند، بعد `dist` و `prisma` و کلاینت آماده‌ی Prisma
را روی آن می‌نویسد. `prisma generate` روی هاست پروداکشن چند دقیقه طول می‌کشد،
پس عمداً آنجا اجرا نمی‌شود.

هر بار که `prisma/schema.prisma` را عوض کردی، `npm run deploy:build` را بزن تا
`prisma-client.tar.gz` هم به‌روز شود؛ وگرنه سرور با کلاینت قدیمی بالا می‌آید.

**فقط اگر پکیج npm جدید اضافه شد** باندل را دوباره بساز و push کن:

```bash
bash scripts/pack-bundle.sh
git add deploy-bundle.tar.gz && git commit -m "refresh deploy bundle" && git push
```

- `env` سرور از `.env` همان پوشه خوانده می‌شود (`env_file` در compose)
- API روی `127.0.0.1:${API_PORT}` بالا می‌آید (سرور: `8585`)
- مایگریشن موقع استارت کانتینر اجرا می‌شود
- LiteSpeed را Reverse Proxy کنید به `http://127.0.0.1:8585`

مثال مسیر 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 |
|------|------|-----------|
| ادمین | `09128081392` | `123456` |
| مشتری | `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