Zum Hauptinhalt springen

Projektübersicht

ChurchApps besteht aus etwa 20 unabhängigen Repositories, die jeweils unter der ChurchApps-GitHub-Organisation veröffentlicht werden. Diese Seite bietet ein vollständiges Verzeichnis aller Projekte, nach Kategorien geordnet, mit ihren Frameworks, Ports und Beziehungen.

Bevor Sie beginnen

  • Installieren Sie die Voraussetzungen für die Projektkategorie, an der Sie arbeiten möchten

Backend-APIs​

Alle APIs sind mit Node.js, Express und TypeScript entwickelt und werden über das Serverless Framework auf AWS Lambda bereitgestellt.

ProjektZweckDev-PortDatenbank
ApiZentraler modularer Monolith für Mitgliedschaft, Anwesenheit, Inhalte, Spenden, Nachrichten und Doing8084Separate MySQL-Datenbank pro Modul (insgesamt 6)
LessonsApiBackend für Lessons.church--Einzelne MySQL-Datenbank lessons
AskApiKI-Abfragetool auf Basis von OpenAI----
Info

Die Kern-Api ist ein modularer Monolith. Jedes Modul (Mitgliedschaft, Anwesenheit, Inhalte, Spenden, Nachrichten, Doing) hat seine eigene Datenbank und ist unter einem Unterpfad wie /membership oder /giving erreichbar. In der Produktion werden diese als separate Lambda-Funktionen hinter dem API Gateway bereitgestellt.

Web-Apps​

ProjektFrameworkDev-PortZweck
B1AdminReact 19 + Vite + MUI 73101Verwaltungs-Dashboard für Kirchen
B1AppNext.js 16 + React 19 + MUI 73301Öffentlich zugängliche App für Kirchenmitglieder
LessonsAppNext.js 163501Frontend für Lessons.church
B1TransferReact + Vite--Dienstprogramm für Datenimport und -export
BrochureSitesStatisch--Statische Prospekt-Websites für Kirchen

Mobile Apps​

Alle mobilen Apps verwenden React Native mit Expo.

ProjektZweckWichtige Versionen
B1CheckinCheck-in-Kiosk-AppExpo
LessonsScreenLektionsanzeige für Android TVExpo
FreePlayWiedergabe von Inhalten (einschließlich TV-Betriebssysteme)Expo
FreeShowRemoteMobile Fernbedienung für FreeShowExpo

Desktop​

ProjektStackZweck
FreeShowElectron 37 + Svelte 3 + VitePräsentations- und Gottesdienstsoftware

Gemeinsam genutzte Bibliotheken​

Gemeinsam genutzter Code wird unter dem Scope @churchapps in npm veröffentlicht und von den oben genannten Projekten als reguläre npm-Abhängigkeiten verwendet. Alle gemeinsamen Pakete befinden sich in einem einzigen Repository – Packages – und werden als Yarn-Workspace verwaltet und mit Changesets veröffentlicht.

PaketZweckVerwendet von
@churchapps/helpersGrundlegende Hilfsfunktionen und gemeinsame TypeScript-Schnittstellen (DateHelper, ApiHelper, CurrencyHelper usw.)Alle Projekte
@churchapps/apihelperHilfsfunktionen für den Express-Server (Authentifizierung, Basis-Controller, Datenbankzugriff, AWS-Integrationen)Alle APIs
@churchapps/apphelperReact-Komponentenbibliothek mit Untermodulen für Anmeldung, Spenden, Formulare, Markdown und Website-ErstellungAlle Web-Apps
@churchapps/content-providersAbstraktion für Drittanbieter-Inhaltsquellen (Lessons.church, Planning Center, Dropbox und andere)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkIntegrationswerkzeugkasten für B1.church: Webhooks, REST-Client, OAuthExterne Integrationsentwickler
@churchapps/textingAbstraktion für SMS-AnbieterApi

Informationen zur Einrichtung des Workspaces und zum Veröffentlichungsablauf finden Sie unter Gemeinsam genutzte Bibliotheken.

Projektbeziehungen​

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

Alle Frontend-Apps hängen von @churchapps/helpers ab. Web-Apps hängen zusätzlich von den Paketen @churchapps/apphelper ab. Alle Backend-APIs hängen sowohl von @churchapps/helpers als auch von @churchapps/apihelper ab.

Nächste Schritte​