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