מדריך הקמה למגזר הציבורי

מיפוי מושגי

שום דבר בלוח לא נקרא ישיבה, תושב או מחלקה. הטבלה אומרת איזה אובייקט ממלא איזה תפקיד; הפרקים שלמטה מגדירים אותם בסדר הזה.

1דרישות מקדימות

מה צריך שיהיה לפני ההתקנה.

1. שרת במרכז הנתונים של המוסד (Ubuntu 22.04 או 24.04), המתקין, ודומיין מאחורי ה-reverse proxy של המוסד לכתובת הציבורית.
2. מקודד האולם או מיקסר הווידאו שיכולים לדחוף RTMP, הקלטות של ישיבות קודמות, וסרטוני ההדרכה לעובדים.
3. החלטה מה ציבורי ומה פנימי, כמה זמן נמשך קו ציבורי, ומי מבין המפעילים מקבל חשבון לוח.

2פריסת התשתית

שרת הניהול, ואחר כך כל אתר מרוחק.

1. הריצו את המתקין על שרת המוסד; הציבו את הלוח מאחורי ה-reverse proxy עם TLS והגדירו TRUSTED_PROXIES כדי שיומן הביקורת וכללי ה-IP יראו כתובות אמיתיות.
2. קבעו את בסיס הניגון לכתובת הציבורית שהתושבים מגיעים אליה, ואת מפתח הרישיון בשרת.
3. רשמו צומת מ-Servers לאתר שזקוק לאחד, כמו בניין שני עם אולם; הלוח מתקין אותו דרך SSH.
4. צרו חשבון שותף (מפיץ) לצוות התקשורת עם הרשאות לקווים ציבוריים, ואחד למשאבי אנוש או הדרכה לקווי עובדים.

3ארגון התוכן

תוכנית ציבורית ואוספי מחלקות.

1. צרו קטגוריות לישיבות, לוועדות ולמידע ציבורי, וסדרה אחת לכל גוף עם פרק אחד לכל אסיפה.
2. צרו באוקט ציבורי עם ערוץ הישיבה החי והארכיון, ובאוקט אחד לכל אוסף הדרכה של מחלקה.
3. צרו חבילה לתושבים שמעניקה רק את הבאוקט הציבורי, עם משך ארוך כתקופת גישה.
4. צרו חבילות לעובדים שמוסיפות את באוקטי ההדרכה והפנימיים לבאוקט הציבורי.

4הגדרת שותפים (מפיצים)

צוותים שמחלקים גישה.

1. צרו קבוצה עם הרשאות לקווים בלבד, וללא גישה לקטלוג או להגדרות.
2. הוסיפו את צוות התקשורת כחשבון שותף עם חבילת התושבים, ואת משאבי האנוש או ההדרכה עם חבילות העובדים.
3. גוף עם כמה שירותים יכול לתת לכל שירות חשבון שותף משלו; זהו חשבון מואצל, לא התקנה מבודדת.

5הגדרת קווי תושבים ועובדים

קווים ציבוריים וקווי עובדים.

1. צרו מפתח Reseller API לאתר המועצה ושמרו אותו בסודותיו; כשתושב מבקש גישה הוא קורא ל-action=create_line עם החבילה הציבורית ומזהה בקשה.
2. קבעו תפוגה ארוכה לקווים ציבוריים, ומגבלת חיבורים שמתאימה לצפייה ביתית.
3. צרו קווי עובדים לכל מחלקה עם חבילות העובדים, ממערכת העובדים של המועצה דרך ה-API או מ-Lines → add.
4. קשרו קווי עובדים לטווח הכתובות של המוסד היכן שהרשת מאפשרת.

6ארכיון ישיבות וספריית הדרכה

הקלטות לפי דרישה.

1. הוסיפו כל ישיבה מוקלטת כפרק בסדרה של הגוף שלה, מיובאת עם משימת ייבוא ה-VOD או מועלית, עם כותרת, תאריך ותיאור.
2. הציבו את סדרת הישיבות בבאוקט הציבורי ואת ספריית ההדרכה בבאוקטים של המחלקות.
3. בדקו ניגון עם קו ניסיון מהחבילה הציבורית ואחד מחבילת עובדים כדי לוודא מי רואה מה.

7ישיבות חיות

האולם כערוץ חי.

1. הוסיפו שידור חי עם דחיפת RTMP ממקודד האולם והציבו אותו בבאוקט הציבורי.
2. הפעילו צפייה בדיעבד כדי שצופים מאחרים יוכלו לחזור אחורה, והוסיפו פריט EPG או כותרת כדי שהצופים ידעו איזו אסיפה משודרת.
3. בדקו את הפיד לפני כל אסיפה, והחזיקו צומת ליד אתר שני אם גם הוא מארח ישיבות.

8תפוגה וחידוש

ארוכה לציבור, קשורה להעסקה לעובדים.

1. קו ציבורי נמשך כמשך החבילה; האריכו אותו עם action=renew_line כשהתושב מבקש שוב.
2. קו עובד מחודש כל עוד האדם עובד במוסד ומושבת עם action=disable_line כשהוא עוזב.
3. הירשמו ב-webhooks ממערכות המועצה כדי לראות קווים שעומדים לפוג וקווים מושבתים.

9אינטגרציה עם מערכות המוסד

מערכות מנהלות את הגישה; הנגן מנגן.

1. האתר ומערכת העובדים יוצרים, מחדשים, מפעילים ומשביתים קווים דרך Reseller API עם מפתח ומזהה בקשה.
2. אין כניסה אחודה לצופים ואין אינטגרציה מובנית עם מוצר ספציפי של המגזר הציבורי: צופים נכנסים לנגן עם פרטי הכניסה של הקו שלהם.
3. השתמשו במפתחות Admin API עם סימון קריאה בלבד, רשימת כתובות IP מותרות ותאריך תפוגה לכלי דיווח.

10שיקולי אבטחה

מופעל על ידי המוסד, בגלוי היכן שצריך.

1. השאירו את הפלטפורמה על תשתית המוסד מאחורי ה-reverse proxy עם TLS, ושמרו חומר ציבורי ופנימי באוקטים נפרדים.
2. כניסה דו-שלבית לכל חשבון לוח וקבוצות הרשאות לכל צוות; reCAPTCHA או Turnstile בכניסה אם הלוח נגיש מבחוץ.
3. קישורי ניגון חתומים ופוקעים, מגבלת חיבורים לכל קו, וקשירה לכתובת בקווי עובדים.
4. גיבויים מוצפנים של מסד הנתונים עם עותק מחוץ לאתר, ויומן ביקורת לכל שינוי בקווים ובקטלוג.

11פתרון תקלות

הבדיקות הראשונות הרגילות.

1. תושב לא יכול לצפות: בדקו את תפוגת הקו, שהוא מופעל, ואת הבאוקט הציבורי של החבילה.
2. ישיבה לא מתחילה: בדקו את הדחיפה של המקודד לשידור ואת סטטוס השידור בלוח.
3. עובדים לא רואים את ספריית ההדרכה: בדקו את החבילה של קו העובד ואת הבאוקטים שהיא מעניקה.
4. יומן הביקורת מציג את כתובת הפרוקסי: הגדירו את TRUSTED_PROXIES לפרוקסי והפעילו מחדש את הלוח.