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