Mergeți la conținut principal

Arhitectură

Aceste pagini sunt hărți ale sistemelor din mai multe depozite. Ele documentează cum funcționează de la un capăt la altul un sistem central ChurchApps, prin aplicații, modulele Api și bibliotecile partajate, și nu cum este configurat un anumit proiect. Citiți-le înainte de a modifica comportamentul unui sistem. Citiți Configurare pentru a porni un proiect și secțiunea API pentru referința la nivel de endpoint.

Ecosistemul pe scurt​

ChurchApps are ~20 de depozite independente (nu un monorepo). Aplicațiile client comunică cu un set mic de API-uri backend prin HTTPS și WebSocket și partajează cod prin pachete npm publicate sub scope-ul @churchapps.

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

Două reguli structurale stau la baza tuturor celor documentate în această secțiune:

  1. Modulele sunt izolate. Fiecare modul Api își deține baza de date și tabelele; celelalte module și aplicații ajung la datele sale doar prin endpoint-urile REST. Vezi Structura modulului.
  2. Codul partajat se livrează ca pachete npm. Aplicațiile nu importă codul sursă una de la alta; orice este reutilizat trece granițele depozitelor prin @churchapps/helpers, @churchapps/apphelper sau @churchapps/apihelper. Vezi Biblioteci partajate.

Hărțile sistemelor​

PaginăCe acoperăSe întinde pe
Notificări și memento-uriCum transmite ceva unei persoane o informație: cele două uși de expediere, lanțul de escaladare a canalelor și motorul de memento-uriApi (messaging), B1Admin, B1App
Arhitectura în timp realCadrul de livrare WebSocket din spatele chatului, prezenței și livrării în aplicațieApi (messaging), toate aplicațiile web
Notificări push webCanalul push din browser: chei VAPID, stocarea abonamentelor, livrareaApi (messaging), toate aplicațiile web
DonațiiFurnizori de plăți și gateway-uri, fluxurile de donații, fonduri și loturi, webhook-urile gateway-urilorApi (giving), apphelper, B1App, B1Admin
Înregistrări la evenimenteModelul comercial al înregistrărilor: tipuri de participanți, selecții, coduri de reducere, plăți prin gateway-ul de donații și lista de așteptareApi (content + giving), B1App, B1Admin
Check-in-uriCheck-in la chioșc și self check-in, modelul de date al prezenței, rutarea camerelor, stratul de siguranță pentru copii, tipărirea etichetelorB1Checkin, B1App, B1Admin, Api (attendance + membership)
Constructorul de site-uriArborele pagină/secțiune/element, contractul tipurilor de elemente și randatoarele, blogul, paginile cu acces restricționat, SEO și generarea cu AIApi (content), AskApi, helpers/apphelper, B1Admin, B1App
Rutarea site-urilor și multi-siteCum se rezolvă o cerere către o biserică și un anumit site, modelul de date multi-site cu siteId și marginea Caddy pentru domeniile personalizateB1App, Api (membership + content), B1Admin
IntegrăriSuprafața de extindere: OAuth, chei API, webhook-uri, furnizori de conținut, MCPApi, biblioteci partajate, aplicații externe
Jurnal de audit și loturi anulabileAuditarea activată implicit a fiecărei modificări la punctul central al controllerelor și stratul de loturi care face importurile și acțiunile în masă anulabileApi (toate modulele), B1Admin, B1Transfer
MinistryStuffServiciul plătit de stocare și credite pentru SMS: identitate prin JWT partajat, S2S cu cheie de serviciu, punctele de integrare pentru SMS și stocare, facturarea StripeMinistryStuffApi, MinistryStuffWeb, Api (content + messaging), pachetele texting/apihelper, B1Admin
Stocare proprie (BYOS)Bisericile leagă Google Drive, Dropbox, OneDrive sau un bucket compatibil S3 pentru încărcări peste limita gratuită de 100 MB: conectare OAuth, forme de încărcare pe furnizor, redirecționarea publică pentru descărcareApi (content + membership), pachetele helpers/apphelper, B1Admin, B1App
Content CommonsStructura comună de active și trimiteri din spatele conținutului generat de utilizatori între produse și coada unică de moderare, accesibilă doar personalului, din B1Admin Server AdminApi (modulul commons), B1Admin, WorshipCommons, Lessons.church, FreeShow
sfat

Când o modificare schimbă felul în care funcționează unul dintre aceste sisteme, nu doar o pagină dintr-o aplicație, harta sistemului corespunzătoare de aici trebuie actualizată în același efort. Așa rămâne această secțiune de încredere ca primul punct de referință pentru noii contribuitori.

Propuneri​

Aceste documente descriu lucrări propuse spre analiză, nu comportamentul disponibil al produsului.

PropunereCe acoperă
Twilio BYOKCont deținut de biserică, chei, serviciu și număr de telefon; domeniul integrării, consimțământul, livrarea, estimările și verificările de lansare
Schiță de onboarding Twilio pentru bisericiSetările propuse pentru formularul de înregistrare B1, exemple de campanii specifice bisericilor și liste de verificare pentru aprobare și operare