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>
6.6 KiB
راهنما و نقشه راه منتکت (Montact CRM)
نسخه: ۱.۰ — وضعیت زنده محصول
تاریخ به‌روزرسانی: ۱۴ شهریور ۱۴۰۵
محصول: CRM فروش‌محور فارسی منتکت
استک: Vue 3 + NestJS + PostgreSQL (Prisma) | ساختار: monorepo
محیط عملیاتی: https://crm.montzar.ir
این سند دیگر «پیش‌نویس قبل از کدنویسی» نیست؛ خلاصهٔ دامنه، فلسفه، آنچه ساخته شده، و مسیر بعدی است.
چک‌لیست روزبه‌روز: وضعیت-پیشرفت.md · فهرست قابلیت‌ها: قابلیت‌های-منتکت.md
۱. هدف محصول
منتکت یک CRM فروش و پشتیبانی برای کسب‌وکارهای ایرانی است با این حلقه اصلی:
سرنخ → شخص / شرکت → معامله در کاریز → فعالیت / 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
۴. تمایز نسبت به 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 | عمداً نه (فعلاً) |
۶. مسیر بعدی (اولویت پیشنهادی)
- MinIO برای پیوست‌ها در استقرار بزرگ
- OpenAPI کامل برای یکپارچه‌سازان بیرونی (در صورت نیاز)
- لندینگ Nuxt — بعد از ثبات UI و استقرار
platform_adminSaaS — فقط وقتی فروش حساب چندمستأجری عمومی شروع شود
۷. اسناد مرتبط
| سند | کاربرد |
|---|---|
وضعیت-پیشرفت.md |
چک‌لیست زنده |
راهنمای-کاربری.md |
آموزش کاربران |
قابلیت‌های-منتکت.md |
فهرست کوتاه قابلیت‌ها |
integrations/tahesab.md |
اتصال ته‌حساب |
../deploy/DEPLOY.md |
استقرار production |
client/MENT_Smart_Notes_extracted.md |
PRD اولیه Smart Notes |
۸. یادداشت تاریخی
نسخه‌های ۰.۱ تا ۰.۵ این سند پیش از اسکلت monorepo نوشته شده بودند (تحلیل دیدار و دامنه فاز ۱). از نسخه ۱.۰ به بعد سند نقش نقشه راه زنده دارد و جزئیات پژوهشی قدیمی به آرشیو مفهومی تقلیل یافته است؛ منبع حقیقت اجرا همان ریپو و چک‌لیست پیشرفت است.