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، Voice؛ شخصی/تیمی + تاریخچه؛ خلاصه خودکار تماس |
| **۱-ج** سرنخ و مالی | انجام شده | فرم‌ساز، پیش‌فاکتور، فاکتور/اقساط، هدف فروش |
| **۱-د** پس‌ازفروش | انجام شده | تیکت، پرتال OTP، پروژه، باشگاه، ته‌حساب |
| **۱-هـ** گزارش و اتصال | انجام شده | گزارش عمیق، اتوماسیون، SMS گروهی با لینک ردیابی، API/وب‌هوک، ووکامرس، مونتیفای، VoIP + خلاصه تماس |
| **۱-و** تیم و مهاجرت | انجام شده | لیدها، کارهای روتین، باشگاه امتیازات، گفتگوی داخلی، مراحل/انواع فعالیت، امکانات جدول، مهاجرت از دیدار، سوپرادمین |

جزئیات تیک‌خورده: [`وضعیت-پیشرفت.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 عمومی / وب‌هوک | آماده |
| پیامک گروهی | آماده |
| ووکامرس | آماده |
| فروشگاه‌های مونتیفای | آماده |
| VoIP + خلاصه خودکار تماس | آماده |
| پنل سوپرادمین (سازمان، ماژول، پلن) | آماده |
| درگاه پرداخت داخل CRM | عمداً نه (فعلاً) |

---

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

1. **MinIO** برای پیوست‌ها در استقرار بزرگ  
2. **OpenAPI کامل** برای یکپارچه‌سازان بیرونی (در صورت نیاز)  
3. **لندینگ Nuxt** — بعد از ثبات UI و استقرار  
4. **ثبت‌نام و پرداخت خودکار اشتراک** — پنل سوپرادمین آماده است؛ خودکارسازی تمدید وقتی فروش 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 نوشته شده بودند (تحلیل دیدار و دامنه فاز ۱). از نسخه ۱.۰ به بعد سند نقش **نقشه راه زنده** دارد و جزئیات پژوهشی قدیمی به آرشیو مفهومی تقلیل یافته است؛ منبع حقیقت اجرا همان ریپو و چک‌لیست پیشرفت است.