डेवलपर दस्तावेज़
ChurchApps लगभग 20 ओपन-सोर्स प्रोजेक्ट्स का एक संग्रह है, जो मिलकर एक पूर्ण चर्च प्रबंधन प्लेटफ़ॉर्म प्रदान करते हैं। इन प्रोजेक्ट्स में बैकएंड API, वेब एप्लिकेशन, मोबाइल ऐप, एक डेस्कटॉप एप्लिकेशन और साझा लाइब्रेरी शामिल हैं -- ये सभी TypeScript में लिखे गए हैं। यह अनुभाग स्थानीय डेवलपमेंट वातावरण सेट करने और योगदान शुरू करने के लिए आवश्यक सब कुछ प्रदान करता है।
एक नज़र में आर्किटेक्चर
ये प्रोजेक्ट्स स्वतंत्र रिपॉज़िटरी हैं (मोनोरेपो नहीं)। साझा कोड @churchapps/* स्कोप के तहत npm पर प्रकाशित होता है और सामान्य निर्भरताओं के रूप में उपयोग होता है। इसका मतलब है कि आप पूरे इकोसिस्टम को क्लोन किए बिना एक ही प्रोजेक्ट पर काम कर सकते हैं।
मुख्य विशेषताएँ:
- भाषा: हर जगह TypeScript
- बैकएंड: Node.js / Express APIs, Serverless Framework के माध्यम से AWS Lambda पर डिप्लॉय
- वेब: React 19 (Vite और Next.js), Material-UI 7
- मोबाइल: Expo के साथ React Native
- डेटाबेस: MySQL 8.0, प्रति API मॉड्यूल एक डेटाबेस
इस अनुभाग में क्या है
- सेटअप -- स्थानीय डेवलपमेंट वातावरण, पूर्वापेक्षाएँ और कॉन्फ़िगरेशन
- पूर्वापेक्षाएँ -- आवश्यक टूल और सॉफ़्टवेयर
- प्रोजेक्ट अवलोकन -- सभी प्रोजेक्ट्स एक नज़र में
- पर्यावरण चर --
.envफ़ाइलें कॉन्फ़िगर करना
- API -- कोर API का स्थानीय सेटअप, डेटाबेस इनिशियलाइज़ेशन और मॉड्यूल संरचना
- वेब ऐप्स -- B1Admin, B1App और LessonsApp को स्थानीय रूप से चलाना
- मोबाइल ऐप्स -- B1Checkin और अन्य Expo ऐप्स बनाना
- साझा लाइब्रेरी -- Helpers, ApiHelper और AppHelper के साथ काम करना
- डिप्लॉयमेंट -- APIs, वेब ऐप्स और मोबाइल ऐप्स को डिप्लॉय करना
- FreePlay कंटेंट प्रोवाइडर -- अपनी लेसन लाइब्रेरी को FreePlay से एकीकृत करना
समुदाय और संसाधन
| संसाधन | लिंक |
|---|---|
| GitHub संगठन | github.com/ChurchApps |
| समस्या ट्रैकर | ChurchAppsSupport Issues |
| Slack समुदाय | Slack से जुड़ें |
योगदान शुरू करने का सबसे तेज़ तरीका है कि कोई वेब ऐप (जैसे B1Admin) चुनें, उसे साझा डेमो APIs की ओर इंगित करें, और फ़्रंटएंड में बदलाव करना शुरू करें। किसी डेटाबेस या API सेटअप की आवश्यकता नहीं है।