MahdiandCursor
40d492cb5a
Rewrite roadmap and progress for the shipped product, update the user guide for auth/Tahesab/AI/UI, and add a short feature index. Co-authored-by: Cursor <cursoragent@cursor.com>
6.6 KiB
راهنما و نقشه راه منتو (Mento CRM)
نسخه: ۱.۰ — وضعیت زنده محصول
تاریخ به‌روزرسانی: ۱۴ شهریور ۱۴۰۵
محصول: CRM فروش‌محور فارسی منتو
استک: Vue 3 + NestJS + PostgreSQL (Prisma) | ساختار: monorepo
محیط عملیاتی: https://crm.montzar.ir
این سند دیگر «پیش‌نویس قبل از کدنویسی» نیست؛ خلاصهٔ دامنه، فلسفه، آنچه ساخته شده، و مسیر بعدی است.
چک‌لیست روزبه‌روز: وضعیت-پیشرفت.md · فهرست قابلیت‌ها: قابلیت‌های-منتو.md
۱. هدف محصول
منتو یک CRM فروش و پشتیبانی برای کسب‌وکارهای ایرانی است با این حلقه اصلی:
سرنخ → شخص / شرکت → معامله در کاریز → فعالیت / Smart Notes → فروش مالی سبک → پس‌ازفروش
الهام اولیه از محصولات ایرانی مثل دیدار بوده، ولی هویت بصری و تمایز محصول مستقل است:
- سادگی کار روزانه فروش و پشتیبانی
- پرونده یکپارچه مشتری + حافظه هوشمند (Mento Memory / Ask Mento)
- 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 Mento، Voice-to-Text؛ باقی: Note شخصی/تیمی، تاریخچه ویرایش |
| ۱-ج سرنخ و مالی | انجام شده | فرم‌ساز، پیش‌فاکتور، فاکتور/اقساط، هدف فروش |
| ۱-د پس‌ازفروش | انجام شده | تیکت، پرتال OTP، پروژه، باشگاه، ته‌حساب |
| ۱-هـ گزارش و اتصال | نیمه‌کاره | گزارش و اتوماسیون و SMS عملیاتی آماده؛ API عمومی/وب‌هوک/درگاه هنوز نه |
جزئیات تیک‌خورده: وضعیت-پیشرفت.md
۴. تمایز نسبت به CRMهای عمومی
| حوزه | منتو |
|---|---|
| یادداشت | Smart Notes + پیشنهاد اقدام با تأیید + Memory با منبع |
| پرسش | Ask Mento روی پرونده و یادداشت‌ها |
| صدا | دیکته Voice-to-Text در فرم‌ها |
| ایران | جلالی، RTL، OTP/پیامک، چندارزی ریال‌محور |
| طلا و جواهر | حوزه کسب‌وکار + اتصال ته‌حساب (مانده و سند) |
| استقرار | monorepo قابل نصب روی سرور اختصاصی |
عمداً ساخته نمی‌شود (تا محصول ERP نشود): انبار سنگین، حسابداری کامل داخلی، BPMS گرافیکی، Field Service.
۵. نقشه ماژول‌های اصلی (وضعیت)
| ماژول | وضعیت |
|---|---|
| احراز هویت (رمز + OTP موبایل) | آماده |
| خانه / داشبورد | آماده |
| اشخاص و شرکت‌ها + پروفایل | آماده |
| کاریز فروش و معامله | آماده |
| فعالیت، تقویم، یادآور SMS/اپ | آماده |
| یادداشت هوشمند / Memory / Ask | آماده |
| پیش‌فاکتور و فاکتور | آماده |
| تیکت / پرتال / SLA / FAQ / CSAT | آماده |
| پروژه سبک / باشگاه / اتوماسیون | آماده |
| گزارش و پیش‌بینی فروش | آماده |
| تنظیمات (تیم، ارز، محصول، فرم سرنخ، …) | آماده |
| ته‌حساب | آماده (فاز ۱ اتصال) |
| API عمومی / وب‌هوک | مانده |
| درگاه پرداخت داخل CRM | مانده |
۶. مسیر بعدی (اولویت پیشنهادی)
- API عمومی + وب‌هوک — اتصال سیستم‌های بیرونی بدون دستکاری هسته
- پرداخت / پیامک مدیریتی — اگر مشتری بخواهد از داخل CRM مدیریت کند
- صیقل Smart Notes — Note شخصی/تیمی، تاریخچه ویرایش
- لندینگ Nuxt — بعد از ثبات UI و استقرار
platform_adminSaaS — فقط وقتی فروش حساب چندمستأجری عمومی شروع شود
۷. اسناد مرتبط
| سند | کاربرد |
|---|---|
وضعیت-پیشرفت.md |
چک‌لیست زنده |
راهنمای-کاربری.md |
آموزش کاربران |
قابلیت‌های-منتو.md |
فهرست کوتاه قابلیت‌ها |
integrations/tahesab.md |
اتصال ته‌حساب |
../deploy/DEPLOY.md |
استقرار production |
client/MENT_Smart_Notes_extracted.md |
PRD اولیه Smart Notes |
۸. یادداشت تاریخی
نسخه‌های ۰.۱ تا ۰.۵ این سند پیش از اسکلت monorepo نوشته شده بودند (تحلیل دیدار و دامنه فاز ۱). از نسخه ۱.۰ به بعد سند نقش نقشه راه زنده دارد و جزئیات پژوهشی قدیمی به آرشیو مفهومی تقلیل یافته است؛ منبع حقیقت اجرا همان ریپو و چک‌لیست پیشرفت است.