המדריכים האלה ממפים מושגים של תעשייה לאובייקטים שיש בפלטפורמה כיום (באוקטים, קווים, חבילות, חשבונות שותפים, צמתים, ה-API). אלה מיפויים מושגיים, לא יכולות ייעודיות לתעשייה, וחשבון שותף הוא חשבון מואצל, לא tenant מבודד.
מיפוי מושגי
שום דבר בלוח לא נקרא פקולטה, סמסטר או סטודנט. הטבלה מציינת איזה אובייקט ממלא איזה תפקיד; הפרקים שלהלן מגדירים אותם בסדר הזה.
| בתעשייה שלכם | בפלטפורמה | איפה בלוח |
|---|---|---|
| חשבון פקולטה או מחלקה | חשבון שותף (מפיץ): לוח מואצל עם קרדיטים, הרשאות וקווים משלו | Users ← הוספת מפיץ; Groups להרשאותיו |
| אוסף פקולטה או מערך הקמפוס | באוקט: קבוצה בעלת שם של ערוצים, סרטים או סדרות שחבילה מעניקה | Bouquets, מתוך Streams ו-Movies / Series |
| ערוץ קמפוס או אירוע חי | ערוץ חי: שידור עם המקורות, ה-EPG ופורמטי הפלט שלו | Streams ← הוספת שידור חי (כתובת מקור או דחיפת RTMP) |
| ארכיון הרצאות | קטלוג VOD: סרטים וסדרות עם עונות ופרקים, קטגוריות ומטא-דאטה | Movies ו-Series, או משימת ingest של VOD |
| גישת סטודנט או איש צוות | קו: גישה אחת עם החבילה, הבאוקטים, התפוגה, מגבלת החיבורים והפלטים שלה | Lines ← הוספה, או קודי הפעלה, או ה-Reseller API |
| סוף הסמסטר או ההרשמה | תאריך התפוגה של הקו, מתחדש בחבילה, בקרדיט או דרך ה-API | תאריך התפוגה של הקו ומשך החבילה |
| צומת קמפוס או מעונות | צמתי הזרמה: שרתי קצה שנרשמו מהלוח, אחד לכל אתר או בניין | Servers ← הוספת צומת, מותקן דרך SSH |
| אינטגרציה של מערכת המידע לסטודנטים | Reseller API ו-webhooks: פעולות הלוח מהמערכת שלכם | מפתחות Reseller API ו-webhooks בלוח של המפיץ |
דרישות מקדימות
מה צריך להכין לפני ההתקנה.
- שרת בקמפוס הראשי (Ubuntu 22.04 או 24.04) הנגיש מהקמפוסים האחרים ומהמעונות, המתקין, וכתובת פנימית או דומיין מאחורי ה-reverse proxy שלכם.
- זרמי ערוצי הקמפוס והקלטות ההרצאות (או הייצוא של מערכת הקלטת ההרצאות), ויכולת של מערכת המידע לסטודנטים לקרוא ל-API של HTTP.
- החלטה על המבנה: אילו פקולטות מקבלות חשבון שותף, איך נקראות סדרות ההרצאות, וכמה זמן נמשך מסלול סמסטר.
פריסת התשתית
קודם הקמפוס הראשי, ואחר כך שאר האתרים.
- הריצו את המתקין בשרת הקמפוס הראשי; הציבו את הלוח מאחורי ה-reverse proxy של האוניברסיטה והגדירו את ה-proxies המהימנים כדי שהיומנים וכללי ה-IP יראו כתובות אמיתיות.
- הגדירו את בסיס ההשמעה לכתובת שהסטודנטים מגיעים אליה מהקמפוס ומהמעונות.
- רשמו צומת לכל קמפוס ולכל מעונות דרך Servers; הלוח מתקין אותו דרך SSH ומנתב אליו את הצופים של אותו אתר.
- הגדירו את מפתח הרישיון בשרת; מוסד בדומיין אקדמי יכול לבקש בדוא״ל את מפתח Professional החינמי של תוכנית החינוך.
ארגון התוכן
אוספי הפקולטות ומערך ערוצי הקמפוס.
- צרו קטגוריות לפי פקולטה ונושא, וסדרה אחת לכל קורס עם עונה לכל תקופה ופרק אחד לכל הרצאה.
- צרו באוקט אחד לכל אוסף פקולטה, אחד לערוצי הקמפוס, ואחד לחומר משותף כמו סרטוני היכרות.
- צרו מסלולים לסטודנטים ולסגל: הבאוקטים שכל אחד צריך, כשהסמסטר הוא המשך המסלול, כך שהגישה מסתיימת עם התקופה אלא אם חודשה.
- צרו מסלול ניסיון קצר לימים פתוחים או לסטודנטים אורחים.
הגדרת שותפים (מפיצים)
פקולטות כחשבונות מואצלים.
- צרו קבוצה עם הרשאות לקווים ולקטלוג של הפקולטה עצמה, וללא גישה להגדרות.
- הוסיפו כל פקולטה או מחלקה כחשבון שותף (מפיץ) עם הקבוצה הזו והמסלולים שלה; תת-מפיצים יכולים לשקף מחלקות בתוך פקולטה.
- פקולטה רואה ומנהלת רק את הקווים שלה; הצוות המרכזי שומר על התמונה המלאה. זה חשבון מואצל, לא התקנה מבודדת.
הגדרת גישה לסטודנטים
קו אחד לכל סטודנט, ממערכת ה-SIS.
- צרו מפתח Reseller API עבור מערכת המידע לסטודנטים ושמרו אותו בסודות של אותה מערכת.
- בעת הרשמה מערכת ה-SIS קוראת ל-action=create_line עם מסלול הסטודנט ומזהה בקשה; משך המסלול, הסמסטר, הוא תקופת הגישה.
- הגדירו את מספר החיבורים המרבי למספר המכשירים שסטודנט רשאי להפעיל במקביל (בדרך כלל שניים: טלפון ומחשב נייד).
- לסגל ולפיילוט, הוסיפו קווים דרך Lines → add ומסרו את פרטי ההתחברות.
ארכיוני הרצאות
הקלטות לפי דרישה.
- העלו כל הקלטה כמקור של פרק או קלטו אותה במשימת VOD ingest; שמרו את שם הקורס ותיאור קצר.
- שייכו את הסדרה לבאוקט של הפקולטה, כך שרק סטודנטים שהמסלול שלהם מעניק זאת יראו את הקורס.
- בדקו השמעה עם קו בדיקה של כל מסלול כדי לוודא מי רואה מה.
ערוצי קמפוס ואירועים בשידור חי
ערוצי שידור חי לקמפוס.
- הוסיפו את זרמי ערוצי הקמפוס כזרמי שידור חי תחת Streams ומקור EPG למדריך.
- הוסיפו זרם חי לכל אולם הרצאות או אירוע, המוזן מהמקודד של האולם דרך RTMP, והפעילו catch-up כדי שצופים מאחרים יוכלו להריץ אחורה.
- שימו כל ערוץ בבאוקט המתאים; הצמתים במעונות לוקחים אותו פעם אחת מהמקור ומשרתים את הסטודנטים מקומית.
תפוגה וחידוש
הסמסטר כתוקף הקו.
- קו פג בסוף תקופת המסלול שלו; בהרשמה מחדש ה-SIS קורא ל-action=renew_line ומתווספת תקופה נוספת.
- כשסטודנט פורש או מסיים את לימודיו, ה-SIS קורא ל-action=disable_line.
- הירשמו ב-webhooks ממערכת ה-SIS כדי ליישב קווים שעומדים לפוג או שפגו מול הרשומות שלה.
שילוב עם מערכת המידע לסטודנטים
ה-SIS שולט בגישה; הנגן מנגן.
- ה-SIS יוצר, מחדש, מפעיל ומשבית קווים דרך Reseller API עם מפתח ומזהה בקשה.
- אין כניסה יחידה (single sign-on) לצופים ואין שילוב מובנה עם LMS או SIS: סטודנט מתחבר לנגן עם פרטי הקו, ודף קורס ב-LMS יכול לקשר לנגן האינטרנט.
- השתמשו במפתחות Admin API עם דגל קריאה בלבד, רשימת IP מורשים ותאריך תפוגה עבור כלי דיווח פנימיים.
שיקולי אבטחה
שמרו את הגישה לסטודנטים ולסגל.
- השאירו את הפלטפורמה ברשת הקמפוס או מאחורי reverse proxy עם TLS; הגדירו את TRUSTED_PROXIES ל-proxy.
- כניסה דו-שלבית לכל חשבון בלוח וקבוצת הרשאות לכל תפקיד, כך שפקולטה לא תראה את הקווים של פקולטה אחרת.
- קישורי השמעה חתומים עם תפוגה, הגבלת חיבורים לכל קו, וקישור למדינה או לכתובת היכן שזה עוזר.
- גיבויים מוצפנים של מסד הנתונים עם עותק מחוץ לאתר, ויומן ביקורת לכל שינוי בקווים ובקטלוג.
פתרון תקלות
הבדיקות הראשונות הרגילות.
- סטודנט לא רואה הרצאות: בדקו את תפוגת הקו, ואז את המסלול והבאוקטים שהוא מעניק.
- לסטודנט חדש אין גישה: בדקו ביומן הקריאות של Reseller API שקריאת ה-SIS הצליחה ושמזהה הבקשה חדש.
- מעונות נתקעים בערב: בדקו את פעימות הלב של הצומת שלהם ושהצופים מנותבים אליו.
- יומן הביקורת מציג את כתובת ה-proxy: הגדירו את TRUSTED_PROXIES ל-proxy והפעילו מחדש את הלוח.