Firebase बैकएंड (डेटाबेस + अकाउंट)

1यह आपके ऐप को क्या देता है#

आम तौर पर आपका बनाया ऐप डेटा सिर्फ़ उसी फ़ोन पर रखता है जिस पर वह चल रहा है। Firebase चालू करने से ऐप को एक मुफ़्त क्लाउड डेटाबेस मिलता है, जिससे वही डेटा किसी भी डिवाइस से दिखता है और (अगर आप चाहें) लोग ईमेल + पासवर्ड से साइन अप कर सकते हैं।

यह अपनी-ख़ुद-की व्यवस्था है - ऐप आपके मुफ़्त Firebase प्रोजेक्ट से जुड़ता है। AppMint कुछ होस्ट नहीं करता और आपसे कोई अतिरिक्त शुल्क नहीं लेता। आप एक बार कॉन्फ़िग पेस्ट करते हैं; सारा कोड AI लिखता है।

आपको कुछ भी लिखने या डिज़ाइन करने की ज़रूरत नहीं है - न टेबल, न स्कीमा, न SQL। Firebase और AppMint आपके ऐप के विवरण से सब खुद समझ लेते हैं।

2Firebase प्रोजेक्ट बनाएँ (5 मिनट, मुफ़्त)#

कंप्यूटर पर करना सबसे आसान है:

1. console.firebase.google.com खोलें और किसी भी Google अकाउंट से साइन इन करें।
2. 'Add project' दबाएँ → कोई भी नाम दें → 'Continue' दबाते जाएँ → Google Analytics छोड़ दें → 'Create project'। लगभग 30 सेकंड रुकें।
3. बाएँ मेन्यू में: Databases & Storage → Firestore → 'Create database'।

• अपने यूज़र के पास की जगह चुनें (इसे बाद में बदला नहीं जा सकता)।
• 'Start in production mode' चुनें - 'test mode' नहीं। टेस्ट मोड 30 दिन बाद अपने-आप ख़त्म हो जाता है और आपका ऐप चुपचाप काम करना बंद कर देगा।

1. बाएँ मेन्यू में: Security → Authentication → 'Get started' → 'Sign-in method' टैब:

• 'Email/Password' चालू करें (पहला टॉगल ON करें, सेव करें)।
• 'Anonymous' भी चालू करें (नीचे स्क्रॉल करें, ON करें, सेव करें) - मेहमान/लीडरबोर्ड ऐप के लिए ज़रूरी।

बस इतना ही। कोई स्कीमा डिज़ाइन नहीं करना है।

Firebase Console खोलें →

3अपना वेब कॉन्फ़िग कॉपी करें#

अब भी Firebase Console में:

1. ⚙️ गियर (ऊपर बाईं ओर) दबाएँ → 'Project settings'।
2. 'Your apps' तक स्क्रॉल करें → </> (वेब) आइकन दबाएँ।
3. ऐप को कोई भी उपनाम दें → 'Register app' दबाएँ ('Firebase Hosting' छोड़ दें)।
4. आपको एक कोड स्निपेट दिखेगा। सिर्फ़ firebaseConfig ऑब्जेक्ट कॉपी करें - शुरुआती { से लेकर आखिरी } तक सब कुछ।

वेब API कुंजी सार्वजनिक होने के लिए ही बनी है - आपके डेटा की सुरक्षा चरण 6 के सिक्योरिटी रूल्स से होती है, कुंजी छिपाने से नहीं।

const firebaseConfig = {
  apiKey: "AIza...",
  authDomain: "my-app.firebaseapp.com",
  projectId: "my-app",
  storageBucket: "my-app.appspot.com",
  messagingSenderId: "123456789",
  appId: "1:123:web:abc"
};   ← copy the { ... } part

4इसे AppMint में पेस्ट करें (एक बार)#

AI Studio खोलें → Settings → 'BACKEND - FIREBASE (OPTIONAL)' तक स्क्रॉल करें:

1. कॉपी किया हुआ firebaseConfig बड़े टेक्स्ट बॉक्स में पेस्ट करें।
2. 'Enable Firebase backend' स्विच चालू करें।
3. 'Save Firebase config' दबाएँ। आपको 'Saved Firebase project: <your-project-id>' दिखना चाहिए।

यह आपके डिवाइस पर एन्क्रिप्ट करके रखा जाता है और आपके बनाए हर ऐप में दोबारा इस्तेमाल होता है - आपको यह सिर्फ़ एक बार करना है।

5अपने ऐप के बारे में बताएँ - बाकी AI कर देगा#

बस सादी भाषा में बताइए कि आपको क्या चाहिए। आप जो माँगते हैं, उसके आधार पर AI तय करता है कि लॉगिन स्क्रीन जोड़नी है या नहीं:

• 'एक नोट्स ऐप जिसमें हर यूज़र अपने नोट्स सेव करे' → AI साइन अप/लॉगिन + निजी नोट्स बनाता है।
• 'टैप गेम के लिए ग्लोबल लीडरबोर्ड, कोई अकाउंट नहीं' → AI चुपचाप मेहमान साइन-इन, सार्वजनिक स्कोर, और बिना लॉगिन UI के बनाता है।
• 'एक साझा बुलेटिन बोर्ड जिस पर हर कोई पोस्ट कर सके' → AI गेस्ट साइन इन इस्तेमाल करता है, लॉगिन स्क्रीन नहीं बनाता।

अगर डिवाइस ऑफ़लाइन है या कॉन्फ़िग नहीं है, तो ऐप अपने आप सिर्फ़-फ़ोन स्टोरेज इस्तेमाल करने लगता है, ताकि वह कभी क्रैश न हो।

6सिक्योरिटी रूल्स लागू करें (ज़रूरी)#

इस चरण के बिना ऐप जब भी पढ़ने या लिखने की कोशिश करेगा, उसे 'permission denied' त्रुटियाँ मिलेंगी। रूल्स AI आपके लिए लिखता है; आपको बस उन्हें पेस्ट करना है।

1. अपना ऐप बन जाने के बाद Code व्यू खोलें (या डाउनलोड किया प्रोजेक्ट अनज़िप करें) और 'firestore.rules' नाम की फ़ाइल ढूँढें। उसे खोलें और पूरा टेक्स्ट कॉपी करें।
2. Firebase Console में: Databases & Storage → Firestore → 'Rules' टैब → 'Edit rules' दबाएँ → जो लिखा है उसे मिटाएँ → AI के दिए रूल्स पेस्ट करें → 'Publish' दबाएँ।

हर ऐप के लिए यह एक बार करें। रूल्स आपके ऐप के हिसाब से बने होते हैं - वे यूज़र को सिर्फ़ अपना डेटा लिखने देते हैं, जबकि लीडरबोर्ड सबके लिए पढ़ने लायक रहते हैं।

7जाँचें कि यह काम कर रहा है#

APK इंस्टॉल करने के बाद एक झटपट जाँच:

1. अपने फ़ोन पर ऐप खोलें और कोई एक ऐसा काम करें जिससे डेटा सेव होना चाहिए (नोट बनाएँ, स्कोर सबमिट करें, आदि)।
2. वापस Firebase Console में: Databases & Storage → Firestore → 'Data' टैब → आपको एक नया कलेक्शन (जैसे 'notes' या 'scores') दिखना चाहिए जिसमें आपका अभी डाला हुआ डेटा हो।
3. Security → Authentication → 'Users' टैब → अगर आपका ऐप लॉगिन इस्तेमाल करता है, तो आपका अकाउंट यहाँ दिखना चाहिए।

अगर कुछ नहीं दिखता: अगले चरण में बताए 3 सबसे आम कारण जाँचें।

8अगर कुछ काम न करे#

सबसे आम त्रुटियाँ:

• 'permission-denied' या डेटा सेव नहीं हो रहा → आप चरण 6 (रूल्स प्रकाशित करें) भूल गए।
• साइन-अप/लॉगिन पर 'auth/operation-not-allowed' → आपने चरण 2 में Email/Password चालू नहीं किया।
• गेस्ट/लीडरबोर्ड ऐप में 'auth/operation-not-allowed' → आपने चरण 2 में Anonymous चालू नहीं किया।
• Google साइन-इन पर 'auth/operation-not-allowed' → आपने Google चालू नहीं किया और अपना SHA-256 फ़िंगरप्रिंट भी पेस्ट नहीं किया (नीचे 'Add Google Sign-In' चरण देखें)।
• पेस्ट किया गया कॉन्फ़िग अस्वीकार हुआ ('Couldn't find a { ... } config object') → पूरा { ... } ब्लॉक कर्ली ब्रैकेट समेत पेस्ट करें, सिर्फ़ अंदर का हिस्सा नहीं।

बनाए गए ऐप में साइन-इन के ये तरीके चलते हैं: Email/Password, Anonymous (गेस्ट), Google Sign-In (नेटिव Credential Manager से) और Phone/SMS (reCAPTCHA से)। Facebook साइन-इन चलता है: विज़ार्ड के Integrate चरण में अपना Facebook App ID और Client Token डालें (लॉगिन ब्राउज़र टैब में खुलता है)। Apple/Twitter साइन-इन अब भी नहीं चलता - इनके लिए OAuth पॉप-अप चाहिए, जिन्हें Google Android WebView के अंदर ब्लॉक करता है।

9Google Sign-In जोड़ें (वैकल्पिक)#

बनाए गए ऐप Android के नेटिव Credential Manager से Google Sign-In इस्तेमाल कर सकते हैं - यह WebView के अंदर काम करता है (OAuth पॉप-अप की तरह नहीं)। हर ऐप के लिए एक बार का सेटअप:

1. Firebase Console → Security → Authentication → 'Sign-in method' टैब → 'Google' चालू करें। सेव करें।
2. Firebase Console → ⚙ Project settings → 'Your apps' → अगर आपने अभी तक कोई Android ऐप रजिस्टर नहीं किया है, तो 'Add app' दबाएँ → Android → अपना पैकेज नाम डालें (वही जो आप AppMint में इस्तेमाल करेंगे)।
3. AppMint में अपना APK एक बार बिल्ड करें। डाउनलोड हुई '<appname>_signkey_info.txt' फ़ाइल खोलें - सबसे ऊपर आपको SHA-1 और SHA-256 फ़िंगरप्रिंट दिखेंगे।
4. Firebase Console में वापस → ⚙ Project settings → Your apps → Android app → 'Add fingerprint' → SHA-1 पेस्ट करें, फिर SHA-256 के लिए दोबारा 'Add fingerprint' दबाएँ। 'Save' दबाएँ। Google Sign-In SHA-1 जाँचता है: सिर्फ़ SHA-256 होने पर वह 'No credentials available' के साथ विफल होता है। (यह हर ऐप के लिए सिर्फ़ एक बार करना है - आगे के हर बिल्ड में वही साइनिंग कुंजी इस्तेमाल होती है।)
5. Google Play पर प्रकाशित कर रहे हैं? Play आपके ऐप को अपनी कुंजी से दोबारा साइन करता है, इसलिए Play से इंस्टॉल का फ़िंगरप्रिंट अलग होता है। Play Console → आपका ऐप → Test and release → App integrity → 'App signing key certificate' के नीचे से SHA-1 और SHA-256 कॉपी करें और दोनों को उसी Firebase Android ऐप में जोड़ें। ऐसा न करने पर साइन-इन APK से तो चलता है पर Play से इंस्टॉल करने वाले सबके लिए विफल हो जाता है।
6. Firebase Console → ⚙ Project settings → General → 'Your apps' तक स्क्रॉल करें → Web SDK सेक्शन ढूँढें → 'Web client ID' कॉपी करें (यह .apps.googleusercontent.com पर ख़त्म होता है)।
7. AppMint Settings खोलें → इसे 'GOOGLE SIGN-IN - OAUTH WEB CLIENT ID' में पेस्ट करें। सेव करें।
8. अपना ऐप दोबारा बिल्ड करें। अब Google Sign-In काम करता है।

10फ़ोन / SMS साइन-इन जोड़ें (वैकल्पिक)#

Phone Auth, Firebase Web SDK + reCAPTCHA इस्तेमाल करता है (WebView के अंदर काम करता है)। यूज़र अपना फ़ोन नंबर डालता है, 'I'm not a robot' जाँच पर टैप करता है, SMS कोड पाता है और उसे डालता है।

सेटअप:

1. Firebase Console → Security → Authentication → 'Sign-in method' टैब → 'Phone' चालू करें। Save करें।
2. SHA की ज़रूरत नहीं (हम reCAPTCHA वेरिफ़िकेशन इस्तेमाल करते हैं, Play Integrity नहीं)।
3. बस अपने ऐप के विवरण में AI से फ़ोन साइन-इन माँग लें (जैसे 'यूज़र अपने फ़ोन नंबर से साइन इन करते हैं')।

⚠️ बिलिंग: असली वेरिफ़िकेशन SMS भेजने के लिए अब Blaze (पे-एज़-यू-गो) प्लान ज़रूरी है - मुफ़्त Spark प्लान में अब मुफ़्त SMS कोटा नहीं मिलता। Firebase Console → ⚙ Project settings → Usage and billing में अपग्रेड करें। Blaze पर Firebase Authentication रोज़ाना 3,000 वेरिफ़िकेशन SMS तक की इजाज़त देता है; SMS की कीमत देश के हिसाब से अलग होती है।

💡 बिलिंग या असली SMS के बिना टेस्ट करने के लिए: Authentication → Settings → 'Phone numbers for testing' में आप एक तय टेस्ट नंबर + कोड जोड़ सकते हैं (कोई SMS नहीं भेजा जाता)।

Firebase Auth कोटा और कीमतें →

11लागत - क्या उम्मीद करें#

Firebase का मुफ़्त 'Spark' प्लान ज़्यादातर शौकिया ऐप के लिए काफ़ी है। रोज़ मुफ़्त:

• 50,000 डॉक्यूमेंट रीड
• 20,000 राइट
• 20,000 डिलीट
• कुल 1 GiB स्टोरेज
• 10 GiB / माह आउटबाउंड नेटवर्क

संदर्भ के लिए: 100 सक्रिय यूज़र वाला छोटा नोट्स ऐप रोज़ लगभग 5,000 रीड करता है। एक वायरल गेम का लीडरबोर्ड एक घंटे में 50k रीड पार कर सकता है।

⚠️ बजट अलर्ट सेट करें: Google Cloud Console → Billing → Budgets & alerts → 'Alert me at $1' सेट करें। इससे आप सुरक्षित रहते हैं और जैसे ही इस्तेमाल पर पैसे लगने लगेंगे, Firebase आपको ईमेल भेज देगा।

बजट अलर्ट सेट करें →