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

124 lines
6.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 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 نوشته شده بودند (تحلیل دیدار و دامنه فاز ۱). از نسخه ۱.۰ به بعد سند نقش **نقشه راه زنده** دارد و جزئیات پژوهشی قدیمی به آرشیو مفهومی تقلیل یافته است؛ منبع حقیقت اجرا همان ریپو و چک‌لیست پیشرفت است.