CRM_Montzar/docs/وضعیت-پیشرفت.md

# وضعیت پیشرفت منتکت (Montact CRM)

سند زندهٔ کارها — با هر قابلیت جدید همین فایل به‌روز می‌شود.  
آخرین به‌روزرسانی: ۱۹ مهر ۱۴۰۵

**راهنما:**  
- `[x]` انجام شده  
- `[ ]` انجام نشده / ناقص  
- وقتی موردی تمام می‌شود: تیک می‌خورد و تاریخ در بخش «تغییرات اخیر» ثبت می‌شود.

---

## تغییرات اخیر

| تاریخ | مورد |
|---|---|
| ۱۴۰۵/۷/۱۹ | بازطراحی سایدبار: برند بزرگ‌تر «مُنتَکت / Montact»، پروفایل + انتخابگر سازمان + خروج آیکونی در پایین، دکمهٔ جمع‌کردن کوچک بالا، فاصله‌های فشرده‌تر؛ اصلاح متن‌های فارسی خراب در shared؛ به‌روزرسانی اسناد |
| ۱۴۰۵/۷/۱۸ | باشگاه امتیازات کارکنان: قوانین امتیاز/سکه، سطح، نشان، بونوس، فروشگاه پاداش + تأیید، رقابت تیمی، تنظیم دستی، گزارش ROI |
| ۱۴۰۵/۷/۱۸ | اتصال چندفروشگاهی مونتیفای: توکن رمزنگاری‌شده، همگام‌سازی تدریجی/کامل، وب‌هوک، سفارش/آدرس/تراکنش در پروفایل |
| ۱۴۰۵/۷/۱۶ | ته‌حساب: نمای سند شبیه فاکتور با برچسب فلز، دادهٔ خام، ورود گروهی مشتریان؛ دور QA |
| ۱۴۰۵/۷/۱۵ | مراحل قابل ویرایش فعالیت (باز/انجام/لغو + رنگ) با نمای تب و کانبان؛ انواع فعالیت سفارشی با فیلد اختصاصی؛ ادغام تب یادداشت در اطلاعات اصلی؛ هشتگ |
| ۱۴۰۵/۷/۱۵ | فرم‌ساز سرنخ: فرم عمومی مطابق پیش‌نمایش، پیش‌نمایش زندهٔ ذخیره‌نشده، پالت رنگ، کاور ۳:۱؛ پنجره‌ها فقط با Esc/×/انصراف بسته می‌شوند |
| ۱۴۰۵/۷/۱۴ | ماژول کارهای روتین: تکرار، دسته، اجباری، اتصال به لید/مشتری، امروز/عقب‌افتاده/تقویم، عملکرد من/تیم، یادآوری‌ها |
| ۱۴۰۵/۷/۱۴ | سوپرادمین: نشان اشتراک، دمو ۷ روزه و پلن دائمی؛ تغییر نام «کاریز فروش» به «مسیر فروش» و «کاریز پروژه» به «تابلوی پروژه» |
| ۱۴۰۵/۷/۱۴ | هم‌ترازی با دیدار: ورود/خروج اکسل شرکت و معامله، فیلدهای معامله (کد، احتمال، تاریخ بستن، ثبت‌کننده، معرف، توضیح شکست)؛ جستجوی یکپارچه در همهٔ لیست‌ها؛ سطح دسترسی پرونده به تفکیک بخش |
| ۱۴۰۵/۷/۱۳ | جدول‌ها: انتخاب ستون ذخیره‌شده برای هر کاربر، انتخاب چندتایی و حذف گروهی، شماره ردیف، اندازهٔ صفحه؛ ورود گروهی مشتریان ته‌حساب با نوار پیشرفت |
| ۱۴۰۵/۷/۱۲ | منبع ورود و نام‌های قبلی اشخاص + گزارش منبع؛ ورود اکسل فعالیت‌های دیدار بدون سرستون |
| ۱۴۰۵/۷/۱۱ | ورود اکسل بزرگ (۴۰ هزار+ ردیف) به‌صورت تکه‌ای با نوار پیشرفت؛ تاریخ ثبت و چند آدرس؛ چند مسئول و زیرنقش روی کار |
| ۱۴۰۵/۷/۹ | پیامک گروهی با لینک ردیابی اختصاصی هر گیرنده + گزارش کلیک + محرک اتوماسیون کلیک لینک |
| ۱۴۰۵/۷/۷–۸ | گفتگوی داخلی تیم: خصوصی/گروه/کانال، فایل تا ۱۰۰MB، صوت، منشن، سنجاق، پیام→فعالیت، دستیار AI |
| ۱۴۰۵/۷/۶ | اتصال فرم‌های عمومی به ماژول لیدها؛ بهبود موبایل لیدها |
| ۱۴۰۵/۷/۵ | لیدها: لوگو، کارت‌های آمار، منوی ردیف ویرایش/حذف، ورود از مخاطبین گوشی |
| ۱۴۰۵/۷/۵ | گزارش‌ها: گزارش‌ساز، ذخیرهٔ نما و لینک اشتراک، تبدیل مرحله‌ای، مقایسهٔ دوره، drill-down؛ ماژول رزرو و نوبت‌دهی |
| ۱۴۰۵/۷/۴ | تیم‌های نام‌دار و دسترسی خود/تیم/سازمان؛ لاگ فعالیت کاربران؛ برچسب‌ها؛ گزارش دلایل شکست |
| ۱۴۰۵/۷/۶ | میز کار (MVP): فیلتر میز من/تیم روی فعالیت‌ها، فقط‌کارهای‌من روی کاریز پروژه، ارجاع مسئول، دسترسی مسئولان کارت |
| ۱۴۰۵/۷/۵ | ماژول مدیریت لیدها: ایمپورت اکسل، تخصیص، Kanban، تبدیل به مشتری، جلوگیری از تکراری |
| ۱۴۰۵/۷/۵ | نرخ تبدیل گزارشات (سبک دیدار): ورودی→موفق + محور زمان/کاربر/منبع |
| ۱۴۰۵/۷/۵ | خلاصه خودکار تماس VoIP (ضبط/متن → STT → AI → یادداشت call_result) |
| ۱۴۰۵/۷/۵ | هم‌ترازی چک‌لیست: API عمومی/وب‌هوک، پیامک گروهی، ووکامرس، VoIP؛ درگاه پرداخت عمداً نه |
| ۱۴۰۵/۷/۵ | چند مسئول روی معاملهٔ کاریز + ذخیره فیلتر در اشخاص و کاریز |
| ۱۴۰۵/۷/۵ | صیقل Smart Notes: یادداشت شخصی/تیمی + تاریخچه ویرایش و بازگردانی |
| ۱۴۰۵/۶/۲۰ | پورسانت کارشناس (درصد پیش‌فرض + تغییر روی فاکتور) و دفتر چک وصل به پرداخت |
| ۱۴۰۵/۶/۱۹ | انبار داخلی + مانده طرف‌حساب وقتی ته‌حساب وصل نیست؛ خروج کالا با صدور فاکتور |
| ۱۴۰۵/۶/۱۴ | هم‌تراز کردن ظاهر صفحات قدیمی با زبان بصری منتکت (لیست/فرم/تنظیمات/گزارش) + جداکننده هزارگان روی فیلدهای مبلغ |
| ۱۴۰۵/۶/۱۴ | یادآور فعالیت: کانال اعلان داخل‌برنامه و/یا پیامک |
| ۱۴۰۵/۶/۱۴ | انتخابگر زمان دایره‌ای در `JalaliDateInput` |
| ۱۴۰۵/۶/۱۴ | اصلاح لایه‌بندی موبایل مخاطبین و یادداشت‌ها |
| ۱۴۰۵/۶/۱۴ | احراز هویت جدید: ثبت‌نام با OTP موبایل؛ ورود با رمز بدون OTP؛ ورود اختیاری با OTP موبایل |
| ۱۴۰۵/۶/۱۴ | اتصال ته‌حساب (طلا و جواهر): چند DB، لینک مشتری، مانده، ثبت سند از پروفایل |
| ۱۴۰۵/۶/۱۴ | فیلد حوزه کسب‌وکار سازمان در ثبت‌نام (از جمله طلا و جواهر) |
| ۱۴۰۵/۶/۱۱ | پروفایل مشتری مطابق ماکاپ + پروفایل کاربر از سایدبار |
| ۱۴۰۵/۶/۸ | کاریز پروژه + باشگاه مشتریان + اتوماسیون اگر/آنگاه |
| ۱۴۰۵/۶/۷ | پرتال مشتری OTP، گزارشات، SLA/FAQ/CSAT، چندارزی، پیش‌بینی فروش، فاکتور/اقساط |

---

## ۱-الف — هسته فروش

| وضعیت | مورد | توضیح |
|---|---|---|
| [x] | ورود / ثبت‌نام / نشست | JWT؛ ثبت‌نام OTP موبایل؛ ورود با رمز؛ OTP اختیاری ورود |
| [x] | اشخاص و شرکت‌ها | جستجو، تکراری، mood مشتری، پروفایل غنی |
| [x] | فیلد سفارشی | شخص / شرکت / معامله |
| [x] | کاریز کانبان | کشیدن معامله؛ UI بازطراحی‌شده |
| [x] | چند کاریز | انتخاب + ساخت |
| [x] | غنی‌سازی معامله | منبع، شکست، برچسب، راکد/فاسد |
| [x] | محصول/خدمت روی معامله | کاتالوگ + ردیف + جمع |
| [x] | فعالیت‌ها | لیست/جزئیات/فرم؛ فیلتر امروز و عقب‌افتاده؛ میز من / همه تیم برای مدیر |
| [x] | یادآور فعالیت | اعلان داخل‌برنامه و/یا SMS |
| [x] | تقویم فعالیت‌ها | نمای ماهانه شمسی |
| [x] | تاریخ/زمان جلالی | ورودی شمسی + صفحهٔ ساعت دایره‌ای |
| [x] | ایمپورت/اکسپورت اکسل | اشخاص و شرکت‌ها |
| [x] | نوتیفیکیشن داخل برنامه | زنگ، خوانده/نخوانده |
| [x] | تایم‌لاین پرونده | یادداشت + فعالیت |
| [x] | UI / ریسپانسیو | شل، خانه، مخاطبین، فعالیت، یادداشت، کاریز + هم‌سبکی صفحات قدیمی |
| [x] | نقش و دسترسی سازمانی | مالک/مدیر/فروش/پشتیبانی |
| [x] | دسترسی پرونده‌ای | فروش/پشتیبانی فقط مالکیت خود |
| [x] | چندارزی | ارز پایه، نرخ، انتخاب روی معامله/فاکتور/محصول |
| [x] | جداکننده مبلغ | فیلدهای قیمت با هزارگان `fa-IR` |

**جمع ۱-الف:** کامل از نظر چک‌لیست فعلی.

---

## ۱-ب — Smart Notes و هوش

| وضعیت | مورد | توضیح |
|---|---|---|
| [x] | Composer سریع شبیه Keep | انواع Note، Pin/Tag/Reminder پایه |
| [x] | اتصال به شخص/شرکت/معامله | |
| [x] | تبدیل Note به Task | |
| [x] | تایم‌لاین یکپارچه | |
| [x] | پیوست فایل روی Note | `uploads/` محلی؛ آماده MinIO |
| [x] | AI: Next Action / پیشنهاد اقدام | با تأیید کاربر |
| [x] | Montact Memory با منبع | خلاصه پایدار + ویرایش/حذف |
| [x] | Ask Montact | پرسش زبان طبیعی روی یادداشت‌ها / پروفایل / خانه |
| [x] | Voice-to-Text | دکمه دیکته (Pipecat/STT) روی Note و فرم‌ها |
| [x] | Note شخصی در برابر تیمی | visibility=team|personal + فیلتر UI |
| [x] | تاریخچه ویرایش Note | NoteRevision + بازگردانی |
| [x] | خلاصه خودکار تماس تلفنی کامل | وب‌هوک VoIP + `recordingUrl`/`transcript` → STT → AI → Note نوع `call_result` |

**جمع ۱-ب:** کامل از نظر چک‌لیست فعلی.

---

## ۱-ج — سرنخ و مالی سبک

| وضعیت | مورد |
|---|---|
| [x] | فرم‌ساز سرنخ + لینک / iframe / QR | شخص+معامله؛ round-robin |
| [x] | مدیریت لیدها (جدا از مشتری) | ایمپورت اکسل پس‌زمینه، وضعیت/Kanban، تخصیص دستی/نوبتی، تبدیل به مشتری، ضدتکراری |
| [x] | پیش‌فاکتور | لیست/فرم، از معامله، چاپ |
| [x] | فاکتور / پرداخت / اقساط | صدور، وصول، برنامه اقساط |
| [x] | هدف و پیش‌بینی فروش | هدف ماهانه + خانه |

---

## ۱-د — پس‌ازفروش، پروژه، حسابداری سبک

| وضعیت | مورد |
|---|---|
| [x] | تیکتینگ | گفتگو، ارجاع، وضعیت/اولویت، ACL |
| [x] | پرتال مشتری OTP | `/p/:slug`؛ FAQ؛ تیکت؛ CSAT؛ SMS |
| [x] | SLA + FAQ + CSAT | |
| [x] | کاریز پروژه | صف/انجام/بازبینی/تمام؛ فیلتر فقط کارهای من؛ دسترسی مسئولان کارت |
| [x] | باشگاه مشتریان | امتیاز و سطوح |
| [x] | اتصال ته‌حساب | چند اتصال DB، لینک شخص، مانده، اسناد، ثبت سند (طلا/جواهر) |
| [x] | انبار و مانده داخلی | وقتی ته‌حساب نیست: موجودی کالا، ورود/اصلاح، خروج با صدور فاکتور، مانده شخص |
| [x] | پورسانت فروش | درصد پیش‌فرض کارشناس در تنظیمات تیم؛ درصد یا مبلغ روی فاکتور؛ ثبت با صدور |
| [x] | دفتر چک | شماره، بانک، سررسید، وضعیت؛ وصل به پرداخت فاکتور؛ وصول فاکتور همان لحظه ثبت |

---

## ۱-هـ — گزارش، اتوماسیون، یکپارچگی

| وضعیت | مورد | توضیح |
|---|---|---|
| [x] | گزارشات و داشبورد | فروش/قیف/فعالیت/تیم/تیکت + فیلتر تاریخ + نرخ تبدیل ورودی→موفق |
| [x] | اتوماسیون اگر/آنگاه | deal_won / ticket_resolved → فعالیت، اعلان، امتیاز |
| [x] | SMS عملیاتی | OTP auth/پرتال؛ یادآور فعالیت (ترِز) |
| [x] | API عمومی + وب‌هوک خروجی | کلید API؛ `public/v1` افراد/معاملات؛ endpoint وب‌هوک + تحویل دوره‌ای |
| [x] | پیامک گروهی | کمپین انبوه به مخاطبان انتخاب‌شده |
| [x] | ووکامرس | اتصال فروشگاه، همگام‌سازی سفارش → فاکتور/مشتری، وب‌هوک |
| [x] | VoIP پایه | اتصال سانترال، وب‌هوک رویداد، لاگ تماس، تطبیق مخاطب، فعالیت، click-to-call |
| [x] | خلاصه خودکار تماس | صف پس‌زمینه روی لاگ تماس؛ وابسته به STT و AI فعال |
| [x] | فروشگاه‌های مونتیفای | چند فروشگاه، توکن رمزنگاری‌شده، همگام‌سازی تدریجی/کامل، وب‌هوک، سفارش/آدرس/تراکنش در پروفایل |
| [x] | ته‌حساب پیشرفته | نمای سند شبیه فاکتور با برچسب فلز، دادهٔ خام، ورود گروهی مشتریان |
| [x] | گزارش‌های عمیق | گزارش‌ساز، ذخیرهٔ نما، لینک اشتراک، تبدیل مرحله‌ای، مقایسهٔ دوره، drill-down، دلایل شکست، منبع ورود |
| [x] | لینک ردیابی پیامک | لینک اختصاصی هر گیرنده، گزارش کلیک، محرک اتوماسیون |

---

## ۱-و — تیم، انگیزش، ارتباط داخلی و مهاجرت

| وضعیت | مورد | توضیح |
|---|---|---|
| [x] | کارهای روتین | تکرار (روزانه/هفتگی/ماهانه/…)، دسته، اجباری، اتصال لید/مشتری، امروز/عقب‌افتاده/تقویم، عملکرد من/تیم، یادآوری و خلاصهٔ پایان روز |
| [x] | باشگاه امتیازات کارکنان | قوانین امتیاز/سکه با سقف و شرط، سطح، نشان، بونوس، فروشگاه پاداش + تأیید، رقابت تیمی، تنظیم دستی، ROI |
| [x] | گفتگوی داخلی | خصوصی/گروه/کانال، فایل/صوت/ویدیو، منشن، سنجاق، واکنش، پیام→فعالیت، دستیار AI |
| [x] | مراحل و انواع فعالیت | ستون‌های باز/انجام/لغو با رنگ، نمای تب و کانبان، انواع سفارشی با فیلد اختصاصی، چند مسئول |
| [x] | امکانات جدول | انتخاب ستون ذخیره‌شده، انتخاب چندتایی، حذف گروهی، شماره ردیف، اندازهٔ صفحه، جستجوی یکپارچه |
| [x] | دسترسی پرونده به تفکیک بخش | مشتری، معامله، کار، لید، مالی، تیکت، یادداشت، پروژه، روتین |
| [x] | مهاجرت از دیدار | ورود/خروج اکسل اشخاص، شرکت‌ها، معاملات، فعالیت‌ها؛ فایل‌های بزرگ تکه‌ای؛ منبع ورود |
| [x] | لیدها و فرم‌ساز | لوگو، آمار، جزئیات؛ فرم عمومی → لید؛ پیش‌نمایش زنده، پالت رنگ |
| [x] | پنل سوپرادمین | سازمان‌ها، کاربران، ادمین‌ها، روشن/خاموش ماژول، پلن (دمو ۷ روزه تا دائمی)، نشان اشتراک |
| [x] | پوستهٔ برنامه | سایدبار بازطراحی‌شده (برند، پروفایل و سازمان پایین، خروج آیکونی، جمع‌کردن کوچک)، نوار پایین موبایل، پنجره‌های امن |
| [x] | QA | تست واحد منطق API، تست دود Playwright، چک پیش از push، چک‌لیست دستی |

---

## عمداً عقب‌افتاده (تصمیم محصول)

| وضعیت | مورد | یادداشت |
|---|---|---|
| [ ] | درگاه پرداخت آنلاین داخل CRM | فعلاً نه — پرداخت دستی/فیش/چک کافی است |
| [ ] | ثبت‌نام و پرداخت خودکار اشتراک SaaS | پنل سوپرادمین هست؛ تمدید فعلاً دستی است |
| [ ] | اپ بومی اندروید/iOS | وب RTL + موبایل‌فرندلی کافی است |
| [ ] | حسابداری کامل / انبار ERP | انبار کوچک داخلی هست؛ دفترکل و چندانبار عمداً نه |
| [ ] | لندینگ Nuxt جدا | بعد از ثبات محصول |

---

## گام بعدی پیشنهادی

1. ارتقای فایل به MinIO در استقرار بزرگ  
2. OpenAPI کامل برای API عمومی (در صورت نیاز یکپارچه‌سازان)  
3. لندینگ Nuxt و پرداخت خودکار اشتراک وقتی فروش SaaS عمومی شروع شود  
4. عکس‌های جدید راهنمای کاربری برای کارهای روتین، باشگاه امتیازات و مونتیفای  

---

## لینک‌های مرتبط

- نقشه راه: [`docs/راهنما-و-نقشه-راه.md`](راهنما-و-نقشه-راه.md)  
- راهنمای کاربری: [`docs/راهنمای-کاربری.md`](راهنمای-کاربری.md)  
- فهرست قابلیت‌ها: [`docs/قابلیت‌های-منتکت.md`](قابلیت‌های-منتکت.md)  
- ته‌حساب: [`docs/integrations/tahesab.md`](integrations/tahesab.md)  
- استقرار: [`deploy/DEPLOY.md`](../deploy/DEPLOY.md)  
- خلاصه ریشه: [`README.md`](../README.md)