Vai al contenuto principale

Panoramica del progetto

ChurchApps è composto da circa 20 repository indipendenti, ciascuno pubblicato sull'organizzazione GitHub ChurchApps. Questa pagina offre un inventario completo di tutti i progetti, organizzati per categoria, insieme ai loro framework, porte e relazioni.

Prima di iniziare

  • Installa i prerequisiti per la categoria di progetto su cui vuoi lavorare

API backend​

Tutte le API sono costruite con Node.js, Express e TypeScript, e vengono distribuite su AWS Lambda tramite Serverless Framework.

ProgettoScopoPorta di sviluppoDatabase
ApiMonolite modulare principale che copre membership, presenze, contenuti, donazioni, messaggistica e attività8084Database MySQL separato per modulo (6 in totale)
LessonsApiBackend di Lessons.church--Singolo database MySQL lessons
AskApiStrumento di interrogazione basato sull'IA, alimentato da OpenAI----
Info

Il progetto principale Api è un monolite modulare. Ogni modulo (membership, presenze, contenuti, donazioni, messaggistica, attività) ha il proprio database ed è accessibile a un sottopercorso come /membership o /giving. In produzione, questi sono esposti come funzioni Lambda separate dietro API Gateway.

Applicazioni web​

ProgettoFrameworkPorta di sviluppoScopo
B1AdminReact 19 + Vite + MUI 73101Dashboard di amministrazione della chiesa
B1AppNext.js 16 + React 19 + MUI 73301App pubblica per i membri della chiesa
LessonsAppNext.js 163501Frontend di Lessons.church
B1TransferReact + Vite--Utility di importazione/esportazione dei dati
BrochureSitesStatico--Siti web brochure statici per chiese

App mobili​

Tutte le app mobili usano React Native con Expo.

ProgettoScopoVersioni principali
B1CheckinApp chiosco per il check-inExpo
LessonsScreenVisualizzazione delle lezioni su Android TVExpo
FreePlayRiproduzione di contenuti (incluso il sistema operativo per TV)Expo
FreeShowRemoteTelecomando mobile per FreeShowExpo

Desktop​

ProgettoStackScopo
FreeShowElectron 37 + Svelte 3 + ViteSoftware per presentazioni e culto

Librerie condivise​

Il codice condiviso è pubblicato su npm sotto l'ambito @churchapps e utilizzato come normale dipendenza npm dai progetti sopra elencati. Tutti i pacchetti condivisi risiedono in un unico repository -- Packages -- gestito come workspace Yarn e rilasciato con changesets.

PacchettoScopoUtilizzato da
@churchapps/helpersUtility di base e interfacce TypeScript condivise (DateHelper, ApiHelper, CurrencyHelper, ecc.)Tutti i progetti
@churchapps/apihelperUtility per il server Express (autenticazione, controller di base, accesso al database, integrazioni AWS)Tutte le API
@churchapps/apphelperLibreria di componenti React con moduli a sottopercorso per login, donazioni, moduli, markdown e creazione di siti webTutte le app web
@churchapps/content-providersAstrazione per i fornitori di contenuti di terze parti (Lessons.church, Planning Center, Dropbox e altri)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkKit di strumenti per l'integrazione con B1.church: webhook, client REST, OAuthSviluppatori di integrazioni esterne
@churchapps/textingAstrazione per i fornitori di SMSApi

Consulta Librerie condivise per la configurazione del workspace e il flusso di rilascio.

Relazioni tra i progetti​

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

Tutte le app frontend dipendono da @churchapps/helpers. Le app web dipendono inoltre dai pacchetti @churchapps/apphelper. Tutte le API backend dipendono sia da @churchapps/helpers sia da @churchapps/apihelper.

Passaggi successivi​