בית
XtreamUIPro

מדריך הקמה

מדריך הקמה לרשתות קמעונאות וזיכיון

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

המדריכים האלה ממפים מושגים של תעשייה לאובייקטים שיש בפלטפורמה כיום (באוקטים, קווים, חבילות, חשבונות שותפים, צמתים, ה-API). אלה מיפויים מושגיים, לא יכולות ייעודיות לתעשייה, וחשבון שותף הוא חשבון מואצל, לא tenant מבודד.

מיפוי מושגי

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

בתעשייה שלכםבפלטפורמהאיפה בלוח
ערוץ חנות או אוסף הדרכהבאוקט: קבוצה בעלת שם של ערוצים, סרטים או סדרות שחבילה מעניקהBouquets, מתוך Streams ו-Movies / Series
ערוץ חנותערוץ חי: שידור עם המקורות, ה-EPG ופורמטי הפלט שלוStreams ← הוספת שידור חי (כתובת מקור או דחיפת RTMP)
וידאו הדרכה ומוצרקטלוג VOD: סרטים וסדרות עם עונות ופרקים, קטגוריות ומטא-דאטהMovies ו-Series, או משימת ingest של VOD
מסך חנות או גישת עובדקו: גישה אחת עם החבילה, הבאוקטים, התפוגה, מגבלת החיבורים והפלטים שלהLines ← הוספה, או קודי הפעלה, או ה-Reseller API
חשבון זכייןחשבון שותף (מפיץ): לוח מואצל עם קרדיטים, הרשאות וקווים משלוUsers ← הוספת מפיץ; Groups להרשאותיו
צומת אזוריצמתי הזרמה: שרתי קצה שנרשמו מהלוח, אחד לכל אתר או בנייןServers ← הוספת צומת, מותקן דרך SSH
מסכים או מכשירים לכל קומספר החיבורים המרבי של הקו: כמה מכשירים יכולים לצפות בו-זמניתמספר החיבורים המרבי של הקו

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

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

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

פריסת התשתית

קודם המשרד הראשי, אחר כך האזורים.

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

ארגון התוכן

ערוץ החנות וספריית ההדרכה.

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

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

חשבון שותף אחד לכל זכיין.

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

הגדרת קווי חנויות ועובדים

קו לכל מסך ולכל עובד.

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

וידאו הדרכה ומוצר

הספרייה לעובדים.

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

ערוץ החנות

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

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

תפוגה וחידוש

הגישה עוקבת אחרי החנות או החוזה.

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

אינטגרציה עם מערכות זיכיון או משאבי אנוש

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

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

שיקולי אבטחה

שמרו כל חנות על הקווים שלה.

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

פתרון תקלות

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

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