Document production deploy gotchas for SMS, Postgres, and shared symlink.
Capture real server lessons so future updates avoid DATABASE_URL, tarball, and nginx traps. Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -7,8 +7,8 @@ CORS_ORIGIN=https://crm.montzar.ir
|
|||||||
JWT_SECRET=change-me-long-random-production-secret
|
JWT_SECRET=change-me-long-random-production-secret
|
||||||
JWT_EXPIRES_IN=7d
|
JWT_EXPIRES_IN=7d
|
||||||
|
|
||||||
# Postgres روی همین سرور — دیتابیس جدا برای CRM (به DB مونتایم دست نزنید)
|
# Postgres روی همین سرور — پورت واقعی این هاست معمولاً 15432 است (نه 5432)
|
||||||
DATABASE_URL="postgresql://mento:CHANGE_ME@127.0.0.1:5432/mento_crm?schema=public"
|
DATABASE_URL="postgresql://mento:CHANGE_ME@127.0.0.1:15432/mento_crm?schema=public"
|
||||||
|
|
||||||
UPLOAD_DIR=/var/www/crm/uploads
|
UPLOAD_DIR=/var/www/crm/uploads
|
||||||
|
|
||||||
|
|||||||
+110
-30
@@ -2,19 +2,22 @@
|
|||||||
|
|
||||||
هاست مشترک مونتایم: `185.50.38.53` (SSH پورت `3031`، کاربر `montime`)
|
هاست مشترک مونتایم: `185.50.38.53` (SSH پورت `3031`، کاربر `montime`)
|
||||||
دامنه: `https://crm.montzar.ir`
|
دامنه: `https://crm.montzar.ir`
|
||||||
|
مسیر کد: `/var/www/crm`
|
||||||
پورت داخلی API: `3030`
|
پورت داخلی API: `3030`
|
||||||
(۳۰۰۰ مونتایم، ۳۰۰۱ فوریسند، ۳۰۱۰ سوپرادمین، ۳۰۲۰ کاتالوگ)
|
PM2: `mento-crm-api` (cwd: `apps/api`، اسکریپت: `dist/src/main.js`)
|
||||||
|
|
||||||
کد از Gitea: `http://get.feep.ir/Mahdi/CRM_Montzar.git`
|
کد از Gitea: `http://get.feep.ir/Mahdi/CRM_Montzar.git`
|
||||||
|
|
||||||
|
پورتهای اشغالشده روی همین سرور (دست نزنید):
|
||||||
|
۳۰۰۰ مونتایم · ۳۰۰۱ فوریسند · ۳۰۱۰ سوپرادمین · ۳۰۲۰ کاتالوگ
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## کارهایی که شما باید انجام دهید (قبل/همراه استقرار)
|
## کارهایی که شما باید انجام دهید (قبل/همراه استقرار)
|
||||||
|
|
||||||
1. **DNS:** رکورد `A` برای `crm.montzar.ir` مثل `ktg.montzar.ir` / `adm.montzar.ir` روی همان IP.
|
1. **DNS:** رکورد `A` برای `crm.montzar.ir` مثل `ktg.montzar.ir` / `adm.montzar.ir` روی همان IP.
|
||||||
2. **Postgres:** یک دیتابیس و کاربر جدا برای CRM بسازید (مثلاً `mento_crm`) — به دیتابیس مونتایم دست نزنید.
|
2. **Postgres:** دیتابیس و کاربر جدا (`mento_crm`) — به دیتابیس مونتایم دست نزنید.
|
||||||
3. **SMS:** همان حساب ترِز/رایگان مونتایم را در `.env` سرور CRM بگذارید (`SMS_USERNAME` / `SMS_PASSWORD` / `SMS_SENDER`).
|
3. **SMS:** همان حساب ترِز/رایگان مونتایم در `.env` (`SMS_USERNAME` / `SMS_PASSWORD` / `SMS_SENDER`).
|
||||||
4. **دسترسی Gitea** برای `git clone` / `git pull` روی سرور (یوزر یا توکن).
|
4. **دسترسی Gitea** برای `git clone` / `git pull` روی سرور.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -51,26 +54,69 @@ cp deploy/.env.production.example apps/api/.env
|
|||||||
nano apps/api/.env
|
nano apps/api/.env
|
||||||
```
|
```
|
||||||
|
|
||||||
`DATABASE_URL`، `JWT_SECRET` و فیلدهای `SMS_*` را پر کنید.
|
نکتههای حیاتی:
|
||||||
`PORTAL_SHOW_OTP=false` بماند تا کد فقط با پیامک برود.
|
|
||||||
|
|
||||||
### ۴) نصب، migrate، بیلد
|
| کلید | مقدار واقعی روی این سرور |
|
||||||
|
|---|---|
|
||||||
|
| `DATABASE_URL` | Postgres روی **`127.0.0.1:15432`** است نه `5432` |
|
||||||
|
| `PORT` | `3030` |
|
||||||
|
| `CORS_ORIGIN` | `https://crm.montzar.ir` |
|
||||||
|
| `SMS_*` | همان ترِز مونتایم |
|
||||||
|
| `PORTAL_SHOW_OTP` | در production حتماً `false` |
|
||||||
|
|
||||||
Node ۲۰ یا جدیدتر.
|
نمونهٔ اتصال:
|
||||||
|
|
||||||
|
```text
|
||||||
|
DATABASE_URL="postgresql://USER:PASS@127.0.0.1:15432/mento_crm?schema=public"
|
||||||
|
```
|
||||||
|
|
||||||
|
### ۴) نصب وابستگیها
|
||||||
|
|
||||||
|
اگر `npm ci` روی سرور timeout زد، از ویندوز بیلد لینوکسی بگیرید و بفرستید:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
# روی ویندوز، در ریشهٔ ریپو
|
||||||
|
npm ci --os=linux --cpu=x64
|
||||||
|
tar -czf crm-node_modules.tgz node_modules
|
||||||
|
scp -P 3031 crm-node_modules.tgz montime@185.50.38.53:/var/www/crm/
|
||||||
|
```
|
||||||
|
|
||||||
|
روی سرور:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /var/www/crm
|
||||||
|
tar -xzf crm-node_modules.tgz
|
||||||
|
chmod +x node_modules/.bin/*
|
||||||
|
find node_modules -path '*esbuild*' -name 'esbuild' -type f -exec chmod +x {} \;
|
||||||
|
|
||||||
|
# مهم: tarball کپی کهنه از @mento/shared میگذارد — همیشه symlink بسازید
|
||||||
|
rm -rf node_modules/@mento/shared
|
||||||
|
ln -s ../../packages/shared node_modules/@mento/shared
|
||||||
|
```
|
||||||
|
|
||||||
|
اگر `npm ci` روی سرور خودش جواب داد، معمولاً symlink workspace درست است؛ باز هم با `ls -la node_modules/@mento/shared` چک کنید که به `packages/shared` اشاره کند.
|
||||||
|
|
||||||
|
### ۵) migrate و بیلد
|
||||||
|
|
||||||
|
`dist/` در git نیست؛ همیشه اول `shared` را بیلد کنید.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd /var/www/crm
|
cd /var/www/crm
|
||||||
npm ci
|
|
||||||
npm run build -w @mento/shared
|
npm run build -w @mento/shared
|
||||||
npx prisma migrate deploy --schema apps/api/prisma/schema.prisma
|
|
||||||
npx prisma generate --schema apps/api/prisma/schema.prisma
|
# Prisma فقط از apps/api/.env میخواند — از ریشه بدون env خطا میدهد (P1012)
|
||||||
|
cd /var/www/crm/apps/api
|
||||||
|
npx prisma migrate deploy
|
||||||
|
npx prisma generate
|
||||||
|
|
||||||
|
cd /var/www/crm
|
||||||
npm run build -w @mento/api
|
npm run build -w @mento/api
|
||||||
npm run build -w @mento/web
|
npm run build -w @mento/web
|
||||||
mkdir -p uploads
|
mkdir -p uploads
|
||||||
# اختیاری یکبار: npm run db:seed
|
# اختیاری یکبار: npm run db:seed
|
||||||
```
|
```
|
||||||
|
|
||||||
### ۵) PM2 — فقط پروسهٔ جدید
|
### ۶) PM2 — فقط پروسهٔ جدید
|
||||||
|
|
||||||
پروسههای موجود را stop نکنید.
|
پروسههای موجود را stop نکنید.
|
||||||
|
|
||||||
@@ -81,9 +127,9 @@ pm2 list
|
|||||||
curl -sI http://127.0.0.1:3030/api/health
|
curl -sI http://127.0.0.1:3030/api/health
|
||||||
```
|
```
|
||||||
|
|
||||||
باید `200` و JSON سلامت بیاید. خطا: `pm2 logs mento-crm-api --lines 80`
|
باید `200` بیاید. خطا: `pm2 logs mento-crm-api --lines 80`
|
||||||
|
|
||||||
### ۶) Nginx — فقط سایت جدید
|
### ۷) Nginx
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo cp /var/www/crm/deploy/nginx-crm.montzar.ir.conf /etc/nginx/sites-available/crm.montzar.ir
|
sudo cp /var/www/crm/deploy/nginx-crm.montzar.ir.conf /etc/nginx/sites-available/crm.montzar.ir
|
||||||
@@ -91,39 +137,73 @@ sudo ln -sf /etc/nginx/sites-available/crm.montzar.ir /etc/nginx/sites-enabled/
|
|||||||
sudo nginx -t && sudo systemctl reload nginx
|
sudo nginx -t && sudo systemctl reload nginx
|
||||||
```
|
```
|
||||||
|
|
||||||
اگر `nginx -t` خطا داد، vhostهای دیگر را ویرایش نکنید.
|
**HTTPS روی همین باکس:** مثل `ktg.montzar.ir`، فرانتپروکسی (`91.247.174.1`) SSL را تمام میکند و به این سرور **HTTP :80** میزند.
|
||||||
|
اگر Certbot روی این vhost `return 404` یا فقط HTTPS بگذارد، سایت از بیرون قطع میشود — vhost را روی الگوی HTTP نگه دارید (فایل `deploy/nginx-crm.montzar.ir.conf`).
|
||||||
### ۷) SSL
|
|
||||||
|
|
||||||
```bash
|
|
||||||
sudo certbot --nginx -d crm.montzar.ir
|
|
||||||
```
|
|
||||||
|
|
||||||
### ۸) تست
|
### ۸) تست
|
||||||
|
|
||||||
1. `https://crm.montzar.ir` → ورود پنل
|
1. `https://crm.montzar.ir` → ورود پنل
|
||||||
2. دمو: `owner@demo.local` / `demo1234` (اگر seed زده باشید)
|
2. دمو: `owner@demo.local` / `demo1234` (اگر seed زده باشید)
|
||||||
3. پرتال: `https://crm.montzar.ir/p/demo-mento` → OTP باید پیامک شود
|
3. پرتال: `https://crm.montzar.ir/p/demo-mento` → OTP باید پیامک شود
|
||||||
4. منوی گزارشات کار کند
|
4. منوها: گزارشات، کاریز پروژه، باشگاه مشتریان، اتوماسیون (مالک/مدیر)
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## آپدیت بعدی
|
## آپدیت بعدی (بعد از `git push`)
|
||||||
|
|
||||||
روی ویندوز `git push`. روی سرور:
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
ssh -p 3031 montime@185.50.38.53
|
||||||
cd /var/www/crm
|
cd /var/www/crm
|
||||||
git pull
|
git pull
|
||||||
npm ci
|
|
||||||
|
# اگر node_modules از tarball تازه شد، دوباره symlink:
|
||||||
|
# rm -rf node_modules/@mento/shared && ln -s ../../packages/shared node_modules/@mento/shared
|
||||||
|
# chmod +x node_modules/.bin/*
|
||||||
|
|
||||||
npm run build -w @mento/shared
|
npm run build -w @mento/shared
|
||||||
npx prisma migrate deploy --schema apps/api/prisma/schema.prisma
|
cd apps/api && npx prisma migrate deploy && npx prisma generate && cd ../..
|
||||||
npm run build -w @mento/api
|
npm run build -w @mento/api
|
||||||
npm run build -w @mento/web
|
npm run build -w @mento/web
|
||||||
pm2 restart mento-crm-api
|
pm2 restart mento-crm-api
|
||||||
```
|
```
|
||||||
|
|
||||||
پوشهٔ `uploads` و `apps/api/.env` را پاک نکنید.
|
پاک نکنید: `uploads/` و `apps/api/.env`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## پیامک (OTP پرتال)
|
||||||
|
|
||||||
|
- سرویس: `apps/api/src/common/sms.service.ts` — الگوی ترِز مثل مونتایم
|
||||||
|
- تنظیمات فقط در `apps/api/.env` (نمونه: `deploy/.env.production.example`)
|
||||||
|
- کلیدها: `SMS_PROVIDER=trez`، `SMS_USERNAME`، `SMS_PASSWORD`، `SMS_SENDER`، `SMS_BASE_URL`، `SMS_SEND_PATH`، `SMS_OTP_TEMPLATE`
|
||||||
|
- در production: `PORTAL_SHOW_OTP=false` تا کد فقط با پیامک برود (نه در JSON پاسخ)
|
||||||
|
- تست: ورود پرتال با موبایل ثبتشده روی شخص سازمان
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## مشکلات رایج (تجربهٔ واقعی همین سرور)
|
||||||
|
|
||||||
|
| علامت | علت | راه حل |
|
||||||
|
|---|---|---|
|
||||||
|
| Prisma `P1012` / `DATABASE_URL` not found | migrate از `/var/www/crm` بدون `.env` | `cd apps/api` سپس `npx prisma migrate deploy` |
|
||||||
|
| اتصال DB رد میشود با پورت `5432` | Postgres این سرور روی **15432** است | `DATABASE_URL` را با `:15432` بگذارید |
|
||||||
|
| Nest: `@mento/shared` has no exported member … | `node_modules/@mento/shared` کپی قدیمی از tarball است | `rm -rf node_modules/@mento/shared && ln -s ../../packages/shared node_modules/@mento/shared` سپس بیلد `shared` و `api` |
|
||||||
|
| بعد از بیلد shared هنوز تایپها نیستند | همان کپی کهنه | `grep AutomationAction node_modules/@mento/shared/dist/index.d.ts` باید match بدهد |
|
||||||
|
| `esbuild` / `.bin` Permission denied | tarball از ویندوز بدون بیت اجرایی | `chmod +x node_modules/.bin/*` و باینری esbuild |
|
||||||
|
| `npm ci` timeout روی سرور | شبکه/رجیستری کند | tarball لینوکسی از ویندوز (`npm ci --os=linux --cpu=x64`) |
|
||||||
|
| سایت از بیرون 404 بعد از Certbot | SSL روی باکس بکاند، پروکسی جلویی HTTP میزند | vhost را فقط HTTP :80 مثل ktg نگه دارید |
|
||||||
|
| PM2 فایل را پیدا نمیکند | خروجی Nest زیر `dist/src/main.js` است | `deploy/ecosystem.config.cjs` را عوض نکنید (`cwd` = `apps/api`) |
|
||||||
|
|
||||||
|
تشخیص سریع لینک shared:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ls -la /var/www/crm/node_modules/@mento/shared
|
||||||
|
# باید شبیه این باشد:
|
||||||
|
# ... -> ../../packages/shared
|
||||||
|
grep -c AutomationAction /var/www/crm/packages/shared/dist/index.d.ts
|
||||||
|
grep -c AutomationAction /var/www/crm/node_modules/@mento/shared/dist/index.d.ts
|
||||||
|
# هر دو باید یک عدد (>0) باشند
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@@ -135,4 +215,4 @@ pm2 restart mento-crm-api
|
|||||||
| پورت ۳۰۳۰ | ۳۰۰۰ / ۳۰۰۱ / ۳۰۱۰ / ۳۰۲۰ |
|
| پورت ۳۰۳۰ | ۳۰۰۰ / ۳۰۰۱ / ۳۰۱۰ / ۳۰۲۰ |
|
||||||
| PM2 نام `mento-crm-api` | پروسههای موجود |
|
| PM2 نام `mento-crm-api` | پروسههای موجود |
|
||||||
| `/var/www/crm` | `/var/www/ktg` و … |
|
| `/var/www/crm` | `/var/www/ktg` و … |
|
||||||
| دیتابیس `mento_crm` | Postgres مونتایم |
|
| دیتابیس `mento_crm` روی `:15432` | Postgres مونتایم |
|
||||||
|
|||||||
@@ -15,6 +15,7 @@
|
|||||||
| تاریخ | مورد |
|
| تاریخ | مورد |
|
||||||
|---|---|
|
|---|---|
|
||||||
| ۱۴۰۵/۶/۸ | کاریز پروژه + باشگاه مشتریان + اتوماسیون اگر/آنگاه |
|
| ۱۴۰۵/۶/۸ | کاریز پروژه + باشگاه مشتریان + اتوماسیون اگر/آنگاه |
|
||||||
|
| ۱۴۰۵/۶/۸ | تکمیل `deploy/DEPLOY.md`: پورت DB ۱۵۴۳۲، Prisma از `apps/api`، symlink `@mento/shared`، SMS ترِز، تلههای tarball/nginx |
|
||||||
| ۱۴۰۵/۶/۷ | پرتال مشتری OTP + گزارشات و داشبورد |
|
| ۱۴۰۵/۶/۷ | پرتال مشتری OTP + گزارشات و داشبورد |
|
||||||
| ۱۴۰۵/۶/۷ | SLA + FAQ + CSAT روی تیکت |
|
| ۱۴۰۵/۶/۷ | SLA + FAQ + CSAT روی تیکت |
|
||||||
| ۱۴۰۵/۶/۷ | تیکتینگ پایه (لیست/فرم/گفتگو/ارجاع) |
|
| ۱۴۰۵/۶/۷ | تیکتینگ پایه (لیست/فرم/گفتگو/ارجاع) |
|
||||||
|
|||||||
Reference in New Issue
Block a user