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

# راهنمای کاربری منتکت (Montact CRM)

**نسخه راهنما:** هماهنگ با محصول روی `https://crm.montzar.ir` (به‌روز ۱۴ شهریور ۱۴۰۵)  
**مخاطب:** همکاران فروش، پشتیبانی و مدیران — با یا بدون تجربه CRM.

اسناد مرتبط: [`قابلیت‌های-منتکت.md`](قابلیت‌های-منتکت.md) · [`وضعیت-پیشرفت.md`](وضعیت-پیشرفت.md)

---

## فهرست مطالب

1. [این راهنما چیست؟](#این-راهنما-چیست)
2. [منتکت چیست؟](#منتکت-چیست-به-زبان-خیلی-ساده)
3. [آدرس‌ها و حساب‌های دمو](#آدرسها-و-حسابهای-دمو)
4. [شروع خیلی ساده](#شروع-خیلی-ساده-۱۰-دقیقه)
5. [منوی کناری](#منوی-کناری-و-ساختار-صفحه)
6. [ورود، ثبت‌نام، نقش‌ها و تیم](#۱-ورود-ثبتنام-نقشها-و-تیم)
7. [خانه امروز](#۲-خانه-امروز)
8. [اشخاص و شرکت‌ها](#۳-اشخاص-و-شرکتها)
9. [کاریز فروش](#۴-کاریز-فروش-معاملات)
10. [فعالیت‌ها و تقویم](#۵-فعالیتها-و-تقویم)
11. [یادداشت‌های هوشمند](#۶-یادداشتهای-هوشمند-smart-notes)
12. [تایم‌لاین و اعلان‌ها](#۷-تایملین-و-اعلانها)
13. [محصولات و مبلغ‌ها](#۸-محصولات-و-مبلغها)
14. [پیش‌فاکتور و فاکتور](#۹-پیشفاکتور-و-فاکتور)
15. [هدف و گزارش فروش](#۱۰-هدف-و-گزارش-فروش)
16. [تیکت و پرتال مشتری](#۱۱-تیکت-و-پرتال-مشتری)
17. [کاریز پروژه و باشگاه](#۱۲-کاریز-پروژه-و-باشگاه)
18. [اتوماسیون و فرم‌ساز سرنخ](#۱۳-اتوماسیون-و-فرمساز-سرنخ)
19. [تنظیمات سازمان](#۱۴-تنظیمات-سازمان)
20. [ته‌حساب (طلا و جواهر)](#۱۵-تهحساب-طلا-و-جواهر)
21. [کار روی موبایل](#۱۶-کار-روی-موبایل)
22. [سناریوهای روزمره](#۱۷-سناریوهای-روزمره)
23. [مشکلات رایج](#۱۸-مشکلات-رایج)
24. [برای مسئول فنی](#برای-مسئول-فنی-کوتاه)

---

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

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

---

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

منتکت یک **CRM فارسی** است: دفترچه مشتری، تخته فروش، پیگیری، پشتیبانی، فاکتور، پرتال مشتری و (برای طلا و جواهر) اتصال به ته‌حساب — در یک جا.

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

---

## آدرس‌ها و حساب‌های دمو

| مورد | آدرس |
|---|---|
| پنل اصلی | `https://crm.montzar.ir` |
| پرتال مشتری دمو | `https://crm.montzar.ir/p/demo-mento` |
| سلامت API | `https://crm.montzar.ir/api/health` |
| پنل لوکال | `http://localhost:5173` |

| ایمیل | رمز | نقش |
|---|---|---|
| `owner@demo.local` | `demo1234` | مالک |
| `admin@demo.local` | `demo1234` | مدیر |
| `sales@demo.local` | `demo1234` | فروش |

---

## شروع خیلی ساده (۱۰ دقیقه)

1. آدرس پنل را باز کنید.  
2. با `owner@demo.local` / `demo1234` وارد شوید (ورود با **رمز**؛ نیازی به OTP نیست).  
3. **اشخاص** را ببینید → یک کارت کاریز را جابه‌جا کنید → یک **فعالیت** و یک **یادداشت** بسازید.  
4. زنگ اعلان کنار برند را باز کنید.  
5. پایین منو **خروج** را تست کنید.

---

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

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

**اصلی:** خانه · فعالیت‌ها · کاریز فروش · اشخاص · تیکت‌ها · یادداشت‌ها  

**فروش و مالی:** پیش‌فاکتور · فاکتور · هدف و پیش‌بینی · گزارشات  

**بیشتر:** تقویم · کاریز پروژه · باشگاه مشتریان  

**تنظیمات (مالک/مدیر):** تیم · اتوماسیون · فرم‌ساز سرنخ · فیلد سفارشی · محصولات · ارزها · FAQ · ته‌حساب  

بالای منو: اعلان‌ها · پایین منو: کارت پروفایل شما + خروج  

---

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

### ورود با رمز (روش اصلی)

1. شناسه را وارد کنید: **ایمیل یا موبایل**.  
2. رمز عبور را بزنید.  
3. **ورود** — مستقیم وارد پنل می‌شوید (بدون OTP).

### ورود اختیاری با OTP موبایل

اگر روی حساب موبایل ثبت شده باشد، می‌توانید مسیر «ورود با کد» را بزنید، کد پیامکی را وارد کنید و وارد شوید.

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

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

### نقش‌ها

| نقش | پرونده‌ها | تنظیمات | دعوت کاربر |
|---|---|---|---|
| مالک | همه | بله | بله |
| مدیر | همه | بله | بله |
| فروش | معمولاً فقط مال خودش | خیر | خیر |
| پشتیبانی | پرونده/تیکت مرتبط | خیر | خیر |

### تیم

**تنظیمات → تیم و نقش‌ها:** دعوت با ایمیل/نام/رمز اولیه و نقش.

---

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

بعد از ورود می‌بینید: خلاصه فعالیت‌ها، میانبرها، نمای کاریز/روند فروش، و امکان **پرسیدن از منتکت** (Ask Montact) درباره کار امروز.

---

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

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

**نکته موبایل:** لیست به‌صورت کارت دیده می‌شود؛ جدول مخصوص دسکتاپ است.

---

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

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

مبالغ با **جداکننده هزارگان** نمایش و وارد می‌شوند.

---

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

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

فیلتر امروز / عقب‌افتاده / بعداً / انجام‌شده · جستجو · نوع فعالیت.  
فعالیت جدید: عنوان، نوع، موعد (جلالی)، مسئول، اتصال به شخص/معامله.

### یادآور

اگر موعد یادآور بگذارید، می‌توانید مشخص کنید اعلان **داخل برنامه** و/یا **پیامک** برود. حداقل یکی باید روشن باشد.

### تقویم

**تقویم فعالیت‌ها:** نمای ماه شمسی موعدها. ساعت را می‌توانید با صفحهٔ دایره‌ای انتخاب کنید.

---

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

1. **یادداشت‌ها** را باز کنید.  
2. نوع یادداشت را انتخاب کنید و متن را بنویسید (یا با دکمه **میکروفون** دیکته کنید).  
3. **سطح دسترسی** را تنظیم کنید: تیمی (پیش‌فرض) یا شخصی (فقط شما).  
4. به شخص/شرکت/معامله وصل کنید؛ در صورت نیاز پین/برچسب/یادآور.  
5. پیشنهاد هوشمند یا Memory را فقط بعد از خواندن و **تأیید** اعمال کنید.  
6. از منوی کارت یا دکمهٔ **تاریخچه** در ویرایش، نسخه‌های قبلی را ببینید و در صورت نیاز بازگردانید.  
7. از کادر **از منتکت بپرس** سؤال زبان طبیعی بپرسید (مثلاً «آخرین بار درباره قیمت چه گفت؟»).

پیوست فایل روی یادداشت از همان فرم قابل افزودن است.

---

## ۷) تایم‌لاین و اعلان‌ها

- روی پرونده شخص/شرکت/معامله، تایم‌لاین رویدادها را می‌بینید.  
- زنگ کنار برند: اعلان‌های خوانده/نخوانده (از جمله یادآور فعالیت).

---

## ۸) محصولات و مبلغ‌ها

**تنظیمات → محصولات:** نام، قیمت واحد، ارز.  
روی معامله/پیش‌فاکتور/فاکتور ردیف اضافه کنید؛ جمع خودکار محاسبه می‌شود.  
در همه فیلدهای قیمت، اعداد سه‌رقم‌سه‌رقم جدا می‌شوند.

---

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

### پیش‌فاکتور

لیست با فیلتر وضعیت · فرم با ردیف و چاپ · صدور از معامله · تبدیل به فاکتور.

### فاکتور

صدور، وضعیت، چاپ · ثبت پرداخت · برنامه اقساط (۲ قسط / ۳ قسط / دستی).

---

## ۱۰) هدف و گزارش فروش

- **هدف و پیش‌بینی:** تارگت دوره و پیگیری تحقق.  
- **گزارشات:** داشبورد فروش، قیف، فعالیت، تیم و تیکت با فیلتر تاریخ.

---

## ۱۱) تیکت و پرتال مشتری

### تیکت داخل پنل

ثبت موضوع، اولویت، مسئول · گفتگو · FAQ پیشنهادی · فیلتر تأخیر SLA · بعد از حل: CSAT.

### پرتال مشتری

آدرس شبیه `https://crm.montzar.ir/p/نام-سازمان`.  
مشتری موبایلی را وارد می‌کند که روی **شخص** ثبت شده، OTP پیامکی می‌گیرد و تیکت/FAQ را می‌بیند.

---

## ۱۲) کاریز پروژه و باشگاه

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

---

## ۱۳) اتوماسیون و فرم‌ساز سرنخ

### اتوماسیون

**تنظیمات → اتوماسیون:** اگر معامله برنده شد / تیکت حل شد → ساخت فعالیت، اعلان، یا امتیاز باشگاه.

### فرم‌ساز سرنخ

**تنظیمات → فرم‌ساز سرنخ:** لینک عمومی، iframe، QR · ثبت شخص+معامله · توزیع نوبتی بین تیم.

---

## ۱۴) تنظیمات سازمان

فقط مالک/مدیر:

| بخش | کار |
|---|---|
| تیم و نقش‌ها | کاربران |
| فیلدهای سفارشی | فیلد اضافه |
| محصولات | کاتالوگ |
| ارزها | ارز پایه و نرخ |
| FAQ | مقالات پشتیبانی |
| اتوماسیون | قوانین |
| فرم‌ساز سرنخ | جذب سرنخ |
| ته‌حساب | اتصال حسابداری طلا |

---

## ۱۵) ته‌حساب (طلا و جواهر)

برای سازمان‌هایی که حوزه طلا/جواهر دارند (یا اتصال حسابداری می‌خواهند):

1. **تنظیمات → ته‌حساب:** اتصال (آدرس، توکن، نام DB) بسازید و تست کنید. می‌توانید چند اتصال داشته باشید.  
2. در **پروفایل شخص → دارایی:** تطبیق خودکار/دستی با کد مشتری ته‌حساب، یا ثبت مشتری جدید در ته‌حساب.  
3. مانده و اسناد را ببینید؛ در صورت نیاز **ثبت سند** (خرید/فروش، طلب/بدهی، بانک و …) از همین تب.

جزئیات فنی: [`integrations/tahesab.md`](integrations/tahesab.md)

---

## ۱۶) کار روی موبایل

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

---

## ۱۷) سناریوهای روزمره

### کارشناس فروش

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

### پشتیبانی

تیکت / پرتال → FAQ → پاسخ → تغییر وضعیت → CSAT → (اتوماسیون) امتیاز باشگاه.

### مدیر

خانه و گزارشات → هدف ماه → معاملات راکد → تیکت‌های تأخیر SLA → مرور اتوماسیون و فرم سرنخ.

---

## ۱۸) مشکلات رایج

| مشکل | کار ساده |
|---|---|
| ورود ناموفق | ایمیل/موبایل و رمز؛ وضعیت API؛ Ctrl+F5 |
| OTP ثبت‌نام/پرتال نمی‌رسد | موبایل درست؟ تنظیمات SMS سرور؟ |
| رکورد «پیدا نشد» | نقش شما فروش است و مالک پرونده دیگری است |
| منوی تنظیمات نیست | نقش مالک/مدیر نیست |
| مبلغ عجیب در کاریز | ارز معامله و نرخ در تنظیمات ارزها |
| ته‌حساب وصل نمی‌شود | توکن/DB/آدرس؛ تست اتصال در تنظیمات |
| صفحه سفید بعد از آپدیت | Ctrl+F5 |

---

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

| مورد | مقدار |
|---|---|
| ریپو | `http://get.feep.ir/Mahdi/CRM_Montzar.git` |
| مسیر سرور | `/var/www/crm` |
| دامنه | `https://crm.montzar.ir` |
| API PM2 | `mento-crm-api` |
| راهنمای استقرار | [`deploy/DEPLOY.md`](../deploy/DEPLOY.md) |

برای بازتولید Word/PDF راهنما از همین Markdown، مثل قبل از ابزار تبدیل داخلی پروژه استفاده کنید (در صورت وجود اسکریپت تولید در `docs/`).