SubSovereign के साथ शुरुआत करें

यह गाइड आपको शून्य से शुरू करके आपके ऐप में एक कार्यशील सदस्यता जाँच तक पहुँचाती है। यह How SubSovereign works की व्यावहारिक साथी है — अगर आप अवधारणाएँ समझना चाहते हैं, तो पहले वह पढ़ें।

इसमें पाँच चरण हैं: सर्वर तैयार करें → अपना ऐप बनाएँ → जो बेचना है वह परिभाषित करें → SDK जोड़ें → एक्सेस जाँचें। पहले चरण के लिए एक दोपहर का समय रखें; बाकी जल्दी हो जाते हैं।

चरण 1 — सर्वर तैयार करें

SubSovereign स्व-होस्टेड है, इसलिए पहला कदम है अपने स्वयं के इन्फ्रास्ट्रक्चर पर बैकएंड चलाना। यह एक Node.js/TypeScript सेवा है जो PostgreSQL (अधिकार, इवेंट और सहमति के लिए) और Redis (तेज़ अधिकार कैश के लिए) पर आधारित है।

cd backend
cp .env.example .env
# Fill in every value in .env — database URL, store credentials, secrets.

npm install
npm run migrate      # creates the database tables
npm run build && npm start

मैनेज्ड डिप्लॉयमेंट के लिए एक तैयार Northflank कॉन्फ़िग (backend/northflank.yml) उपलब्ध है, लेकिन कोई भी होस्ट जो Node + PostgreSQL + Redis चला सके, काम करेगा — मुख्य बात यह है कि यह आपका है। एक बार यह चालू हो जाए, तो इसका पता नोट करें; यही वह baseUrl है जिससे आपके ऐप बात करेंगे (जैसे https://subs.yourdomain.com)।

सुझाव: सर्वर को UK/EU होस्टिंग पर रखें। डेटा संप्रभुता और GDPR ही इसका मूल उद्देश्य हैं — डिप्लॉयमेंट के चरण में ही इसे न छोड़ें।

चरण 2 — डैशबोर्ड में अपना ऐप बनाएँ

डैशबोर्ड खोलें और एक ऐप बनाएँ — प्रत्येक उत्पाद के लिए एक जिसे आप शिप करते हैं (आपका Android ऐप और iOS ऐप एक ही ऐप रिकॉर्ड हो सकते हैं, या अलग-अलग; यह आप तय करें)। ऐप बनाने पर आपको दो ज़रूरी चीज़ें मिलती हैं:

एक appId — सर्वर पर इस ऐप की पहचान करता है, और
एक API key — वह क्रेडेंशियल जिसे आपका ऐप अपने SDK कॉल को प्रमाणित करने के लिए उपयोग करता है।

API key को सुरक्षित जगह रखें। आप डैशबोर्ड से कभी भी key जारी कर सकते हैं या रद्द कर सकते हैं।

चरण 3 — जो बेचना है वह परिभाषित करें

अभी भी डैशबोर्ड में, वे चीज़ें सेट करें जो आपके उपयोगकर्ता वास्तव में खरीदेंगे:

अपने एक्सेस स्तर बनाएँ (जिन्हें टियर भी कहते हैं) — आपके उत्पाद द्वारा दिए जाने वाले एक्सेस के स्तर, जैसे pro या premium। ये वे नाम हैं जिनके विरुद्ध आपका ऐप जाँच करेगा।
प्रत्येक एक्सेस स्तर को अपने स्टोर उत्पादों से जोड़ें। प्रत्येक स्टोर (App Store, Google Play, Amazon, Roku, Stripe) में आप सदस्यता उत्पाद सामान्य तरीके से बनाते हैं; SubSovereign में आप उसे बताते हैं कि "यह स्टोर उत्पाद यह एक्सेस स्तर प्रदान करता है।" यही मैपिंग एक खरीद को अधिकार में बदलती है।
अपना पेवॉल डिज़ाइन करें — शीर्षक, सुविधाएँ, कीमतें और ट्रायल अवधि। चूँकि यह रिमोटली सर्व किया जाता है, आप बाद में ऐप अपडेट शिप किए बिना इसे बदल सकते हैं।

चरण 4 — अपने ऐप में SDK जोड़ें

SDK को अपने ऐप में डालें और इसे अपने सर्वर की ओर इंगित करें। हर प्लेटफ़ॉर्म पर तरीका एक जैसा है — अपने प्लेटफ़ॉर्म की गाइड देखें:

Android / Fire TV (Kotlin)
iOS / tvOS (Swift)
Web / React Native (JavaScript)
Roku (BrightScript)
React (React वेब ऐप्स के लिए पेवॉल UI)
React Native (डेटा क्लाइंट + नेटिव पेवॉल)
Flutter (Dart)
Web Component (Vue / Svelte / Angular / सादा HTML)

हर एक SDK को एक बार आपके apiKey, appId, आपके सर्वर के baseUrl, और साइन-इन उपयोगकर्ता के लिए एक स्थिर userId के साथ कॉन्फ़िगर करता है (हर जगह एक ही ID उपयोग करें ताकि एक्सेस उपयोगकर्ता के साथ सभी डिवाइस पर बना रहे)।

चरण 5 — एक्सेस जाँचें और लाइव हों

SDK कॉन्फ़िगर होने के बाद, आपका ऐप दो काम करता है:

लॉन्च पर, उपयोगकर्ता के पास क्या है यह जानें और उसी के अनुसार अनलॉक करें (Android गाइड में यह checkEntitlements() के रूप में दिखाया गया है; हर SDK में इसके समकक्ष है)।
खरीद के बाद, रसीद SubSovereign को सौंपें ताकि सर्वर उसे स्टोर से सर्वर-साइड रसीद सत्यापन के ज़रिए जाँचे और एक्सेस स्तर प्रदान करे — फिर दोबारा जाँचें और अनलॉक करें।

बस, इंटीग्रेशन तैयार है। शिप करने से पहले, एक त्वरित चेकलिस्ट:

सर्वर UK/EU होस्टिंग पर डिप्लॉय किया गया, माइग्रेशन चलाया गया, आपके ऐप से पहुँच योग्य।
ऐप बनाया गया; API key सुरक्षित रूप से संग्रहीत; ऐप आपके baseUrl की ओर इंगित है।
एक्सेस स्तर परिभाषित और हर उस स्टोर के वास्तविक उत्पादों से जुड़े जिन्हें आप सपोर्ट करते हैं।
आपके ऐप में स्टोर बिलिंग (Google Play / StoreKit / Amazon / Roku / Stripe) कार्यशील।
लॉन्च पर अधिकार जाँच; खरीद के बाद सर्वर-साइड रसीद सत्यापन; दोनों एक वास्तविक डिवाइस पर वास्तविक (सैंडबॉक्स) खरीद के साथ परीक्षित।
जहाँ आप इसे एकत्र करते हैं वहाँ GDPR सहमति दर्ज की गई।

आगे कहाँ जाएँ

मॉडल को गहराई से समझें: How SubSovereign works।
अपना प्लेटफ़ॉर्म कनेक्ट करें: ऊपर दी गई SDK गाइड।