# راهنمای کامل استفاده از لیموسی — نقش به نقش

> این راهنما بر پایه کد نسخه فعلی نوشته شده است. جدول‌های دسترسی مستقیماً از `RolePermissions` و `PermissionEnum` تولید شده‌اند، نه از روی حافظه یا مستندات قدیمی.

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

1. [لیموسی چیست و چطور سازمان‌دهی شده](#۱-لیموسی-چیست-و-چطور-سازماندهی-شده)
2. [پنج نقش در یک نگاه](#۲-پنج-نقش-در-یک-نگاه)
3. [نقش مالک](#۳-نقش-مالک-owner)
4. [نقش مدیر فروش](#۴-نقش-مدیر-فروش-sales_manager)
5. [نقش فروشنده](#۵-نقش-فروشنده-seller)
6. [نقش مالی](#۶-نقش-مالی-finance)
7. [نقش مشاهده‌گر](#۷-نقش-مشاهدهگر-viewer)
8. [کاربر پرتال — حساب جداگانه](#۸-کاربر-پرتال--حساب-جداگانه)
9. [جدول منوها بر اساس نقش](#۹-جدول-منوها-بر-اساس-نقش)
10. [ماتریس کامل ۶۲ دسترسی](#۱۰-ماتریس-کامل-۶۲-دسترسی)
11. [ماژول‌ها به ترتیب مسیر کار](#۱۱-ماژولها-به-ترتیب-مسیر-کار)
12. [نکاتی که هنگام تخصیص نقش باید بدانید](#۱۲-نکاتی-که-هنگام-تخصیص-نقش-باید-بدانید)
13. [آنچه در نسخه فعلی وجود ندارد](#۱۳-آنچه-در-نسخه-فعلی-وجود-ندارد)

---

## ۱. لیموسی چیست و چطور سازمان‌دهی شده

لیموسی نرم‌افزار مدیریت مشتری، فروش، پروژه و پشتیبانی برای تیم‌های خدماتی کوچک است.

**فضای کاری (Workspace)** واحد اصلی جداسازی است. هر فضای کاری داده‌های کاملاً مستقل دارد و این جداسازی در سطح خود نرم‌افزار اعمال می‌شود، نه فقط در رابط کاربری: اگر رکوردی متعلق به فضای کاری دیگری باشد، اصلاً در نتایج شما نمی‌آید. یک کاربر می‌تواند عضو چند فضای کاری باشد و از سوییچر بالای صفحه (در موبایل، از منوی کشویی) بین آن‌ها جابه‌جا شود.

**دو نوع حساب کاملاً جدا وجود دارد:**

| نوع حساب | چه کسی | ورود از | نقش‌ها |
|---|---|---|---|
| `staff` — کارمند | تیم خودتان | `/login` | مالک، مدیر فروش، فروشنده، مالی، مشاهده‌گر |
| `portal` — کاربر پرتال | کارکنان سازمان مشتری شما | `/portal/login` | نقش ندارد؛ دسترسی‌اش جداگانه تنظیم می‌شود |

کاربر پرتال هرگز وارد پنل اصلی شما نمی‌شود و کاربر کارمند هم وارد پرتال نمی‌شود. این دو مسیر ورود و دو مجموعه دسترسی کاملاً مجزا هستند.

**سلسله‌مراتب داده:**

```
فضای کاری
└── شرکت طرف قرارداد (سازمان مشتری)
    ├── قرارداد ──── دوره پشتیبانی (SLA)
    ├── پروژه ────── تیکت، پیش‌فاکتور
    └── کاربر پرتال
```

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

---

## ۲. پنج نقش در یک نگاه

هر عضو فضای کاری دقیقاً یک نقش دارد. نقش‌ها ثابت‌اند و در نسخه فعلی قابل ویرایش یا ساخت نقش دلخواه نیستند.

| نقش | تعداد دسترسی | تمرکز اصلی | نمی‌تواند |
|---|---|---|---|
| **مالک** | ۶۲ از ۶۲ | همه چیز | — |
| **مدیر فروش** | ۳۲ از ۶۲ | تیم فروش، پشتیبانی، پرتال | تنظیمات، تسویه، حذف |
| **فروشنده** | ۲۰ از ۶۲ | مشتریان خودش | گزارش‌ها، پورسانت دیگران، پرتال |
| **مالی** | ۱۸ از ۶۲ | پرداخت، پورسانت، تسویه | مشتری‌سازی، فعالیت، تیکت |
| **مشاهده‌گر** | ۸ از ۶۲ | فقط خواندن | هر تغییری |

نقش مالک قابل واگذاری یا تغییر توسط دیگران نیست.

---

## ۳. نقش مالک (`owner`)

**چه کسی باید این نقش را داشته باشد:** مؤسس یا مدیر کسب‌وکار. معمولاً یک نفر.

مالک تنها نقشی است که هر ۶۲ دسترسی را دارد. کسی که فضای کاری را می‌سازد، به‌صورت خودکار مالک آن می‌شود.

**کارهایی که فقط مالک می‌تواند انجام دهد:**

| کار | مسیر | چرا فقط مالک |
|---|---|---|
| دعوت عضو جدید | تنظیمات ← اعضا | مدیر فروش می‌تواند نقش‌ها را عوض کند ولی دعوت نکند |
| غیرفعال‌سازی عضو | تنظیمات ← اعضا | — |
| تنظیمات فضای کاری و برندینگ | تنظیمات ← فضای کاری / برندینگ | — |
| **ثبت اهداف فروش** | تنظیمات ← اهداف فروش | نیازمند «مدیریت تنظیمات فضای کاری» |
| قوانین کمیسیون | تنظیمات ← قوانین کمیسیون | — |
| مشاهده گزارش رویدادها (Audit) | داشبورد / تحلیل فروش | تنها نقش دارای `audit.view` |
| حذف مشتری، پروژه، معامله، آیتم کاتالوگ | صفحه هر بخش | هیچ نقش دیگری دسترسی حذف ندارد |

**نکته مهم درباره اهداف فروش:** چون ثبت هدف به «مدیریت تنظیمات فضای کاری» گره خورده، **مدیر فروش نمی‌تواند هدف تعیین کند** — حتی برای تیم خودش. اگر می‌خواهید مدیران فروش هدف‌گذاری کنند، این یک تصمیم محصولی است که باید تغییر کند.

**روز کاری معمول مالک:** داشبورد ← تحلیل فروش برای دیدن روند و قیف ← بررسی «نیازمند اقدام» ← در پایان ماه، ثبت هدف ماه بعد و مرور رویدادهای ثبت‌شده.

![داشبورد مالک — منوی کامل با هر ۱۷ آیتم، و تب‌های شخصی/تیم/مالی](images/roles/owner-dashboard.png)
*داشبورد مالک — منوی کامل با هر ۱۷ آیتم، و تب‌های شخصی/تیم/مالی*

![تحلیل فروش، نمای کامل مالک](images/roles/owner-analytics.png)
*تحلیل فروش، نمای کامل مالک*

![تنظیمات ← اهداف فروش — صفحه‌ای که فقط مالک می‌بیند](images/roles/owner-sales-targets.png)
*تنظیمات ← اهداف فروش — صفحه‌ای که فقط مالک می‌بیند*

![تنظیمات ← اعضا — دعوت و تغییر نقش، مخصوص مالک](images/roles/owner-members.png)
*تنظیمات ← اعضا — دعوت و تغییر نقش، مخصوص مالک*


---

## ۴. نقش مدیر فروش (`sales_manager`)

**چه کسی باید این نقش را داشته باشد:** کسی که تیم فروش را می‌چرخاند و مسئول پشتیبانی مشتریان هم هست.

**می‌بیند و می‌تواند:**

- **مشتریان تیم** (نه فقط خودش) — و می‌تواند مشتری را به فروشنده اختصاص دهد یا مالکیتش را منتقل کند
- **پیش‌فاکتور** را بسازد، ویرایش کند، **به‌جای مشتری تایید/رد کند** و به معامله تبدیل کند
- **معامله** بسازد و ویرایش کند
- **پشتیبانی و SLA** را کامل مدیریت کند: دوره پشتیبانی تعریف کند، تیکت را رسیدگی و به کارشناس ارجاع دهد
- **کاربران پرتال** را دعوت و لغو کند
- **همه پورسانت‌ها** را ببیند و بررسی (review) کند
- **گزارش‌ها** را ببیند و خروجی بگیرد
- **نقش اعضا را عوض کند** (ولی دعوت نکند)

**نمی‌تواند:**

| نمی‌تواند | یعنی |
|---|---|
| وارد تنظیمات شود | منوی «تنظیمات» را اصلاً نمی‌بیند |
| هدف فروش ثبت کند | نوار پیشرفت را می‌بیند ولی هدف نمی‌گذارد |
| تسویه ثبت یا تایید کند | منوی «تسویه‌ها» را نمی‌بیند |
| پورسانت را تایید یا پرداخت کند | فقط بررسی می‌کند |
| پرداخت ثبت کند | فقط پرداخت‌ها را می‌بیند |
| شرکت طرف قرارداد یا قرارداد بسازد | فقط مشاهده — **ولی فروشنده می‌تواند بسازد** |
| هیچ چیزی را حذف کند | — |

**غیرمنتظره‌ترین نکته این نقش:** مدیر فروش قراردادها را فقط می‌بیند، در حالی که فروشنده اجازه ساخت و ویرایش شرکت طرف قرارداد و قرارداد را دارد. اگر انتظارتان برعکس است، این را در «نکات» بخش ۱۲ ببینید.

![داشبورد مدیر فروش — «تنظیمات» و «تسویه‌ها» در منو نیست](images/roles/manager-dashboard.png)
*داشبورد مدیر فروش — «تنظیمات» و «تسویه‌ها» در منو نیست*

![مشتریان تیم، با امکان اختصاص و انتقال مالکیت](images/roles/manager-customers.png)
*مشتریان تیم، با امکان اختصاص و انتقال مالکیت*

![تیکت‌های پشتیبانی — مدیر فروش رسیدگی و ارجاع می‌دهد](images/roles/manager-tickets.png)
*تیکت‌های پشتیبانی — مدیر فروش رسیدگی و ارجاع می‌دهد*


---

## ۵. نقش فروشنده (`seller`)

**چه کسی باید این نقش را داشته باشد:** کارشناس فروشی که سبد مشتریان خودش را دارد.

**می‌بیند و می‌تواند:**

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

**نمی‌تواند:**

| نمی‌تواند | یعنی |
|---|---|
| منوی گزارش‌ها را ببیند | `reports.view` ندارد |
| پیش‌فاکتور را به‌جای مشتری تایید کند | فقط مدیر فروش و مالک |
| پیش‌فاکتور را به معامله تبدیل کند | `quotations.convert` ندارد |
| مشتری را به کسی اختصاص دهد | — |
| پورسانت دیگران را ببیند | فقط `commissions.view_own` |
| کاربر پرتال دعوت کند | — |

**داشبورد و تحلیل فروش برای فروشنده چه شکلی است؟** منوهایش را می‌بیند، ولی چون `reports.view` ندارد، **فقط داده‌های خودش را می‌بیند** و جدول مقایسه کارشناسان برایش نمایش داده نمی‌شود. این محدودیت در خود صفحه اعمال شده، نه فقط در منو.

![داشبورد فروشنده — بدون «گزارش‌ها»، «تسویه‌ها» و «تنظیمات»؛ عنوان صفحه هم «پورسانت شما» است نه تیم](images/roles/seller-dashboard.png)
*داشبورد فروشنده — بدون «گزارش‌ها»، «تسویه‌ها» و «تنظیمات»؛ عنوان صفحه هم «پورسانت شما» است نه تیم*

![فقط مشتریان خودِ فروشنده](images/roles/seller-customers.png)
*فقط مشتریان خودِ فروشنده*

![تحلیل فروش فروشنده — بدون جدول مقایسه کارشناسان](images/roles/seller-analytics.png)
*تحلیل فروش فروشنده — بدون جدول مقایسه کارشناسان*


---

## ۶. نقش مالی (`finance`)

**چه کسی باید این نقش را داشته باشد:** حسابدار یا مسئول مالی.

**می‌بیند و می‌تواند:**

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

**نمی‌تواند:**

| نمی‌تواند | یعنی |
|---|---|
| مشتری ثبت یا ویرایش کند | فقط خواندن |
| منوی فعالیت‌ها را ببیند | `activities.view` ندارد |
| منوی تیکت‌ها را ببیند | `tickets.view` ندارد — **ولی گزارش پشتیبانی را می‌بیند** |
| پیش‌فاکتور یا معامله بسازد | فقط خواندن |
| کاتالوگ، پروژه یا قرارداد ببیند | این منوها برایش نمایش داده نمی‌شوند |

![داشبورد مالی — بدون فعالیت‌ها و تیکت‌ها، ولی با تسویه‌ها و گزارش پشتیبانی](images/roles/finance-dashboard.png)
*داشبورد مالی — بدون فعالیت‌ها و تیکت‌ها، ولی با تسویه‌ها و گزارش پشتیبانی*

![پورسانت‌ها — بررسی، تایید و پرداخت](images/roles/finance-commissions.png)
*پورسانت‌ها — بررسی، تایید و پرداخت*

![تسویه‌ها — فقط مالک و مالی این منو را دارند](images/roles/finance-settlements.png)
*تسویه‌ها — فقط مالک و مالی این منو را دارند*


---

## ۷. نقش مشاهده‌گر (`viewer`)

**چه کسی باید این نقش را داشته باشد:** کسی که باید در جریان باشد ولی نباید چیزی را تغییر دهد — مشاور، سرمایه‌گذار، کارآموز.

مشاهده‌گر **هیچ دسترسی نوشتنی ندارد**. هر ۸ دسترسی‌اش خواندنی است.

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

**هشدار مهم:** مشاهده‌گر دسترسی «مشاهده همه پورسانت‌ها» و «مشاهده گزارش‌ها» دارد. یعنی **حقوق و پورسانت تک‌تک فروشندگان و کل گردش مالی تیم را می‌بیند.** اگر این نقش را به کسی خارج از حلقه مدیریتی می‌دهید، این را در نظر بگیرید. جزئیات در بخش ۱۲.

![داشبورد مشاهده‌گر](images/roles/viewer-dashboard.png)
*داشبورد مشاهده‌گر*

![فروش‌ها از نگاه مشاهده‌گر — بدون هیچ دکمهٔ ثبت یا ویرایش](images/roles/viewer-deals.png)
*فروش‌ها از نگاه مشاهده‌گر — بدون هیچ دکمهٔ ثبت یا ویرایش*


---

## ۸. کاربر پرتال — حساب جداگانه

کاربر پرتال عضو فضای کاری شما نیست و هیچ‌کدام از پنج نقش بالا را ندارد. حساب جدا، ورود جدا (`/portal/login`) و دسترسی‌های جدا دارد.

**چطور ساخته می‌شود:** از صفحه شرکت طرف قرارداد ← تب «کاربران پرتال» ← دعوت. مدیر فروش و مالک این کار را می‌توانند انجام دهند.

**چه چیزی می‌بیند:** برای هر کاربر پرتال جداگانه تعیین می‌کنید که کدام‌ها را ببیند:

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

**سه قانون همیشگی که قابل تغییر نیستند:**

![داشبورد پرتال مشتری — منوی کاملاً متفاوت و محدود به سازمان خودش](images/roles/portal-dashboard.png)
*داشبورد پرتال مشتری — منوی کاملاً متفاوت و محدود به سازمان خودش*

![فهرست تیکت‌های مشتری در پرتال](images/roles/portal-tickets.png)
*فهرست تیکت‌های مشتری در پرتال*


1. هر کاربر پرتال فقط اطلاعات سازمان خودش را می‌بیند
2. **یادداشت‌های داخلی تیم شما هرگز برای مشتری نمایش داده نمی‌شود**
3. کاربر پرتال نمی‌تواند وضعیت تیکت را به‌دلخواه تغییر دهد

دسترسی می‌تواند به کل سازمان یا فقط پروژه‌های مشخصی محدود شود.

**مشتری فقط وقتی می‌تواند تیکت ثبت کند** که پروژه‌اش یک دوره پشتیبانی با وضعیت «فعال» داشته باشد. اگر دوره پشتیبانی در حالت پیش‌نویس بماند، دکمه ثبت تیکت برای مشتری کار نمی‌کند — این شایع‌ترین دلیل «چرا مشتری نمی‌تواند تیکت بزند» است.

---

## ۹. جدول منوها بر اساس نقش

کدام آیتم منو برای کدام نقش نمایش داده می‌شود:

| منو | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| داشبورد | ✅ | ✅ | ✅ | ✅ | ✅ |
| تحلیل فروش | ✅ | ✅ | ✅ | ✅ | ✅ |
| شرکت‌های طرف قرارداد | ✅ | ✅ | ✅ | — | — |
| قراردادها | ✅ | ✅ | ✅ | — | — |
| پروژه‌ها | ✅ | ✅ | ✅ | — | — |
| کاتالوگ | ✅ | ✅ | ✅ | — | — |
| مشتریان | ✅ | ✅ | ✅ | ✅ | ✅ |
| فعالیت‌ها | ✅ | ✅ | ✅ | — | ✅ |
| تیکت‌های پشتیبانی | ✅ | ✅ | ✅ | — | ✅ |
| پیش‌فاکتورها | ✅ | ✅ | ✅ | ✅ | ✅ |
| توضیحات پیش‌فاکتور | ✅ | ✅ | ✅ | ✅ | ✅ |
| فروش‌ها | ✅ | ✅ | ✅ | ✅ | ✅ |
| پورسانت‌ها | ✅ | ✅ | ✅ | ✅ | ✅ |
| تسویه‌ها | ✅ | — | — | ✅ | — |
| گزارش‌ها | ✅ | ✅ | — | ✅ | ✅ |
| گزارش پشتیبانی | ✅ | ✅ | — | ✅ | ✅ |
| تنظیمات | ✅ | — | — | — | — |
> «داشبورد» و «تحلیل فروش» برای همه نقش‌ها در منو دیده می‌شوند، ولی **محتوایشان فرق می‌کند**: نقشی که دسترسی «مشاهده گزارش‌ها» ندارد (فروشنده) فقط داده‌های خودش را می‌بیند و تب‌های تیمی و مالی برایش باز نمی‌شود.

---

## ۱۰. ماتریس کامل ۶۲ دسترسی

این جدول‌ها مستقیماً از کد تولید شده‌اند و مرجع نهایی هستند.


**فضای کاری**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مدیریت فضای کاری | ✅ | — | — | — | — |
| مدیریت تنظیمات فضای کاری | ✅ | — | — | — | — |

**اعضای تیم**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده اعضای تیم | ✅ | ✅ | — | — | — |
| دعوت عضو جدید | ✅ | — | — | — | — |
| ویرایش نقش اعضا | ✅ | ✅ | — | — | — |
| غیرفعال‌سازی عضو | ✅ | — | — | — | — |

**شرکت‌ها و قراردادها**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده شرکت‌های طرف قرارداد و قراردادها | ✅ | ✅ | ✅ | — | — |
| ثبت شرکت طرف قرارداد و قرارداد جدید | ✅ | — | ✅ | — | — |
| ویرایش شرکت طرف قرارداد و قرارداد | ✅ | — | ✅ | — | — |
| حذف شرکت طرف قرارداد | ✅ | — | — | — | — |

**پروژه‌ها**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده پروژه‌ها | ✅ | ✅ | ✅ | — | — |
| ثبت پروژه جدید | ✅ | — | — | — | — |
| ویرایش پروژه | ✅ | — | — | — | — |
| حذف پروژه | ✅ | — | — | — | — |

**کاتالوگ**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده کاتالوگ | ✅ | ✅ | ✅ | — | — |
| افزودن آیتم کاتالوگ | ✅ | — | — | — | — |
| ویرایش آیتم کاتالوگ | ✅ | — | — | — | — |
| حذف آیتم کاتالوگ | ✅ | — | — | — | — |

**مشتریان**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده مشتریان خود | ✅ | — | ✅ | — | — |
| مشاهده مشتریان تیم | ✅ | ✅ | — | — | ✅ |
| مشاهده همه مشتریان | ✅ | — | — | ✅ | — |
| ثبت مشتری جدید | ✅ | ✅ | ✅ | — | — |
| ویرایش مشتریان خود | ✅ | — | ✅ | — | — |
| اختصاص مشتری به فروشنده | ✅ | ✅ | — | — | — |
| انتقال مالکیت مشتری | ✅ | ✅ | — | — | — |

**فعالیت‌ها**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده فعالیت‌ها | ✅ | ✅ | ✅ | — | ✅ |
| ثبت فعالیت جدید | ✅ | ✅ | ✅ | — | — |
| ویرایش فعالیت | ✅ | ✅ | ✅ | — | — |
| حذف فعالیت | ✅ | — | — | — | — |

**پیش‌فاکتورها**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده پیش‌فاکتورها | ✅ | ✅ | ✅ | ✅ | ✅ |
| ثبت پیش‌فاکتور جدید | ✅ | ✅ | ✅ | — | — |
| ویرایش پیش‌فاکتور | ✅ | ✅ | ✅ | — | — |
| تایید/رد پیش‌فاکتور به‌جای مشتری | ✅ | ✅ | — | — | — |
| تبدیل پیش‌فاکتور به معامله | ✅ | ✅ | — | — | — |

**معاملات (فروش)**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده معاملات | ✅ | ✅ | ✅ | ✅ | ✅ |
| ثبت معامله جدید | ✅ | ✅ | ✅ | — | — |
| ویرایش معامله | ✅ | ✅ | ✅ | — | — |
| حذف معامله | ✅ | — | — | — | — |

**پرداخت‌ها**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده پرداخت‌ها | ✅ | ✅ | — | ✅ | ✅ |
| ثبت پرداخت | ✅ | — | — | ✅ | — |
| تایید پرداخت | ✅ | — | — | ✅ | — |
| برگشت پرداخت | ✅ | — | — | ✅ | — |

**پورسانت‌ها**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده پورسانت خود | ✅ | — | ✅ | — | — |
| مشاهده همه پورسانت‌ها | ✅ | ✅ | — | ✅ | ✅ |
| بررسی پورسانت | ✅ | ✅ | — | ✅ | — |
| تایید پورسانت | ✅ | — | — | ✅ | — |
| پرداخت پورسانت | ✅ | — | — | ✅ | — |

**تسویه‌ها**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده تسویه‌ها | ✅ | — | — | ✅ | — |
| ثبت تسویه | ✅ | — | — | ✅ | — |
| تایید تسویه | ✅ | — | — | ✅ | — |
| لغو تسویه | ✅ | — | — | ✅ | — |

**گزارش‌ها**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده گزارش‌ها | ✅ | ✅ | — | ✅ | ✅ |
| خروجی گرفتن از گزارش‌ها | ✅ | ✅ | — | ✅ | — |

**رویدادها و امنیت**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده گزارش رویدادها | ✅ | — | — | — | — |
| مشاهده فایل‌های حساس | ✅ | — | — | ✅ | — |

**پرتال مشتریان**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده کاربران پرتال مشتریان | ✅ | ✅ | — | — | — |
| مدیریت (دعوت/لغو) کاربران پرتال | ✅ | ✅ | — | — | — |

**پشتیبانی و SLA**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده دوره‌های پشتیبانی | ✅ | ✅ | — | — | — |
| مدیریت دوره‌های پشتیبانی و SLA | ✅ | ✅ | — | — | — |

**تیکت‌های پشتیبانی**

| دسترسی | مالک | مدیر فروش | فروشنده | مالی | مشاهده‌گر |
|---|---|---|---|---|---|
| مشاهده تیکت‌های پشتیبانی | ✅ | ✅ | ✅ | — | ✅ |
| رسیدگی و پاسخ به تیکت | ✅ | ✅ | ✅ | — | — |
| ارجاع تیکت به کارشناس | ✅ | ✅ | — | — | — |
---

## ۱۱. ماژول‌ها به ترتیب مسیر کار

ترتیب زیر همان ترتیبی است که یک تیم تازه‌وارد باید طی کند.

### گام ۱ — کاتالوگ

فهرست خدمات و محصولات قابل‌فروش، با دسته‌بندی و تاریخچه نسخه‌های قیمت و کمیسیون. هر تغییر قیمت یا نرخ کمیسیون **نسخه جدید** می‌سازد و پیش‌فاکتورهای قبلی دست‌نخورده می‌مانند. آیتم‌های کاتالوگ در فرم پیش‌فاکتور برای افزودن سریع ردیف استفاده می‌شوند.

*دسترسی مشاهده: مالک، مدیر فروش، فروشنده. ساخت و ویرایش: فقط مالک.*

### گام ۲ — شرکت‌های طرف قرارداد

سازمان مشتری شما؛ همان طرفی که قرارداد با او بسته می‌شود. می‌تواند اطلاعات حقوقی (کد اقتصادی، شناسه ملی)، چند قرارداد و چند کاربر پرتال داشته باشد. قراردادها و پروژه‌ها همیشه زیرمجموعه یک سازمان تعریف می‌شوند.

*مشاهده: مالک، مدیر فروش، فروشنده. ساخت و ویرایش: مالک و فروشنده.*

### گام ۳ — قراردادها و پشتیبانی (SLA)

هر قرارداد یکی از وضعیت‌های پیش‌نویس، فعال، منقضی یا فسخ‌شده را دارد. **تا وقتی قرارداد «فعال» نشود، در پرتال مشتری دیده نمی‌شود.**

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

### گام ۴ — پروژه‌ها

محل واقعی اجرای کار برای یک سازمان، و پایه تیکت و پیش‌فاکتور. دسترسی کاربران پرتال از طریق همین پروژه‌ها کنترل می‌شود.

### گام ۵ — مشتریان

لیدها و مشتریان که فروشندگان با آن‌ها در ارتباط‌اند — جدا از «شرکت‌های طرف قرارداد» که سطح سازمانی است. هر مشتری به یک فروشنده اختصاص داده می‌شود. تایم‌لاین هر مشتری، فعالیت‌ها، پیش‌فاکتورها و معاملات مرتبط را یک‌جا نشان می‌دهد.

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

### گام ۶ — فعالیت‌ها

تماس، جلسه یا پیگیری با یادآوری و وضعیت انجام‌شده/عقب‌افتاده. فعالیت‌های عقب‌افتاده در داشبورد برجسته می‌شوند. *نقش مالی این منو را نمی‌بیند.*

### گام ۷ — پیش‌فاکتورها

چرخه عمر: پیش‌نویس ← ارسال‌شده ← دیده‌شده ← تاییدشده یا ردشده (یا منقضی، اگر مشتری تا تاریخ اعتبار تصمیم نگیرد).

پس از ارسال، یک **لینک عمومی بدون نیاز به ورود** برای مشتری تولید می‌شود تا پیش‌فاکتور را ببیند، تایید/رد کند و PDF بگیرد. پیش‌فاکتور تاییدشده مستقیم به معامله تبدیل می‌شود. خروجی PDF و اکسل در دسترس است.

### گام ۸ — فروش‌ها (قیف معاملات)

معاملات در یک قیف با مراحل قابل‌تعریف (کانبان) مدیریت می‌شوند. هر معامله می‌تواند چند همکار داشته باشد که در پورسانت سهیم می‌شوند.

**ثبت دلیل ازدست‌رفتن:** با زدن «ازدست‌رفته» پنجره‌ای دلیل را می‌پرسد: قیمت، انتخاب رقیب، زمان‌بندی نامناسب، نبود بودجه، بی‌پاسخ ماندن مشتری، عدم تطابق با نیاز، تصمیم داخلی مشتری، سایر. ثبت دلیل اختیاری است، ولی گزارش «دلایل ازدست‌رفتن» فقط از همین ثبت‌ها ساخته می‌شود.

### گام ۹ — فاکتور و پرداخت

فاکتور مدل جداگانه‌ای ندارد: وقتی معامله‌ای برنده می‌شود و شماره فاکتور می‌گیرد، همان معامله در پرتال به‌عنوان «فاکتور» دیده می‌شود. وضعیت پرداخت (پرداخت‌نشده/جزئی/تسویه/سررسیدگذشته) خودکار محاسبه می‌شود.

*ثبت و تایید پرداخت: فقط مالک و مالی.*

### گام ۱۰ — پورسانت‌ها و تسویه‌ها

با ثبت پرداخت روی معاملات برنده، کمیسیون طبق قوانین تعریف‌شده خودکار محاسبه می‌شود و مسیر بررسی ← تایید ← پرداخت را طی می‌کند. پورسانت‌های تاییدشده یک فروشنده در یک بازه، در قالب یک تسویه دوره‌ای جمع و پرداخت می‌شوند.

*تسویه فقط برای مالک و مالی قابل مشاهده است.*

### گام ۱۱ — تیکت‌های پشتیبانی

درخواست‌های پشتیبانی، چه از پنل و چه از پرتال، با رعایت مهلت‌های SLA پیگیری می‌شوند. وقتی وضعیت روی «منتظر پاسخ مشتری» می‌رود، **شمارش SLA موقتاً متوقف** و با پاسخ مشتری از سر گرفته می‌شود.

### گام ۱۲ — تحلیل فروش و اهداف

فیلترها در آدرس صفحه ذخیره می‌شوند، پس می‌توانید لینک یک نمای فیلترشده را برای همکار بفرستید. **بازه‌ها شمسی‌اند:** «این ماه» از اول ماه شمسی و «امسال» از اول فروردین.

- **کارت‌های بالا:** درصد تغییر نسبت به دوره قبلیِ هم‌طول
- **قیف فروش:** با درصد تبدیل هر مرحله؛ مرحله‌ای که افت ناگهانی دارد گلوگاه شماست
- **پیش‌بینی فروش:** مبلغ هر فرصت باز × درصد احتمال مرحله‌اش
- **عمر فرصت‌های باز:** شش سطل زمانی برای یافتن معاملات راکد
- **فعالیت‌ها و نیازمند اقدام:** عمداً از فیلتر بازه پیروی نمی‌کنند، چون کار عقب‌افتاده مستقل از بازه انتخابی عقب‌افتاده است

**اهداف فروش** ماهانه‌اند و خودکار تمدید نمی‌شوند. اگر کارشناسی انتخاب نکنید هدف برای کل تیم ثبت می‌شود. ثبت دوباره برای همان ماه و همان دامنه، مقدار قبلی را به‌روزرسانی می‌کند.

### ابزارهای کمکی

- **ثبت سریع:** دکمه «+ ثبت سریع» در نوار بالا (در موبایل، دکمه دایره‌ای «+» در نوار پایین) برای ثبت مشتری، فعالیت یا پیش‌فاکتور بدون خروج از صفحه. **آفلاین هم کار می‌کند** و بعد از اتصال همگام می‌شود.
- **تور راهنما:** آیکون «؟» کنار زنگ اعلان‌ها.

---

## ۱۲. نکاتی که هنگام تخصیص نقش باید بدانید

این‌ها واقعیت‌های نسخه فعلی‌اند، نه پیشنهاد. اگر با انتظار شما نمی‌خوانند، تصمیم محصولی لازم است.

**۱. مشاهده‌گر حقوق همه را می‌بیند.** نقش مشاهده‌گر `commissions.view_all` و `reports.view` دارد؛ یعنی پورسانت تک‌تک فروشندگان و کل گردش مالی تیم برایش قابل مشاهده است. اگر منظورتان از «مشاهده‌گر» یک ناظر کم‌دسترسی است، این نقش آن نیست.

**۲. مدیر فروش نمی‌تواند هدف تعیین کند.** ثبت هدف فروش به «مدیریت تنظیمات فضای کاری» گره خورده که فقط مالک دارد.

**۳. مدیر فروش می‌تواند نقش عوض کند ولی دعوت نکند.** `members.update` دارد، `members.invite` ندارد.

**۴. فروشنده قرارداد می‌سازد، مدیر فروش نه.** فروشنده `partner_companies.create` و `.update` دارد؛ مدیر فروش فقط `.view`.

**۵. مالی تیکت‌ها را نمی‌بیند ولی گزارش پشتیبانی را می‌بیند.** `tickets.view` ندارد ولی `reports.view` دارد، و گزارش پشتیبانی زیر همان دسترسی است.

**۶. حذف فقط مال مالک است.** هیچ نقش دیگری اجازه حذف مشتری، پروژه، معامله یا آیتم کاتالوگ ندارد.

**۷. گزارش رویدادها فقط برای مالک.** `audit.view` را هیچ نقش دیگری ندارد.

**۸. فروشنده منوی گزارش‌ها را ندارد ولی تحلیل فروش را دارد** — با داده‌های محدود به خودش.

---

## ۱۳. آنچه در نسخه فعلی وجود ندارد

برای اینکه انتظار اشتباه شکل نگیرد:

- **نقش دلخواه ساخته نمی‌شود.** پنج نقش ثابت‌اند و ماتریس دسترسی در کد تعریف شده، نه در دیتابیس. تغییرش نیازمند تغییر کد است.
- **دسترسی تک‌به‌تک قابل تنظیم نیست.** نمی‌توانید به یک فروشنده خاص فقط `reports.view` بدهید.
- **احراز هویت دو مرحله‌ای وجود ندارد.**
- **اهداف فروش فقط ماهانه‌اند** — هدف هفتگی یا فصلی نیست.
- **فاکتور موجودیت مستقلی نیست** و از معامله برنده ساخته می‌شود.

---

*این راهنما از روی کد نسخه فعلی تولید شده است. با تغییر ماتریس دسترسی در `app/Support/Authorization/RolePermissions.php`، جدول‌های بخش ۹ و ۱۰ باید دوباره تولید شوند.*