Initial Mento CRM: portal OTP, reports, SMS, and deploy for crm.montzar.ir.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-29 21:06:30 +03:30
commit 29a040c21d
195 changed files with 39430 additions and 0 deletions
@@ -0,0 +1,123 @@
+# Mento CRM (منتو)
+
+Monorepo برای CRM فروش‌محور ایرانی با هم‌ترازی قابلیت نسبت به دیدار، به‌اضافه Smart Notes (سند کارفرما).
+
+## استک
+
+| بخش | فناوری |
+|---|---|
+| پنل | Vue 3 + Vite + TypeScript + Pinia |
+| API | NestJS |
+| دیتابیس | PostgreSQL (Prisma) |
+| صف/کش | Redis (آماده در Compose) |
+| فایل | MinIO (آماده در Compose) |
+| لندینگ | بعداً با Nuxt در `apps/landing` |
+
+UI را پیکسل‌به‌پیکسل از دیدار کپی نمی‌کنیم؛ هویت بصری مستقل **منتو (Mento)** است.
+
+## ساختار
+
+```text
+apps/
+  web/       # پنل Vue
+  api/       # NestJS
+packages/
+  shared/    # تایپ‌ها و قرارداد مشترک
+docs/        # نقشه راه و PRD
+docker-compose.yml
+```
+
+## پیش‌نیاز
+
+- Node.js 20+
+- PostgreSQL روی `localhost:5432` یا Docker Desktop
+- (اختیاری) Redis و MinIO از Compose
+
+اگر Docker دارید:
+
+```bash
+docker compose up -d
+```
+
+## راه‌اندازی
+
+```bash
+npm install
+npm run build -w @mento/shared
+npm run prisma:generate -w @mento/api
+npm run prisma:migrate -w @mento/api
+npm run prisma:seed -w @mento/api
+```
+
+ترمینال ۱:
+
+```bash
+npm run dev:api
+```
+
+ترمینال ۲:
+
+```bash
+npm run dev:web
+```
+
+- پنل: http://localhost:5173
+- API: http://localhost:3000/api/health
+
+حساب دمو بعد از seed:
+
+- مالک: `owner@demo.local` / `demo1234`
+- مدیر: `admin@demo.local` / `demo1234`
+- فروش: `sales@demo.local` / `demo1234`
+
+## فاز فعلی
+
+جزئیات تیک‌خورده و باقی‌مانده:
+
+- [`docs/وضعیت-پیشرفت.md`](docs/وضعیت-پیشرفت.md) ← **چک‌لیست زنده**
+
+مایل‌استون ۱-الف تقریباً کامل:
+
+- ✅ ورود / سازمان
+- ✅ اشخاص و شرکت‌ها (جستجو + جلوگیری از تکراری)
+- ✅ کاریز فروش کانبان (معامله، کشیدن بین مراحل)
+- ✅ فعالیت‌ها (امروز / عقب‌افتاده)
+- ✅ Smart Notes پایه (ثبت سریع، پین، تگ، اتصال، تبدیل به وظیفه)
+- ✅ فیلد سفارشی (تعریف + مقدار روی شخص/شرکت/معامله)
+- ✅ ایمپورت/اکسپورت اکسل مخاطبین
+- ✅ غنی‌سازی پرونده معامله (برچسب، راکد/فاسد، منبع، دلیل شکست)
+- ✅ محصول/خدمت روی معامله (کاتالوگ + ردیف و جمع مبلغ)
+- ✅ نوتیفیکیشن داخل برنامه (زنگ اعلان، خوانده/نخوانده، رویداد فعالیت و معامله)
+- ✅ تایم‌لاین پرونده (یادداشت + فعالیت روی شخص/شرکت/معامله)
+- ✅ تقویم فعالیت‌ها (نمای ماهانه + فیلتر بازه تاریخ)
+- ✅ چند کاریز فروش (انتخاب کاریز + ساخت کاریز جدید)
+- ✅ انواع Note (فیلتر + برچسب نوع روی کارت)
+- ✅ پیوست فایل روی Note (آپلود / دانلود / حذف)
+- ✅ نقش و دسترسی سازمانی (تیم، RolesGuard، تنظیمات فقط مالک/مدیر)
+- ✅ سطح دسترسی پرونده‌ای (فروش/پشتیبانی فقط مالکیت خود)
+- ✅ هدف‌گذاری و پیش‌بینی فروش پایه
+- ✅ چندارزی واقعی (ارز پایه + نرخ + انتخاب در فرم‌ها)
+- ✅ تیکتینگ پایه (گفتگو + ارجاع)
+- ✅ SLA + FAQ + CSAT
+- ✅ پرتال مشتری OTP (`/p/demo-mento` + SMS ترِز)
+- ✅ گزارشات و داشبورد
+- استقرار: [`deploy/DEPLOY.md`](deploy/DEPLOY.md) → `crm.montzar.ir`
+- ✅ فرم‌ساز سرنخ (لینک عمومی / iframe / QR)
+- ✅ پیش‌فاکتور (از معامله یا مستقل + چاپ)
+- ✅ فاکتور / پرداخت / اقساط ساده
+
+## راهنمای کاربری
+
+برای کار با پنل (زبان ساده، گام‌به‌گام):
+
+- [`docs/راهنمای-کاربری.md`](docs/راهنمای-کاربری.md)
+- [`docs/راهنمای-کاربری.docx`](docs/راهنمای-کاربری.docx)
+- [`docs/راهنمای-کاربری.pdf`](docs/راهنمای-کاربری.pdf)
+
+برای بازتولید Word/PDF:
+
+```bash
+python docs/export-doc.py --preset user-guide
+```
+
+سپس در صورت نیاز همان DOCX را از Word به PDF Export کنید.