Spring til hovedindhold

Arkitektur

Disse sider er systemkort på tværs af repositories: de dokumenterer, hvordan et centralt ChurchApps-system fungerer fra start til slut — på tværs af apps, API-moduler og delte biblioteker — snarere end hvordan et enkelt projekt er opsat. Læs dem, før du ændrer et systems adfærd. Læs Opsætning for at få et projekt i gang, og API-sektionen for referencer på endpoint-niveau.

Økosystemet i overblik​

ChurchApps består af ca. 20 uafhængige repositories (ikke et monorepo). Klientapps kommunikerer med et lille sæt backend-API'er over HTTPS og WebSocket og deler kode via npm-pakker, der udgives under @churchapps-scopet.

┌────────────────────────────────┐            ┌──────────────────────────────────────────────┐
│ Klienter │ │ Api — kernemodulær monolit (AWS Lambda) │
│ │ │ │
│ B1Admin personaleportal │ HTTPS │ membership attendance content │
│ B1App medlemsportal + │ ─────────▶ │ giving messaging doing │
│ kirkehjemmesider │ │ │
│ B1Checkin check-in-kiosk │ ◀───WS───▶ │ én MySQL-database pr. modul (6 i alt) │
│ │ └──────────────────────────────────────────────┘
│ FreePlay tv-indholdsafspiller│ ┌──────────────────────────────────────────────┐
└───────────────┬────────────────┘ │ LessonsApi — Lessons.church-backend │
│ └──────────────────────────────────────────────┘
│ delt kode via npm (@churchapps/*)
▼
helpers (tværgående grænseflader) · apphelper (React-komponenter) · apihelper (Express/server-hjælpefunktioner)

To strukturelle regler former alt, der dokumenteres i denne sektion:

  1. Moduler er isolerede. Hvert Api-modul ejer sin database og sine tabeller; andre moduler og apps får kun adgang til dets data via dets REST-endpoints. Se Modulstruktur.
  2. Delt kode udgives som npm-pakker. Apps importerer aldrig hinandens kildekode; alt, der genbruges, krydser repository-grænser via @churchapps/helpers, @churchapps/apphelper eller @churchapps/apihelper. Se Delte biblioteker.

Systemkort​

SideHvad den dækkerOmfatter
Notifikationer & påmindelserHvordan noget fortæller en person noget: de to afsendelsesindgange, eskaleringskæden for kanaler og påmindelsesmotorenApi (messaging), B1Admin, B1App
RealtidsarkitekturWebSocket-leveringsrammeværket bag chat, tilstedeværelse og levering i appenApi (messaging), alle web-apps
Web push-notifikationerBrowserens push-kanal: VAPID-nøgler, lagring af abonnementer, leveringApi (messaging), alle web-apps
DonationerBetalingsudbydere og gateways, donationsflows, fonde/batches, gateway-webhooksApi (giving), apphelper, B1App, B1Admin
EventregistreringerRegistreringsmodellen for kommercielle transaktioner: deltagertyper, valg, rabatkoder, betalinger via donationsgatewayen og ventelisteApi (content + giving), B1App, B1Admin
Check-insKiosk- og selvbetjent check-in, datamodellen for fremmøde, rumrouting, børnesikkerhedslaget, udskrivning af etiketterB1Checkin, B1App, B1Admin, Api (attendance + membership)
HjemmesidebyggerSide-/sektion-/elementtræet, kontrakten for elementtyper og renderere, blog, adgangsstyrede sider, SEO og AI-genereringApi (content), AskApi, helpers/apphelper, B1Admin, B1App
Hjemmesideroutning & multi-siteHvordan en forespørgsel løses til en kirke og et specifikt site, datamodellen for multi-site siteId og Caddy-kanten til egne domænerB1App, Api (membership + content), B1Admin
IntegrationerUdvidelsesfladen: OAuth, API-nøgler, webhooks, indholdsudbydere, MCPApi, delte biblioteker, eksterne apps
Revisionslog & fortrydelige batchesStandardaktiveret revision af alle ændringer på controller-niveau, og batch-laget der gør import og masseoperationer fortrydeligeApi (alle moduler), B1Admin, B1Transfer
MinistryStuffDen betalte lagrings- og sms-kredittjeneste: identitet via delt JWT, service-key S2S, sms- og lagringsudbyder-sømme, Stripe-faktureringMinistryStuffApi, MinistryStuffWeb, Api (content + messaging), texting/apihelper-pakker, B1Admin
Egen lagring (BYOS)Kirker kan forbinde Google Drive, Dropbox, OneDrive eller en S3-kompatibel bucket til uploads ud over de gratis 100 MB: OAuth-forbindelse, upload-format pr. udbyder, den offentlige download-omdirigeringApi (content + membership), helpers/apphelper-pakker, B1Admin, B1App
Content CommonsDet delte aktiv- og indsendelseslag bag tværprodukt-brugergenereret indhold og den ene modereringskø for kun medarbejdere i B1Admin Server AdminApi (commons-modul), B1Admin, WorshipCommons, Lessons.church, FreeShow
tip

Når en ændring ændrer, hvordan et af disse systemer fungerer — ikke blot en side i en enkelt app — skal det tilsvarende systemkort her opdateres i samme arbejde. Det holder denne sektion troværdig som det første holdepunkt for nye bidragydere.

Forslag​

Disse dokumenter beskriver foreslået arbejde til gennemgang og ikke tilgængelig produktadfærd.

ForslagHvad det dækker
Twilio BYOKKirkeejet konto, nøgler, tjeneste og telefonnummer; integrationsomfang, samtykke, levering, estimater og udgivelsestjek
Udkast til Twilio-onboarding for kirkerForeslåede indstillinger for B1-tilmeldingsformularen, kirkespecifikke kampagneeksempler og godkendelses- og driftstjeklister