CRM_Montzar/docs/راهنما-و-نقشه-راه.md

# راهنما و نقشه راه منتکت (Montact CRM)

نسخه: ۱.۰ — وضعیت زنده محصول  
تاریخ به‌روزرسانی: ۱۴ شهریور ۱۴۰۵  
محصول: CRM فروش‌محور فارسی **منتکت**  
استک: Vue 3 + NestJS + PostgreSQL (Prisma) | ساختار: monorepo  
محیط عملیاتی: `https://crm.montzar.ir`

این سند دیگر «پیش‌نویس قبل از کدنویسی» نیست؛ خلاصهٔ دامنه، فلسفه، آنچه ساخته شده، و مسیر بعدی است.  
چک‌لیست روزبه‌روز: [`وضعیت-پیشرفت.md`](وضعیت-پیشرفت.md) · فهرست قابلیت‌ها: [`قابلیت‌های-منتکت.md`](قابلیت‌های-منتکت.md)

---

## ۱. هدف محصول

منتکت یک CRM فروش و پشتیبانی برای کسب‌وکارهای ایرانی است با این حلقه اصلی:

```text
سرنخ → شخص / شرکت → معامله در کاریز → فعالیت / Smart Notes → فروش مالی سبک → پس‌ازفروش
```

الهام اولیه از محصولات ایرانی مثل دیدار بوده، ولی هویت بصری و تمایز محصول مستقل است:

- سادگی کار روزانه فروش و پشتیبانی  
- پرونده یکپارچه مشتری + حافظه هوشمند (Montact Memory / Ask Montact)  
- RTL، تاریخ جلالی، پیامک، و اتصال به حسابداری طلا/جواهر (ته‌حساب)  
- نصب اختصاصی (self-host) به‌جای وابستگی اجباری به SaaS عمومی  

---

## ۲. تصمیم‌های قفل‌شده معماری

| موضوع | تصمیم |
|---|---|
| مدل | چندمستأجری سبک (`organizationId`) از روز اول |
| پنل | Vue 3 + Vite + Pinia |
| API | NestJS |
| دیتابیس | PostgreSQL + Prisma |
| UI | زبان بصری منتکت (تیل، پنل سفید نرم، موبایل ≤۹۰۰) — نه کپی پیکسلی دیدار |
| فایل | فعلاً دیسک محلی؛ Compose برای MinIO آماده است |
| لندینگ بازاریابی | Nuxt جدا، بعد از ثبات محصول |
| اپ بومی | عمداً خارج از فاز ۱ |

---

## ۳. وضعیت فاز ۱ (جمع‌بندی)

فاز ۱ = هم‌ترازی هسته فروش/پشتیبانی + Smart Notes + مالی سبک + یکپارچگی‌های حیاتی.

| مایل‌استون | وضعیت | محتوا |
|---|---|---|
| **۱-الف** هسته فروش | انجام شده | مخاطب، کاریز، فعالیت، تقویم، اکسل، نقش، چندارزی، UI |
| **۱-ب** Smart Notes / AI | تقریباً کامل | Composer، Memory، Ask Montact، Voice-to-Text؛ باقی: Note شخصی/تیمی، تاریخچه ویرایش |
| **۱-ج** سرنخ و مالی | انجام شده | فرم‌ساز، پیش‌فاکتور، فاکتور/اقساط، هدف فروش |
| **۱-د** پس‌ازفروش | انجام شده | تیکت، پرتال OTP، پروژه، باشگاه، ته‌حساب |
| **۱-هـ** گزارش و اتصال | نیمه‌کاره | گزارش و اتوماسیون و SMS عملیاتی آماده؛ API عمومی/وب‌هوک/درگاه هنوز نه |

جزئیات تیک‌خورده: [`وضعیت-پیشرفت.md`](وضعیت-پیشرفت.md)

---

## ۴. تمایز نسبت به CRMهای عمومی

| حوزه | منتکت |
|---|---|
| یادداشت | Smart Notes + پیشنهاد اقدام با تأیید + Memory با منبع |
| پرسش | Ask Montact روی پرونده و یادداشت‌ها |
| صدا | دیکته Voice-to-Text در فرم‌ها |
| ایران | جلالی، RTL، OTP/پیامک، چندارزی ریال‌محور |
| طلا و جواهر | حوزه کسب‌وکار + اتصال ته‌حساب (مانده و سند) |
| استقرار | monorepo قابل نصب روی سرور اختصاصی |

عمداً ساخته نمی‌شود (تا محصول ERP نشود): انبار سنگین، حسابداری کامل داخلی، BPMS گرافیکی، Field Service.

---

## ۵. نقشه ماژول‌های اصلی (وضعیت)

| ماژول | وضعیت |
|---|---|
| احراز هویت (رمز + OTP موبایل) | آماده |
| خانه / داشبورد | آماده |
| اشخاص و شرکت‌ها + پروفایل | آماده |
| کاریز فروش و معامله | آماده |
| فعالیت، تقویم، یادآور SMS/اپ | آماده |
| یادداشت هوشمند / Memory / Ask | آماده |
| پیش‌فاکتور و فاکتور | آماده |
| تیکت / پرتال / SLA / FAQ / CSAT | آماده |
| پروژه سبک / باشگاه / اتوماسیون | آماده |
| گزارش و پیش‌بینی فروش | آماده |
| تنظیمات (تیم، ارز، محصول، فرم سرنخ، …) | آماده |
| ته‌حساب | آماده (فاز ۱ اتصال) |
| API عمومی / وب‌هوک | مانده |
| درگاه پرداخت داخل CRM | مانده |

---

## ۶. مسیر بعدی (اولویت پیشنهادی)

1. **API عمومی + وب‌هوک** — اتصال سیستم‌های بیرونی بدون دستکاری هسته  
2. **پرداخت / پیامک مدیریتی** — اگر مشتری بخواهد از داخل CRM مدیریت کند  
3. **صیقل Smart Notes** — Note شخصی/تیمی، تاریخچه ویرایش  
4. **لندینگ Nuxt** — بعد از ثبات UI و استقرار  
5. **`platform_admin` SaaS** — فقط وقتی فروش حساب چندمستأجری عمومی شروع شود  

---

## ۷. اسناد مرتبط

| سند | کاربرد |
|---|---|
| [`وضعیت-پیشرفت.md`](وضعیت-پیشرفت.md) | چک‌لیست زنده |
| [`راهنمای-کاربری.md`](راهنمای-کاربری.md) | آموزش کاربران |
| [`قابلیت‌های-منتکت.md`](قابلیت‌های-منتکت.md) | فهرست کوتاه قابلیت‌ها |
| [`integrations/tahesab.md`](integrations/tahesab.md) | اتصال ته‌حساب |
| [`../deploy/DEPLOY.md`](../deploy/DEPLOY.md) | استقرار production |
| [`client/MENT_Smart_Notes_extracted.md`](client/MENT_Smart_Notes_extracted.md) | PRD اولیه Smart Notes |

---

## ۸. یادداشت تاریخی

نسخه‌های ۰.۱ تا ۰.۵ این سند پیش از اسکلت monorepo نوشته شده بودند (تحلیل دیدار و دامنه فاز ۱). از نسخه ۱.۰ به بعد سند نقش **نقشه راه زنده** دارد و جزئیات پژوهشی قدیمی به آرشیو مفهومی تقلیل یافته است؛ منبع حقیقت اجرا همان ریپو و چک‌لیست پیشرفت است.