این راهنماها مفاهیم یک صنعت را روی اشیایی که پلتفرم امروز دارد (بوکه‌ها، لاین‌ها، بسته‌ها، حساب‌های پارتنر، نودها، API) نگاشت می‌کنند. این‌ها نگاشت‌های مفهومی‌اند، نه قابلیت‌های مخصوص صنعت، و حساب پارتنر یک حساب تفویضی است، نه tenant ایزوله.
نگاشت مفهومی
در پنل چیزی به نام جلسه، شهروند یا اداره نیست. جدول می‌گوید کدام شیء چه نقشی دارد؛ بخش‌های زیر آن‌ها را به همین ترتیب راه می‌اندازند.
| در صنعت شما | روی پلتفرم | کجا در پنل |
|---|---|---|
| جلسه شورا یا کانال عمومی | کانال زنده: یک استریم با منابع، EPG و فرمت‌های خروجی‌اش | Streams ← افزودن استریم زنده (URL منبع یا RTMP push) |
| آرشیو جلسات و کتابخانه آموزش | کاتالوگ VOD: فیلم و سریال با فصل و قسمت، دسته‌بندی‌ها و اطلاعات متادیتا | Movies و Series، یا کار ingest VOD |
| برنامه عمومی یا مجموعه اداره | بوکه: مجموعه‌ای نام‌دار از کانال‌ها، فیلم‌ها یا سریال‌ها که یک بسته می‌دهد | Bouquets، از Streams و Movies / Series |
| دسترسی شهروند یا کارمند | لاین: یک دسترسی با بسته، بوکه‌ها، انقضا، محدودیت اتصال و خروجی‌هایش | Lines ← افزودن، یا کدهای فعال‌سازی، یا Reseller API |
| اعتبار دسترسی عمومی یا کارکنان | تاریخ انقضای لاین، که با بسته، کردیت یا API تمدید می‌شود | تاریخ انقضای لاین و مدت بسته |
| یکپارچگی با سامانه شورا | Reseller API و وب‌هوک‌ها: عملیات پنل از سیستم خودتان | کلیدهای Reseller API و وب‌هوک‌ها در داشبورد ریسلر |
پیش‌نیازها
آنچه پیش از نصب باید داشته باشید.
- یک سرور در مرکز داده نهاد (Ubuntu 22.04 یا 24.04)، نصب‌کننده و دامنه‌ای پشت ریورس‌پراکسی نهاد برای آدرس عمومی.
- انکودر یا میکسر ویدیوی تالار که بتواند RTMP پوش کند، ضبط جلسات گذشته و ویدیوهای آموزشی کارکنان.
- تصمیم درباره اینکه چه چیزی عمومی و چه چیزی داخلی است، لاین عمومی چقدر دوام دارد و کدام اپراتورها حساب پنل بگیرند.
استقرار زیرساخت
سرور مدیریت، بعد هر سایت دور.
- نصب‌کننده را روی سرور نهاد اجرا کنید؛ پنل را پشت ریورس‌پراکسی با TLS بگذارید و TRUSTED_PROXIES را تنظیم کنید تا گزارش ممیزی و قواعد IP آدرس‌های واقعی را ببینند.
- پایه پخش را روی آدرس عمومی که شهروندان به آن می‌رسند و کلید مجوز را روی سرور بگذارید.
- برای سایتی که نیاز دارد، مثل ساختمان دومی با تالار، از Servers یک نود ثبت کنید؛ پنل آن را با SSH نصب می‌کند.
- برای تیم ارتباطات حساب پارتنر (ریسلر) با مجوز لاین‌های عمومی بسازید، و یکی برای منابع انسانی یا آموزش برای لاین‌های کارکنان.
سازمان‌دهی محتوا
یک برنامه عمومی و مجموعه‌های ادارات.
- برای جلسات، کمیته‌ها و اطلاعات عمومی دسته‌بندی بسازید، و برای هر نهاد یک سریال با یک قسمت برای هر نشست.
- یک بوکه عمومی با کانال زنده جلسه و آرشیو بسازید، و یک بوکه برای مجموعه آموزش هر اداره.
- برای شهروندان بسته‌ای بسازید که فقط بوکه عمومی را می‌دهد، با مدت طولانی به‌عنوان دوره دسترسی.
- برای کارکنان بسته‌هایی بسازید که بوکه‌های آموزش و داخلی را به بوکه عمومی اضافه می‌کنند.
پیکربندی پارتنر (ریسلر)
تیم‌هایی که دسترسی توزیع می‌کنند.
- گروهی فقط با مجوز لاین‌ها بسازید، بدون دسترسی به کاتالوگ یا تنظیمات.
- تیم ارتباطات را با بسته شهروندان و منابع انسانی یا آموزش را با بسته‌های کارکنان به‌صورت حساب پارتنر اضافه کنید.
- نهادی با چند سرویس می‌تواند به هر سرویس حساب پارتنر خودش را بدهد؛ این یک حساب تفویض‌شده است، نه نصب جداگانه.
پیکربندی لاین شهروندان و کارکنان
لاین‌های عمومی و لاین‌های کارکنان.
- برای وب‌سایت شورا یک کلید Reseller API بسازید و در اسرار آن نگه دارید؛ وقتی شهروندی دسترسی می‌خواهد، action=create_line را با بسته عمومی و شناسه درخواست صدا می‌زند.
- برای لاین‌های عمومی انقضای بلند و سقف اتصالی متناسب با تماشای خانگی بگذارید.
- لاین کارکنان را برای هر اداره با بسته‌های کارکنان، از سامانه کارکنان شورا با API یا از Lines → افزودن بسازید.
- هر جا شبکه اجازه می‌دهد لاین کارکنان را به بازه آدرس نهاد ببندید.
آرشیو جلسات و کتابخانه آموزش
ضبط‌ها به‌صورت درخواستی.
- هر جلسه ضبط‌شده را به‌صورت قسمتی از سریال نهادش، با ingest از کار VOD یا آپلود، با عنوان، تاریخ و توضیح اضافه کنید.
- سریال جلسات را در بوکه عمومی و کتابخانه آموزش را در بوکه‌های ادارات بگذارید.
- پخش را با لاین آزمایشی بسته عمومی و یکی از بسته‌های کارکنان بررسی کنید تا مطمئن شوید چه کسی چه می‌بیند.
جلسات زنده
تالار به‌صورت کانال زنده.
- یک استریم زنده با RTMP پوش از انکودر تالار اضافه کنید و در بوکه عمومی بگذارید.
- catch-up را فعال کنید تا بینندگان دیرآمده بتوانند به عقب برگردند، و یک ورودی EPG یا عنوان اضافه کنید تا بینندگان بدانند کدام نشست در جریان است.
- فید را پیش از هر نشست آزمایش کنید، و اگر سایت دومی هم نشست برگزار می‌کند نزدیک آن یک نود نگه دارید.
انقضا و تمدید
برای عموم بلند، برای کارکنان وابسته به استخدام.
- لاین عمومی به اندازه مدت بسته دوام دارد؛ وقتی شهروند دوباره درخواست می‌کند با action=renew_line تمدیدش کنید.
- لاین کارکنان تا وقتی فرد برای نهاد کار می‌کند تمدید می‌شود و هنگام رفتنش با action=disable_line غیرفعال می‌شود.
- سامانه‌های شورا را به وب‌هوک‌ها مشترک کنید تا لاین‌های در حال انقضا و غیرفعال را ببینند.
یکپارچگی با سامانه‌های نهاد
سامانه‌ها دسترسی را می‌رانند؛ پخش‌کننده پخش می‌کند.
- وب‌سایت و سامانه کارکنان با Reseller API و یک کلید و شناسه درخواست لاین می‌سازند، تمدید، فعال و غیرفعال می‌کنند.
- ورود یکپارچه برای بینندگان نیست و یکپارچگی بومی با محصول خاصی از بخش عمومی وجود ندارد: بینندگان با اطلاعات لاین خود وارد پخش‌کننده می‌شوند.
- برای ابزارهای گزارش‌گیری از کلیدهای Admin API با پرچم فقط‌خواندنی، فهرست مجاز IP و تاریخ انقضا استفاده کنید.
ملاحظات امنیتی
اداره‌شده توسط نهاد، هر جا باید باز باشد باز.
- پلتفرم را روی زیرساخت نهاد پشت ریورس‌پراکسی با TLS نگه دارید و مواد عمومی و داخلی را در بوکه‌های جدا بگذارید.
- ورود دومرحله‌ای برای هر حساب پنل و گروه‌های مجوز برای هر تیم؛ اگر پنل از بیرون در دسترس است روی ورود reCAPTCHA یا Turnstile بگذارید.
- لینک‌های پخش امضاشده و منقضی‌شونده، سقف اتصال برای هر لاین و بستن به آدرس برای لاین کارکنان.
- پشتیبان‌های رمزگذاری‌شده پایگاه داده با نسخه بیرونی و گزارش ممیزی برای هر تغییر لاین‌ها و کاتالوگ.
عیب‌یابی
بررسی‌های اولیه معمول.
- شهروند نمی‌تواند تماشا کند: انقضای لاین، فعال بودنش و بوکه عمومی بسته را بررسی کنید.
- جلسه شروع نمی‌شود: پوش انکودر به استریم و وضعیت استریم را در پنل بررسی کنید.
- کارکنان کتابخانه آموزش را نمی‌بینند: بسته لاین کارکنان و بوکه‌هایی که می‌دهد را بررسی کنید.
- گزارش ممیزی آدرس پراکسی را نشان می‌دهد: TRUSTED_PROXIES را روی پراکسی بگذارید و پنل را راه‌اندازی مجدد کنید.