Lumipat sa pangunahing nilalaman

Pangkalahatang-ideya ng Proyekto

Ang ChurchApps ay binubuo ng humigit-kumulang 20 independiyenteng repositoryo, na bawat isa ay nakalathala sa ilalim ng ChurchApps GitHub organization. Ipinapakita ng pahinang ito ang kumpletong listahan ng lahat ng proyekto ayon sa kategorya, kasama ang kanilang mga framework, port, at ugnayan.

Bago Ka Magsimula

  • I-install ang mga prerequisite para sa kategorya ng proyektong nais mong pagtrabahuhan

Mga Backend API​

Ang lahat ng API ay ginawa gamit ang Node.js, Express, at TypeScript, at dine-deploy sa AWS Lambda sa pamamagitan ng Serverless Framework.

ProyektoLayuninDev PortDatabase
ApiPangunahing modular monolith na sumasaklaw sa membership, attendance, content, giving, messaging, at doing8084Hiwalay na MySQL database para sa bawat module (6 sa kabuuan)
LessonsApiBackend ng Lessons.church--Iisang lessons MySQL database
AskApiTool para sa AI query na pinapagana ng OpenAI----
Impormasyon

Ang pangunahing Api na proyekto ay isang modular monolith. Ang bawat module (membership, attendance, content, giving, messaging, doing) ay may sariling database at maa-access sa isang subpath gaya ng /membership o /giving. Sa production, ang mga ito ay inilalantad bilang hiwalay na Lambda function sa likod ng API Gateway.

Mga Web App​

ProyektoFrameworkDev PortLayunin
B1AdminReact 19 + Vite + MUI 73101Dashboard para sa administrasyon ng simbahan
B1AppNext.js 16 + React 19 + MUI 73301App para sa mga miyembro ng simbahan na nakaharap sa publiko
LessonsAppNext.js 163501Frontend ng Lessons.church
B1TransferReact + Vite--Utility para sa pag-import at pag-export ng data
BrochureSitesStatic--Mga static na brochure website ng simbahan

Mga Mobile App​

Ang lahat ng mobile app ay gumagamit ng React Native kasama ang Expo.

ProyektoLayuninMahahalagang Bersyon
B1CheckinApp ng check-in kioskExpo
LessonsScreenPagpapakita ng aralin sa Android TVExpo
FreePlayPag-playback ng content (kasama ang TV OS)Expo
FreeShowRemoteMobile remote control para sa FreeShowExpo

Desktop​

ProyektoStackLayunin
FreeShowElectron 37 + Svelte 3 + ViteSoftware para sa presentasyon at pagsamba

Mga Shared Library​

Ang shared na code ay nilalathala sa npm sa ilalim ng @churchapps scope at ginagamit bilang karaniwang npm dependency ng mga proyektong nabanggit sa itaas. Ang lahat ng shared package ay nasa iisang repositoryo -- Packages -- na pinamamahalaan bilang Yarn workspace at inilalabas gamit ang changesets.

PackageLayuninGinagamit Ng
@churchapps/helpersMga pangunahing utility at shared na TypeScript interface (DateHelper, ApiHelper, CurrencyHelper, atbp.)Lahat ng proyekto
@churchapps/apihelperMga utility para sa Express server (auth, base controller, database access, AWS integration)Lahat ng API
@churchapps/apphelperReact component library na may mga subpath module para sa login, donasyon, form, markdown, at pagbuo ng websiteLahat ng web app
@churchapps/content-providersAbstraksyon para sa mga third-party content provider (Lessons.church, Planning Center, Dropbox, at iba pa)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkIntegration toolkit ng B1.church: webhook, REST client, OAuthMga external na developer ng integration
@churchapps/textingAbstraksyon para sa SMS providerApi

Tingnan ang Shared Libraries para sa setup ng workspace at workflow ng paglalabas.

Ugnayan ng Mga Proyekto​

Frontend Apps              Shared Libraries           Backend APIs
-------------- ---------------- ------------
B1Admin ──────┐
B1App ──────┤ @churchapps/helpers ◄───── Api
LessonsApp ──────┼──► @churchapps/apphelper LessonsApi
FreeShow ──────┘ AskApi
@churchapps/apihelper ◄────┘

Ang lahat ng frontend app ay umaasa sa @churchapps/helpers. Karagdagang umaasa ang mga web app sa mga package ng @churchapps/apphelper. Ang lahat ng backend API ay umaasa sa @churchapps/helpers at @churchapps/apihelper.

Mga Susunod na Hakbang​