Αυτοί οι οδηγοί αντιστοιχίζουν τις έννοιες ενός κλάδου στα αντικείμενα που έχει σήμερα η πλατφόρμα (bouquets, lines, πακέτα, λογαριασμοί διανομέων, κόμβοι, το API). Είναι εννοιολογικές αντιστοιχίσεις, όχι λειτουργίες ειδικές για κλάδο, και ο λογαριασμός διανομέα είναι ανατεθειμένος λογαριασμός, όχι απομονωμένος tenant.
Εννοιολογική αντιστοίχιση
Τίποτα στον πίνακα δεν λέγεται συνδρομή ή σημείο παρουσίας. Ο πίνακας δείχνει ποιο αντικείμενο παίζει ποιον ρόλο· τα κεφάλαια παρακάτω τα στήνουν με αυτή τη σειρά.
| Στον κλάδο σας | Στην πλατφόρμα | Πού στον πίνακα |
|---|---|---|
| Λογαριασμός μεταπωλητή ή περιφερειακού συνεργάτη | Λογαριασμός μεταπωλητή: ανατεθειμένος πίνακας με credits, δικαιώματα και δικά του lines | Users → προσθήκη μεταπωλητή· Groups για τα δικαιώματά του |
| Επίπεδο καναλιών ή πακέτο προσθήκης | Bouquet: ονομασμένο σύνολο καναλιών, ταινιών ή σειρών που παραχωρεί ένα πακέτο | Bouquets, από Streams και Movies / Series |
| Τηλεοπτικό κανάλι | Ζωντανό κανάλι: ένα stream με τις πηγές, το EPG και τις μορφές εξόδου του | Streams → προσθήκη ζωντανού stream (URL πηγής ή αποστολή RTMP) |
| Βιβλιοθήκη VOD | Κατάλογος VOD: ταινίες και σειρές με σεζόν και επεισόδια, κατηγορίες και μεταδεδομένα | Movies και Series, ή η εργασία VOD ingest |
| Τηλεοπτική πρόσβαση συνδρομητή | Line: μία πρόσβαση με το πακέτο, τα bouquets, τη λήξη, το όριο συνδέσεων και τις εξόδους της | Lines → προσθήκη, ή κωδικοί ενεργοποίησης, ή το Reseller API |
| Λήξη της περιόδου τιμολόγησης | Ημερομηνία λήξης του line, που ανανεώνεται με πακέτο, credit ή το API | Η ημερομηνία λήξης του line και η διάρκεια του πακέτου |
| Οθόνες ανά συνδρομή | Μέγιστες συνδέσεις του line: πόσες συσκευές μπορούν να παρακολουθούν ταυτόχρονα | Οι μέγιστες συνδέσεις του line |
| Ενσωμάτωση τιμολόγησης και provisioning | Reseller API και webhooks: οι λειτουργίες του πίνακα από το δικό σας σύστημα | Κλειδιά Reseller API και webhooks στον πίνακα του μεταπωλητή |
| Node σημείου παρουσίας | Κόμβοι streaming: edge διακομιστές που εγγράφονται από τον πίνακα, ένας ανά χώρο ή κτίριο | Servers → προσθήκη κόμβου, με εγκατάσταση μέσω SSH |
Προαπαιτούμενα
Τι να έχετε πριν την εγκατάσταση.
- Έναν διακομιστή στον κεντρικό χώρο (Ubuntu 22.04 ή 24.04), το πρόγραμμα εγκατάστασης, ένα domain ή διεύθυνση που φτάνουν οι συνδρομητές και έναν διακομιστή σε κάθε σημείο παρουσίας για τα nodes.
- Τις αδειοδοτημένες τροφοδοσίες καναλιών, τη βιβλιοθήκη VOD και το σύστημα τιμολόγησης όπου ζουν οι συνδρομές.
- Μια απόφαση για τα επίπεδα, πόσο διαρκεί μια περίοδος τιμολόγησης και ποιοι μεταπωλητές παίρνουν λογαριασμό συνεργάτη.
Εγκατάσταση υποδομής
Ο κεντρικός χώρος, μετά τα σημεία παρουσίας.
- Εκτελέστε το πρόγραμμα εγκατάστασης στον κεντρικό διακομιστή· βάλτε τον πίνακα πίσω από το reverse proxy σας και ορίστε το TRUSTED_PROXIES ώστε τα logs και οι κανόνες IP να βλέπουν την πραγματική διεύθυνση του συνδρομητή.
- Ορίστε τη βάση αναπαραγωγής στη δημόσια διεύθυνση στην οποία φτάνουν οι συνδρομητές και το κλειδί άδειας στον διακομιστή.
- Εγγράψτε ένα node ανά σημείο παρουσίας από τους Servers· ο πίνακας το εγκαθιστά μέσω SSH, ή το node εγγράφεται με κωδικό μίας χρήσης, και κατευθύνει σε αυτό τους συνδρομητές κοντά του.
- Δημιουργήστε έναν λογαριασμό συνεργάτη (reseller) για την υποστήριξη ή την ομάδα τιμολόγησης με δικαιώματα μόνο για lines.
Οργάνωση περιεχομένου
Επίπεδα και πακέτα ως bouquets.
- Προσθέστε τα κανάλια στα Streams και τη βιβλιοθήκη VOD στις Movies και Series, με κατηγορίες και μια πηγή EPG.
- Δημιουργήστε bouquets για το βασικό πακέτο καναλιών, τα premium κανάλια και τη βιβλιοθήκη VOD.
- Δημιουργήστε ένα πακέτο ανά επίπεδο συνδρομής με τα bouquets που χορηγεί, την περίοδο τιμολόγησης ως διάρκεια και μια τιμή σε credits.
- Δημιουργήστε ένα σύντομο δοκιμαστικό πακέτο για μια προσφορά ή έναν νέο πελάτη.
Ρύθμιση συνεργατών (reseller)
Μεταπωλητές με credits.
- Δημιουργήστε μια ομάδα για μεταπωλητές με δικαιώματα για τα δικά τους lines και χωρίς πρόσβαση στον κατάλογο ή στις ρυθμίσεις.
- Προσθέστε κάθε περιφερειακό μεταπωλητή ως λογαριασμό συνεργάτη με αυτή την ομάδα, τα πακέτα που μπορεί να πουλά και ένα υπόλοιπο credits· ένας μεταπωλητής μπορεί να έχει sub-resellers έως πέντε επίπεδα βάθος.
- Το webhook credits.low και η ειδοποίηση χαμηλών credits λένε σε έναν μεταπωλητή να κάνει αναπλήρωση πριν σταματήσουν οι πωλήσεις.
Ρύθμιση lines συνδρομητών
Ένα line ανά συνδρομή.
- Η τιμολόγηση δημιουργεί ένα line όταν ξεκινά μια συνδρομή, μέσω connector ή του action=create_line του Reseller API με το πακέτο του επιπέδου και ένα request id.
- Ορίστε τις μέγιστες συνδέσεις ανά επίπεδο, τον αριθμό οθονών που μπορεί να χρησιμοποιεί ταυτόχρονα ένα νοικοκυριό.
- Δέστε ένα line στη διεύθυνση, χώρα ή ISP του συνδρομητή όπου η προσφορά αφορά μόνο το δίκτυό σας.
- Για πιλοτικό ή υπόθεση υποστήριξης, προσθέστε lines από Lines → add και δώστε τα διαπιστευτήρια.
Βιβλιοθήκη VOD
Ο κατάλογος κατά παραγγελία.
- Προσθέστε ταινίες και σειρές με σεζόν και επεισόδια, εισαγμένες με τη διεργασία VOD ingest ή ανεβασμένες, με μεταδεδομένα TMDB για αφίσες και περιγραφές.
- Ομαδοποιήστε τους τίτλους σε bouquets ανά επίπεδο ή πρόσθετο, ώστε ένα πακέτο να χορηγεί ακριβώς ό,τι περιλαμβάνει η συνδρομή.
- Τα nodes αποθηκεύουν προσωρινά τα αρχεία VOD, οπότε οι δημοφιλείς τίτλοι εξυπηρετούνται από το σημείο παρουσίας κοντά στον συνδρομητή.
Ζωντανά κανάλια
Το πακέτο καναλιών.
- Προσθέστε κάθε αδειοδοτημένο κανάλι στα Streams με την τροφοδοσία του και ενεργοποιήστε catch-up ή timeshift μόνο εκεί που το επιτρέπουν τα δικαιώματα.
- Προσθέστε μια πηγή EPG ώστε οι εφαρμογές και τα boxes να δείχνουν τον οδηγό προγράμματος.
- Κάθε node παίρνει ένα ζωντανό κανάλι μία φορά από το origin και το διανέμει στους συνδρομητές του.
Λήξη, ανανέωση και ακύρωση
Η περίοδος τιμολόγησης ως ισχύς του line.
- Ένα line διαρκεί όσο η περίοδος του πακέτου του· η τιμολόγηση το ανανεώνει σε κάθε περίοδο με action=renew_line ή μέσω του connector.
- Όταν μια συνδρομή λήγει ή ακυρώνεται, η τιμολόγηση καλεί action=disable_line και ενεργοποιεί ξανά το line στην επανενεργοποίηση.
- Εγγράψτε την τιμολόγηση στα webhooks για να συμφιλιώνει τα lines που λήγουν και όσα έχουν λήξει με τα αρχεία της.
Ενσωμάτωση με την τιμολόγηση
Η τιμολόγηση οδηγεί την πρόσβαση· ο player παίζει.
- Εγκαταστήστε το connector για το σύστημα τιμολόγησής σας στη δική του πλευρά (WHMCS, Blesta, Odoo και άλλα), ή καλέστε το Reseller API με κλειδί και request id από το δικό σας σύστημα.
- Δεν υπάρχει ενιαία σύνδεση (single sign-on) για θεατές: ένας συνδρομητής συνδέεται σε μια εφαρμογή ή box με τα διαπιστευτήρια του line, που η τιμολόγηση μπορεί να δείχνει στην περιοχή πελατών.
- Χρησιμοποιήστε κλειδιά Admin API με σημαία μόνο ανάγνωσης, λίστα επιτρεπόμενων IP και ημερομηνία λήξης για εργαλεία αναφορών.
Ζητήματα ασφάλειας
Κρατήστε την υπηρεσία για τους συνδρομητές.
- Βάλτε τον πίνακα πίσω από το reverse proxy με TLS και ορίστε το TRUSTED_PROXIES· κρατήστε την κίνηση διαχείρισης των nodes σε ιδιωτικό δίκτυο.
- Σύνδεση δύο παραγόντων για κάθε λογαριασμό του πίνακα και ομάδες δικαιωμάτων για υποστήριξη και μεταπωλητές· reCAPTCHA ή Turnstile στη σύνδεση.
- Υπογεγραμμένοι σύνδεσμοι αναπαραγωγής που λήγουν, όριο συνδέσεων ανά συνδρομή και δέσιμο σε διεύθυνση, χώρα ή ISP όπου ταιριάζει.
- Κρυπτογραφημένα αντίγραφα ασφαλείας της βάσης με εξωτερικό αντίγραφο και το audit log για κάθε αλλαγή lines και credits.
Αντιμετώπιση προβλημάτων
Οι συνηθισμένοι πρώτοι έλεγχοι.
- Ένας συνδρομητής δεν έχει τηλεόραση: ελέγξτε ότι το line είναι ενεργό και δεν έχει λήξει, μετά την κλήση της τιμολόγησης στο log κλήσεων του Reseller API.
- Ένα κανάλι λείπει για ένα επίπεδο: ελέγξτε τα bouquets του πακέτου αυτού του επιπέδου.
- Ένα σημείο παρουσίας κάνει buffering: ελέγξτε το heartbeat του node του και ότι οι συνδρομητές του κατευθύνονται σε αυτό.
- Ένας μεταπωλητής δεν μπορεί να δημιουργήσει line: ελέγξτε τα credits του και ότι το πακέτο είναι από αυτά που μπορεί να πουλά.