डेवलपर दस्तावेज़ीकरण

ChurchApps लगभग 20 ओपन-सोर्स प्रोजेक्ट्स का एक संग्रह है जो मिलकर एक पूर्ण चर्च प्रबंधन प्लेटफ़ॉर्म प्रदान करते हैं। प्रोजेक्ट्स में बैकएंड API, वेब एप्लिकेशन, मोबाइल ऐप्स, एक डेस्कटॉप एप्लिकेशन और साझा लाइब्रेरीज़ शामिल हैं -- सभी TypeScript में लिखे गए हैं। यह अनुभाग आपको स्थानीय विकास वातावरण स्थापित करने और योगदान शुरू करने के लिए आवश्यक सब कुछ प्रदान करता है।

आर्किटेक्चर एक नज़र में

प्रोजेक्ट्स स्वतंत्र रिपॉज़िटरीज़ हैं (मोनोरेपो नहीं)। साझा कोड npm पर @churchapps/* स्कोप के तहत प्रकाशित किया जाता है और नियमित डिपेंडेंसीज़ के रूप में उपयोग किया जाता है। इसका मतलब है कि आप पूरे इकोसिस्टम को क्लोन किए बिना एक ही प्रोजेक्ट पर काम कर सकते हैं।

मुख्य विशेषताएँ:

• भाषा: पूरे में TypeScript
• बैकएंड: Node.js / Express API, 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 को स्थानीय रूप से चलाना
• मोबाइल ऐप्स -- B1Mobile और अन्य Expo ऐप्स का निर्माण
• साझा लाइब्रेरीज़ -- Helpers, ApiHelper, और AppHelper के साथ काम करना
• डिप्लॉयमेंट -- API, वेब ऐप्स, और मोबाइल ऐप्स को डिप्लॉय करना

समुदाय और संसाधन

संसाधन	लिंक
GitHub संगठन	github.com/ChurchApps
इश्यू ट्रैकर	ChurchAppsSupport Issues
Slack समुदाय	Slack से जुड़ें

सुझाव

योगदान शुरू करने का सबसे तेज़ तरीका एक वेब ऐप (जैसे B1Admin) चुनना, इसे स्टेजिंग API की ओर इंगित करना, और फ़्रंटएंड परिवर्तन करना शुरू करना है। कोई डेटाबेस या API सेटअप आवश्यक नहीं है।