Mento CRM (منتو)

Monorepo برای CRM فروش‌محور ایرانی با هم‌ترازی قابلیت نسبت به دیدار، به‌اضافه Smart Notes (سند کارفرما).

استک

بخش	فناوری
پنل	Vue 3 + Vite + TypeScript + Pinia
API	NestJS
دیتابیس	PostgreSQL (Prisma)
صف/کش	Redis (آماده در Compose)
فایل	MinIO (آماده در Compose)
لندینگ	بعداً با Nuxt در apps/landing

UI را پیکسل‌به‌پیکسل از دیدار کپی نمی‌کنیم؛ هویت بصری مستقل منتو (Mento) است.

ساختار

apps/
  web/       # پنل Vue
  api/       # NestJS
packages/
  shared/    # تایپ‌ها و قرارداد مشترک
docs/        # نقشه راه و PRD
docker-compose.yml

پیش‌نیاز

• Node.js 20+
• PostgreSQL روی localhost:5432 یا Docker Desktop
• (اختیاری) Redis و MinIO از Compose

اگر Docker دارید:

docker compose up -d

راه‌اندازی

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

ترمینال ۱:

npm run dev:api

ترمینال ۲:

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 ← چک‌لیست زنده

مایل‌استون ۱-الف تقریباً کامل:

• ✅ ورود / سازمان
• ✅ اشخاص و شرکت‌ها (جستجو + جلوگیری از تکراری)
• ✅ کاریز فروش کانبان (معامله، کشیدن بین مراحل)
• ✅ فعالیت‌ها (امروز / عقب‌افتاده)
• ✅ Smart Notes پایه (ثبت سریع، پین، تگ، اتصال، تبدیل به وظیفه)
• ✅ فیلد سفارشی (تعریف + مقدار روی شخص/شرکت/معامله)
• ✅ ایمپورت/اکسپورت اکسل مخاطبین
• ✅ غنی‌سازی پرونده معامله (برچسب، راکد/فاسد، منبع، دلیل شکست)
• ✅ محصول/خدمت روی معامله (کاتالوگ + ردیف و جمع مبلغ)
• ✅ نوتیفیکیشن داخل برنامه (زنگ اعلان، خوانده/نخوانده، رویداد فعالیت و معامله)
• ✅ تایم‌لاین پرونده (یادداشت + فعالیت روی شخص/شرکت/معامله)
• ✅ تقویم فعالیت‌ها (نمای ماهانه + فیلتر بازه تاریخ)
• ✅ چند کاریز فروش (انتخاب کاریز + ساخت کاریز جدید)
• ✅ انواع Note (فیلتر + برچسب نوع روی کارت)
• ✅ پیوست فایل روی Note (آپلود / دانلود / حذف)
• ✅ نقش و دسترسی سازمانی (تیم، RolesGuard، تنظیمات فقط مالک/مدیر)
• ✅ سطح دسترسی پرونده‌ای (فروش/پشتیبانی فقط مالکیت خود)
• ✅ هدف‌گذاری و پیش‌بینی فروش پایه
• ✅ چندارزی واقعی (ارز پایه + نرخ + انتخاب در فرم‌ها)
• ✅ تیکتینگ پایه (گفتگو + ارجاع)
• ✅ SLA + FAQ + CSAT
• ✅ پرتال مشتری OTP (/p/demo-mento + SMS ترِز)
• ✅ گزارشات و داشبورد
• استقرار: deploy/DEPLOY.md → crm.montzar.ir
• ✅ فرم‌ساز سرنخ (لینک عمومی / iframe / QR)
• ✅ پیش‌فاکتور (از معامله یا مستقل + چاپ)
• ✅ فاکتور / پرداخت / اقساط ساده

راهنمای کاربری

برای کار با پنل (زبان ساده، گام‌به‌گام):

• docs/راهنمای-کاربری.md
• docs/راهنمای-کاربری.docx
• docs/راهنمای-کاربری.pdf

برای بازتولید Word/PDF:

python docs/export-doc.py --preset user-guide

سپس در صورت نیاز همان DOCX را از Word به PDF Export کنید.