Initial Mento CRM: portal OTP, reports, SMS, and deploy for crm.montzar.ir.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/client/MENT_Smart_Notes_extracted.md

@@ -0,0 +1,104 @@
+MENT SMART NOTES
+داکیومنت محصول — یادداشت هوشمند و حافظه مشتری
+نسخه 1.0 | مناسب برای Product، UI/UX و تیم فنی
+1. هدف قابلیت
+Smart Notes باید ثبت اطلاعات مشتری را به سریع‌ترین و طبیعی‌ترین بخش CRM تبدیل کند. کاربر نباید برای ثبت هر تماس، جلسه یا نکته وارد فرم‌های سنگین شود؛ کافی است مثل Google Keep یک یادداشت کوتاه بنویسد. سیستم، یادداشت را به پرونده مشتری متصل و در صورت نیاز با AI به اطلاعات ساختاریافته تبدیل می‌کند.
+• کاهش اصطکاک ثبت اطلاعات مشتری و افزایش نرخ استفاده واقعی از CRM
+• جلوگیری از فراموش‌شدن نکات شفاهی، قول‌ها، حساسیت‌ها و پیگیری‌ها
+• تبدیل یادداشت آزاد به Task، Reminder، Tag و Insight با کمک AI
+• ساخت یک حافظه مشترک از مشتری برای کل تیم فروش
+2. تجربه اصلی کاربر
+کاربر وارد پروفایل مشتری می‌شود و تب «یادداشت‌ها» را باز می‌کند. در بالای صفحه یک Composer ساده وجود دارد. کاربر متن، صدا یا فایل اضافه می‌کند و دکمه «ثبت یادداشت» را می‌زند. یادداشت بلافاصله در کارت‌های Notes ظاهر می‌شود و در صورت وجود اطلاعات قابل اقدام، MENT پیشنهادهای هوشمند ارائه می‌دهد.
+3. انواع Note
+• یادداشت معمولی — نکته آزاد درباره مشتری
+• نتیجه تماس — خلاصه یک تماس و تصمیمات آن
+• جلسه — نکات جلسه، نیازها و اقدامات بعدی
+• نکته مهم — اطلاعاتی که باید همیشه جلوی چشم تیم باشد
+• هشدار — ریسک، نارضایتی یا موضوع حساس
+• کار بعدی — موردی که باید تبدیل به Task یا Reminder شود
+نوع Note بهتر است اجباری نباشد. کاربر می‌تواند آزادانه بنویسد و سیستم نوع احتمالی را تشخیص دهد؛ هدف این است که سادگی Keep حفظ شود.
+4. رفتار AI داخل Smart Notes
+AI نباید صرفاً متن را خلاصه کند؛ باید اطلاعات قابل استفاده برای فروش را استخراج کند. مثال:
+خروجی پیشنهادی MENT:
+• حساسیت: قیمت
+• علاقه‌مندی: پلن سالانه
+• فرد مؤثر در تصمیم: مدیر مالی
+• Next Action: تماس پیگیری
+• زمان پیگیری: پنجشنبه ساعت ۱۰
+سیستم باید برای اقدامات مهم تأیید بگیرد. AI حق ندارد بدون اطلاع کاربر، Reminder مهم، اطلاعات شخصیتی یا Memory دائمی ثبت کند.
+5. MENT Memory
+MENT Memory یک خلاصه زنده از نکات مهم و نسبتاً پایدار مشتری است. هدف این بخش این است که یک کارشناس جدید بدون خواندن ده‌ها یادداشت بفهمد برای ارتباط با این مشتری چه چیزهایی مهم است.
+• به قیمت حساس است
+• پیام‌های کوتاه را ترجیح می‌دهد
+• تماس تلفنی را به پیام ترجیح می‌دهد
+• مدیر مالی در تصمیم مؤثر است
+• علاقه‌مند به پلن سالانه است
+• معمولاً صبح‌ها پاسخ می‌دهد
+هر Memory Item باید منبع داشته باشد: Note، تماس، جلسه یا پیام. کاربر باید بتواند آن را ویرایش، تأیید یا حذف کند.
+6. جست‌وجوی طبیعی در Notes
+در پایین یا بالای صفحه یک ورودی «از منتک بپرس» وجود داشته باشد. کاربر بتواند به زبان طبیعی درباره سوابق مشتری سؤال کند.
+• نمونه سؤال: «آخرین بار درباره قیمت چی گفت؟»
+• نمونه سؤال: «کی باید دوباره باهاش تماس بگیریم؟»
+• نمونه سؤال: «بیشترین دغدغه این مشتری چیه؟»
+• نمونه سؤال: «تا حالا چه قول‌هایی بهش دادیم؟»
+پاسخ باید همراه با تاریخ و منبع باشد تا کاربر بتواند به Note یا تماس اصلی برگردد.
+7. ساختار کارت Note
+• عنوان یا نوع Note
+• متن اصلی
+• نویسنده
+• تاریخ و ساعت
+• Tagها
+• Pin / Unpin
+• Reminder متصل
+• فایل و Voice Note
+• Deal مرتبط
+• سه‌نقطه: ویرایش، حذف، تبدیل به Task
+• AI Insights کوچک و غیرمزاحم
+8. MVP پیشنهادی
+9. قوانین محصول و UX
+• ثبت Note باید با حداکثر یک کلیک بعد از تایپ انجام شود.
+• فرم اجباری برای ثبت Note وجود نداشته باشد.
+• کاربر بتواند Noteهای شخصی و تیمی را در نسخه‌های بعدی تفکیک کند.
+• AI Suggestionها باید قابل رد کردن باشند و مزاحم جریان کار نشوند.
+• اطلاعات استخراج‌شده درباره شخصیت یا ترجیحات مشتری باید به‌عنوان «برداشت سیستم» نمایش داده شوند، نه حقیقت قطعی.
+• تاریخچه ویرایش برای Noteهای مهم سازمانی در نسخه Enterprise نگهداری شود.
+• سطوح دسترسی Notes از Permissionهای پرونده مشتری تبعیت کند.
+10. معیارهای موفقیت
+• درصد مشتریانی که حداقل یک Note دارند
+• تعداد Note ثبت‌شده به ازای هر کارشناس در هفته
+• درصد Noteهایی که به Task/Reminder تبدیل می‌شوند
+• کاهش تعداد Follow-upهای فراموش‌شده
+• نرخ استفاده از MENT Memory
+• نرخ پذیرش پیشنهادهای AI
+• زمان متوسط ثبت یک Note
+11. اتود رابط کاربری
+نمونه زیر جهت انتقال کانسپت است: Notes به‌صورت کارت‌های ساده و قابل اسکن، Composer در بالای صفحه و MENT Memory در ستون کناری.
+اتود MENT Smart Notes — مرجع اولیه برای طراحی UI/UX
+12. جمع‌بندی محصول
+Smart Notes نباید فقط یک بخش یادداشت در CRM باشد. ارزش واقعی آن زمانی ایجاد می‌شود که ثبت آزاد و سریع اطلاعات را با حافظه مشتری، پیگیری هوشمند و AI ترکیب کند. تجربه ایده‌آل این است که کارشناس هر چیزی را همان لحظه ثبت کند و MENT آن را به اطلاعات قابل اقدام تبدیل کند.
+
+--- TABLE 1 ---
+ایده مرکزی: «هرچی درباره مشتری می‌دونی، فقط بنویس؛ منتک بقیه‌ش رو می‌فهمه.»
+
+--- TABLE 2 ---
+مرحله | عنوان | رفتار
+1 | ثبت سریع | متن بنویسد، Voice Note بگذارد یا فایل پیوست کند.
+2 | تشخیص هوشمند | AI تاریخ، پیگیری، حساسیت، ترجیح و شخص مؤثر در تصمیم را تشخیص دهد.
+3 | پیشنهاد اقدام | مثلاً «پنجشنبه ساعت ۱۰ یادآوری بسازم؟» یا «این مورد را به Deal اضافه کنم؟»
+4 | ذخیره در Memory | نکات پایدار و مهم، پس از تأیید کاربر وارد MENT Memory شوند.
+
+--- TABLE 3 ---
+«صحبت کردم. گفت قیمت یکم بالاست. تا پنجشنبه با مدیر مالی صحبت می‌کنه. پنجشنبه ساعت ۱۰ زنگ بزنم. بیشتر دنبال پلن یک‌ساله‌ست.»
+
+--- TABLE 4 ---
+اولویت | قابلیت | نسخه
+ضروری | ثبت/ویرایش/حذف Note | MVP
+ضروری | Pin کردن Note | MVP
+ضروری | Tag و جست‌وجو | MVP
+ضروری | اتصال Note به مشتری و Deal | MVP
+ضروری | Reminder از داخل Note | MVP
+ضروری | Activity Timeline | MVP
+پیشنهادی | استخراج تاریخ و Next Action با AI | MVP+
+پیشنهادی | MENT Memory | MVP+
+بعدی | Voice-to-Note و خلاصه تماس | V2
+بعدی | Ask MENT روی کل تاریخچه مشتری | V2