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

# راهنمای کاربری منتو (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. [برای مسئول فنی](#برای-مسئول-فنی-کوتاه)

---

## این راهنما چیست؟

به زبان ساده می‌گوید:

- منتو چیست و هر مفهوم (شخص، معامله، تیکت، …) یعنی چه  
- چطور وارد شوید و با منو کار کنید  
- برای هر بخش: **کجا بروید → چه دکمه‌هایی بزنید → نتیجه چه می‌شود**  
- تفاوت نقش‌ها (مالک / مدیر / فروش / پشتیبانی)  
- کار روزمره فروش و پشتیبانی با مثال  

> اگر تازه‌کارید، از **شروع خیلی ساده** شروع کنید، بعد بخش مربوط به کار خودتان را بخوانید.

---

## منتو چیست؟ (به زبان خیلی ساده)

منتو یک **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. آدرس `https://crm.montzar.ir` را وارد کنید (یا لوکال بالا).  
3. Enter بزنید.

اگر صفحه باز نشد، به مسئول فنی بگویید: «سایت یا API بالا نیست.»

### گام ۲ — ورود

1. در کادر **ایمیل**: `owner@demo.local`  
2. در کادر **رمز عبور**: `demo1234`  
3. **ورود** را بزنید.

اگر «اتصال به سرور برقرار نشد» دیدید، API روی سرور (پورت داخلی ۳۰۳۰ پشت nginx) باید روشن باشد.

### گام ۳ — یک دور تمرین

1. **اشخاص و شرکت‌ها** → لیست را ببینید.  
2. **کاریز فروش** → یک کارت را به ستون بعدی بکشید.  
3. **فعالیت‌ها** → کارهای امروز را ببینید.  
4. **یادداشت‌ها** → یک یادداشت کوتاه ثبت کنید.  
5. روی آیکون زنگ کنار برند کلیک کنید → اعلان‌ها را ببینید.  
6. پایین منو **خروج** را تست کنید و دوباره وارد شوید.

---

## منوی کناری و ساختار صفحه

منوی سمت راست (در دسکتاپ همیشه دیده می‌شود؛ در موبایل با دکمه همبرگری باز می‌شود).

### همیشه دیده می‌شود (موارد اصلی)

| منو | کارش |
|---|---|
| خانه امروز | خلاصه وضعیت، میانبرها، کارهای فوری |
| فعالیت‌ها | تماس / جلسه / وظیفه و فیلتر امروز و عقب‌افتاده |
| کاریز فروش | تخته معاملات فروش |
| اشخاص و شرکت‌ها | دفترچه مخاطبین + اکسل |
| تیکت‌ها | پشتیبانی مشتری |
| یادداشت‌ها | ثبت سریع Smart Notes |

### فروش و مالی (با کلیک باز می‌شود)

| منو | کارش |
|---|---|
| پیش‌فاکتورها | پیشنهاد قیمت قبل از فاکتور |
| فاکتورها | صدور، پرداخت، اقساط |
| هدف و پیش‌بینی | تارگت ماهانه و پیش‌بینی ساده |
| گزارشات | داشبورد فروش / قیف / تیم / تیکت |

### موارد بیشتر

| منو | کارش |
|---|---|
| تقویم فعالیت‌ها | نمای ماهانه شمسی موعدها |
| کاریز پروژه | کارهای داخلی و تحویل (جدا از فروش) |
| باشگاه مشتریان | امتیاز و سطح وفاداری |

### تنظیمات (فقط مالک و مدیر)

| منو | کارش |
|---|---|
| تیم و نقش‌ها | دعوت کاربر و نقش |
| اتوماسیون | قوانین اگر / آنگاه |
| فرم‌ساز سرنخ | لینک، iframe، QR |
| فیلدهای سفارشی | فیلد اختصاصی شخص/شرکت/معامله |
| محصولات | کاتالوگ محصول/خدمت |
| ارزها | ارز پایه و نرخ تبدیل |
| FAQ | مقالات پرتکرار برای تیکت و پرتال |

### بالای منو و پایین منو

- **کنار برند منتو:** آیکون اعلان + شمارنده خوانده‌نشده  
- **پایین منو:** کارت پروفایل (نام، نقش، آنلاین) — با کلیک، پروفایل خودتان باز می‌شود + دکمه **خروج**

اگر نقش شما فروش یا پشتیبانی باشد، ممکن است ببینید: «فقط پرونده‌های خودتان را می‌بینید.»

---

## ۱) ورود، خروج، نقش‌ها و تیم

### ورود

1. صفحه ورود را باز کنید.  
2. ایمیل و رمز را وارد کنید.  
3. **ورود** را بزنید.  
4. اگر قبلاً لینک داخلی باز کرده بودید، بعد از ورود معمولاً به همان صفحه برمی‌گردید.

### خروج

1. پایین منوی کناری **خروج** را بزنید.  
2. به صفحه ورود برمی‌گردید. روی دستگاه مشترک حتماً خارج شوید.

### ثبت‌نام سازمان جدید

اگر هنوز سازمانی ندارید:

1. روی **ثبت‌نام سازمان** بزنید.  
2. نام سازمان، نام خودتان، ایمیل و رمز را پر کنید.  
3. ثبت کنید؛ به‌عنوان **مالک** وارد پنل می‌شوید.

### نقش‌ها (چه کسی چه می‌تواند)

| نقش | پرونده‌ها | تنظیمات سازمان | دعوت کاربر | تغییر نقش مالک |
|---|---|---|---|---|
| **مالک** | همه | بله | بله | — |
| **مدیر** | همه | بله | بله | خیر |
| **فروش** | فقط مال خودش | خیر | خیر | خیر |
| **پشتیبانی** | فقط مال خودش (و تیکت‌های مرتبط) | خیر | خیر | خیر |

«مالک پرونده» یعنی مسئول آن شخص / شرکت / معامله / کارت پروژه معمولاً همان کاربری است که ساخته یا به او ارجاع شده.

### تیم و نقش‌ها (مالک / مدیر)

1. از **تنظیمات → تیم و نقش‌ها** وارد شوید.  
2. لیست کاربران سازمان را ببینید.  
3. برای دعوت: ایمیل، نام، رمز اولیه و نقش (مدیر / فروش / پشتیبانی) را پر کنید و ذخیره کنید.  
4. نقش کاربر موجود را در صورت نیاز عوض کنید (نقش مالک را به این سادگی عوض نکنید).

---

## ۲) خانه امروز

صفحه اول بعد از ورود.

معمولاً می‌بینید:

- خلاصه فعالیت‌های **عقب‌افتاده** و **امروز**  
- میانبر به کاریز، گزارشات یا هدف فروش ماه  
- وضعیت سریع فروش / تیکت (بسته به نسخه صفحه)

**پیشنهاد صبحگاهی:**

1. عقب‌افتاده‌ها را اول جمع کنید (دکمه **انجام شد**).  
2. کارهای امروز را یکی‌یکی پیش ببرید.  
3. معاملات راکد را در کاریز چک کنید.  
4. تیکت‌های باز یا تأخیر SLA را ببینید.

---

## ۳) اشخاص و شرکت‌ها

اینجا دفترچه تلفن و بانک مشتری شماست.

### دیدن لیست

1. منو → **اشخاص و شرکت‌ها**.  
2. دو زبانه: **اشخاص** و **شرکت‌ها**.  
3. در کادر جستجو نام / ایمیل / موبایل را بنویسید و جستجو کنید.

### ثبت شخص جدید

1. زبانه **اشخاص** → **شخص جدید**.  
2. حداقل **نام** و **نام خانوادگی** را پر کنید.  
3. موبایل یا ایمیل را در صورت امکان بگذارید (برای تکراری‌نشدن و پرتال OTP مهم است).  
4. در صورت نیاز سمت، تلفن، یادداشت و **شرکت** مرتبط را انتخاب کنید.  
5. اگر فیلد سفارشی تعریف شده، پایین فرم پر کنید.  
6. **ذخیره** را بزنید.

روی نام شخص در لیست، **پروفایل مشتری** باز می‌شود (خلاصه هوشمند، تب‌ها، معاملات و تایم‌لاین). برای ویرایش فیلدها از منوی سه‌نقطه → **ویرایش اطلاعات** استفاده کنید.

روی پرونده:

- تماس / پیام / پیگیری از ردیف اکشن‌ها
- تب‌های خلاصه، فعالیت‌ها، معاملات، کارت‌ها، اطلاعات
- پایین صفحه: فعالیت جدید، ایجاد سریع، تماس سریع
- بخش **باشگاه مشتریان** در تب اطلاعات (لینک به مدیریت باشگاه)

### ویرایش یا حذف شخص

1. در لیست روی نام کلیک کنید تا پروفایل باز شود.  
2. منوی سه‌نقطه → **ویرایش اطلاعات** → ذخیره.  
3. برای حذف: همان منو → **حذف شخص** و تأیید (مراقب باشید؛ ارتباط‌ها تحت تأثیر قرار می‌گیرند).

### ثبت و ویرایش شرکت

1. زبانه **شرکت‌ها** → **شرکت جدید**.  
2. **نام شرکت** الزامی است.  
3. تلفن، ایمیل، وب‌سایت، آدرس، شناسه ملی، یادداشت را در صورت نیاز پر کنید.  
4. ذخیره کنید. اشخاص را بعداً به این شرکت وصل کنید.

### جلوگیری از تکراری

سیستم جلوی ثبت دوباره را می‌گیرد:

- **شخص:** ایمیل یا موبایل یکسان  
- **شرکت:** ایمیل / تلفن / شناسه ملی یکسان  

اگر پیام تکراری دیدید، همان مخاطب قبلی را جستجو و ویرایش کنید — دوباره نسازید.

---

## ۴) کاریز فروش (معاملات)

کاریز فروش مثل تخته وایت‌برد مراحل فروش است. با **کاریز پروژه** اشتباه نشود؛ آن برای کارهای داخلی است.

### مراحل پیش‌فرض

1. سرنخ  
2. تماس اول  
3. پیشنهاد  
4. مذاکره  
5. برنده  
6. از دست‌رفته  

### دیدن کاریز

1. منو → **کاریز فروش**.  
2. از لیست بالا بین چند کاریز جابه‌جا شوید.  
3. مالک/مدیر می‌تواند **کاریز جدید** بسازد (همان مراحل پیش‌فرض).  
4. زیر هر ستون: تعداد کارت و جمع مبلغ (بر اساس ارز پایه سازمان).

### ساخت معامله جدید

1. **معامله جدید** را بزنید.  
2. **عنوان** را بنویسید (مثلاً «فروش بسته سازمانی آکمه»).  
3. مبلغ و ارز را وارد کنید، یا از ردیف محصول استفاده کنید تا مبلغ جمع شود.  
4. شخص و/یا شرکت را وصل کنید.  
5. مرحله اولیه را انتخاب کنید (معمولاً سرنخ).  
6. اختیاری: منبع آشنایی، برچسب، تاریخ بسته‌شدن مورد انتظار، یادداشت، مسئول.  
7. **ذخیره** را بزنید.

### جلو بردن معامله (کشیدن کارت)

1. روی کارت ماوس را نگه دارید.  
2. بگیرید و به ستون مقصد بکشید و رها کنید.  
3. اگر به **برنده** برود، وضعیت معامله won می‌شود و در صورت فعال بودن اتوماسیون، قوانین مربوط اجرا می‌شود.  
4. اگر به **از دست‌رفته** برود، وضعیت lost می‌شود؛ در فرم می‌توانید **دلیل شکست** بنویسید.

### ویرایش معامله از روی کارت

1. روی عنوان کارت کلیک کنید (یا دوبارکلیک).  
2. فیلدها را عوض کنید.  
3. نشان‌های **راکد** / **فاسد** را در صورت نیاز بزنید.  
4. ردیف محصول اضافه/حذف کنید.  
5. از همان صفحه می‌توانید به پیش‌فاکتور یا فاکتور بروید (در صورت وجود میانبر).  
6. **ذخیره** یا **حذف** (با تأیید).

### چند نکته کاربردی

- هر معامله یک **مسئول (مالک)** دارد؛ جابه‌جایی در کاریز معمولاً به او اعلان می‌دهد.  
- کارشناس فروش فقط معاملات خودش را روی برد می‌بیند.  
- جمع ستون‌ها با نرخ ارز به ارز پایه تبدیل می‌شود.

---

## ۵) فعالیت‌ها و تقویم

فعالیت = کاری که باید برای مشتری یا معامله انجام دهید.

### فهرست فعالیت‌ها

1. منو → **فعالیت‌ها**.  
2. زبانه‌ها: امروز / عقب‌افتاده / بعداً / انجام‌شده / همه.  
3. با جستجو عنوان را پیدا کنید.  
4. روی یک ردیف بزنید تا باز شود؛ یا **انجام شد** بزنید.

### ثبت فعالیت جدید

1. **فعالیت جدید**.  
2. عنوان (مثلاً «تماس پیگیری پیشنهاد»).  
3. نوع: تماس / جلسه / وظیفه / یادداشت.  
4. موعد (تاریخ و ساعت).  
5. شخص، شرکت، معامله و **مسئول** را در صورت نیاز وصل کنید.  
6. ذخیره کنید.

اگر فعالیت به شخص دیگری ارجاع شود، برای او **اعلان** ساخته می‌شود.

### تقویم ماهانه (شمسی)

1. از **موارد بیشتر → تقویم فعالیت‌ها** یا لینک تقویم داخل فعالیت‌ها.  
2. با **ماه قبل / ماه بعد** جابه‌جا شوید یا **برو به امروز**.  
3. روی یک روز کلیک کنید تا لیست همان روز را ببینید.  
4. **افزودن در این روز** فعالیت با موعد همان روز می‌سازد.

---

## ۶) یادداشت‌های هوشمند (Smart Notes)

مثل Google Keep سریع می‌نویسید؛ بعداً قابلیت‌های AI اضافه می‌شود.

### ثبت یادداشت

1. منو → **یادداشت‌ها**.  
2. نوع را انتخاب کنید: معمولی، نتیجه تماس، جلسه، نکته مهم، هشدار، کار بعدی.  
3. متن را بنویسید (عنوان اختیاری).  
4. در صورت نیاز شخص / شرکت / معامله، یادآوری، برچسب.  
5. **پیوست فایل** (تصویر، PDF، Word، Excel، متن، ZIP — حداکثر حدود ۱۰ مگابایت).  
6. **ثبت یادداشت**.

### روی کارت یادداشت

- **سنجاق** تا بالا بماند  
- تغییر **رنگ**  
- افزودن / دانلود / حذف پیوست  
- **تبدیل به وظیفه** → یک فعالیت در بخش فعالیت‌ها می‌سازد  

با تب بالای صفحه فقط یک نوع یادداشت را فیلتر کنید. با جستجو متن یا برچسب پیدا کنید.

---

## ۷) تایم‌لاین پرونده

روی پروفایل **شخص** تایم‌لاین در تب خلاصه و فعالیت‌هاست. روی پرونده **شرکت** یا **معامله**، پایین فرم بخش **تایم‌لاین** هست.

نشان می‌دهد:

- یادداشت‌های متصل  
- فعالیت‌های مرتبط  

از همان‌جا می‌توانید:

1. **یادداشت سریع** بنویسید و ثبت کنید.  
2. عنوان پیگیری بدهید و **افزودن فعالیت** بزنید.  
3. فعالیت باز را **انجام شد** کنید.

> روی فرم «جدید» (هنوز ذخیره نشده) تایم‌لاین نیست؛ اول یک‌بار ذخیره کنید.

---

## ۸) اعلان‌ها

### کجا؟

- **دسکتاپ:** آیکون زنگ کنار برند «منتو» در بالای منو + شمارنده قرمز  
- **موبایل:** دکمه اعلان در نوار بالای صفحه  

### کار با پنل اعلان

1. روی آیکون بزنید.  
2. لیست اعلان‌ها باز می‌شود (جدیدترها بالا).  
3. روی یک مورد بزنید: خوانده می‌شود و اگر لینک داشته باشد به همان صفحه می‌روید.  
4. **همه خوانده شد** همه را پاک می‌کند از حالت نخوانده.

### انواع رایج

| نوع | معنی |
|---|---|
| فعالیت ارجاع‌شده | کاری به شما سپرده شده |
| جابه‌جایی معامله | معامله تحت مالکیت شما در کاریز حرکت کرده |
| تیکت ارجاع‌شده | تیکت به شما رسیده |
| فعالیت عقب‌افتاده / یادآور یادداشت | سررسید گذشته |
| اتوماسیون | از قانون اگر/آنگاه ساخته شده |

---

## ۹) محصولات و ردیف معامله

### کاتالوگ (مالک / مدیر)

1. **تنظیمات → محصولات**.  
2. نام، قیمت، ارز، فعال/غیرفعال را تعریف کنید.  
3. ذخیره کنید.

### استفاده روی معامله

1. معامله را باز کنید.  
2. ردیف محصول اضافه کنید (از کاتالوگ یا دستی).  
3. تعداد و قیمت واحد را تنظیم کنید.  
4. مبلغ معامله از جمع ردیف‌ها به‌روز می‌شود.

---

## ۱۰) پیش‌فاکتور

1. منو → **فروش و مالی → پیش‌فاکتورها** یا از پرونده معامله **صدور پیش‌فاکتور**.  
2. عنوان، شخص/شرکت، ارز و ردیف‌ها را پر کنید.  
3. وضعیت: پیش‌نویس / ارسال‌شده / پذیرفته / رد / منقضی.  
4. ذخیره کنید.  
5. **چاپ** برای نسخه کاغذی یا PDF مرورگر.  
6. بعد از تأیید مشتری، از همان مسیر **صدور فاکتور** بزنید.

---

## ۱۱) فاکتور، پرداخت و اقساط

1. منو → **فاکتورها** یا صدور از معامله / پیش‌فاکتور.  
2. ردیف‌ها، ارز، شخص/شرکت را بررسی کنید.  
3. در صورت نیاز با میانبر **۲ قسط** / **۳ قسط** برنامه اقساط بسازید (یا دستی).  
4. وضعیت را روی **صادرشده** بگذارید و ذخیره کنید.  
5. در بخش **ثبت پرداخت**: مبلغ، روش (نقد / کارت / حواله / چک / سایر)، تاریخ و در صورت نیاز قسط مرتبط.  
6. وضعیت وصول (جزئی / تسویه / …) از جمع پرداخت‌ها به‌روز می‌شود.  
7. فاکتور لغوشده دیگر پرداخت نپذیرید مگر وضعیت را برگردانید.

---

## ۱۲) هدف و پیش‌بینی فروش

1. منو → **هدف و پیش‌بینی** (یا کارت مرتبط در خانه).  
2. مبلغ هدف ماه/بازه، تاریخ شروع و پایان را بگذارید.  
3. مالک/مدیر می‌تواند هدف را برای کل سازمان یا یک کاربر بگذارد.  
4. اعداد صفحه:

| شاخص | معنی تقریبی |
|---|---|
| تحقق | جمع معاملات **برنده** در همان بازه |
| کاریز باز | ارزش معاملات باز |
| پیش‌بینی | تحقق + حدود ۴۰٪ کاریز باز (مدل ساده) |

کارشناس فروش فقط اعداد پرونده‌های خودش را می‌بیند.

---

## ۱۳) گزارشات و داشبورد

1. منو → **گزارشات**.  
2. بازه تاریخ را انتخاب و **اعمال** بزنید.  
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 (پرسش زبان طبیعی)  
- API عمومی و وب‌هوک برای سیستم‌های دیگر  
- پنل پیامکی مستقل و درگاه پرداخت آنلاین داخل خود CRM  
- اتصال عمیق‌تر VoIP / ووکامرس / حسابداری  

---

## برای مسئول فنی (کوتاه)

| مورد | مقدار |
|---|---|
| ریپو | `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 و PDF از همین مارک‌داون:

```bash
python docs/export-doc.py --preset user-guide
# سپس در ویندوز با Word ذخیره به‌صورت PDF، یا فایل‌های آماده:
# docs/راهنمای-کاربری.docx
# docs/راهنمای-کاربری.pdf
```

---

**یادآوری پایانی:** این راهنما باید با نرم‌افزار واقعی یکی باشد. اگر دکمه‌ای در راهنما بود ولی در پنل نبود (یا برعکس)، به تیم محصول بگویید تا همین فایل را هم‌زمان اصلاح کنند.