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

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

docs/راهنمای-کاربری.md

@@ -0,0 +1,491 @@
+# راهنمای کاربری منتو (Mento CRM)
+
+نسخه راهنما: همزمان با ساخت محصول به‌روز می‌شود.  
+مخاطب: همه همکاران فروش و پشتیبانی — با یا بدون تجربه نرم‌افزار.
+
+---
+
+## این راهنما چیست؟
+
+این سند به زبان ساده می‌گوید:
+
+1. منتو چیست و به چه کار می‌آید  
+2. چطور وارد شوید  
+3. چطور مشتری (شخص / شرکت) ثبت کنید  
+4. چطور معامله را در کاریز فروش جلو ببرید  
+5. چطور فعالیت‌های امروز و عقب‌افتاده را مدیریت کنید  
+6. چطور یادداشت سریع (Smart Notes) ثبت کنید  
+7. چطور فیلد سفارشی تعریف کنید  
+8. چطور مخاطبین را از اکسل وارد یا خارج کنید  
+9. چطور اعلان‌های داخل برنامه را ببینید  
+10. چطور تایم‌لاین پرونده را ببینید  
+
+هر بخش را **به ترتیب** بخوانید. اگر تازه‌کارید، از «شروع خیلی ساده» شروع کنید.
+
+> این راهنما با پیشرفت محصول کامل‌تر می‌شود. بخش‌هایی که هنوز ساخته نشده‌اند با برچسب **به‌زودی** مشخص‌اند.
+
+---
+
+## منتو چیست؟ (به زبان خیلی ساده)
+
+تصور کنید دفترچه تماس، تخته وظایف فروش، و پیگیری مشتری را یک‌جا داشته باشید.
+
+- **شخص**: آدم واقعی که با او حرف می‌زنید (مثلاً خانم محمدی)  
+- **شرکت**: سازمانی که آن شخص برایش کار می‌کند (مثلاً شرکت آکمه)  
+- **معامله / فرصت**: یک فروش احتمالی که دارید جلو می‌برید  
+- **کاریز فروش**: یک تخته ستونی (مثل تخته وایت‌برد) که هر ستون یک مرحله فروش است؛ کارت معامله را ستون‌به‌ستون جلو می‌کشید  
+
+هدف: هیچ پیگیری گم نشود و مدیر ببیند فروش تیم در چه مرحله‌ای است.
+
+---
+
+## شروع خیلی ساده (۵ دقیقه)
+
+### گام ۱ — باز کردن پنل
+
+1. مرورگر را باز کنید (کروم یا اج پیشنهاد می‌شود).  
+2. این آدرس را بنویسید: `http://localhost:5173`  
+3. Enter بزنید.
+
+اگر صفحه باز نشد، به مسئول فنی بگویید: «وب یا API بالا نیست.»
+
+### گام ۲ — ورود
+
+1. در کادر **ایمیل** بنویسید: `owner@demo.local`  
+2. در کادر **رمز عبور** بنویسید: `demo1234`  
+3. روی دکمه **ورود** بزنید.
+
+اگر پیام «اتصال به سرور برقرار نشد» دیدید، API روی پورت ۳۰۰۰ باید روشن باشد.
+
+### گام ۳ — آشنایی با منوی سمت راست/چپ
+
+بعد از ورود، منو را می‌بینید:
+
+| منو | کارش |
+|---|---|
+| خانه امروز | خلاصه وضعیت و میانبرها |
+| فعالیت‌ها | تماس، جلسه، وظیفه و لیست امروز/عقب‌افتاده |
+| تقویم فعالیت‌ها | نمای ماهانه موعدها |
+| کاریز فروش | تخته معاملات |
+| هدف و پیش‌بینی | تارگت ماهانه و پیش‌بینی ساده فروش |
+| تیکت‌ها | پشتیبانی و پیگیری درخواست مشتری |
+| پیش‌فاکتورها | صدور و پیگیری پیش‌فاکتور |
+| فاکتورها | صدور فاکتور، پرداخت و اقساط |
+| اشخاص و شرکت‌ها | دفترچه مخاطبین + ورود/خروج اکسل |
+| یادداشت‌ها | ثبت سریع، پین، تگ، تبدیل به وظیفه |
+| تیم و نقش‌ها | افزودن کاربر و تعیین نقش (فقط مالک/مدیر) |
+| فرم‌ساز سرنخ | لینک / iframe / QR برای جذب سرنخ (فقط مالک/مدیر) |
+| فیلدهای سفارشی | تعریف فیلد اختصاصی برای شخص/شرکت/معامله (فقط مالک/مدیر) |
+| محصولات | کاتالوگ محصول/خدمت برای معامله (فقط مالک/مدیر) |
+| ارزها | ارز پایه، ارزهای فعال و نرخ تبدیل (فقط مالک/مدیر) |
+| اعلان‌ها (پایین منو) | خبر فعالیت ارجاع‌شده، جابه‌جایی معامله، یادآور |
+
+### گام ۴ — یک دور سریع تمرین
+
+1. بروید به **اشخاص و شرکت‌ها** و لیست را ببینید.  
+2. بروید به **کاریز فروش** و کارت‌ها را ببینید.  
+3. یک کارت را با ماوس بگیرید و به ستون بعدی بکشید.  
+4. بروید به **فعالیت‌ها** و لیست امروز را ببینید.  
+5. بروید به **یادداشت‌ها** و یک یادداشت کوتاه ثبت کنید.
+
+---
+
+## ۱) ورود و خروج
+
+### ورود
+
+1. صفحه ورود را باز کنید.  
+2. ایمیل و رمز را وارد کنید.  
+3. **ورود** را بزنید.
+
+### خروج
+
+1. پایین منوی کناری، دکمه **خروج** را بزنید.  
+2. دوباره به صفحه ورود می‌روید.
+
+### نقش‌ها
+
+| نقش | دسترسی |
+|---|---|
+| مالک | همه چیز + مدیریت کاربران و تنظیمات + مشاهده همه پرونده‌ها |
+| مدیر | تنظیمات و دعوت کاربر (بدون تغییر مالک) + مشاهده همه پرونده‌ها |
+| فروش / پشتیبانی | فقط پرونده‌ها، معاملات، فاکتورها و فعالیت‌های خودشان |
+
+حساب‌های دمو اضافه: `admin@demo.local` و `sales@demo.local` با همان رمز `demo1234`.
+
+با حساب **فروش** فقط پرونده‌های تخصیص‌یافته به همان کاربر دیده می‌شود؛ مالک و مدیر همه را می‌بینند.
+
+### ثبت‌نام سازمان جدید
+
+اگر سازمان ندارید:
+
+1. روی **ثبت‌نام سازمان** بزنید.  
+2. نام سازمان، نام خودتان، ایمیل و رمز را پر کنید.  
+3. ثبت کنید؛ بعد از ثبت، وارد پنل می‌شوید.
+
+---
+
+## ۲) اشخاص و شرکت‌ها
+
+اینجا دفترچه تلفن و بانک مشتری شماست.
+
+### دیدن لیست
+
+1. از منو **اشخاص و شرکت‌ها** را باز کنید.  
+2. دو زبانه دارید:
+   - **اشخاص**
+   - **شرکت‌ها**
+3. برای پیدا کردن کسی، در کادر جستجو نام / ایمیل / موبایل را بنویسید و **جستجو** بزنید.
+
+### ثبت شخص جدید
+
+1. زبانه **اشخاص** را انتخاب کنید.  
+2. **شخص جدید** را بزنید.  
+3. حداقل **نام** و **نام خانوادگی** را پر کنید.  
+4. در صورت امکان موبایل یا ایمیل را هم بگذارید (برای جلوگیری از تکراری مفید است).  
+5. اگر به شرکتی وصل است، از لیست **شرکت** انتخاب کنید.  
+6. **ذخیره** را بزنید.
+
+### ویرایش یا حذف شخص
+
+1. در لیست، روی نام شخص کلیک کنید.  
+2. اطلاعات را عوض کنید و **ذخیره** بزنید.  
+3. برای حذف، **حذف** را بزنید و تأیید کنید.
+
+### ثبت شرکت جدید
+
+1. زبانه **شرکت‌ها** را انتخاب کنید.  
+2. **شرکت جدید** را بزنید.  
+3. **نام شرکت** را وارد کنید.  
+4. در صورت تمایل تلفن، ایمیل، آدرس و یادداشت را پر کنید.  
+5. **ذخیره** را بزنید.
+
+### نکته مهم درباره تکراری
+
+سیستم جلوی ثبت دوباره با **ایمیل** یا **موبایل** یکسان (برای اشخاص) و **ایمیل / تلفن / شناسه ملی** یکسان (برای شرکت‌ها) را می‌گیرد.  
+اگر پیام تکراری دیدید، یعنی آن مخاطب از قبل هست؛ همان را پیدا و ویرایش کنید.
+
+---
+
+## ۳) کاریز فروش (معاملات)
+
+کاریز مثل تخته فروش است. هر ستون یک مرحله است:
+
+1. سرنخ  
+2. تماس اول  
+3. پیشنهاد  
+4. مذاکره  
+5. برنده  
+6. از دست‌رفته  
+
+### دیدن کاریز
+
+1. از منو **کاریز فروش** را باز کنید.  
+2. از لیست **کاریز** می‌توانید بین کاریزها جابه‌جا شوید.  
+3. با **کاریز جدید** یک تخته جدا با همان مراحل پیش‌فرض بسازید.
+2. ستون‌ها و کارت‌های معامله را می‌بینید.  
+3. زیر عنوان هر ستون، تعداد کارت و جمع مبلغ همان ستون نشان داده می‌شود.
+
+### ساخت معامله جدید
+
+1. روی **معامله جدید** بزنید.  
+2. **عنوان معامله** را بنویسید (مثلاً «فروش بسته سازمانی آکمه»).  
+3. در صورت امکان **مبلغ** را به ریال وارد کنید.  
+4. شخص و/یا شرکت مرتبط را انتخاب کنید.  
+5. مرحله اولیه را انتخاب کنید (معمولاً «سرنخ»).  
+6. **ذخیره** را بزنید.
+
+### جلو بردن معامله (کشیدن کارت)
+
+1. روی کارت ماوس را نگه دارید.  
+2. کارت را بگیرید و به ستون بعدی بکشید.  
+3. رها کنید.
+
+مثال: وقتی پیشنهاد فرستادید، کارت را از «تماس اول» به «پیشنهاد» بکشید.
+
+### ویرایش معامله
+
+1. روی کارت کلیک کنید.  
+2. عنوان، مبلغ، شخص، شرکت، مرحله یا یادداشت را عوض کنید.  
+3. در صورت نیاز **منبع آشنایی**، **برچسب** و تاریخ بسته‌شدن مورد انتظار را پر کنید.  
+4. می‌توانید از منوی **محصولات** کاتالوگ بسازید و روی معامله ردیف محصول اضافه کنید؛ مبلغ از جمع ردیف‌ها محاسبه می‌شود.  
+5. اگر پیگیری متوقف شده **راکد**، و اگر تقریباً از دست رفته **فاسد** را علامت بزنید.  
+6. **ذخیره** را بزنید. روی کارت کاریز، برچسب و نشان راکد/فاسد دیده می‌شود.  
+7. با **بازگشت به کاریز** به تخته برگردید.
+
+### معامله برنده یا از دست‌رفته
+
+- اگر فروش قطعی شد، کارت را به ستون **برنده** بکشید.  
+- اگر معامله شکست خورد، به ستون **از دست‌رفته** بکشید.  
+- در صفحه ویرایش می‌توانید **دلیل شکست** را هم بنویسید (برای تحلیل بعدی).
+
+### حذف معامله
+
+1. معامله را باز کنید.  
+2. **حذف** را بزنید و تأیید کنید.
+
+---
+
+## ۴) فعالیت‌ها (تماس، جلسه، وظیفه)
+
+فعالیت یعنی کاری که باید برای مشتری یا معامله انجام دهید.
+
+### دیدن کارهای امروز
+
+1. وارد **خانه امروز** شوید.  
+2. بخش‌های **عقب‌افتاده** و **امروز** را ببینید.  
+3. وقتی کار تمام شد، **انجام شد** را بزنید.
+
+### فهرست کامل
+
+1. از منو **فعالیت‌ها** را باز کنید.  
+2. زبانه‌ها: امروز / عقب‌افتاده / بعداً / انجام‌شده / همه  
+3. با جستجو عنوان را پیدا کنید.  
+4. برای نمای ماهانه، **تقویم** را بزنید (یا از منو **تقویم فعالیت‌ها**).
+
+### تقویم ماهانه
+
+1. ماه را با **ماه قبل / ماه بعد** عوض کنید؛ یا **برو به امروز**.  
+2. روی یک روز کلیک کنید تا فعالیت‌های همان روز در پنل کناری دیده شود.  
+3. **افزودن در این روز** فعالیت جدید با موعد همان روز می‌سازد.
+
+### ثبت فعالیت جدید
+
+1. **فعالیت جدید** را بزنید.  
+2. عنوان را بنویسید (مثلاً «تماس پیگیری پیشنهاد»).  
+3. نوع را انتخاب کنید: تماس، جلسه، وظیفه یا یادداشت.  
+4. موعد را بگذارید.  
+5. در صورت تمایل شخص و معامله مرتبط را انتخاب کنید.  
+6. **ذخیره** را بزنید.
+
+### پیشنهاد روزانه
+
+1. صبح وارد شوید و خانه امروز را ببینید.  
+2. عقب‌افتاده‌ها را اول جمع کنید.  
+3. کارهای امروز را یکی‌یکی انجام و تیک بزنید.  
+4. معامله‌ها را در کاریز جلو ببرید.  
+5. مشتری جدید را در اشخاص ثبت کنید.
+
+---
+
+## ۵) یادداشت‌های هوشمند (Smart Notes)
+
+اینجا مثل Google Keep سریع می‌نویسید؛ بعداً AI و حافظه مشتری اضافه می‌شود.
+
+### ثبت یادداشت
+
+1. از منو **یادداشت‌ها** را باز کنید.  
+2. نوع را انتخاب کنید: معمولی، نتیجه تماس، جلسه، نکته مهم، هشدار یا کار بعدی.  
+3. در کادر بالا متن را بنویسید (عنوان اختیاری است).  
+4. در صورت نیاز، شخص، معامله، یادآوری یا برچسب اضافه کنید.  
+5. با **پیوست فایل** می‌توانید تصویر، PDF، Word، Excel یا ZIP اضافه کنید (حداکثر ۱۰ مگابایت).  
+6. **ثبت یادداشت** را بزنید.
+
+با تب‌های بالای صفحه می‌توانید فقط یک نوع یادداشت را ببینید.
+
+روی هر کارت یادداشت هم می‌توانید پیوست جدید اضافه کنید، دانلود کنید یا حذف کنید.
+
+### پیوست فایل
+
+- هنگام ثبت، **پیوست فایل** را بزنید (تصویر، PDF، Word، Excel، متن یا ZIP؛ حداکثر ۱۰ مگابایت).  
+- روی کارت یادداشت هم می‌توانید پیوست اضافه، دانلود یا حذف کنید.
+
+### سنجاق، رنگ، تبدیل به وظیفه
+
+- برای مهم‌ها دکمه سنجاق را بزنید تا بالا بمانند.  
+- رنگ کارت را عوض کنید تا دسته‌بندی بصری داشته باشید.  
+- **تبدیل به وظیفه** یادداشت را به یک فعالیت در بخش فعالیت‌ها تبدیل می‌کند.
+
+### جستجو
+
+در بالای صفحه با متن یا برچسب جستجو کنید.
+
+---
+
+## ۶) فیلدهای سفارشی
+
+گاهی برای کسب‌وکار شما فیلدی لازم است که در فرم استاندارد نیست (مثلاً «صنعت» یا «کانال ترجیحی»).
+
+### تعریف فیلد
+
+1. از منو **فیلدهای سفارشی** را باز کنید (فقط مالک یا مدیر).  
+2. عنوان، نوع (متن / عدد / تاریخ / بله‌خیر / لیست)، و اینکه روی شخص / شرکت / معامله باشد را مشخص کنید.  
+3. **افزودن فیلد** را بزنید.
+
+### پر کردن روی پرونده
+
+وقتی شخص، شرکت یا معامله را باز می‌کنید، بخش **فیلدهای سفارشی** زیر فرم اصلی ظاهر می‌شود. مقدار را وارد و ذخیره کنید.
+
+---
+
+## ۷) ورود و خروج اکسل مخاطبین
+
+### خروجی اکسل
+
+1. بروید به **اشخاص و شرکت‌ها**.  
+2. تب اشخاص یا شرکت‌ها را انتخاب کنید.  
+3. **خروجی اکسل** را بزنید؛ فایل `.xlsx` دانلود می‌شود.  
+اگر جستجو فعال باشد، همان نتایج فیلترشده خارج می‌شوند.
+
+### ورود از اکسل
+
+1. ترجیحاً یک‌بار خروجی بگیرید تا قالب ستون‌ها درست باشد.  
+2. فایل را پر کنید و **ورود از اکسل** را بزنید.  
+3. موارد تکراری (ایمیل/موبایل شخص یا ایمیل/تلفن/شناسه ملی شرکت) رد می‌شوند و بقیه ثبت می‌شوند.
+
+---
+
+## ۸) اعلان‌های داخل برنامه
+
+در پایین منوی کناری دکمه **اعلان‌ها** را می‌بینید. اگر اعلان خوانده‌نشده باشد، عدد قرمز روی دکمه ظاهر می‌شود.
+
+### دیدن اعلان‌ها
+
+1. روی **اعلان‌ها** کلیک کنید.  
+2. لیست اعلان‌ها باز می‌شود (جدیدترها بالا).  
+3. روی یک اعلان بزنید تا خوانده شود و در صورت داشتن لینک، به همان صفحه بروید.
+
+### انواع رایج
+
+- **فعالیت جدید برای شما** — وقتی فعالیتی به شما ارجاع شود  
+- **جابه‌جایی معامله** — وقتی معامله‌ای که مالکتان است در کاریز جابه‌جا شود  
+- **فعالیت عقب‌افتاده** / **یادآوری یادداشت** — وقتی سررسید گذشته باشد
+
+### همه را خوانده علامت بزنید
+
+در بالای پنل اعلان‌ها، **همه خوانده شد** را بزنید.
+
+---
+
+## ۹) تایم‌لاین پرونده
+
+روی پروندهٔ ذخیره‌شدهٔ **شخص**، **شرکت** یا **معامله**، پایین فرم بخش **تایم‌لاین** را می‌بینید.
+
+### چه چیزی نشان داده می‌شود؟
+
+- یادداشت‌های Smart Notes متصل به همان پرونده  
+- فعالیت‌های مرتبط (تماس، جلسه، وظیفه، …)
+
+### ثبت سریع
+
+1. در کادر **یادداشت سریع** بنویسید و **ثبت یادداشت** را بزنید.  
+2. یا عنوان یک پیگیری را بنویسید و **افزودن فعالیت** را بزنید.  
+3. برای فعالیت باز، می‌توانید همان‌جا **انجام شد** بزنید.
+
+تایم‌لاین فقط بعد از اولین ذخیرهٔ پرونده ظاهر می‌شود (روی فرم «جدید» نیست).
+
+---
+
+## ۱۰) مشکلات رایج
+
+| مشکل | کار ساده |
+|---|---|
+| ورود ناموفق / اتصال برقرار نشد | بپرسید API روشن است یا نه؛ در صورت نیاز دوباره وارد شوید |
+| مخاطب تکراری | همان مخاطب قبلی را جستجو و ویرایش کنید |
+| کارت جابه‌جا نمی‌شود | صفحه را بروزرسانی کنید؛ دوباره بکشید |
+| صفحه خالی است | از منو دوباره همان بخش را باز کنید؛ در صورت نیاز خارج و دوباره وارد شوید |
+
+---
+
+## ۱۰) پیش‌فاکتور
+
+1. از منو **پیش‌فاکتورها** را باز کنید یا از پرونده معامله **صدور پیش‌فاکتور** را بزنید.  
+2. عنوان، شخص/شرکت و ردیف‌های محصول را پر کنید.  
+3. وضعیت را (پیش‌نویس / ارسال‌شده / …) تنظیم و ذخیره کنید.  
+4. برای نسخه کاغذی، **چاپ** را بزنید.  
+5. در صورت تأیید، از همان پرونده **صدور فاکتور** بزنید.
+
+---
+
+## ۱۱) فاکتور، پرداخت و اقساط
+
+1. از منو **فاکتورها** یا از معامله / پیش‌فاکتور **صدور فاکتور** را باز کنید.  
+2. ردیف‌ها را بررسی کنید؛ در صورت نیاز با دکمهٔ **۲ قسط** / **۳ قسط** برنامه اقساط بسازید.  
+3. وضعیت را روی **صادرشده** بگذارید و ذخیره کنید.  
+4. در بخش **ثبت پرداخت** مبلغ، روش و در صورت نیاز قسط مرتبط را وارد کنید.  
+5. وضعیت وصول (جزئی / تسویه) بر اساس مجموع پرداخت‌ها به‌روز می‌شود.
+
+---
+
+## ۱۲) فرم‌ساز سرنخ
+
+1. با حساب مالک/مدیر از منو **فرم‌ساز سرنخ** را باز کنید.  
+2. نام فرم و در صورت نیاز مسئولان توزیع نوبتی را مشخص کنید و **ساخت فرم** را بزنید.  
+3. لینک عمومی، کد iframe یا QR را کپی کنید و در سایت بگذارید.  
+4. هر ارسال، یک **شخص** و یک **معامله** در مرحلهٔ اول کاریز می‌سازد (یا شخص تکراری را به‌روز می‌کند).
+
+---
+
+## ۱۳) هدف و پیش‌بینی فروش
+
+1. از منو **هدف و پیش‌بینی** را باز کنید (یا کارت «فروش این ماه» در خانه).  
+2. مبلغ هدف، بازه تاریخ و در صورت مالک/مدیر بودن، مخاطب هدف (سازمان یا کاربر) را مشخص کنید.  
+3. **تحقق** از معاملات برندهٔ همان دوره، **کاریز باز** از معاملات باز، و **پیش‌بینی** = تحقق + ۴۰٪ کاریز باز محاسبه می‌شود.  
+4. کارشناس فروش فقط اعداد پرونده‌های خودش را می‌بیند.
+
+---
+
+## ۱۴) ارزها
+
+1. با حساب مالک/مدیر از منو **ارزها** را باز کنید.  
+2. ارز پایه (مثلاً ریال) و ارزهای فعال را انتخاب کنید.  
+3. برای هر ارز خارجی، نرخ به ارز پایه را وارد کنید (۱ دلار = چند ریال).  
+4. در معامله، پیش‌فاکتور، فاکتور و محصول می‌توانید ارز را عوض کنید.  
+5. جمع ستون‌های کاریز و پیش‌بینی فروش بر اساس ارز پایه محاسبه می‌شود.
+
+---
+
+## ۱۵) تیکت پشتیبانی
+
+1. از منو **تیکت‌ها** را باز کنید و **تیکت جدید** بزنید.  
+2. موضوع، اولویت، شخص/شرکت و در صورت نیاز مسئول را مشخص کنید.  
+3. وضعیت را (باز / در حال رسیدگی / …) به‌روز کنید.  
+4. در بخش گفتگو پاسخ بفرستید؛ برای یادداشت تیمی، **یادداشت داخلی** را بزنید.  
+5. کارشناس فروش/پشتیبانی فقط تیکت‌هایی را می‌بیند که مسئول یا ثبت‌کنندهٔ آن‌هاست.
+6. مهلت پاسخ اول (SLA) بر اساس اولویت تنظیم می‌شود؛ فیلتر «فقط تأخیر SLA» در لیست موجود است.
+7. بعد از حل/بستن تیکت می‌توانید امتیاز رضایت (CSAT) ۱ تا ۵ ثبت کنید.
+8. مقالات FAQ از **تنظیمات → FAQ** مدیریت می‌شوند و هنگام ساخت تیکت جدید پیشنهاد می‌شوند.
+
+---
+
+## ۱۶) پرتال مشتری (OTP)
+
+1. آدرس عمومی: `/p/demo-mento` (به‌جای `demo-mento` اسلاگ سازمان خودتان).  
+2. مشتری موبایل را وارد می‌کند و کد تأیید پیامکی می‌گیرد. در توسعهٔ لوکال ممکن است کد روی صفحه هم دیده شود.  
+3. بعد از ورود می‌تواند FAQ ببیند، تیکت بسازد، گفتگو کند و پس از حل، رضایت بدهد.  
+4. یادداشت‌های داخلی تیم در پرتال دیده نمی‌شوند.  
+5. آدرس عمومی روی سرور: `https://crm.montzar.ir/p/demo-mento`
+
+---
+
+## ۱۷) گزارشات و داشبورد
+
+1. از منو **گزارشات** را باز کنید.  
+2. بازه تاریخ را انتخاب و **اعمال** بزنید.  
+3. KPI فروش، قیف باز، فعالیت‌ها، عملکرد تیم و وضعیت تیکت/CSAT را یک‌جا می‌بینید.  
+4. لینک پرتال مشتری سازمان هم در همین صفحه هست.
+
+---
+
+## ۱۸) بخش‌های بعدی (به‌زودی)
+
+این‌ها در راهنما اضافه می‌شوند وقتی ساخته شدند:
+
+- پیشنهاد AI داخل یادداشت و Mento Memory  
+- Ask Mento  
+- کاریز پروژه / باشگاه مشتریان  
+- اتوماسیون اگر/آنگاه  
+
+---
+
+## برای مسئول فنی (کوتاه)
+
+- پنل: `npm run dev:web` → `http://localhost:5173`  
+- API: `npm run dev:api` → `http://localhost:3000/api`  
+- حساب دمو: `owner@demo.local` / `demo1234`  
+- پرتال دمو: `http://localhost:5173/p/demo-mento` با موبایل `09121234567`  
+- نقشه راه محصول: `docs/راهنما-و-نقشه-راه.md`
+
+---
+
+**یادآوری:** این راهنما زنده است. با هر قابلیت جدید، همین فایل به‌روز می‌شود تا همیشه با نرم‌افزار واقعی یکی باشد.