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

B1 Admin

B1Admin चर्च प्रशासन डैशबोर्ड है -- Vite और Material-UI से बना एक React सिंगल-पेज एप्लिकेशन। चर्च स्टाफ इसका उपयोग लोगों, समूहों, उपस्थिति, दान, सामग्री और अन्य चीज़ों के प्रबंधन के लिए करता है।

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

सेटअप​

1. रिपॉज़िटरी क्लोन करें​

git clone https://github.com/ChurchApps/B1Admin.git

2. डिपेंडेंसी इंस्टॉल करें​

cd B1Admin
npm install

3. पर्यावरण चर कॉन्फ़िगर करें​

cp dotenv.sample.txt .env

.env खोलें और API endpoints कॉन्फ़िगर करें। आप उन्हें साझा डेमो API (https://api.demo.churchapps.org) या अपने लोकल API इंस्टेंस की ओर इंगित कर सकते हैं। सैंपल फ़ाइल में अभी भी रिटायर हो चुके staging URLs सूचीबद्ध हो सकते हैं; उन्हें बदल दें।

4. डेव सर्वर शुरू करें​

npm start

यह Vite dev server लॉन्च करता है। ऐप hot module replacement सक्षम के साथ आपके ब्राउज़र में उपलब्ध होगा।

मुख्य पर्यावरण चर​

चरविवरण
REACT_APP_STAGEपर्यावरण का नाम (जैसे सैंपल फ़ाइल में demo, prod, या selfhost)
PORTडेव सर्वर पोर्ट (डिफ़ॉल्ट: 3101)
REACT_APP_*_APIहर मॉड्यूल के लिए API endpoint URLs
जानकारी

postinstall स्क्रिप्ट @churchapps/apphelper से locale और CSS फ़ाइलें कॉपी करती है। अगर कंपोनेंट बिना स्टाइल के दिखें, तो npm run postinstall मैन्युअल रूप से चलाएं।

मुख्य कमांड​

कमांडविवरण
npm startVite dev server शुरू करें
npm run buildVite के माध्यम से प्रोडक्शन बिल्ड
npm run testPlaywright से end-to-end टेस्ट चलाएं
npm run lintauto-fix के साथ ESLint चलाएं

टेक स्टैक​

  • React 19 TypeScript के साथ
  • Vite बिल्ड टूलिंग और डेव सर्वर के लिए
  • Material-UI 7 UI कंपोनेंट के लिए
  • React Query 5 सर्वर स्टेट के लिए
  • @churchapps/apphelper* पैकेज साझा कंपोनेंट के लिए

डिप्लॉयमेंट​

प्रोडक्शन बिल्ड S3 + CloudFront पर डिप्लॉय होते हैं:

  1. npm run build स्टैटिक एसेट्स बनाता है
  2. एसेट्स एक S3 bucket में सिंक होते हैं
  3. नया संस्करण परोसने के लिए CloudFront invalidation ट्रिगर होता है
सुझाव

विस्तृत डिप्लॉयमेंट निर्देशों के लिए Web App Deployment गाइड देखें।