MahdiandCursor
c5c903d4b4
When a PBX webhook includes recordingUrl or transcript, queue STT and AI to create a call_result note; mark API, bulk SMS, WooCommerce, and VoIP as done and defer online payments. Co-authored-by: Cursor <cursoragent@cursor.com>
126 lines
6.6 KiB
Markdown
126 lines
6.6 KiB
Markdown
# راهنما و نقشه راه منتکت (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. **`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 نوشته شده بودند (تحلیل دیدار و دامنه فاز ۱). از نسخه ۱.۰ به بعد سند نقش **نقشه راه زنده** دارد و جزئیات پژوهشی قدیمی به آرشیو مفهومی تقلیل یافته است؛ منبع حقیقت اجرا همان ریپو و چک‌لیست پیشرفت است.
|