Naar hoofdinhoud gaan

Architectuur

Deze pagina's zijn systeemoverzichten over meerdere repositories: ze documenteren hoe een kernsysteem van ChurchApps van begin tot eind werkt, over de apps, de API-modules en de gedeelde bibliotheken heen, in plaats van hoe één project is ingesteld. Lees ze voordat je het gedrag van een systeem wijzigt. Lees Installatie om een project op gang te brengen en de API-sectie voor naslag op endpointniveau.

Het ecosysteem in een oogopslag​

ChurchApps bestaat uit ongeveer 20 onafhankelijke repositories (geen monorepo). Clientapps communiceren via HTTPS en WebSocket met een beperkt aantal backend-API's en delen code via npm-pakketten die onder de @churchapps-scope worden gepubliceerd.

┌────────────────────────────────┐            ┌──────────────────────────────────────────────┐
│ 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)

Twee structurele regels bepalen alles wat in deze sectie wordt beschreven:

  1. Modules zijn geïsoleerd. Elke Api-module beheert zijn eigen database en tabellen. Andere modules en apps bereiken zijn gegevens alleen via de REST-endpoints. Zie Modulestructuur.
  2. Gedeelde code wordt uitgeleverd als npm-pakketten. Apps importeren nooit elkaars broncode. Alles wat hergebruikt wordt, gaat via @churchapps/helpers, @churchapps/apphelper of @churchapps/apihelper over de grenzen van repositories heen. Zie Gedeelde bibliotheken.

Systeemoverzichten​

PaginaWat het behandeltOmvat
Meldingen en herinneringenHoe alles een persoon iets laat weten: de twee verzendingsingangen, de kanaalescalatieketen en de herinneringsengineApi (messaging), B1Admin, B1App
Realtime-architectuurHet WebSocket-leveringsframework achter chat, aanwezigheid en levering binnen de appApi (messaging), alle webapps
Webpush-meldingenHet webpushkanaal in de browser: VAPID-sleutels, opslag van abonnementen, leveringApi (messaging), alle webapps
DonerenBetalingsproviders en gateways, donatiestromen, fondsen en batches, gateway-webhooksApi (giving), apphelper, B1App, B1Admin
EvenementregistratiesHet registratie-commerce-model: deelnemertypen, selecties, kortingscodes, betalingen via de givinggateway en de wachtlijstApi (content + giving), B1App, B1Admin
IncheckfunctiesIncheckkiosk en zelfinchecken, het aanwezigheidsdatamodel, ruimtetoewijzing, de kinderveiligheidslaag, het printen van labelsB1Checkin, B1App, B1Admin, Api (attendance + membership)
WebsitebouwerDe pagina-, sectie- en elementstructuur, het contract en de renderers voor elementtypen, blog, pagina's met toegangsbeperking, SEO en AI-generatieApi (content), AskApi, helpers/apphelper, B1Admin, B1App
Websiterouting en multi-siteHoe een verzoek wordt herleid naar een kerk en een specifieke site, het multi-site-datamodel met siteId en de Caddy-edge voor eigen domeinenB1App, Api (membership + content), B1Admin
IntegratiesHet uitbreidingsoppervlak: OAuth, API-sleutels, webhooks, contentproviders, MCPApi, gedeelde bibliotheken, externe apps
Auditlog en ongedaan te maken batchesStandaard ingeschakelde auditing van elke mutatie op het controllerknooppunt, en de batchlaag die imports en bulkacties ongedaan maakbaar maaktApi (alle modules), B1Admin, B1Transfer
MinistryStuffDe betaalde opslag- en sms-tegoeddienst: identiteit via gedeelde JWT, service-key S2S, de sms- en opslagprovider-koppelpunten, Stripe-factureringMinistryStuffApi, MinistryStuffWeb, Api (content + messaging), texting/apihelper-pakketten, B1Admin
Eigen opslag meebrengen (BYOS)Kerken koppelen Google Drive, Dropbox, OneDrive of een S3-compatibele bucket voor uploads boven de gratis 100MB: OAuth-koppeling, uploadvormen per provider, de openbare downloadredirectApi (content + membership), helpers/apphelper-pakketten, B1Admin, B1App
Gedeelde contentDe gedeelde spil voor assets en inzendingen achter cross-product gebruikersinhoud, en de enkele moderatiewachtrij voor alleen medewerkers in Server Admin van B1AdminApi (commons module), B1Admin, WorshipCommons, Lessons.church, FreeShow
tip

Wanneer een wijziging de werking van een van deze systemen verandert, en niet alleen een pagina binnen één app, moet de bijbehorende systeemkaart hier in dezelfde inspanning worden bijgewerkt. Zo blijft deze sectie betrouwbaar als eerste aanspreekpunt voor nieuwe bijdragers.

Voorstellen​

Deze documenten beschrijven voorgestelde werkzaamheden ter beoordeling en geen beschikbaar productgedrag.

VoorstelWat het behandelt
Twilio BYOKAccount, sleutels, service en telefoonnummer in eigendom van de kerk; integratiereikwijdte, toestemming, levering, schattingen en controles vóór release
Concept onboarding Twilio-kerkenVoorgestelde instellingen voor het aanmeldformulier van B1, voorbeelden van kerkspecifieke campagnes en checklists voor goedkeuring en beheer