diff --git a/docs/راهنمای-کاربری.md b/docs/راهنمای-کاربری.md
index 458a386..d30e485 100644
--- a/docs/راهنمای-کاربری.md
+++ b/docs/راهنمای-کاربری.md
@@ -1,175 +1,312 @@
 # راهنمای کاربری منتو (Mento CRM)
 
-نسخه راهنما: همزمان با ساخت محصول به‌روز می‌شود.  
-مخاطب: همه همکاران فروش و پشتیبانی — با یا بدون تجربه نرم‌افزار.
+**نسخه راهنما:** هماهنگ با محصول روی `https://crm.montzar.ir` (به‌روز در شهریور ۱۴۰۵)  
+**مخاطب:** همه همکاران فروش، پشتیبانی و مدیران سازمان — با یا بدون تجربه نرم‌افزار CRM.
+
+این سند زنده است؛ با هر قابلیت جدید همین فایل کامل‌تر می‌شود.
+
+---
+
+## فهرست مطالب
+
+1. [این راهنما چیست؟](#این-راهنما-چیست)
+2. [منتو چیست؟](#منتو-چیست-به-زبان-خیلی-ساده)
+3. [آدرس‌ها و حساب‌های دمو](#آدرسها-و-حسابهای-دمو)
+4. [شروع خیلی ساده (۱۰ دقیقه)](#شروع-خیلی-ساده-۱۰-دقیقه)
+5. [منوی کناری و ساختار صفحه](#منوی-کناری-و-ساختار-صفحه)
+6. [ورود، خروج، نقش‌ها و تیم](#۱-ورود-خروج-نقشها-و-تیم)
+7. [خانه امروز](#۲-خانه-امروز)
+8. [اشخاص و شرکت‌ها](#۳-اشخاص-و-شرکتها)
+9. [کاریز فروش (معاملات)](#۴-کاریز-فروش-معاملات)
+10. [فعالیت‌ها و تقویم](#۵-فعالیتها-و-تقویم)
+11. [یادداشت‌های هوشمند](#۶-یادداشتهای-هوشمند-smart-notes)
+12. [تایم‌لاین پرونده](#۷-تایملین-پرونده)
+13. [اعلان‌ها](#۸-اعلانها)
+14. [محصولات و ردیف معامله](#۹-محصولات-و-ردیف-معامله)
+15. [پیش‌فاکتور](#۱۰-پیشفاکتور)
+16. [فاکتور، پرداخت و اقساط](#۱۱-فاکتور-پرداخت-و-اقساط)
+17. [هدف و پیش‌بینی فروش](#۱۲-هدف-و-پیشبینی-فروش)
+18. [گزارشات و داشبورد](#۱۳-گزارشات-و-داشبورد)
+19. [تیکت پشتیبانی، SLA، FAQ و CSAT](#۱۴-تیکت-پشتیبانی-sla-faq-و-csat)
+20. [پرتال مشتری (OTP و پیامک)](#۱۵-پرتال-مشتری-otp-و-پیامک)
+21. [کاریز پروژه](#۱۶-کاریز-پروژه)
+22. [باشگاه مشتریان](#۱۷-باشگاه-مشتریان)
+23. [اتوماسیون اگر / آنگاه](#۱۸-اتوماسیون-اگر--آنگاه)
+24. [فرم‌ساز سرنخ](#۱۹-فرمساز-سرنخ)
+25. [فیلدهای سفارشی](#۲۰-فیلدهای-سفارشی)
+26. [ارزها](#۲۱-ارزها)
+27. [ورود و خروج اکسل](#۲۲-ورود-و-خروج-اکسل)
+28. [دسترسی پرونده‌ای (چه کسی چه می‌بیند)](#۲۳-دسترسی-پروندهای)
+29. [کار روی موبایل](#۲۴-کار-روی-موبایل)
+30. [سناریوهای روزمره پیشنهادی](#۲۵-سناریوهای-روزمره-پیشنهادی)
+31. [مشکلات رایج](#۲۶-مشکلات-رایج)
+32. [بخش‌های بعدی (به‌زودی)](#۲۷-بخشهای-بعدی-بهزودی)
+33. [برای مسئول فنی](#برای-مسئول-فنی-کوتاه)
 
 ---
 
 ## این راهنما چیست؟
 
-این سند به زبان ساده می‌گوید:
+به زبان ساده می‌گوید:
 
-1. منتو چیست و به چه کار می‌آید  
-2. چطور وارد شوید  
-3. چطور مشتری (شخص / شرکت) ثبت کنید  
-4. چطور معامله را در کاریز فروش جلو ببرید  
-5. چطور فعالیت‌های امروز و عقب‌افتاده را مدیریت کنید  
-6. چطور یادداشت سریع (Smart Notes) ثبت کنید  
-7. چطور فیلد سفارشی تعریف کنید  
-8. چطور مخاطبین را از اکسل وارد یا خارج کنید  
-9. چطور اعلان‌های داخل برنامه را ببینید  
-10. چطور تایم‌لاین پرونده را ببینید  
+- منتو چیست و هر مفهوم (شخص، معامله، تیکت، …) یعنی چه  
+- چطور وارد شوید و با منو کار کنید  
+- برای هر بخش: **کجا بروید → چه دکمه‌هایی بزنید → نتیجه چه می‌شود**  
+- تفاوت نقش‌ها (مالک / مدیر / فروش / پشتیبانی)  
+- کار روزمره فروش و پشتیبانی با مثال  
 
-هر بخش را **به ترتیب** بخوانید. اگر تازه‌کارید، از «شروع خیلی ساده» شروع کنید.
-
-> این راهنما با پیشرفت محصول کامل‌تر می‌شود. بخش‌هایی که هنوز ساخته نشده‌اند با برچسب **به‌زودی** مشخص‌اند.
+> اگر تازه‌کارید، از **شروع خیلی ساده** شروع کنید، بعد بخش مربوط به کار خودتان را بخوانید.
 
 ---
 
 ## منتو چیست؟ (به زبان خیلی ساده)
 
-تصور کنید دفترچه تماس، تخته وظایف فروش، و پیگیری مشتری را یک‌جا داشته باشید.
+منتو یک **CRM فارسی** است: دفترچه مشتری، تخته فروش، پیگیری کارها، پشتیبانی، فاکتور و پرتال مشتری در یک جا.
 
-- **شخص**: آدم واقعی که با او حرف می‌زنید (مثلاً خانم محمدی)  
-- **شرکت**: سازمانی که آن شخص برایش کار می‌کند (مثلاً شرکت آکمه)  
-- **معامله / فرصت**: یک فروش احتمالی که دارید جلو می‌برید  
-- **کاریز فروش**: یک تخته ستونی (مثل تخته وایت‌برد) که هر ستون یک مرحله فروش است؛ کارت معامله را ستون‌به‌ستون جلو می‌کشید  
+| مفهوم | یعنی چه؟ | مثال |
+|---|---|---|
+| **سازمان** | شرکت شما داخل منتو | «آکمه» |
+| **شخص** | آدم واقعی که با او حرف می‌زنید | خانم محمدی |
+| **شرکت** | سازمان طرف‌حساب | شرکت آکمه |
+| **معامله / فرصت** | یک فروش احتمالی | «بسته سازمانی ۱۴۰۵» |
+| **کاریز فروش** | تخته ستونی مراحل فروش | سرنخ → پیشنهاد → برنده |
+| **فعالیت** | کار پیگیری (تماس، جلسه، وظیفه) | «تماس فردا ساعت ۱۰» |
+| **یادداشت** | ثبت سریع حرف‌ها و نکات | «قیمت را تا پنجشنبه نگه داریم» |
+| **تیکت** | درخواست پشتیبانی مشتری | «نرم‌افزار قطع شده» |
+| **کاریز پروژه** | تخته کارهای داخلی / تحویل پس‌ازفروش | صف → انجام → تمام |
+| **باشگاه مشتریان** | امتیاز و سطح وفاداری روی شخص | برنزی / نقره‌ای / طلایی |
+| **اتوماسیون** | اگر اتفاقی افتاد، خودکار کاری انجام شود | معامله برنده → ساخت وظیفه |
 
-هدف: هیچ پیگیری گم نشود و مدیر ببیند فروش تیم در چه مرحله‌ای است.
+هدف: هیچ پیگیری گم نشود؛ مدیر ببیند فروش و پشتیبانی در چه وضعی است.
 
 ---
 
-## شروع خیلی ساده (۵ دقیقه)
+## آدرس‌ها و حساب‌های دمو
+
+### محیط واقعی (سرور)
+
+| مورد | آدرس |
+|---|---|
+| پنل اصلی | `https://crm.montzar.ir` |
+| پرتال مشتری دمو | `https://crm.montzar.ir/p/demo-mento` |
+| سلامت API | `https://crm.montzar.ir/api/health` |
+
+### محیط توسعه (لوکال)
+
+| مورد | آدرس |
+|---|---|
+| پنل | `http://localhost:5173` |
+| API | `http://localhost:3000/api` |
+| پرتال دمو | `http://localhost:5173/p/demo-mento` |
+
+### حساب‌های نمونه (بعد از seed)
+
+| ایمیل | رمز | نقش |
+|---|---|---|
+| `owner@demo.local` | `demo1234` | مالک |
+| `admin@demo.local` | `demo1234` | مدیر |
+| `sales@demo.local` | `demo1234` | فروش |
+
+موبایل نمونه برای تست پرتال (اگر seed زده شده): معمولاً `09121234567` روی شخص دمو.
+
+---
+
+## شروع خیلی ساده (۱۰ دقیقه)
 
 ### گام ۱ — باز کردن پنل
 
-1. مرورگر را باز کنید (کروم یا اج پیشنهاد می‌شود).  
-2. این آدرس را بنویسید: `http://localhost:5173`  
+1. مرورگر کروم یا اج را باز کنید.  
+2. آدرس `https://crm.montzar.ir` را وارد کنید (یا لوکال بالا).  
 3. Enter بزنید.
 
-اگر صفحه باز نشد، به مسئول فنی بگویید: «وب یا API بالا نیست.»
+اگر صفحه باز نشد، به مسئول فنی بگویید: «سایت یا API بالا نیست.»
 
 ### گام ۲ — ورود
 
-1. در کادر **ایمیل** بنویسید: `owner@demo.local`  
-2. در کادر **رمز عبور** بنویسید: `demo1234`  
-3. روی دکمه **ورود** بزنید.
+1. در کادر **ایمیل**: `owner@demo.local`  
+2. در کادر **رمز عبور**: `demo1234`  
+3. **ورود** را بزنید.
 
-اگر پیام «اتصال به سرور برقرار نشد» دیدید، API روی پورت ۳۰۰۰ باید روشن باشد.
+اگر «اتصال به سرور برقرار نشد» دیدید، API روی سرور (پورت داخلی ۳۰۳۰ پشت nginx) باید روشن باشد.
 
-### گام ۳ — آشنایی با منوی سمت راست/چپ
+### گام ۳ — یک دور تمرین
 
-بعد از ورود، منو را می‌بینید:
-
-| منو | کارش |
-|---|---|
-| خانه امروز | خلاصه وضعیت و میانبرها |
-| فعالیت‌ها | تماس، جلسه، وظیفه و لیست امروز/عقب‌افتاده |
-| تقویم فعالیت‌ها | نمای ماهانه موعدها |
-| کاریز فروش | تخته معاملات |
-| هدف و پیش‌بینی | تارگت ماهانه و پیش‌بینی ساده فروش |
-| تیکت‌ها | پشتیبانی و پیگیری درخواست مشتری |
-| پیش‌فاکتورها | صدور و پیگیری پیش‌فاکتور |
-| فاکتورها | صدور فاکتور، پرداخت و اقساط |
-| اشخاص و شرکت‌ها | دفترچه مخاطبین + ورود/خروج اکسل |
-| یادداشت‌ها | ثبت سریع، پین، تگ، تبدیل به وظیفه |
-| تیم و نقش‌ها | افزودن کاربر و تعیین نقش (فقط مالک/مدیر) |
-| فرم‌ساز سرنخ | لینک / iframe / QR برای جذب سرنخ (فقط مالک/مدیر) |
-| فیلدهای سفارشی | تعریف فیلد اختصاصی برای شخص/شرکت/معامله (فقط مالک/مدیر) |
-| محصولات | کاتالوگ محصول/خدمت برای معامله (فقط مالک/مدیر) |
-| ارزها | ارز پایه، ارزهای فعال و نرخ تبدیل (فقط مالک/مدیر) |
-| اعلان‌ها (پایین منو) | خبر فعالیت ارجاع‌شده، جابه‌جایی معامله، یادآور |
-
-### گام ۴ — یک دور سریع تمرین
-
-1. بروید به **اشخاص و شرکت‌ها** و لیست را ببینید.  
-2. بروید به **کاریز فروش** و کارت‌ها را ببینید.  
-3. یک کارت را با ماوس بگیرید و به ستون بعدی بکشید.  
-4. بروید به **فعالیت‌ها** و لیست امروز را ببینید.  
-5. بروید به **یادداشت‌ها** و یک یادداشت کوتاه ثبت کنید.
+1. **اشخاص و شرکت‌ها** → لیست را ببینید.  
+2. **کاریز فروش** → یک کارت را به ستون بعدی بکشید.  
+3. **فعالیت‌ها** → کارهای امروز را ببینید.  
+4. **یادداشت‌ها** → یک یادداشت کوتاه ثبت کنید.  
+5. روی آیکون زنگ کنار برند کلیک کنید → اعلان‌ها را ببینید.  
+6. پایین منو **خروج** را تست کنید و دوباره وارد شوید.
 
 ---
 
-## ۱) ورود و خروج
+## منوی کناری و ساختار صفحه
+
+منوی سمت راست (در دسکتاپ همیشه دیده می‌شود؛ در موبایل با دکمه همبرگری باز می‌شود).
+
+### همیشه دیده می‌شود (موارد اصلی)
+
+| منو | کارش |
+|---|---|
+| خانه امروز | خلاصه وضعیت، میانبرها، کارهای فوری |
+| فعالیت‌ها | تماس / جلسه / وظیفه و فیلتر امروز و عقب‌افتاده |
+| کاریز فروش | تخته معاملات فروش |
+| اشخاص و شرکت‌ها | دفترچه مخاطبین + اکسل |
+| تیکت‌ها | پشتیبانی مشتری |
+| یادداشت‌ها | ثبت سریع Smart Notes |
+
+### فروش و مالی (با کلیک باز می‌شود)
+
+| منو | کارش |
+|---|---|
+| پیش‌فاکتورها | پیشنهاد قیمت قبل از فاکتور |
+| فاکتورها | صدور، پرداخت، اقساط |
+| هدف و پیش‌بینی | تارگت ماهانه و پیش‌بینی ساده |
+| گزارشات | داشبورد فروش / قیف / تیم / تیکت |
+
+### موارد بیشتر
+
+| منو | کارش |
+|---|---|
+| تقویم فعالیت‌ها | نمای ماهانه شمسی موعدها |
+| کاریز پروژه | کارهای داخلی و تحویل (جدا از فروش) |
+| باشگاه مشتریان | امتیاز و سطح وفاداری |
+
+### تنظیمات (فقط مالک و مدیر)
+
+| منو | کارش |
+|---|---|
+| تیم و نقش‌ها | دعوت کاربر و نقش |
+| اتوماسیون | قوانین اگر / آنگاه |
+| فرم‌ساز سرنخ | لینک، iframe، QR |
+| فیلدهای سفارشی | فیلد اختصاصی شخص/شرکت/معامله |
+| محصولات | کاتالوگ محصول/خدمت |
+| ارزها | ارز پایه و نرخ تبدیل |
+| FAQ | مقالات پرتکرار برای تیکت و پرتال |
+
+### بالای منو و پایین منو
+
+- **کنار برند منتو:** آیکون اعلان + شمارنده خوانده‌نشده  
+- **پایین منو:** نام کاربر و نقش در یک ردیف + دکمه **خروج**
+
+اگر نقش شما فروش یا پشتیبانی باشد، ممکن است ببینید: «فقط پرونده‌های خودتان را می‌بینید.»
+
+---
+
+## ۱) ورود، خروج، نقش‌ها و تیم
 
 ### ورود
 
 1. صفحه ورود را باز کنید.  
 2. ایمیل و رمز را وارد کنید.  
-3. **ورود** را بزنید.
+3. **ورود** را بزنید.  
+4. اگر قبلاً لینک داخلی باز کرده بودید، بعد از ورود معمولاً به همان صفحه برمی‌گردید.
 
 ### خروج
 
-1. پایین منوی کناری، دکمه **خروج** را بزنید.  
-2. دوباره به صفحه ورود می‌روید.
-
-### نقش‌ها
-
-| نقش | دسترسی |
-|---|---|
-| مالک | همه چیز + مدیریت کاربران و تنظیمات + مشاهده همه پرونده‌ها |
-| مدیر | تنظیمات و دعوت کاربر (بدون تغییر مالک) + مشاهده همه پرونده‌ها |
-| فروش / پشتیبانی | فقط پرونده‌ها، معاملات، فاکتورها و فعالیت‌های خودشان |
-
-حساب‌های دمو اضافه: `admin@demo.local` و `sales@demo.local` با همان رمز `demo1234`.
-
-با حساب **فروش** فقط پرونده‌های تخصیص‌یافته به همان کاربر دیده می‌شود؛ مالک و مدیر همه را می‌بینند.
+1. پایین منوی کناری **خروج** را بزنید.  
+2. به صفحه ورود برمی‌گردید. روی دستگاه مشترک حتماً خارج شوید.
 
 ### ثبت‌نام سازمان جدید
 
-اگر سازمان ندارید:
+اگر هنوز سازمانی ندارید:
 
 1. روی **ثبت‌نام سازمان** بزنید.  
 2. نام سازمان، نام خودتان، ایمیل و رمز را پر کنید.  
-3. ثبت کنید؛ بعد از ثبت، وارد پنل می‌شوید.
+3. ثبت کنید؛ به‌عنوان **مالک** وارد پنل می‌شوید.
+
+### نقش‌ها (چه کسی چه می‌تواند)
+
+| نقش | پرونده‌ها | تنظیمات سازمان | دعوت کاربر | تغییر نقش مالک |
+|---|---|---|---|---|
+| **مالک** | همه | بله | بله | — |
+| **مدیر** | همه | بله | بله | خیر |
+| **فروش** | فقط مال خودش | خیر | خیر | خیر |
+| **پشتیبانی** | فقط مال خودش (و تیکت‌های مرتبط) | خیر | خیر | خیر |
+
+«مالک پرونده» یعنی مسئول آن شخص / شرکت / معامله / کارت پروژه معمولاً همان کاربری است که ساخته یا به او ارجاع شده.
+
+### تیم و نقش‌ها (مالک / مدیر)
+
+1. از **تنظیمات → تیم و نقش‌ها** وارد شوید.  
+2. لیست کاربران سازمان را ببینید.  
+3. برای دعوت: ایمیل، نام، رمز اولیه و نقش (مدیر / فروش / پشتیبانی) را پر کنید و ذخیره کنید.  
+4. نقش کاربر موجود را در صورت نیاز عوض کنید (نقش مالک را به این سادگی عوض نکنید).
 
 ---
 
-## ۲) اشخاص و شرکت‌ها
+## ۲) خانه امروز
+
+صفحه اول بعد از ورود.
+
+معمولاً می‌بینید:
+
+- خلاصه فعالیت‌های **عقب‌افتاده** و **امروز**  
+- میانبر به کاریز، گزارشات یا هدف فروش ماه  
+- وضعیت سریع فروش / تیکت (بسته به نسخه صفحه)
+
+**پیشنهاد صبحگاهی:**
+
+1. عقب‌افتاده‌ها را اول جمع کنید (دکمه **انجام شد**).  
+2. کارهای امروز را یکی‌یکی پیش ببرید.  
+3. معاملات راکد را در کاریز چک کنید.  
+4. تیکت‌های باز یا تأخیر SLA را ببینید.
+
+---
+
+## ۳) اشخاص و شرکت‌ها
 
 اینجا دفترچه تلفن و بانک مشتری شماست.
 
 ### دیدن لیست
 
-1. از منو **اشخاص و شرکت‌ها** را باز کنید.  
-2. دو زبانه دارید:
-   - **اشخاص**
-   - **شرکت‌ها**
-3. برای پیدا کردن کسی، در کادر جستجو نام / ایمیل / موبایل را بنویسید و **جستجو** بزنید.
+1. منو → **اشخاص و شرکت‌ها**.  
+2. دو زبانه: **اشخاص** و **شرکت‌ها**.  
+3. در کادر جستجو نام / ایمیل / موبایل را بنویسید و جستجو کنید.
 
 ### ثبت شخص جدید
 
-1. زبانه **اشخاص** را انتخاب کنید.  
-2. **شخص جدید** را بزنید.  
-3. حداقل **نام** و **نام خانوادگی** را پر کنید.  
-4. در صورت امکان موبایل یا ایمیل را هم بگذارید (برای جلوگیری از تکراری مفید است).  
-5. اگر به شرکتی وصل است، از لیست **شرکت** انتخاب کنید.  
+1. زبانه **اشخاص** → **شخص جدید**.  
+2. حداقل **نام** و **نام خانوادگی** را پر کنید.  
+3. موبایل یا ایمیل را در صورت امکان بگذارید (برای تکراری‌نشدن و پرتال OTP مهم است).  
+4. در صورت نیاز سمت، تلفن، یادداشت و **شرکت** مرتبط را انتخاب کنید.  
+5. اگر فیلد سفارشی تعریف شده، پایین فرم پر کنید.  
 6. **ذخیره** را بزنید.
 
+روی پرونده ذخیره‌شده:
+
+- بخش **باشگاه مشتریان** امتیاز و سطح را نشان می‌دهد (لینک به مدیریت باشگاه).  
+- پایین صفحه **تایم‌لاین** ظاهر می‌شود.
+
 ### ویرایش یا حذف شخص
 
-1. در لیست، روی نام شخص کلیک کنید.  
-2. اطلاعات را عوض کنید و **ذخیره** بزنید.  
-3. برای حذف، **حذف** را بزنید و تأیید کنید.
+1. در لیست روی نام کلیک کنید.  
+2. ویرایش → **ذخیره**.  
+3. برای حذف: **حذف** و تأیید (مراقب باشید؛ ارتباط‌ها تحت تأثیر قرار می‌گیرند).
 
-### ثبت شرکت جدید
+### ثبت و ویرایش شرکت
 
-1. زبانه **شرکت‌ها** را انتخاب کنید.  
-2. **شرکت جدید** را بزنید.  
-3. **نام شرکت** را وارد کنید.  
-4. در صورت تمایل تلفن، ایمیل، آدرس و یادداشت را پر کنید.  
-5. **ذخیره** را بزنید.
+1. زبانه **شرکت‌ها** → **شرکت جدید**.  
+2. **نام شرکت** الزامی است.  
+3. تلفن، ایمیل، وب‌سایت، آدرس، شناسه ملی، یادداشت را در صورت نیاز پر کنید.  
+4. ذخیره کنید. اشخاص را بعداً به این شرکت وصل کنید.
 
-### نکته مهم درباره تکراری
+### جلوگیری از تکراری
 
-سیستم جلوی ثبت دوباره با **ایمیل** یا **موبایل** یکسان (برای اشخاص) و **ایمیل / تلفن / شناسه ملی** یکسان (برای شرکت‌ها) را می‌گیرد.  
-اگر پیام تکراری دیدید، یعنی آن مخاطب از قبل هست؛ همان را پیدا و ویرایش کنید.
+سیستم جلوی ثبت دوباره را می‌گیرد:
+
+- **شخص:** ایمیل یا موبایل یکسان  
+- **شرکت:** ایمیل / تلفن / شناسه ملی یکسان  
+
+اگر پیام تکراری دیدید، همان مخاطب قبلی را جستجو و ویرایش کنید — دوباره نسازید.
 
 ---
 
-## ۳) کاریز فروش (معاملات)
+## ۴) کاریز فروش (معاملات)
 
-کاریز مثل تخته فروش است. هر ستون یک مرحله است:
+کاریز فروش مثل تخته وایت‌برد مراحل فروش است. با **کاریز پروژه** اشتباه نشود؛ آن برای کارهای داخلی است.
+
+### مراحل پیش‌فرض
 
 1. سرنخ  
 2. تماس اول  
@@ -180,312 +317,546 @@
 
 ### دیدن کاریز
 
-1. از منو **کاریز فروش** را باز کنید.  
-2. از لیست **کاریز** می‌توانید بین کاریزها جابه‌جا شوید.  
-3. با **کاریز جدید** یک تخته جدا با همان مراحل پیش‌فرض بسازید.
-2. ستون‌ها و کارت‌های معامله را می‌بینید.  
-3. زیر عنوان هر ستون، تعداد کارت و جمع مبلغ همان ستون نشان داده می‌شود.
+1. منو → **کاریز فروش**.  
+2. از لیست بالا بین چند کاریز جابه‌جا شوید.  
+3. مالک/مدیر می‌تواند **کاریز جدید** بسازد (همان مراحل پیش‌فرض).  
+4. زیر هر ستون: تعداد کارت و جمع مبلغ (بر اساس ارز پایه سازمان).
 
 ### ساخت معامله جدید
 
-1. روی **معامله جدید** بزنید.  
-2. **عنوان معامله** را بنویسید (مثلاً «فروش بسته سازمانی آکمه»).  
-3. در صورت امکان **مبلغ** را به ریال وارد کنید.  
-4. شخص و/یا شرکت مرتبط را انتخاب کنید.  
-5. مرحله اولیه را انتخاب کنید (معمولاً «سرنخ»).  
-6. **ذخیره** را بزنید.
+1. **معامله جدید** را بزنید.  
+2. **عنوان** را بنویسید (مثلاً «فروش بسته سازمانی آکمه»).  
+3. مبلغ و ارز را وارد کنید، یا از ردیف محصول استفاده کنید تا مبلغ جمع شود.  
+4. شخص و/یا شرکت را وصل کنید.  
+5. مرحله اولیه را انتخاب کنید (معمولاً سرنخ).  
+6. اختیاری: منبع آشنایی، برچسب، تاریخ بسته‌شدن مورد انتظار، یادداشت، مسئول.  
+7. **ذخیره** را بزنید.
 
 ### جلو بردن معامله (کشیدن کارت)
 
 1. روی کارت ماوس را نگه دارید.  
-2. کارت را بگیرید و به ستون بعدی بکشید.  
-3. رها کنید.
+2. بگیرید و به ستون مقصد بکشید و رها کنید.  
+3. اگر به **برنده** برود، وضعیت معامله won می‌شود و در صورت فعال بودن اتوماسیون، قوانین مربوط اجرا می‌شود.  
+4. اگر به **از دست‌رفته** برود، وضعیت lost می‌شود؛ در فرم می‌توانید **دلیل شکست** بنویسید.
 
-مثال: وقتی پیشنهاد فرستادید، کارت را از «تماس اول» به «پیشنهاد» بکشید.
+### ویرایش معامله از روی کارت
 
-### ویرایش معامله
+1. روی عنوان کارت کلیک کنید (یا دوبارکلیک).  
+2. فیلدها را عوض کنید.  
+3. نشان‌های **راکد** / **فاسد** را در صورت نیاز بزنید.  
+4. ردیف محصول اضافه/حذف کنید.  
+5. از همان صفحه می‌توانید به پیش‌فاکتور یا فاکتور بروید (در صورت وجود میانبر).  
+6. **ذخیره** یا **حذف** (با تأیید).
 
-1. روی کارت کلیک کنید.  
-2. عنوان، مبلغ، شخص، شرکت، مرحله یا یادداشت را عوض کنید.  
-3. در صورت نیاز **منبع آشنایی**، **برچسب** و تاریخ بسته‌شدن مورد انتظار را پر کنید.  
-4. می‌توانید از منوی **محصولات** کاتالوگ بسازید و روی معامله ردیف محصول اضافه کنید؛ مبلغ از جمع ردیف‌ها محاسبه می‌شود.  
-5. اگر پیگیری متوقف شده **راکد**، و اگر تقریباً از دست رفته **فاسد** را علامت بزنید.  
-6. **ذخیره** را بزنید. روی کارت کاریز، برچسب و نشان راکد/فاسد دیده می‌شود.  
-7. با **بازگشت به کاریز** به تخته برگردید.
+### چند نکته کاربردی
 
-### معامله برنده یا از دست‌رفته
-
-- اگر فروش قطعی شد، کارت را به ستون **برنده** بکشید.  
-- اگر معامله شکست خورد، به ستون **از دست‌رفته** بکشید.  
-- در صفحه ویرایش می‌توانید **دلیل شکست** را هم بنویسید (برای تحلیل بعدی).
-
-### حذف معامله
-
-1. معامله را باز کنید.  
-2. **حذف** را بزنید و تأیید کنید.
+- هر معامله یک **مسئول (مالک)** دارد؛ جابه‌جایی در کاریز معمولاً به او اعلان می‌دهد.  
+- کارشناس فروش فقط معاملات خودش را روی برد می‌بیند.  
+- جمع ستون‌ها با نرخ ارز به ارز پایه تبدیل می‌شود.
 
 ---
 
-## ۴) فعالیت‌ها (تماس، جلسه، وظیفه)
+## ۵) فعالیت‌ها و تقویم
 
-فعالیت یعنی کاری که باید برای مشتری یا معامله انجام دهید.
+فعالیت = کاری که باید برای مشتری یا معامله انجام دهید.
 
-### دیدن کارهای امروز
+### فهرست فعالیت‌ها
 
-1. وارد **خانه امروز** شوید.  
-2. بخش‌های **عقب‌افتاده** و **امروز** را ببینید.  
-3. وقتی کار تمام شد، **انجام شد** را بزنید.
-
-### فهرست کامل
-
-1. از منو **فعالیت‌ها** را باز کنید.  
-2. زبانه‌ها: امروز / عقب‌افتاده / بعداً / انجام‌شده / همه  
+1. منو → **فعالیت‌ها**.  
+2. زبانه‌ها: امروز / عقب‌افتاده / بعداً / انجام‌شده / همه.  
 3. با جستجو عنوان را پیدا کنید.  
-4. برای نمای ماهانه، **تقویم** را بزنید (یا از منو **تقویم فعالیت‌ها**).
-
-### تقویم ماهانه
-
-1. ماه را با **ماه قبل / ماه بعد** عوض کنید؛ یا **برو به امروز**.  
-2. روی یک روز کلیک کنید تا فعالیت‌های همان روز در پنل کناری دیده شود.  
-3. **افزودن در این روز** فعالیت جدید با موعد همان روز می‌سازد.
+4. روی یک ردیف بزنید تا باز شود؛ یا **انجام شد** بزنید.
 
 ### ثبت فعالیت جدید
 
-1. **فعالیت جدید** را بزنید.  
-2. عنوان را بنویسید (مثلاً «تماس پیگیری پیشنهاد»).  
-3. نوع را انتخاب کنید: تماس، جلسه، وظیفه یا یادداشت.  
-4. موعد را بگذارید.  
-5. در صورت تمایل شخص و معامله مرتبط را انتخاب کنید.  
-6. **ذخیره** را بزنید.
+1. **فعالیت جدید**.  
+2. عنوان (مثلاً «تماس پیگیری پیشنهاد»).  
+3. نوع: تماس / جلسه / وظیفه / یادداشت.  
+4. موعد (تاریخ و ساعت).  
+5. شخص، شرکت، معامله و **مسئول** را در صورت نیاز وصل کنید.  
+6. ذخیره کنید.
 
-### پیشنهاد روزانه
+اگر فعالیت به شخص دیگری ارجاع شود، برای او **اعلان** ساخته می‌شود.
 
-1. صبح وارد شوید و خانه امروز را ببینید.  
-2. عقب‌افتاده‌ها را اول جمع کنید.  
-3. کارهای امروز را یکی‌یکی انجام و تیک بزنید.  
-4. معامله‌ها را در کاریز جلو ببرید.  
-5. مشتری جدید را در اشخاص ثبت کنید.
+### تقویم ماهانه (شمسی)
+
+1. از **موارد بیشتر → تقویم فعالیت‌ها** یا لینک تقویم داخل فعالیت‌ها.  
+2. با **ماه قبل / ماه بعد** جابه‌جا شوید یا **برو به امروز**.  
+3. روی یک روز کلیک کنید تا لیست همان روز را ببینید.  
+4. **افزودن در این روز** فعالیت با موعد همان روز می‌سازد.
 
 ---
 
-## ۵) یادداشت‌های هوشمند (Smart Notes)
+## ۶) یادداشت‌های هوشمند (Smart Notes)
 
-اینجا مثل Google Keep سریع می‌نویسید؛ بعداً AI و حافظه مشتری اضافه می‌شود.
+مثل Google Keep سریع می‌نویسید؛ بعداً قابلیت‌های AI اضافه می‌شود.
 
 ### ثبت یادداشت
 
-1. از منو **یادداشت‌ها** را باز کنید.  
-2. نوع را انتخاب کنید: معمولی، نتیجه تماس، جلسه، نکته مهم، هشدار یا کار بعدی.  
-3. در کادر بالا متن را بنویسید (عنوان اختیاری است).  
-4. در صورت نیاز، شخص، معامله، یادآوری یا برچسب اضافه کنید.  
-5. با **پیوست فایل** می‌توانید تصویر، PDF، Word، Excel یا ZIP اضافه کنید (حداکثر ۱۰ مگابایت).  
-6. **ثبت یادداشت** را بزنید.
+1. منو → **یادداشت‌ها**.  
+2. نوع را انتخاب کنید: معمولی، نتیجه تماس، جلسه، نکته مهم، هشدار، کار بعدی.  
+3. متن را بنویسید (عنوان اختیاری).  
+4. در صورت نیاز شخص / شرکت / معامله، یادآوری، برچسب.  
+5. **پیوست فایل** (تصویر، PDF، Word، Excel، متن، ZIP — حداکثر حدود ۱۰ مگابایت).  
+6. **ثبت یادداشت**.
 
-با تب‌های بالای صفحه می‌توانید فقط یک نوع یادداشت را ببینید.
+### روی کارت یادداشت
 
-روی هر کارت یادداشت هم می‌توانید پیوست جدید اضافه کنید، دانلود کنید یا حذف کنید.
+- **سنجاق** تا بالا بماند  
+- تغییر **رنگ**  
+- افزودن / دانلود / حذف پیوست  
+- **تبدیل به وظیفه** → یک فعالیت در بخش فعالیت‌ها می‌سازد  
 
-### پیوست فایل
-
-- هنگام ثبت، **پیوست فایل** را بزنید (تصویر، PDF، Word، Excel، متن یا ZIP؛ حداکثر ۱۰ مگابایت).  
-- روی کارت یادداشت هم می‌توانید پیوست اضافه، دانلود یا حذف کنید.
-
-### سنجاق، رنگ، تبدیل به وظیفه
-
-- برای مهم‌ها دکمه سنجاق را بزنید تا بالا بمانند.  
-- رنگ کارت را عوض کنید تا دسته‌بندی بصری داشته باشید.  
-- **تبدیل به وظیفه** یادداشت را به یک فعالیت در بخش فعالیت‌ها تبدیل می‌کند.
-
-### جستجو
-
-در بالای صفحه با متن یا برچسب جستجو کنید.
+با تب بالای صفحه فقط یک نوع یادداشت را فیلتر کنید. با جستجو متن یا برچسب پیدا کنید.
 
 ---
 
-## ۶) فیلدهای سفارشی
+## ۷) تایم‌لاین پرونده
 
-گاهی برای کسب‌وکار شما فیلدی لازم است که در فرم استاندارد نیست (مثلاً «صنعت» یا «کانال ترجیحی»).
+روی پرونده **ذخیره‌شده** شخص، شرکت یا معامله، پایین فرم بخش **تایم‌لاین** هست.
 
-### تعریف فیلد
+نشان می‌دهد:
 
-1. از منو **فیلدهای سفارشی** را باز کنید (فقط مالک یا مدیر).  
-2. عنوان، نوع (متن / عدد / تاریخ / بله‌خیر / لیست)، و اینکه روی شخص / شرکت / معامله باشد را مشخص کنید.  
-3. **افزودن فیلد** را بزنید.
+- یادداشت‌های متصل  
+- فعالیت‌های مرتبط  
 
-### پر کردن روی پرونده
+از همان‌جا می‌توانید:
 
-وقتی شخص، شرکت یا معامله را باز می‌کنید، بخش **فیلدهای سفارشی** زیر فرم اصلی ظاهر می‌شود. مقدار را وارد و ذخیره کنید.
+1. **یادداشت سریع** بنویسید و ثبت کنید.  
+2. عنوان پیگیری بدهید و **افزودن فعالیت** بزنید.  
+3. فعالیت باز را **انجام شد** کنید.
+
+> روی فرم «جدید» (هنوز ذخیره نشده) تایم‌لاین نیست؛ اول یک‌بار ذخیره کنید.
 
 ---
 
-## ۷) ورود و خروج اکسل مخاطبین
+## ۸) اعلان‌ها
 
-### خروجی اکسل
+### کجا؟
 
-1. بروید به **اشخاص و شرکت‌ها**.  
-2. تب اشخاص یا شرکت‌ها را انتخاب کنید.  
-3. **خروجی اکسل** را بزنید؛ فایل `.xlsx` دانلود می‌شود.  
-اگر جستجو فعال باشد، همان نتایج فیلترشده خارج می‌شوند.
+- **دسکتاپ:** آیکون زنگ کنار برند «منتو» در بالای منو + شمارنده قرمز  
+- **موبایل:** دکمه اعلان در نوار بالای صفحه  
 
-### ورود از اکسل
+### کار با پنل اعلان
 
-1. ترجیحاً یک‌بار خروجی بگیرید تا قالب ستون‌ها درست باشد.  
-2. فایل را پر کنید و **ورود از اکسل** را بزنید.  
-3. موارد تکراری (ایمیل/موبایل شخص یا ایمیل/تلفن/شناسه ملی شرکت) رد می‌شوند و بقیه ثبت می‌شوند.
-
----
-
-## ۸) اعلان‌های داخل برنامه
-
-در پایین منوی کناری دکمه **اعلان‌ها** را می‌بینید. اگر اعلان خوانده‌نشده باشد، عدد قرمز روی دکمه ظاهر می‌شود.
-
-### دیدن اعلان‌ها
-
-1. روی **اعلان‌ها** کلیک کنید.  
+1. روی آیکون بزنید.  
 2. لیست اعلان‌ها باز می‌شود (جدیدترها بالا).  
-3. روی یک اعلان بزنید تا خوانده شود و در صورت داشتن لینک، به همان صفحه بروید.
+3. روی یک مورد بزنید: خوانده می‌شود و اگر لینک داشته باشد به همان صفحه می‌روید.  
+4. **همه خوانده شد** همه را پاک می‌کند از حالت نخوانده.
 
 ### انواع رایج
 
-- **فعالیت جدید برای شما** — وقتی فعالیتی به شما ارجاع شود  
-- **جابه‌جایی معامله** — وقتی معامله‌ای که مالکتان است در کاریز جابه‌جا شود  
-- **فعالیت عقب‌افتاده** / **یادآوری یادداشت** — وقتی سررسید گذشته باشد
-
-### همه را خوانده علامت بزنید
-
-در بالای پنل اعلان‌ها، **همه خوانده شد** را بزنید.
-
----
-
-## ۹) تایم‌لاین پرونده
-
-روی پروندهٔ ذخیره‌شدهٔ **شخص**، **شرکت** یا **معامله**، پایین فرم بخش **تایم‌لاین** را می‌بینید.
-
-### چه چیزی نشان داده می‌شود؟
-
-- یادداشت‌های Smart Notes متصل به همان پرونده  
-- فعالیت‌های مرتبط (تماس، جلسه، وظیفه، …)
-
-### ثبت سریع
-
-1. در کادر **یادداشت سریع** بنویسید و **ثبت یادداشت** را بزنید.  
-2. یا عنوان یک پیگیری را بنویسید و **افزودن فعالیت** را بزنید.  
-3. برای فعالیت باز، می‌توانید همان‌جا **انجام شد** بزنید.
-
-تایم‌لاین فقط بعد از اولین ذخیرهٔ پرونده ظاهر می‌شود (روی فرم «جدید» نیست).
-
----
-
-## ۱۰) مشکلات رایج
-
-| مشکل | کار ساده |
+| نوع | معنی |
 |---|---|
-| ورود ناموفق / اتصال برقرار نشد | بپرسید API روشن است یا نه؛ در صورت نیاز دوباره وارد شوید |
-| مخاطب تکراری | همان مخاطب قبلی را جستجو و ویرایش کنید |
-| کارت جابه‌جا نمی‌شود | صفحه را بروزرسانی کنید؛ دوباره بکشید |
-| صفحه خالی است | از منو دوباره همان بخش را باز کنید؛ در صورت نیاز خارج و دوباره وارد شوید |
+| فعالیت ارجاع‌شده | کاری به شما سپرده شده |
+| جابه‌جایی معامله | معامله تحت مالکیت شما در کاریز حرکت کرده |
+| تیکت ارجاع‌شده | تیکت به شما رسیده |
+| فعالیت عقب‌افتاده / یادآور یادداشت | سررسید گذشته |
+| اتوماسیون | از قانون اگر/آنگاه ساخته شده |
+
+---
+
+## ۹) محصولات و ردیف معامله
+
+### کاتالوگ (مالک / مدیر)
+
+1. **تنظیمات → محصولات**.  
+2. نام، قیمت، ارز، فعال/غیرفعال را تعریف کنید.  
+3. ذخیره کنید.
+
+### استفاده روی معامله
+
+1. معامله را باز کنید.  
+2. ردیف محصول اضافه کنید (از کاتالوگ یا دستی).  
+3. تعداد و قیمت واحد را تنظیم کنید.  
+4. مبلغ معامله از جمع ردیف‌ها به‌روز می‌شود.
 
 ---
 
 ## ۱۰) پیش‌فاکتور
 
-1. از منو **پیش‌فاکتورها** را باز کنید یا از پرونده معامله **صدور پیش‌فاکتور** را بزنید.  
-2. عنوان، شخص/شرکت و ردیف‌های محصول را پر کنید.  
-3. وضعیت را (پیش‌نویس / ارسال‌شده / …) تنظیم و ذخیره کنید.  
-4. برای نسخه کاغذی، **چاپ** را بزنید.  
-5. در صورت تأیید، از همان پرونده **صدور فاکتور** بزنید.
+1. منو → **فروش و مالی → پیش‌فاکتورها** یا از پرونده معامله **صدور پیش‌فاکتور**.  
+2. عنوان، شخص/شرکت، ارز و ردیف‌ها را پر کنید.  
+3. وضعیت: پیش‌نویس / ارسال‌شده / پذیرفته / رد / منقضی.  
+4. ذخیره کنید.  
+5. **چاپ** برای نسخه کاغذی یا PDF مرورگر.  
+6. بعد از تأیید مشتری، از همان مسیر **صدور فاکتور** بزنید.
 
 ---
 
 ## ۱۱) فاکتور، پرداخت و اقساط
 
-1. از منو **فاکتورها** یا از معامله / پیش‌فاکتور **صدور فاکتور** را باز کنید.  
-2. ردیف‌ها را بررسی کنید؛ در صورت نیاز با دکمهٔ **۲ قسط** / **۳ قسط** برنامه اقساط بسازید.  
-3. وضعیت را روی **صادرشده** بگذارید و ذخیره کنید.  
-4. در بخش **ثبت پرداخت** مبلغ، روش و در صورت نیاز قسط مرتبط را وارد کنید.  
-5. وضعیت وصول (جزئی / تسویه) بر اساس مجموع پرداخت‌ها به‌روز می‌شود.
+1. منو → **فاکتورها** یا صدور از معامله / پیش‌فاکتور.  
+2. ردیف‌ها، ارز، شخص/شرکت را بررسی کنید.  
+3. در صورت نیاز با میانبر **۲ قسط** / **۳ قسط** برنامه اقساط بسازید (یا دستی).  
+4. وضعیت را روی **صادرشده** بگذارید و ذخیره کنید.  
+5. در بخش **ثبت پرداخت**: مبلغ، روش (نقد / کارت / حواله / چک / سایر)، تاریخ و در صورت نیاز قسط مرتبط.  
+6. وضعیت وصول (جزئی / تسویه / …) از جمع پرداخت‌ها به‌روز می‌شود.  
+7. فاکتور لغوشده دیگر پرداخت نپذیرید مگر وضعیت را برگردانید.
 
 ---
 
-## ۱۲) فرم‌ساز سرنخ
+## ۱۲) هدف و پیش‌بینی فروش
 
-1. با حساب مالک/مدیر از منو **فرم‌ساز سرنخ** را باز کنید.  
-2. نام فرم و در صورت نیاز مسئولان توزیع نوبتی را مشخص کنید و **ساخت فرم** را بزنید.  
-3. لینک عمومی، کد iframe یا QR را کپی کنید و در سایت بگذارید.  
-4. هر ارسال، یک **شخص** و یک **معامله** در مرحلهٔ اول کاریز می‌سازد (یا شخص تکراری را به‌روز می‌کند).
+1. منو → **هدف و پیش‌بینی** (یا کارت مرتبط در خانه).  
+2. مبلغ هدف ماه/بازه، تاریخ شروع و پایان را بگذارید.  
+3. مالک/مدیر می‌تواند هدف را برای کل سازمان یا یک کاربر بگذارد.  
+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. از منو **گزارشات** را باز کنید.  
+1. منو → **گزارشات**.  
 2. بازه تاریخ را انتخاب و **اعمال** بزنید.  
-3. KPI فروش، قیف باز، فعالیت‌ها، عملکرد تیم و وضعیت تیکت/CSAT را یک‌جا می‌بینید.  
-4. لینک پرتال مشتری سازمان هم در همین صفحه هست.
+3. یک‌جا می‌بینید:
+
+- KPI فروش (باز / برد / باخت، مبالغ، نرخ برد)  
+- قیف مراحل کاریز  
+- خلاصه فعالیت‌ها  
+- عملکرد تیم  
+- وضعیت تیکت و میانگین CSAT  
+- تعداد اشخاص جدید در بازه  
+
+4. لینک پرتال مشتری سازمان معمولاً در همین صفحه هم هست.
 
 ---
 
-## ۱۸) بخش‌های بعدی (به‌زودی)
+## ۱۴) تیکت پشتیبانی، SLA، FAQ و CSAT
 
-این‌ها در راهنما اضافه می‌شوند وقتی ساخته شدند:
+### لیست تیکت‌ها
+
+1. منو → **تیکت‌ها**.  
+2. فیلتر وضعیت / اولویت / جستجو.  
+3. فیلتر **فقط تأخیر SLA** برای مواردی که مهلت پاسخ اول گذشته.
+
+### ساخت تیکت
+
+1. **تیکت جدید**.  
+2. موضوع الزامی است؛ شرح را کامل بنویسید.  
+3. اولویت: کم / عادی / بالا / فوری — روی **مهلت پاسخ اول (SLA)** اثر دارد.  
+4. شخص، شرکت، معامله مرتبط و مسئول را انتخاب کنید.  
+5. هنگام ساخت، مقالات **FAQ** مرتبط پیشنهاد می‌شوند؛ اول همان‌ها را چک کنید تا تیکت تکراری نسازید.  
+6. ذخیره کنید؛ شماره تیکت ساخته می‌شود.
+
+### گفتگو و وضعیت
+
+1. تیکت را باز کنید.  
+2. در بخش گفتگو پاسخ بفرستید.  
+3. برای حرف داخلی تیم که مشتری نباید ببیند: **یادداشت داخلی**.  
+4. وضعیت را عوض کنید: باز → در حال رسیدگی → در انتظار → حل‌شده → بسته.  
+5. وقتی به حل‌شده/بسته می‌رود، در صورت فعال بودن اتوماسیون، قوانین «تیکت حل شد» اجرا می‌شود.
+
+### رضایت مشتری (CSAT)
+
+بعد از حل یا بستن:
+
+1. امتیاز ۱ تا ۵ ثبت کنید.  
+2. در صورت تمایل توضیح بنویسید.  
+3. همین امتیاز در گزارشات جمع می‌شود. مشتری از پرتال هم می‌تواند CSAT بدهد.
+
+### FAQ (مالک / مدیر)
+
+1. **تنظیمات → FAQ**.  
+2. سؤال، پاسخ، دسته، منتشر/پیش‌نویس، ترتیب.  
+3. مقالات منتشرشده در پرتال مشتری و پیشنهاد تیکت دیده می‌شوند.
+
+### دسترسی تیکت
+
+فروش/پشتیبانی معمولاً فقط تیکت‌هایی را می‌بینند که **مسئول** یا **ثبت‌کننده** آن‌ها هستند. مالک/مدیر همه را می‌بینند.
+
+---
+
+## ۱۵) پرتال مشتری (OTP و پیامک)
+
+پرتال برای خود مشتری است؛ نیاز به ایمیل سازمانی ندارد.
+
+### آدرس
+
+`https://crm.montzar.ir/p/اسلاگ-سازمان`  
+مثال دمو: `https://crm.montzar.ir/p/demo-mento`
+
+### ورود مشتری
+
+1. موبایلی را وارد کند که روی پرونده **شخص** در CRM ثبت شده.  
+2. **ارسال کد** را بزند.  
+3. کد یک‌بارمصرف با **پیامک** (پنل ترِز مثل مونتایم) می‌رسد.  
+4. کد را وارد کند و وارد شود.
+
+در production کد معمولاً داخل پاسخ وب دیده نمی‌شود (`PORTAL_SHOW_OTP=false`)؛ فقط پیامک. در توسعه لوکال ممکن است کد روی صفحه هم نشان داده شود.
+
+### کارهای مشتری داخل پرتال
+
+- دیدن FAQ  
+- ساخت تیکت و پیگیری گفتگو (بدون دیدن یادداشت داخلی)  
+- ثبت رضایت بعد از حل تیکت  
+
+اگر پیامک نرسید: موبایل شخص در CRM درست باشد؛ تنظیمات `SMS_*` سرور درست باشد؛ به مسئول فنی بگویید لاگ API را چک کند.
+
+---
+
+## ۱۶) کاریز پروژه
+
+برای کارهای **داخلی و پس‌ازفروش** است (تحویل، پیاده‌سازی، پیگیری داخلی). با کاریز فروش قاطی نشود.
+
+### مراحل پیش‌فرض برد
+
+1. صف  
+2. در حال انجام  
+3. بازبینی  
+4. انجام‌شده  
+
+### کار روزمره
+
+1. منو → **موارد بیشتر → کاریز پروژه**.  
+2. بین چند برد جابه‌جا شوید؛ مالک/مدیر **برد جدید** می‌سازد.  
+3. **کارت جدید** → عنوان و یادداشت.  
+4. کارت را بین ستون‌ها بکشید.  
+5. روی کارت کلیک کنید تا ویرایش یا حذف کنید.
+
+کارت پروژه می‌تواند (در API/فرم‌های بعدی) به شخص، شرکت یا معامله وصل شود؛ فعلاً حداقل عنوان و جابه‌جایی روی برد کافی است برای صف کار تیم.
+
+---
+
+## ۱۷) باشگاه مشتریان
+
+امتیاز وفاداری روی **شخص**.
+
+### سطوح پیش‌فرض
+
+| سطح | حداقل امتیاز تقریبی |
+|---|---|
+| برنزی | ۰ |
+| نقره‌ای | ۵۰۰ |
+| طلایی | ۲۰۰۰ |
+
+مالک/مدیر می‌تواند سطح جدید بسازد، حداقل امتیاز و رنگ را عوض یا سطح را حذف کند.
+
+### صفحه باشگاه
+
+1. منو → **موارد بیشتر → باشگاه مشتریان**.  
+2. لیست سطوح و تعداد اعضا را ببینید.  
+3. اعضا را جستجو کنید.  
+4. برای تغییر امتیاز: شخص را انتخاب کنید، مقدار مثبت یا منفی بدهید (مثلاً `+100` یا `-50`) و **تغییر امتیاز** بزنید.  
+5. سطح به‌صورت خودکار بر اساس مجموع امتیاز عوض می‌شود.
+
+روی فرم شخص هم امتیاز و سطح خلاصه دیده می‌شود.
+
+امتیاز می‌تواند از **اتوماسیون** هم بیاید (مثلاً بعد از برد معامله یا حل تیکت).
+
+---
+
+## ۱۸) اتوماسیون اگر / آنگاه
+
+فقط **مالک و مدیر**. بعد از رویداد مشخص، سیستم خودکار کار می‌کند.
+
+### باز کردن
+
+**تنظیمات → اتوماسیون**
+
+### ساخت قانون
+
+1. **نام** قانون را بنویسید (قابل فهم برای تیم).  
+2. **اگر (محرک)** را انتخاب کنید:
+
+| محرک | کی اجرا می‌شود؟ |
+|---|---|
+| معامله برنده شد | وقتی معامله تازه به وضعیت برد می‌رسد (مثلاً کشیدن به ستون برنده) |
+| تیکت حل شد | وقتی وضعیت تیکت تازه به حل‌شده یا بسته می‌رود |
+
+3. **آنگاه (عمل)** را انتخاب کنید:
+
+| عمل | نتیجه |
+|---|---|
+| ساخت فعالیت | یک وظیفه/فعالیت پیگیری ساخته می‌شود |
+| ارسال اعلان | به مسئول مرتبط اعلان می‌رود |
+| افزودن امتیاز باشگاه | اگر شخص روی معامله/تیکت باشد، امتیاز اضافه می‌شود |
+
+4. عنوان/توضیح اختیاری و برای امتیاز، تعداد امتیاز را بگذارید.  
+5. **فعال** را روشن بگذارید و ذخیره کنید.
+
+### مدیریت
+
+- در لیست: فعال/غیرفعال، ویرایش، حذف  
+- اگر قانون خطا بدهد، معمولاً عملیات اصلی (جابه‌جایی معامله / حل تیکت) را خراب نمی‌کند  
+
+**مثال آماده:**
+
+- اگر معامله برنده شد → ساخت فعالیت «جلسه شروع پروژه»  
+- اگر تیکت حل شد → افزودن ۱۰۰ امتیاز باشگاه  
+- اگر معامله برنده شد → اعلان به مالک معامله  
+
+---
+
+## ۱۹) فرم‌ساز سرنخ
+
+مالک / مدیر.
+
+1. **تنظیمات → فرم‌ساز سرنخ**.  
+2. نام فرم، کاریز مقصد، منبع، پیام تشکر / آدرس هدایت را تنظیم کنید.  
+3. مسئولان را برای **توزیع نوبتی (round-robin)** اضافه کنید.  
+4. فیلدهای فرم را بچینید و به فیلدهای شخص/معامله نگاشت کنید.  
+5. **ساخت / ذخیره**.  
+6. **لینک عمومی**، کد **iframe** یا **QR** را بردارید و در سایت/شبکه اجتماعی بگذارید.
+
+آدرس عمومی شبیه: `https://crm.montzar.ir/f/توکن-فرم`
+
+هر ارسال موفق معمولاً:
+
+- یک **شخص** می‌سازد یا تکراری را به‌روز می‌کند  
+- یک **معامله** در مرحله اول کاریز می‌سازد  
+- مسئول را نوبتی بین لیست می‌چرخاند  
+
+---
+
+## ۲۰) فیلدهای سفارشی
+
+مالک / مدیر.
+
+1. **تنظیمات → فیلدهای سفارشی**.  
+2. عنوان، نوع (متن / عدد / تاریخ / بله‌خیر / لیست انتخابی)، موجودیت (شخص / شرکت / معامله).  
+3. برای نوع لیست، گزینه‌ها را تعریف کنید.  
+4. افزودن فیلد.
+
+وقتی پرونده را باز می‌کنید، بخش **فیلدهای سفارشی** زیر فرم اصلی ظاهر می‌شود؛ مقدار را وارد و همراه ذخیره اصلی ثبت کنید.
+
+---
+
+## ۲۱) ارزها
+
+مالک / مدیر.
+
+1. **تنظیمات → ارزها**.  
+2. **ارز پایه** سازمان را انتخاب کنید (مثلاً IRR).  
+3. ارزهای فعال (مثل USD، EUR) را روشن کنید.  
+4. برای هر ارز خارجی، **نرخ به ارز پایه** را بگذارید (۱ واحد ارز خارجی = چند واحد پایه).  
+5. در معامله، پیش‌فاکتور، فاکتور و محصول می‌توانید ارز را عوض کنید.  
+6. جمع کاریز و گزارش‌ها بر اساس ارز پایه محاسبه می‌شود.
+
+اگر نرخ را عوض کردید، اعداد نمایشی بعدی با نرخ جدیدند؛ تاریخچه نرخ جداگانه نگه داشته نمی‌شود مگر بعداً اضافه شود.
+
+---
+
+## ۲۲) ورود و خروج اکسل
+
+1. **اشخاص و شرکت‌ها**.  
+2. تب اشخاص یا شرکت‌ها.  
+3. **خروجی اکسل** → فایل `.xlsx` (اگر جستجو فعال باشد، همان نتایج فیلترشده).  
+4. برای ورود: ترجیحاً یک‌بار خروجی بگیرید تا قالب ستون‌ها درست باشد، فایل را پر کنید، **ورود از اکسل** را بزنید.  
+5. ردیف‌های تکراری رد می‌شوند؛ بقیه ثبت می‌شوند. خلاصه نتیجه را بخوانید.
+
+---
+
+## ۲۳) دسترسی پرونده‌ای
+
+| نقش | اشخاص / شرکت‌ها / معاملات / فاکتورها / کارت پروژه | تیکت |
+|---|---|---|
+| مالک / مدیر | همه سازمان | همه |
+| فروش / پشتیبانی | معمولاً فقط جایی که **مالک** پرونده هستند | مسئول یا ثبت‌کننده |
+
+اگر چیزی «پیدا نمی‌شود»، اول نقش و مالکیت را چک کنید — ممکن است وجود داشته باشد ولی برای شما فیلتر شده باشد.
+
+تغییر مسئول پرونده معمولاً فقط برای مالک/مدیر آزاد است.
+
+---
+
+## ۲۴) کار روی موبایل
+
+- نوار بالا: منو (همبرگر) + برند + اعلان  
+- منوی کناری به‌صورت کشویی از کنار باز می‌شود  
+- کاریز را افقی ورق بزنید؛ برای کشیدن کارت بهتر است صفحه را افقی نگه دارید یا از دسکتاپ استفاده کنید  
+- فرم‌های بلند را تا ته اسکرول کنید تا دکمه ذخیره را ببینید  
+
+---
+
+## ۲۵) سناریوهای روزمره پیشنهادی
+
+### الف) کارشناس فروش — از سرنخ تا فاکتور
+
+1. سرنخ از فرم وب می‌آید یا شخص را دستی می‌سازید.  
+2. معامله در کاریز ساخته می‌شود / می‌سازید.  
+3. فعالیت تماس و یادداشت نتیجه تماس ثبت می‌کنید.  
+4. کارت را مرحله‌به‌مرحله جلو می‌برید.  
+5. پیش‌فاکتور می‌دهید → تأیید → فاکتور و در صورت نیاز اقساط.  
+6. کارت را به **برنده** می‌کشید (اتوماسیون می‌تواند وظیفه شروع پروژه یا امتیاز بسازد).  
+7. در **کاریز پروژه** کارت تحویل می‌سازید.
+
+### ب) پشتیبانی
+
+1. تیکت جدید یا تیکت پرتال را باز می‌کنید.  
+2. FAQ را چک می‌کنید.  
+3. پاسخ می‌دهید؛ وضعیت را عوض می‌کنید.  
+4. بعد از حل، CSAT می‌گیرید.  
+5. اگر اتوماسیون فعال است، امتیاز باشگاه خودکار می‌نشیند.
+
+### ج) مدیر فروش — صبح دوشنبه
+
+1. خانه امروز و گزارشات هفته قبل.  
+2. هدف ماه و پیش‌بینی.  
+3. معاملات راکد/فاسد روی کاریز.  
+4. تیکت‌های تأخیر SLA.  
+5. قوانین اتوماسیون و توزیع فرم سرنخ را مرور می‌کنید.
+
+---
+
+## ۲۶) مشکلات رایج
+
+| مشکل | کار ساده |
+|---|---|
+| ورود ناموفق / اتصال برقرار نشد | VPN/شبکه؛ وضعیت سایت؛ به فنی بگویید API/PM2 را چک کند |
+| «پیدا نشد» برای رکوردی که همکار می‌بیند | نقش شما فروش/پشتیبانی است و مالک پرونده دیگری است |
+| مخاطب تکراری | همان قبلی را ویرایش کنید |
+| کارت جابه‌جا نمی‌شود | بروزرسانی صفحه؛ دوباره بکشید؛ در موبایل سخت‌تر است |
+| OTP پیامک نمی‌رسد | موبایل شخص درست؟ فیلتر اسپم؟ تنظیمات SMS سرور؟ |
+| پرتال شخص را نمی‌شناسد | موبایل واردشده باید عین موبایل ذخیره‌شده روی شخص باشد |
+| منوی تنظیمات نیست | نقش شما مالک/مدیر نیست |
+| جمع کاریز عجیب است | نرخ ارز و ارز معامله را در تنظیمات ارزها چک کنید |
+| اعلان نمی‌آید | آیکون زنگ بالای منو را باز کنید؛ فیلتر نخوانده |
+| صفحه سفید بعد از آپدیت | یک‌بار Ctrl+F5؛ کش مرورگر |
+
+---
+
+## ۲۷) بخش‌های بعدی (به‌زودی)
+
+هنوز در محصول کامل نیستند؛ وقتی آماده شوند به همین راهنما اضافه می‌شوند:
 
 - پیشنهاد AI داخل یادداشت و Mento Memory  
-- Ask Mento  
-- کاریز پروژه / باشگاه مشتریان  
-- اتوماسیون اگر/آنگاه  
+- Ask Mento (پرسش زبان طبیعی)  
+- API عمومی و وب‌هوک برای سیستم‌های دیگر  
+- پنل پیامکی مستقل و درگاه پرداخت آنلاین داخل خود CRM  
+- اتصال عمیق‌تر VoIP / ووکامرس / حسابداری  
 
 ---
 
 ## برای مسئول فنی (کوتاه)
 
-- پنل: `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`
+| مورد | مقدار |
+|---|---|
+| ریپو | `http://get.feep.ir/Mahdi/CRM_Montzar.git` |
+| مسیر سرور | `/var/www/crm` |
+| دامنه | `https://crm.montzar.ir` |
+| PM2 | `mento-crm-api` (پورت ۳۰۳۰) |
+| استقرار | `deploy/DEPLOY.md` (شامل SMS، Postgres `:15432`، symlink `@mento/shared`) |
+| توسعه وب | `npm run dev:web` → `:5173` |
+| توسعه API | `npm run start:dev -w @mento/api` → معمولاً `:3000` |
+| دمو | `owner@demo.local` / `demo1234` |
+| نقشه راه | `docs/راهنما-و-نقشه-راه.md` |
+| وضعیت پیشرفت | `docs/وضعیت-پیشرفت.md` |
+
+خروجی Word از همین مارک‌داون:
+
+```bash
+python docs/export-doc.py --preset user-guide
+```
 
 ---
 
-**یادآوری:** این راهنما زنده است. با هر قابلیت جدید، همین فایل به‌روز می‌شود تا همیشه با نرم‌افزار واقعی یکی باشد.
+**یادآوری پایانی:** این راهنما باید با نرم‌افزار واقعی یکی باشد. اگر دکمه‌ای در راهنما بود ولی در پنل نبود (یا برعکس)، به تیم محصول بگویید تا همین فایل را هم‌زمان اصلاح کنند.
diff --git a/docs/وضعیت-پیشرفت.md b/docs/وضعیت-پیشرفت.md
index 42c73e9..9bf2b63 100644
--- a/docs/وضعیت-پیشرفت.md
+++ b/docs/وضعیت-پیشرفت.md
@@ -14,6 +14,7 @@
 
 | تاریخ | مورد |
 |---|---|
+| ۱۴۰۵/۶/۸ | تکمیل کامل راهنمای کاربری (همه ماژول‌ها، منوی جدید، پرتال/SMS، پروژه، باشگاه، اتوماسیون) |
 | ۱۴۰۵/۶/۸ | کاریز پروژه + باشگاه مشتریان + اتوماسیون اگر/آنگاه |
 | ۱۴۰۵/۶/۸ | تکمیل `deploy/DEPLOY.md`: پورت DB ۱۵۴۳۲، Prisma از `apps/api`، symlink `@mento/shared`، SMS ترِز، تله‌های tarball/nginx |
 | ۱۴۰۵/۶/۷ | پرتال مشتری OTP + گزارشات و داشبورد |