Ugrás a fő tartalomra

Projektáttekintés

A ChurchApps körülbelül 20 önálló tárolóból (repository) áll, amelyek mindegyike a ChurchApps GitHub szervezet alatt érhető el. Ez az oldal kategóriák szerint rendezve tartalmazza az összes projekt teljes leltárát, valamint azok keretrendszereit, portjait és kapcsolatait.

Mielőtt elkezdené

  • Telepítse a előfeltételeketahhoz a projektkategóriához, amellyel dolgozni szeretne

Backend API-k​

Minden API Node.js, Express és TypeScript segítségével készült, és a Serverless Framework révén AWS Lambdára van telepítve.

ProjektCélFejlesztési portAdatbázis
ApiModuláris monolit alapú főrendszer, amely a tagságot, a jelenlétet, a tartalmat, az adományozást, az üzenetküldést és a feladatokat (doing) fedi le8084Modulonként külön MySQL-adatbázis (összesen 6)
LessonsApiLessons.church háttérrendszer--Egyetlen lessons MySQL-adatbázis
AskApiMI-alapú lekérdezőeszköz, amelyet az OpenAI működtet----
info

A fő Api projekt moduláris monolit. Minden modulnak (tagság, jelenlét, tartalom, adományozás, üzenetküldés, feladatok) saját adatbázisa van, és olyan almappán érhető el, mint például /membership vagy /giving. Éles környezetben ezek külön Lambda-függvényekként jelennek meg az API Gateway mögött.

Webalkalmazások​

ProjektKeretrendszerFejlesztési portCél
B1AdminReact 19 + Vite + MUI 73101Gyülekezeti adminisztrációs felület
B1AppNext.js 16 + React 19 + MUI 73301Nyilvános, gyülekezeti tagoknak szóló alkalmazás
LessonsAppNext.js 163501Lessons.church felhasználói felület
B1TransferReact + Vite--Adatimport/-export segédeszköz
BrochureSitesStatikus--Statikus gyülekezeti szórólap-weboldalak

Mobilalkalmazások​

Minden mobilalkalmazás React Native-t használ Expo-val.

ProjektCélFontos verziók
B1CheckinBejelentkező (check-in) kioszk alkalmazásExpo
LessonsScreenAndroid TV-s leckemegjelenítőExpo
FreePlayTartalomlejátszás (TV operációs rendszeren is)Expo
FreeShowRemoteMobil távirányító a FreeShow-hozExpo

Asztali alkalmazás​

ProjektTechnológiai háttérCél
FreeShowElectron 37 + Svelte 3 + VitePrezentációs és istentiszteleti szoftver

Megosztott könyvtárak​

A megosztott kód az @churchapps névtér alatt került közzétételre az npm-en, és a fenti projektek szokásos npm-függőségként használják. Minden megosztott csomag egyetlen tárolóban található -- Packages --, amelyet Yarn-munkaterületként kezelnek és changesetekkel adnak ki.

CsomagCélHasználja
@churchapps/helpersAlapvető segédfüggvények és megosztott TypeScript-interfészek (DateHelper, ApiHelper, CurrencyHelper stb.)Minden projekt
@churchapps/apihelperExpress-szerver segédeszközök (hitelesítés, alap vezérlők, adatbázis-hozzáférés, AWS-integrációk)Minden API
@churchapps/apphelperReact-komponenskönyvtár almodulokkal a bejelentkezéshez, adományozáshoz, űrlapokhoz, markdownhoz és weboldal-készítéshezMinden webalkalmazás
@churchapps/content-providersHarmadik féltől származó tartalomszolgáltatók absztrakciója (Lessons.church, Planning Center, Dropbox és mások)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkB1.church integrációs eszközkészlet: webhookok, REST-kliens, OAuthKülső integrációfejlesztők
@churchapps/textingSMS-szolgáltatók absztrakciójaApi

A munkaterület beállításáért és a kiadási folyamatért lásd: Megosztott könyvtárak.

Projektek közötti kapcsolatok​

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

Minden frontend alkalmazás függ a @churchapps/helpers csomagtól. A webalkalmazások emellett az @churchapps/apphelper csomagoktól is függnek. Minden backend API mind a @churchapps/helpers, mind a @churchapps/apihelper csomagtól függ.

Következő lépések​