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.
| Projekt | Cél | Fejlesztési port | Adatbázis |
|---|---|---|---|
| Api | Modulá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 le | 8084 | Modulonként külön MySQL-adatbázis (összesen 6) |
| LessonsApi | Lessons.church háttérrendszer | -- | Egyetlen lessons MySQL-adatbázis |
| AskApi | MI-alapú lekérdezőeszköz, amelyet az OpenAI működtet | -- | -- |
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
| Projekt | Keretrendszer | Fejlesztési port | Cél |
|---|---|---|---|
| B1Admin | React 19 + Vite + MUI 7 | 3101 | Gyülekezeti adminisztrációs felület |
| B1App | Next.js 16 + React 19 + MUI 7 | 3301 | Nyilvános, gyülekezeti tagoknak szóló alkalmazás |
| LessonsApp | Next.js 16 | 3501 | Lessons.church felhasználói felület |
| B1Transfer | React + Vite | -- | Adatimport/-export segédeszköz |
| BrochureSites | Statikus | -- | Statikus gyülekezeti szórólap-weboldalak |
Mobilalkalmazások
Minden mobilalkalmazás React Native-t használ Expo-val.
| Projekt | Cél | Fontos verziók |
|---|---|---|
| B1Checkin | Bejelentkező (check-in) kioszk alkalmazás | Expo |
| LessonsScreen | Android TV-s leckemegjelenítő | Expo |
| FreePlay | Tartalomlejátszás (TV operációs rendszeren is) | Expo |
| FreeShowRemote | Mobil távirányító a FreeShow-hoz | Expo |
Asztali alkalmazás
| Projekt | Technológiai háttér | Cél |
|---|---|---|
| FreeShow | Electron 37 + Svelte 3 + Vite | Prezentá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.
| Csomag | Cél | Használja |
|---|---|---|
@churchapps/helpers | Alapvető segédfüggvények és megosztott TypeScript-interfészek (DateHelper, ApiHelper, CurrencyHelper stb.) | Minden projekt |
@churchapps/apihelper | Express-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/apphelper | React-komponenskönyvtár almodulokkal a bejelentkezéshez, adományozáshoz, űrlapokhoz, markdownhoz és weboldal-készítéshez | Minden webalkalmazás |
@churchapps/content-providers | Harmadik féltől származó tartalomszolgáltatók absztrakciója (Lessons.church, Planning Center, Dropbox és mások) | Api, B1Admin, B1App, FreePlay |
@churchapps/integration-sdk | B1.church integrációs eszközkészlet: webhookok, REST-kliens, OAuth | Külső integrációfejlesztők |
@churchapps/texting | SMS-szolgáltatók absztrakciója | Api |
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
- Környezeti változók -- Állítsa be a
.envfájljait az API-khoz való kapcsolódáshoz - API helyi beállítása -- Állítsa be a backend API-t helyben