B1 Admin
B1Admin चर्च प्रशासन डैशबोर्ड है -- Vite और Material-UI के साथ बनाया गया एक React सिंगल-पेज एप्लिकेशन। चर्च स्टाफ इसका उपयोग लोगों, समूहों, उपस्थिति, दान, सामग्री और अधिक का प्रबंधन करने के लिए करते हैं।
शुरू करने से पहले
- Node.js 22+ और Git इंस्टॉल करें -- देखें पूर्वापेक्षाएँ
- अपना API लक्ष्य (स्टेजिंग या स्थानीय) कॉन्फ़िगर करें -- देखें पर्यावरण चर
सेटअप
1. रिपॉज़िटरी क्लोन करें
git clone https://github.com/ChurchApps/B1Admin.git
2. डिपेंडेंसी इंस्टॉल करें
cd B1Admin
npm install
3. पर्यावरण चर कॉन्फ़िगर करें
cp dotenv.sample.txt .env
.env खोलें और API एंडपॉइंट कॉन्फ़िगर करें। आप उन्हें स्टेजिंग API या अपने स्थानीय API इंस्टेंस पर पॉइंट कर सकते हैं।
4. डेव सर्वर शुरू करें
npm start
यह Vite डेव सर्वर लॉन्च करता है। ऐप हॉट मॉड्यूल रिप्लेसमेंट सक्षम के साथ ब्राउज़र में उपलब्ध होगा।
प्रमुख पर्यावरण चर
| चर | विवरण |
|---|---|
REACT_APP_STAGE | एनवायरनमेंट नाम (जैसे local, staging, prod) |
PORT | डेव सर्वर पोर्ट (डिफ़ॉल्ट: 3101) |
REACT_APP_*_API | प्रत्येक मॉड्यूल के लिए API एंडपॉइंट URL |
जानकारी
postinstall स्क्रिप्ट @churchapps/apphelper से लोकेल और CSS फ़ाइलें कॉपी करती है। यदि कंपोनेंट अनस्टाइल्ड दिखते हैं, तो npm run postinstall मैन्युअल रूप से चलाएँ।
प्रमुख कमांड
| कमांड | विवरण |
|---|---|
npm start | Vite डेव सर्वर शुरू करें |
npm run build | Vite के माध्यम से प्रोडक्शन बिल्ड |
npm run test | Playwright के साथ एंड-टू-एंड टेस्ट चलाएँ |
npm run lint | ऑटो-फिक्स के साथ ESLint चलाएँ |
तकनीकी स्टैक
- React 19 TypeScript के साथ
- Vite बिल्ड टूलिंग और डेव सर्वर के लिए
- Material-UI 7 UI कंपोनेंट के लिए
- React Query 5 सर्वर स्टेट के लिए
@churchapps/apphelper*साझा कंपोनेंट के लिए पैकेज
डिप्लॉयमेंट
प्रोडक्शन बिल्ड S3 + CloudFront पर डिप्लॉय किए जाते हैं:
npm run buildस्टैटिक एसेट जनरेट करता है- एसेट S3 बकेट पर सिंक किए जाते हैं
- नया संस्करण सर्व करने के लिए CloudFront इनवैलिडेशन ट्रिगर किया जाता है
सुझाव
विस्तृत डिप्लॉयमेंट निर्देशों के लिए, वेब ऐप डिप्लॉयमेंट गाइड देखें।