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

135 lines
7.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# راهنما و نقشه راه منتکت (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 نوشته شده بودند (تحلیل دیدار و دامنه فاز ۱). از نسخه ۱.۰ به بعد سند نقش **نقشه راه زنده** دارد و جزئیات پژوهشی قدیمی به آرشیو مفهومی تقلیل یافته است؛ منبع حقیقت اجرا همان ریپو و چک‌لیست پیشرفت است.