BSS HostKhaneh

پنل Tenant Admin

← بازگشت به راهنما

پنل Tenant Admin



| فیلد | مقدار |
|------|--------|
| **نسخه** | 1.36 |
| **آخرین بروزرسانی** | 2026-09-23 |
| **مخاطب** | ادمین |

دسترسی



هر شرکت (Tenant) پنل جداگانه دارد:

| محیط | URL |
|------|-----|
| Subdomain | `https://demo.bss.hostkhaneh.com/panel` |
| مسیر مستقیم | `https://bss.hostkhaneh.com/panel` |

هویت بصری — Operations Hub



از نسخه ۱.۱۳+ پنل `/panel` پوسته‌ای جدا از Platform Admin (`/admin`) و پورتال مشتری دارد. نسخه ۱.۱۴ داشبورد را از چیدمان پیش‌فرض Filament جدا کرد. نسخه ۱.۱۵ گراف Workflow را از منوی جدا به دکمهٔ «نمایش» در لیست Workflow محصول منتقل کرد. نسخه ۱.۱۶ دسته‌بندی وضعیت عملیاتی را به‌صورت تب داخل وضعیت‌های عملیاتی workflow آورد (مثل پیکربندی سرورهای بیرونی). نسخه ۱.۲۱ سایدبار آکاردئونی؛ نسخه ۱.۲۲–۱.۲۶ تنظیم رنگ منو/کانواس؛ نسخه ۱.۲۷ تنظیمات اصلی پنج‌تب؛ نسخه ۱.۲۸ عرض تمام؛ نسخه ۱.۲۹ اصلاح کارت‌های تودرتوی فرم تنظیمات (فیلد مشتری / نقشه / مالی).

| عنصر | رفتار |
|------|--------|
| CSS | فقط `bss-tenant-ops.css` (پوستهٔ navyی `bss-filament.css` عمداً لود نمی‌شود) |
| سایدبار | زغالی تیره (`#2a303a`) با متن روشن و اکسنت برند؛ گروه‌های جمع‌شو با آیکون؛ انبار و تنظیمات و گزارش پیش‌فرض جمع |
| کانواس صفحه | خاکستری `#d5dee9`؛ **یک کارت** روی خودِ `.fi-section` (نه دوبل روی content-ctn) — مشترک همهٔ فرم‌های تنظیمات |
| عرض محتوا | تمام‌عرض (`MaxWidth::Full`) — جداول و فرم‌ها تا لبهٔ کانواس کشیده می‌شوند |
| ۴۱۹ / Page Expired | ۱) بعد از `view:clear` روی تب باز → Ctrl+F5. ۲) اگر **فقط مرکز عملیات** می‌ترکید: ویجت `OrdersTrendChart` باید در `TenantPanelProvider->widgets()` ثبت باشد و بعد `filament:cache-components` با کاربر `bsshostkhaneh` |
| Topbar | نوار زنده **کیف پول لایسنس** (کلیک → شارژ) / SLA / تیکت / کارتابل / صف + نام شرکت |
| داشبورد | صفحهٔ سفارشی `OpsDashboard` — hero، KPI، هشدار، میانبر، کارتابل، صف، نمودار |
| اکسنت | رنگ `primary` از برندینگ tenant |
| دکمه‌های عملیات جدول | View / Edit / Delete / Create همیشه با آیکون (پیکربندی سراسری در `AppServiceProvider`) |

گروه‌های منو: **پشتیبانی**، **راه‌اندازی سرویس** (فارسی).

داشبورد عملیاتی



مسیر خانه: **مرکز عملیات** (`App\Filament\Pages\OpsDashboard`).

| بلوک | محتوا |
|------|--------|
| Hero | نام شرکت + وضعیت توجه |
| KPI | مشتری، سفارش، اشتراک فعال، درآمد (لینک‌دار) |
| هشدارها | نقض SLA، تیکت باز، کارتابل باز، Provision exhausted |
| میانبرها | سفارش، کارتابل، صف، تیکت، مشتری، محصول |
| کارتابل | تعداد باز + ردیف‌های اخیر |
| صف Provision | queued / processing / exhausted |
| روند | نمودار ۳۰ روزه |

داده: `ReportingService::opsHubSnapshot()`.

آموزش داخل پنل



روی **همه منوها** دکمه خاکستری **آموزش** (کلاه فارغ‌التحصیلی) در هدر صفحه هست و همان بخش را توضیح می‌دهد (کاتالوگ، CRM از جمله **نمایندگان فروش**، سفارش، مالی از جمله **کمیسیون نمایندگان**، انبار ADSL/IP، پشتیبانی، تنظیمات، …).

از ۱.۱۸+: منوهای جدید لایسنس هم آموزش دارند — **حساب‌های بانکی**، **کیف پول لایسنس**، **تیکت پلتفرم**. قانون پروژه: هر Resource/Page جدید بدون دکمه آموزش تمام نیست (`menu-guide-required.mdc`).

پنل ریسلر (`/reseller`) هم در نوار بالا دکمه **آموزش** متناسب با صفحه جاری دارد.
پنل سوپرادمین (`/admin`) برای منوهای پلتفرم از `PlatformMenuGuide` استفاده می‌کند.

حساب Demo



  • **ایمیل:** `tenant@demo.bss.hostkhaneh.com`

  • **رمز:** `Tenant1234`

  • **بازنشانی:** `php artisan bss:reset-demo-passwords`


  • تفاوت با پنل Platform



    | پنل | URL | نقش |
    |-----|-----|-----|
    | Platform Admin | `/admin` | super-admin فقط |
    | Tenant Admin | `/panel` | tenant-admin, tenant-staff |

    قابلیت‌ها (گروه‌های منو مهم)



    | گروه | موارد |
    |------|--------|
    | CRM | مشتریان — تب‌ها: خلاصه · صورتحساب · تیکت · بانک مجازی · قراردادها · فعالیت · پیام‌ها (+ ویرایش)؛ **نمایندگان فروش** (سلسله، کاتالوگ، پورسانت، صفحه **مدیریت مالی** کیف پول) |
    | سفارش و اشتراک | **سفارش‌ها** (مشاهده / عملیات سرویس — **ایجاد سفارش فقط از ریسلر**)؛ کارتابل فروش |
    | راه‌اندازی سرویس | صف Provision |
    | انبار | **ADSL** / **IP ثابت** / **LTE** / **Wireless** / **MVNO** / **FTTH** — [ADSL](adsl-inventory.md) · [IP](static-ip-inventory.md) · [LTE](lte-inventory.md) · [Wireless](wireless-inventory.md) · [MVNO](mvno-inventory.md) · [FTTH](ftth-inventory.md) |
    | مالی | فاکتور، درگاه، شارژ کیف پول، حساب بانکی، … |
    | گزارش‌گیری | گزارش‌ها · گزارش شاهکار · **پرداخت‌ها** · **کمیسیون نمایندگان** (فقط مشاهده؛ واریز خودکار) |
    | پشتیبانی | تیکت، SLA |
    | تنظیمات | دسته‌بندی محصول · محصولات و پلن‌ها · Workflow محصول · **پیکربندی سرورهای بیرونی** · **وضعیت‌های عملیاتی workflow** · **تنظیمات اصلی** (تب‌ها: تنظیمات اصلی · برندینگ · فیلدهای مشتری · اتصال نقشه · تنظیمات مالی · تنظیمات شاهکار) · اعلان‌ها · کیف پول لایسنس · … |

    نکته: منوی جداگانه «اشتراک‌ها» نیست — سرویس فعال داخل **سفارش‌ها** دیده و فیلتر می‌شود.

    داده‌ها به‌صورت خودکار به شرکت جاری محدود می‌شوند.

    Subdomain



    با ورود به `demo.bss.hostkhaneh.com`، Tenant به‌صورت خودکار شناسایی می‌شود و برند پنل نام شرکت نمایش داده می‌شود.