मुख्य सामग्री पर जाएं

पर्यावरण चर

हर ChurchApps प्रोजेक्ट स्थानीय कॉन्फ़िगरेशन के लिए .env फ़ाइल का उपयोग करता है। हर प्रोजेक्ट में एक नमूना फ़ाइल होती है, जिसे आप कॉपी करके अपनी ज़रूरत के अनुसार बदलते हैं। इस पृष्ठ में API, वेब ऐप और मोबाइल ऐप के पर्यावरण चर दिए गए हैं, साथ ही यह भी बताया गया है कि डेमो और लोकल API लक्ष्य के बीच कैसे चुनाव करें।

शुरू करने से पहले

  • अपने प्रोजेक्ट की पूर्वापेक्षाएँ इंस्टॉल करें
  • वह प्रोजेक्ट रिपॉज़िटरी क्लोन करें जिस पर आप काम करना चाहते हैं
  • प्रोजेक्ट अवलोकन देखें ताकि समझ सकें कि आपके प्रोजेक्ट को कौन-से API मॉड्यूल चाहिए

सामान्य पैटर्न​

  1. प्रोजेक्ट रूट में dotenv.sample.txt या .env.sample खोजें।
  2. उसे .env नाम से कॉपी करें।
  3. ज़रूरत के अनुसार मान संपादित करें।
# .env.sample वाले प्रोजेक्ट का उदाहरण
cp .env.sample .env

# dotenv.sample.txt वाले प्रोजेक्ट का उदाहरण
cp dotenv.sample.txt .env
चेतावनी

.env फ़ाइलों को कभी भी वर्ज़न कंट्रोल में कमिट न करें। इनमें डेटाबेस क्रेडेंशियल, API कुंजियाँ और JWT सीक्रेट जैसी गोपनीय जानकारी होती है। सभी ChurchApps प्रोजेक्ट्स में .env को .gitignore में शामिल किया गया है, फिर भी कमिट करने से पहले अच्छी तरह जाँच लें।

API लक्ष्य चुनना​

सबसे महत्वपूर्ण निर्णय यह है कि आपका फ़्रंटएंड API कॉल किस पते पर भेजे। इसके दो विकल्प हैं:

विकल्प 1: डेमो API (फ़्रंटएंड डेवलपमेंट के लिए अनुशंसित)​

साझा डेमो वातावरण का उपयोग करें। इसके लिए किसी लोकल API या डेटाबेस सेटअप की ज़रूरत नहीं है। यह main शाखा का नवीनतम कोड चलाता है, और इसका नमूना डेटा हर रात फिर से भरा जाता है।

# बेस URL पैटर्न
https://api.demo.churchapps.org/{module}

# मॉड्यूल URL के उदाहरण
https://api.demo.churchapps.org/membership
https://api.demo.churchapps.org/attendance
https://api.demo.churchapps.org/content
https://api.demo.churchapps.org/giving
https://api.demo.churchapps.org/messaging
https://api.demo.churchapps.org/doing
चेतावनी

स्टेजिंग वातावरण (api.staging.churchapps.org, api.staging.lessons.church और संबंधित होस्ट) बंद किया जा चुका है। कुछ नमूना .env फ़ाइलों में अब भी स्टेजिंग URL हो सकते हैं; उन्हें इस पृष्ठ पर दिए डेमो या लोकल मानों से बदल दें। अब कोई साझा गैर-प्रोडक्शन Lessons API उपलब्ध नहीं है -- जब आपको एक चाहिए, तब LessonsApi को लोकली चलाएँ (यह पोर्ट 8090 पर सुनता है)।

विकल्प 2: लोकल API​

Api प्रोजेक्ट को अपनी मशीन पर चलाएँ। इसके लिए MySQL 8.0+ चाहिए, जिसमें हर मॉड्यूल के लिए डेटाबेस बने हों। देखें API लोकल सेटअप मार्गदर्शिका।

# बेस URL पैटर्न
http://localhost:8084/{module}

# मॉड्यूल URL के उदाहरण
http://localhost:8084/membership
http://localhost:8084/attendance
http://localhost:8084/content
http://localhost:8084/giving
http://localhost:8084/messaging
http://localhost:8084/doing

API पर्यावरण चर​

मुख्य Api प्रोजेक्ट (.env.sample) में सबसे अधिक कॉन्फ़िगरेशन है। यहाँ मुख्य वेरिएबल दिए गए हैं:

साझा सेटिंग्स​

वेरिएबलविवरणउदाहरण
ENVIRONMENTरनटाइम वातावरणdev
SERVER_PORTलोकल डेव सर्वर के लिए HTTP पोर्ट8084
ENCRYPTION_KEYसंवेदनशील डेटा के लिए 192-बिट एन्क्रिप्शन कुंजीaSecretKeyOfExactly192BitsLength
JWT_SECRETJSON Web Tokens पर हस्ताक्षर करने का सीक्रेटjwt-secret-dev
FILE_STOREअपलोड की गई फ़ाइलें कहाँ संग्रहीत हों (disk या s3)disk
CORS_ORIGINअनुमत CORS ऑरिजिन (लोकल डेव के लिए *)*

डेटाबेस कनेक्शन​

एक ही बेस URL API को MySQL से जोड़ता है। API इसी बेस से हर मॉड्यूल के लिए एक अलग डेटाबेस तय करता है (/membership, /attendance, /content, /giving, /messaging, /doing, /reporting)।

वेरिएबलउदाहरण
API_DATABASE_URLmysql://root:password@localhost:3306
सुझाव

root:password को अपने वास्तविक MySQL क्रेडेंशियल से बदलें। API चलाने से पहले हर मॉड्यूल का डेटाबेस मौजूद होना चाहिए। सभी मॉड्यूल का स्कीमा बनाने के लिए npm run initdb का उपयोग करें, या केवल एक मॉड्यूल के लिए npm run initdb:membership चलाएँ।

WebSocket सेटिंग्स​

वेरिएबलविवरणउदाहरण
SOCKET_PORTWebSocket सर्वर का पोर्ट8087
SOCKET_URLवह WebSocket URL जिससे क्लाइंट कनेक्ट होते हैंws://localhost:8087

वेब ऐप पर्यावरण चर​

B1Admin (React + Vite)​

नमूना फ़ाइल: .env.sample

वेरिएबलविवरणउदाहरण (डेमो)
REACT_APP_STAGEवातावरण का नामdemo
PORTडेव सर्वर का पोर्ट3101
REACT_APP_API_BASEसभी ChurchApps API के लिए एकल बेस URL (/membership, /attendance, /content, /giving, /messaging, /doing, /reporting अपने आप जोड़ दिए जाते हैं)https://api.demo.churchapps.org
REACT_APP_CONTENT_ROOTकंटेंट डिलीवरी URLhttps://democontent.churchapps.org
REACT_APP_GOOGLE_ANALYTICSGoogle Analytics ID (वैकल्पिक)UA-123456789-1

लोकल API डेवलपमेंट के लिए, बेस URL को अपने लोकल स्टैक की ओर इंगित करें:

REACT_APP_API_BASE=http://localhost:8084

B1App (Next.js)​

नमूना फ़ाइल: .env.sample

वेरिएबलविवरणउदाहरण (डेमो)
NEXT_PUBLIC_API_BASEसभी ChurchApps API के लिए एकल बेस URL (/membership, /attendance, /content, /giving, /messaging, /doing, /reporting अपने आप जोड़ दिए जाते हैं)https://api.demo.churchapps.org
NEXT_PUBLIC_CONTENT_ROOTकंटेंट डिलीवरी URLhttps://democontent.churchapps.org
NEXT_PUBLIC_GOOGLE_ANALYTICSGoogle Analytics ID (वैकल्पिक)UA-123456789-1
जानकारी

Next.js में, जो भी पर्यावरण चर ब्राउज़र में उपलब्ध होना चाहिए, उस पर NEXT_PUBLIC_ उपसर्ग (prefix) होना अनिवार्य है। केवल सर्वर पर उपयोग होने वाले वेरिएबल को इस उपसर्ग की ज़रूरत नहीं होती।

LessonsApp (Next.js)​

नमूना फ़ाइल: dotenv.sample.txt

वेरिएबलविवरणउदाहरण (लोकल LessonsApi)
STAGEवातावरण का चरण (लोकल डेवलपमेंट के लिए खाली छोड़ें या dev रखें)dev
NEXT_PUBLIC_LESSONS_APILessons API URLhttp://localhost:8090
NEXT_PUBLIC_CONTENT_ROOTकंटेंट डिलीवरी URLhttp://localhost:8090/content
NEXT_PUBLIC_API_BASEसाइन-इन के लिए उपयोग होने वाला ChurchApps API बेस (केवल तभी लागू होता है जब STAGE खाली हो या dev हो)https://api.demo.churchapps.org

मोबाइल ऐप पर्यावरण चर​

B1Checkin (React Native / Expo)​

नमूना फ़ाइल: dotenv.sample.txt

वेरिएबलविवरणउदाहरण
EXPO_PUBLIC_STAGEतय करता है कि ऐप किस API सेट से कनेक्ट होगा: dev (लोकल API http://127.0.0.1:8084 पर), staging, या prod (सेट न होने पर डिफ़ॉल्ट)dev

B1Checkin केवल Membership और Attendance API मॉड्यूल तथा कंटेंट डिलीवरी URL का उपयोग करता है। हर चरण के लिए उनके पते src/helpers/EnvironmentHelper.ts में सेट हैं।

जानकारी

Expo केवल EXPO_PUBLIC_ से शुरू होने वाले वेरिएबल ही ऐप बंडल में शामिल करता है। .env बदलने के बाद yarn start --reset-cache से डेव सर्वर फिर से शुरू करें।


त्वरित संदर्भ: नमूना फ़ाइलों के स्थान​

प्रोजेक्टनमूना फ़ाइल
Api.env.sample
B1Admin.env.sample
B1App.env.sample
B1Checkindotenv.sample.txt
LessonsAppdotenv.sample.txt
AskApidotenv.sample.txt