Pangkalahatang-tanaw ng Proyekto

Ang ChurchApps ay binubuo ng humigit-kumulang 20 independiyenteng mga repository, lahat ay naka-publish sa ilalim ng ChurchApps GitHub organization. Nagbibigay ang pahinang ito ng kompletong imbentaryo ng lahat ng proyekto na nakaayos ayon sa kategorya, kasama ang kanilang mga framework, port, at relasyon.

Bago Ka Magsimula

• I-install ang mga kinakailangan para sa kategorya ng proyektong gusto mong gawin

Mga Backend API

Lahat ng API ay binuo gamit ang Node.js, Express, at TypeScript, at naka-deploy sa AWS Lambda sa pamamagitan ng Serverless Framework.

Proyekto	Layunin	Dev Port	Database
Api	Core modular monolith na sumasaklaw sa membership, attendance, content, giving, messaging, at doing	8084	Hiwalay na MySQL database sa bawat module (6 sa kabuuan)
LessonsApi	Lessons.church backend	--	Isang lessons MySQL database
AskApi	AI query tool na pinapagana ng OpenAI	--	--

Impormasyon

Ang core na 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 tulad ng /membership o /giving. Sa production, ang mga ito ay nakabukas bilang hiwalay na Lambda function sa likod ng API Gateway.

Mga Web App

Proyekto	Framework	Dev Port	Layunin
B1Admin	React 19 + Vite + MUI 7	5173	Dashboard para sa administrasyon ng simbahan
B1App	Next.js 16 + React 19 + MUI 7	3301	Pampublikong app para sa mga miyembro ng simbahan
LessonsApp	Next.js 16	3501	Lessons.church frontend
B1Transfer	React + Vite	--	Utility para sa pag-import/export ng data
BrochureSites	Static	--	Mga static na brochure website ng simbahan

Mga Mobile App

Lahat ng mobile app ay gumagamit ng React Native na may Expo.

Proyekto	Layunin	Mga Pangunahing Bersyon
B1Mobile	App para sa mga miyembro ng simbahan para sa iOS at Android	Expo 54, React Native 0.81
B1Checkin	Kiosk app para sa check-in	Expo
LessonsScreen	Android TV display ng mga aralin	Expo
FreePlay	Content playback (kasama ang TV OS)	Expo
FreeShowRemote	Mobile remote control para sa FreeShow	Expo

Desktop

Proyekto	Stack	Layunin
FreeShow	Electron 37 + Svelte 3 + Vite	Software para sa presentasyon at pagsamba

Mga Shared Library

Ang shared code ay nai-publish sa npm sa ilalim ng @churchapps scope. Ginagamit ang mga ito bilang regular na npm dependency ng mga proyekto sa itaas.

Package	npm Name	Layunin	Ginagamit Ng
Helpers	@churchapps/helpers	Mga base utility (DateHelper, ApiHelper, CurrencyHelper, atbp.)	Lahat ng proyekto
ApiHelper	@churchapps/apihelper	Mga Express server utility (auth middleware, DB helper, AWS integration)	Lahat ng API
AppHelper	Workspace na may 6 na package	React component library	Lahat ng web app
ContentProviderHelper	@churchapps/content-provider-helper	YouTube, Vimeo, at lokal na content provider	FreeShow, FreePlay, Api

Mga Sub-package ng AppHelper

Ang AppHelper na proyekto ay isang monorepo workspace na nag-publish ng anim na package:

Package	npm Name
Core	@churchapps/apphelper
Login	@churchapps/apphelper-login
Donations	@churchapps/apphelper-donations
Forms	@churchapps/apphelper-forms
Markdown	@churchapps/apphelper-markdown
Website	@churchapps/apphelper-website

Mga Relasyon ng Proyekto

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

Lahat ng frontend app ay umaasa sa @churchapps/helpers. Ang mga web app ay karagdagang umaasa sa mga @churchapps/apphelper package. Lahat ng backend API ay umaasa sa parehong @churchapps/helpers at @churchapps/apihelper.

Mga Susunod na Hakbang

• Mga Environment Variable -- I-configure ang iyong mga .env file para kumonekta sa mga API
• Lokal na API Setup -- I-set up ang backend API nang lokal