Przejdź do zawartości głównej

Przegląd projektu

ChurchApps składa się z około 20 niezależnych repozytoriów, każde opublikowane w organizacji ChurchApps na GitHubie. Ta strona zawiera pełny spis wszystkich projektów uporządkowanych według kategorii, wraz z ich frameworkami, portami i powiązaniami.

Zanim zaczniesz

Backendowe API​

Wszystkie API są zbudowane w oparciu o Node.js, Express i TypeScript i są wdrażane w AWS Lambda za pomocą Serverless Framework.

ProjektPrzeznaczeniePort deweloperskiBaza danych
ApiGłówny modularny monolit obejmujący członkostwo, frekwencję, treści, dary, komunikację i zadania8084Osobna baza MySQL dla każdego modułu (łącznie 6)
LessonsApiBackend Lessons.church--Pojedyncza baza MySQL lessons
AskApiNarzędzie do zapytań AI oparte na OpenAI----
informacja

Główny projekt Api to modularny monolit. Każdy moduł (membership, attendance, content, giving, messaging, doing) ma własną bazę danych i jest dostępny pod podścieżką, np. /membership lub /giving. W środowisku produkcyjnym są one udostępniane jako osobne funkcje Lambda za API Gateway.

Aplikacje webowe​

ProjektFrameworkPort deweloperskiPrzeznaczenie
B1AdminReact 19 + Vite + MUI 73101Panel administracyjny kościoła
B1AppNext.js 16 + React 19 + MUI 73301Publiczna aplikacja dla członków kościoła
LessonsAppNext.js 163501Frontend Lessons.church
B1TransferReact + Vite--Narzędzie do importu i eksportu danych
BrochureSitesStatyczny--Statyczne strony internetowe kościołów w formie broszur

Aplikacje mobilne​

Wszystkie aplikacje mobilne korzystają z React Native z Expo.

ProjektPrzeznaczenieKluczowe wersje
B1CheckinAplikacja kiosku do zameldowaniaExpo
LessonsScreenWyświetlanie lekcji na Android TVExpo
FreePlayOdtwarzanie treści (w tym na systemach TV)Expo
FreeShowRemoteMobilny pilot zdalnego sterowania dla FreeShowExpo

Aplikacje desktopowe​

ProjektStos technologicznyPrzeznaczenie
FreeShowElectron 37 + Svelte 3 + ViteOprogramowanie do prezentacji i nabożeństw

Biblioteki współdzielone​

Współdzielony kod jest publikowany w npm w zakresie @churchapps i jest używany jako zwykłe zależności npm przez wyżej wymienione projekty. Wszystkie współdzielone pakiety znajdują się w jednym repozytorium -- Packages -- zarządzanym jako workspace Yarn i wydawanym za pomocą changesets.

PakietPrzeznaczenieUżywany przez
@churchapps/helpersPodstawowe narzędzia i współdzielone interfejsy TypeScript (DateHelper, ApiHelper, CurrencyHelper itd.)Wszystkie projekty
@churchapps/apihelperNarzędzia serwera Express (uwierzytelnianie, kontrolery bazowe, dostęp do bazy danych, integracje AWS)Wszystkie API
@churchapps/apphelperBiblioteka komponentów React z podmodułami dla logowania, darowizn, formularzy, markdown i tworzenia stron internetowychWszystkie aplikacje webowe
@churchapps/content-providersAbstrakcja dostawców treści zewnętrznych (Lessons.church, Planning Center, Dropbox i inni)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkZestaw narzędzi do integracji B1.church: webhooki, klient REST, OAuthZewnętrzni deweloperzy integracji
@churchapps/textingAbstrakcja dostawców SMSApi

Informacje o konfiguracji workspace i procesie wydawania znajdziesz w Biblioteki współdzielone.

Powiązania między projektami​

Aplikacje frontendowe      Biblioteki współdzielone   Backendowe API
--------------------- ------------------------ --------------
B1Admin ──────┐
B1App ──────┤ @churchapps/helpers ◄───── Api
LessonsApp ──────┼──► @churchapps/apphelper LessonsApi
FreeShow ──────┘ AskApi
@churchapps/apihelper ◄────┘

Wszystkie aplikacje frontendowe zależą od @churchapps/helpers. Aplikacje webowe dodatkowo zależą od pakietów @churchapps/apphelper. Wszystkie backendowe API zależą zarówno od @churchapps/helpers, jak i @churchapps/apihelper.

Następne kroki​