Zum Hauptinhalt springen

Architektur

Diese Seiten sind repositoryübergreifende Systemübersichten: Sie beschreiben, wie ein zentrales ChurchApps-System von Anfang bis Ende funktioniert, über die Apps, die API-Module und die gemeinsam genutzten Bibliotheken hinweg, und nicht, wie ein einzelnes Projekt eingerichtet wird. Lesen Sie sie, bevor Sie das Verhalten eines Systems ändern. Lesen Sie Einrichtung, um ein Projekt zum Laufen zu bringen, und den API-Abschnitt für die Referenz auf Endpunktebene.

Das Ökosystem auf einen Blick​

ChurchApps besteht aus rund 20 unabhängigen Repositories (kein Monorepo). Client-Apps kommunizieren über HTTPS und WebSocket mit einer kleinen Gruppe von Backend-APIs und teilen Code über npm-Pakete, die unter dem Scope @churchapps veröffentlicht werden.

┌────────────────────────────────┐            ┌──────────────────────────────────────────────┐
│ Clients │ │ Api — core modular monolith (AWS Lambda) │
│ │ │ │
│ B1Admin staff dashboard │ HTTPS │ membership attendance content │
│ B1App member portal + │ ─────────▶ │ giving messaging doing │
│ church websites │ │ │
│ B1Checkin check-in kiosk │ ◀───WS───▶ │ one MySQL database per module (6 total) │
│ │ └──────────────────────────────────────────────┘
│ FreePlay TV content player │ ┌──────────────────────────────────────────────┐
└───────────────┬────────────────┘ │ LessonsApi — Lessons.church backend │
│ └──────────────────────────────────────────────┘
│ shared code via npm (@churchapps/*)
▼
helpers (cross-app interfaces) · apphelper (React components) · apihelper (Express/server utilities)

Zwei strukturelle Regeln prägen alles, was in diesem Abschnitt dokumentiert ist:

  1. Module sind isoliert. Jedes Api-Modul besitzt seine eigene Datenbank und seine Tabellen. Andere Module und Apps erreichen seine Daten nur über dessen REST-Endpunkte. Siehe Modulstruktur.
  2. Gemeinsamer Code wird als npm-Pakete bereitgestellt. Apps importieren niemals den Quellcode der jeweils anderen. Alles, was wiederverwendet wird, überschreitet Repository-Grenzen über @churchapps/helpers, @churchapps/apphelper oder @churchapps/apihelper. Siehe Gemeinsam genutzte Bibliotheken.

Systemübersichten​

SeiteInhaltBetrifft
Benachrichtigungen & ErinnerungenWie eine Person über etwas informiert wird: die beiden Versandwege, die Eskalationskette der Kanäle und die Erinnerungs-EngineApi (messaging), B1Admin, B1App
Echtzeit-ArchitekturDas WebSocket-Auslieferungsframework hinter Chat, Anwesenheitsanzeige und In-App-ZustellungApi (messaging), alle Web-Apps
Web-Push-BenachrichtigungenDer Push-Kanal im Browser: VAPID-Schlüssel, Speicherung von Abonnements, ZustellungApi (messaging), alle Web-Apps
SpendenZahlungsanbieter und Gateways, Spendenabläufe, Fonds/Batches, Gateway-WebhooksApi (giving), apphelper, B1App, B1Admin
VeranstaltungsanmeldungenDas Modell für Anmeldungen als Handelsvorgang: Teilnehmertypen, Auswahlen, Rabattcodes, Zahlungen über das Spenden-Gateway und die WartelisteApi (content + giving), B1App, B1Admin
Check-insCheck-in am Kiosk und Selbst-Check-in, das Datenmodell der Anwesenheit, Raumzuordnung, die Kinderschutzebene, EtikettendruckB1Checkin, B1App, B1Admin, Api (attendance + membership)
Website-BuilderDer Baum aus Seiten, Abschnitten und Elementen, der Vertrag und die Renderer der Elementtypen, Blog, zugriffsbeschränkte Seiten, SEO und KI-GenerierungApi (content), AskApi, helpers/apphelper, B1Admin, B1App
Website-Routing & MehrfachstandorteWie eine Anfrage einer Kirche und einer bestimmten Website zugeordnet wird, das Datenmodell für Mehrfachstandorte mit siteId und die Caddy-Edge für eigene DomainsB1App, Api (membership + content), B1Admin
IntegrationenDie Erweiterungsschnittstelle: OAuth, API-Schlüssel, Webhooks, Content-Provider, MCPApi, gemeinsam genutzte Bibliotheken, externe Apps
Prüfprotokoll & rückgängig machbare StapelStandardmäßig aktive Protokollierung jeder Änderung am zentralen Controller-Kontrollpunkt sowie die Stapelschicht, die Importe und Massenaktionen rückgängig machbar machtApi (alle Module), B1Admin, B1Transfer
MinistryStuffDer kostenpflichtige Dienst für Speicher und SMS-Guthaben: Identität über ein geteiltes JWT, Service-Key-S2S, die Anbieterschnittstellen für Textnachrichten und Speicher, Stripe-AbrechnungMinistryStuffApi, MinistryStuffWeb, Api (content + messaging), texting/apihelper-Pakete, B1Admin
Eigener Speicher (Bring-Your-Own-Storage)Kirchen verknüpfen Google Drive, Dropbox, OneDrive oder einen S3-kompatiblen Bucket für Uploads über die kostenlosen 100 MB hinaus: OAuth-Verbindung, Upload-Formate je Anbieter, die öffentliche Download-WeiterleitungApi (content + membership), helpers/apphelper-Pakete, B1Admin, B1App
Content CommonsDie gemeinsame Basis für Assets und Einreichungen hinter anbieterübergreifenden nutzergenerierten Inhalten sowie die einzige, nur für Mitarbeiter zugängliche Moderationswarteschlange im Server Admin von B1AdminApi (commons-Modul), B1Admin, WorshipCommons, Lessons.church, FreeShow
Tipp

Wenn eine Änderung die Funktionsweise eines dieser Systeme verändert, nicht nur eine Seite innerhalb einer einzelnen App, sollte die passende Systemübersicht hier im selben Arbeitsschritt aktualisiert werden. So bleibt dieser Abschnitt verlässlich die erste Anlaufstelle für neue Mitwirkende.

Vorschläge​

Diese Dokumente beschreiben geplante Arbeiten zur Prüfung und keine verfügbaren Produktfunktionen.

VorschlagInhalt
Twilio BYOKKircheneigenes Konto, Schlüssel, Dienst und Telefonnummer; Umfang der Integration, Einwilligung, Zustellung, Schätzungen und Freigabeprüfungen
Twilio-Entwurf für das Onboarding von KirchenVorgeschlagene Einstellungen für das B1-Anmeldeformular, kirchenspezifische Kampagnenbeispiele sowie Checklisten für Freigabe und Betrieb