Hopp til hovedinnhold

Prosjektoversikt

ChurchApps består av omtrent 20 uavhengige repositorier, som hver er publisert under ChurchApps GitHub-organisasjonen. Denne siden gir en fullstendig oversikt over alle prosjekter, organisert etter kategori, sammen med rammeverk, porter og relasjoner.

Før du begynner

Backend-API-er​

Alle API-er er bygget med Node.js, Express og TypeScript, og distribueres til AWS Lambda via Serverless Framework.

ProsjektFormålUtviklingsportDatabase
ApiKjernemonolitt med moduler for medlemskap, oppmøte, innhold, gaver, meldinger og oppgaver8084Egen MySQL-database per modul (6 totalt)
LessonsApiBackend for Lessons.church--Enkelt lessons-MySQL-database
AskApiAI-søkeverktøy drevet av OpenAI----
Info

Kjerneprosjektet Api er en modulær monolitt. Hver modul (medlemskap, oppmøte, innhold, gaver, meldinger og oppgaver) har sin egen database og er tilgjengelig på en underbane, for eksempel /membership eller /giving. I produksjon eksponeres disse som separate Lambda-funksjoner bak API Gateway.

Webapper​

ProsjektRammeverkUtviklingsportFormål
B1AdminReact 19 + Vite + MUI 73101Administrasjonsdashbord for menigheten
B1AppNext.js 16 + React 19 + MUI 73301Offentlig app for menighetsmedlemmer
LessonsAppNext.js 163501Frontend for Lessons.church
B1TransferReact + Vite--Verktøy for import og eksport av data
BrochureSitesStatisk--Statiske brosjyrenettsteder for menigheter

Mobilapper​

Alle mobilapper bruker React Native med Expo.

ProsjektFormålViktige versjoner
B1CheckinInnsjekkingsapp for kioskExpo
LessonsScreenVisning av leksjoner på Android TVExpo
FreePlayAvspilling av innhold (inkludert TV-operativsystemer)Expo
FreeShowRemoteMobil fjernkontroll for FreeShowExpo

Desktop​

ProsjektStakkFormål
FreeShowElectron 37 + Svelte 3 + VitePresentasjons- og gudstjenestesoftware

Delte biblioteker​

Delt kode publiseres til npm under @churchapps-scopet og brukes som vanlige npm-avhengigheter av prosjektene ovenfor. Alle delte pakker ligger i ett enkelt repositorium – Packages – som administreres som et Yarn-arbeidsområde og slippes med changesets.

PakkeFormålBrukes av
@churchapps/helpersGrunnleggende verktøy og delte TypeScript-grensesnitt (DateHelper, ApiHelper, CurrencyHelper osv.)Alle prosjekter
@churchapps/apihelperVerktøy for Express-server (autentisering, grunnkontrollere, databasetilgang, AWS-integrasjoner)Alle API-er
@churchapps/apphelperReact-komponentbibliotek med undermoduler for innlogging, donasjoner, skjemaer, markdown og nettstedbyggingAlle webapper
@churchapps/content-providersAbstraksjon for tredjeparts innholdsleverandører (Lessons.church, Planning Center, Dropbox m.fl.)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkVerktøykasse for B1.church-integrasjoner: webhooks, REST-klient, OAuthEksterne integrasjonsutviklere
@churchapps/textingAbstraksjon for SMS-leverandørerApi

Se Delte biblioteker for oppsett av arbeidsområdet og utgivelsesflyten.

Prosjektrelasjoner​

Frontend-apper             Delte biblioteker          Backend-API-er
-------------- ----------------- --------------
B1Admin ──────┐
B1App ──────┤ @churchapps/helpers ◄───── Api
LessonsApp ──────┼──► @churchapps/apphelper LessonsApi
FreeShow ──────┘ AskApi
@churchapps/apihelper ◄────┘

Alle frontend-apper er avhengige av @churchapps/helpers. Webapper er i tillegg avhengige av @churchapps/apphelper-pakkene. Alle backend-API-er er avhengige av både @churchapps/helpers og @churchapps/apihelper.

Neste steg​