ये गाइड किसी उद्योग की अवधारणाओं को उन ऑब्जेक्ट से जोड़ती हैं जो प्लेटफ़ॉर्म में आज हैं (बुके, लाइनें, पैकेज, पार्टनर खाते, नोड्स, API)। ये वैचारिक मैपिंग हैं, उद्योग-विशिष्ट फ़ीचर नहीं, और पार्टनर खाता एक प्रतिनिधि खाता है, अलग-थलग टेनेंट नहीं।
वैचारिक मैपिंग
पैनल में कुछ भी सब्सक्रिप्शन या पॉइंट ऑफ़ प्रेज़ेंस नहीं कहलाता। तालिका बताती है कि कौन-सी ऑब्जेक्ट कौन-सी भूमिका निभाती है; नीचे के अध्याय उन्हें इसी क्रम में सेट करते हैं।
| आपके उद्योग में | प्लेटफ़ॉर्म पर | पैनल में कहाँ |
|---|---|---|
| डीलर या क्षेत्रीय पार्टनर का खाता | पार्टनर खाता (रीसेलर): क्रेडिट, अनुमतियों और अपनी लाइनों वाला प्रतिनिधि डैशबोर्ड | Users → रीसेलर जोड़ें; उसकी अनुमतियों के लिए Groups |
| चैनल टियर या ऐड-ऑन पैक | बुके: चैनलों, फ़िल्मों या सीरीज़ का नामित समूह जो कोई पैकेज देता है | Bouquets, Streams और Movies / Series से |
| टेलीविज़न चैनल | लाइव चैनल: अपने स्रोतों, EPG और आउटपुट फ़ॉर्मैट वाली स्ट्रीम | Streams → लाइव स्ट्रीम जोड़ें (स्रोत URL या RTMP पुश) |
| VOD लाइब्रेरी | VOD कैटलॉग: सीज़न और एपिसोड वाली फ़िल्में और सीरीज़, श्रेणियाँ और मेटाडेटा | Movies और Series, या VOD इन्जेस्ट जॉब |
| सब्सक्राइबर का टेलीविज़न एक्सेस | लाइन: एक एक्सेस, अपने पैकेज, बुके, समाप्ति, कनेक्शन सीमा और आउटपुट के साथ | Lines → जोड़ें, या एक्टिवेशन कोड, या Reseller API |
| बिलिंग अवधि का अंत | लाइन की समाप्ति तिथि, जिसे पैकेज, क्रेडिट या API रिन्यू करती है | लाइन की समाप्ति तिथि और पैकेज की अवधि |
| प्रति सब्सक्रिप्शन स्क्रीन | लाइन के अधिकतम कनेक्शन: एक साथ कितने डिवाइस देख सकते हैं | लाइन के अधिकतम कनेक्शन |
| बिलिंग और प्रोविज़निंग इंटीग्रेशन | Reseller API और webhooks: पैनल के ऑपरेशन आपके अपने सिस्टम से | रीसेलर के डैशबोर्ड में Reseller API कुंजियाँ और webhooks |
| पॉइंट-ऑफ़-प्रेज़ेंस नोड | स्ट्रीमिंग नोड्स: पैनल से जोड़े गए एज सर्वर, हर साइट या इमारत के लिए एक | Servers → नोड जोड़ें, SSH से इंस्टॉल |
पूर्वापेक्षाएँ
इंस्टॉल करने से पहले क्या तैयार रखें।
- कोर साइट में एक सर्वर (Ubuntu 22.04 या 24.04), इंस्टॉलर, एक डोमेन या पता जिस तक सब्सक्राइबर पहुँच सकें, और हर पॉइंट ऑफ़ प्रेज़ेंस में नोड्स के लिए एक सर्वर।
- लाइसेंस वाली चैनल फ़ीड, VOD लाइब्रेरी, और वह बिलिंग सिस्टम जिसमें सब्सक्रिप्शन रहते हैं।
- टियरों पर फ़ैसला, बिलिंग अवधि कितनी लंबी होगी, और किन डीलरों को पार्टनर खाता मिले।
इन्फ्रास्ट्रक्चर डिप्लॉयमेंट
पहले कोर साइट, फिर पॉइंट्स ऑफ़ प्रेज़ेंस।
- कोर सर्वर पर इंस्टॉलर चलाएँ; पैनल को अपने रिवर्स प्रॉक्सी के पीछे रखें और TRUSTED_PROXIES सेट करें ताकि लॉग और IP नियम सब्सक्राइबर का असली पता देखें।
- प्लेबैक बेस को उस सार्वजनिक पते पर सेट करें जिस तक सब्सक्राइबर पहुँचते हैं, और सर्वर पर लाइसेंस कुंजी सेट करें।
- Servers से हर पॉइंट ऑफ़ प्रेज़ेंस के लिए एक नोड एनरोल करें; पैनल उसे SSH से इंस्टॉल करता है, या नोड एक-बार के कोड से एनरोल होता है, और उसके पास के सब्सक्राइबरों को उस पर रूट करता है।
- सपोर्ट या बिलिंग टीम के लिए सिर्फ़ लाइनों की अनुमतियों वाला पार्टनर खाता (रीसेलर) बनाएँ।
कंटेंट का संगठन
बुके के रूप में टियर और पैक।
- चैनलों को Streams में और VOD लाइब्रेरी को Movies और Series में, श्रेणियों और EPG स्रोत के साथ जोड़ें।
- बेसिक लाइन-अप, प्रीमियम चैनलों और VOD लाइब्रेरी के लिए बुके बनाएँ।
- हर सब्सक्रिप्शन टियर के लिए एक पैकेज बनाएँ, जिसमें वे बुके हों जो वह देता है, बिलिंग अवधि उसकी अवधि हो और क्रेडिट में कीमत हो।
- प्रमोशन या नए ग्राहक के लिए छोटा ट्रायल पैकेज बनाएँ।
पार्टनर (रीसेलर) कॉन्फ़िगरेशन
क्रेडिट वाले डीलर।
- डीलरों के लिए अपनी लाइनों की अनुमतियों वाला ग्रुप बनाएँ, जिसकी कैटलॉग या सेटिंग तक पहुँच न हो।
- हर क्षेत्रीय डीलर को उस ग्रुप, बेचे जा सकने वाले पैकेजों और क्रेडिट बैलेंस के साथ पार्टनर खाते के रूप में जोड़ें; डीलर के पाँच स्तर तक सब-रीसेलर हो सकते हैं।
- वेबहुक credits.low और कम-क्रेडिट की सूचना डीलर को बिक्री रुकने से पहले टॉप अप करने को कहती है।
सब्सक्राइबर लाइन का कॉन्फ़िगरेशन
हर सब्सक्रिप्शन की एक लाइन।
- सब्सक्रिप्शन शुरू होने पर बिलिंग कनेक्टर से या Reseller API के action=create_line से, टियर के पैकेज और रिक्वेस्ट आईडी के साथ, लाइन बनाती है।
- हर टियर के लिए अधिकतम कनेक्शन सेट करें, यानी एक घर एक साथ कितनी स्क्रीनें इस्तेमाल कर सकता है।
- जब ऑफ़र सिर्फ़ आपके नेटवर्क के लिए हो तो लाइन को सब्सक्राइबर के पते, देश या ISP से बाँधें।
- पायलट या सपोर्ट केस के लिए Lines → जोड़ें से लाइनें जोड़ें और क्रेडेंशियल दें।
VOD लाइब्रेरी
ऑन-डिमांड कैटलॉग।
- सीज़न और एपिसोड के साथ फ़िल्में और सीरीज़ जोड़ें, VOD इन्जेस्ट जॉब से इन्जेस्ट करके या अपलोड करके, पोस्टर और विवरण के लिए TMDB मेटाडेटा के साथ।
- टाइटलों को टियर या ऐड-ऑन के अनुसार बुके में समूहित करें, ताकि पैकेज ठीक वही दे जो सब्सक्रिप्शन में शामिल है।
- नोड VOD फ़ाइलें कैश करते हैं, इसलिए लोकप्रिय टाइटल सब्सक्राइबर के पास के पॉइंट ऑफ़ प्रेज़ेंस से परोसे जाते हैं।
लाइव चैनल
लाइन-अप।
- हर लाइसेंस वाले चैनल को उसकी फ़ीड के साथ Streams में जोड़ें, और कैच-अप या टाइमशिफ़्ट सिर्फ़ वहाँ चालू करें जहाँ अधिकार इजाज़त दें।
- EPG स्रोत जोड़ें ताकि ऐप और बॉक्स प्रोग्राम गाइड दिखाएँ।
- हर नोड लाइव चैनल को ओरिजिन से एक बार लेता है और अपने सब्सक्राइबरों तक बाँटता है।
समाप्ति, नवीनीकरण और रद्दीकरण
लाइन की वैधता के रूप में बिलिंग अवधि।
- लाइन अपने पैकेज की अवधि तक चलती है; बिलिंग हर अवधि में action=renew_line से या कनेक्टर के ज़रिए उसे रिन्यू करती है।
- जब सब्सक्रिप्शन लैप्स या रद्द होता है, बिलिंग action=disable_line कॉल करती है, और पुनः सक्रिय होने पर लाइन फिर चालू करती है।
- समाप्त होने वाली और समाप्त लाइनों को अपने रिकॉर्ड से मिलाने के लिए बिलिंग को वेबहुक के लिए सब्सक्राइब करें।
बिलिंग के साथ इंटीग्रेशन
बिलिंग एक्सेस चलाती है; प्लेयर चलाता है।
- अपने बिलिंग सिस्टम की ओर उसका कनेक्टर इंस्टॉल करें (WHMCS, Blesta, Odoo और अन्य), या अपने सिस्टम से कुंजी और रिक्वेस्ट आईडी के साथ Reseller API कॉल करें।
- दर्शकों के लिए सिंगल साइन-ऑन नहीं है: सब्सक्राइबर ऐप या बॉक्स में लाइन के क्रेडेंशियल से साइन इन करता है, जिन्हें बिलिंग ग्राहक क्षेत्र में दिखा सकती है।
- रिपोर्टिंग टूल के लिए रीड-ओनली फ़्लैग, IP अनुमति-सूची और समाप्ति तिथि वाली Admin API कुंजियाँ इस्तेमाल करें।
सुरक्षा संबंधी विचार
सेवा को सब्सक्राइबरों के लिए रखें।
- पैनल को TLS वाले रिवर्स प्रॉक्सी के पीछे रखें और TRUSTED_PROXIES सेट करें; नोड्स का मैनेजमेंट ट्रैफ़िक निजी नेटवर्क पर रखें।
- हर पैनल खाते के लिए टू-फ़ैक्टर साइन-इन और सपोर्ट व डीलरों के लिए अनुमति ग्रुप; साइन-इन पर reCAPTCHA या Turnstile।
- साइन किए गए और समाप्त होने वाले प्लेबैक लिंक, हर सब्सक्रिप्शन पर कनेक्शन सीमा, और जहाँ उचित हो वहाँ पते, देश या ISP की बाइंडिंग।
- ऑफ़-साइट कॉपी के साथ एन्क्रिप्टेड डेटाबेस बैकअप, और लाइनों व क्रेडिट के हर बदलाव के लिए ऑडिट लॉग।
समस्या-निवारण
आम तौर पर पहली जाँचें।
- सब्सक्राइबर को टेलीविज़न नहीं चलता: जाँचें कि लाइन चालू है और समाप्त नहीं हुई, फिर Reseller API कॉल लॉग में बिलिंग की कॉल।
- एक टियर के लिए चैनल गायब है: उस टियर के पैकेज के बुके जाँचें।
- पॉइंट ऑफ़ प्रेज़ेंस बफ़र करता है: उसके नोड का हार्टबीट और यह जाँचें कि उसके सब्सक्राइबर उस पर रूट हैं।
- डीलर लाइन नहीं बना पाता: उसके क्रेडिट जाँचें और यह कि पैकेज उसके बेचने योग्य है।