מדריך הקמה לקהילות מגורים

מיפוי מושגי

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

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

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

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

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

השרת המרכזי, אחר כך צומת לכל בניין.

1. הריצו את המתקין על השרת המרכזי וקבעו את כתובת בסיס הניגון לכתובת שהבניינים יכולים להגיע אליה.
2. הוסיפו את פידי הערוצים תחת Streams ואת ההודעות תחת Movies, ובדקו אותם בנגן האינטרנט.
3. רשמו צומת לכל בניין מ-Servers; הלוח מתקין אותו דרך SSH, או שהצומת נרשם בקוד חד-פעמי, ומנתב אליו את תושבי הבניין.
4. הוסיפו את מנהל הנכסים תחת Users → add a reseller, עם קבוצה שמאפשרת קווים וללא שינויים בקטלוג.

3ארגון התוכן

מערכים לכל סוג בית.

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

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

מנהל הנכסים כחשבון מואצל.

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

5הגדרת דירה (קו)

קו אחד לכל דירה, בשם מספרה.

1. צרו קו אחד לכל דירה תחת Lines → add, עם מספר הדירה כשם והחבילה של סוג הבית.
2. קבעו את מספר החיבורים המרבי למספר הטלוויזיות בבית.
3. השתמשו בקוד הפעלה במקום בסיסמה כשהתושב צריך להזין קוד קצר במכשיר.
4. הגדירו את המכשיר פעם אחת (Xtream Codes API או M3U עם פרטי הקו, או פורטל MAG או Enigma2); הפרטים נשארים עם הדירה עד שהקו מקבל פרטים חדשים.

6סרטוני קבלת פנים והודעות

סרטוני חברת הניהול לפי דרישה.

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

7ערוצים וערוץ המידע

המערך וערוץ ההודעות כשידורים חיים.

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

8כניסה, יציאה ותפוגה

האיכלוס כתוקף הקו.

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

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

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

1. צרו מפתח Reseller API למערכת הדיור או החיוב; היא קוראת ל-create_line, renew_line, enable_line ו-disable_line, ושולחת מזהה בקשה עם כל כתיבה.
2. השתמשו במחבר מסחר כשתושבים קונים חבילות נוספות ברשת; כל מערכת אחרת משתמשת ב-Reseller API וב-webhooks.
3. אין כניסה אחודה לצופים: תושב נכנס לנגן עם פרטי הכניסה של הקו.

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

שמרו את השירות בתוך הקהילה.

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

11פתרון תקלות

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

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