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

492 lines
25 KiB
Markdown
Raw Normal View History

# راهنمای کاربری منتو (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`
---
**یادآوری:** این راهنما زنده است. با هر قابلیت جدید، همین فایل به‌روز می‌شود تا همیشه با نرم‌افزار واقعی یکی باشد.