Saltar al contenido principal

Arquitectura

Estas páginas son mapas de sistemas entre repositorios: documentan cómo funciona de extremo a extremo un sistema central de ChurchApps, abarcando las aplicaciones, los módulos de la API y las bibliotecas compartidas, en lugar de explicar cómo configurar un proyecto concreto. Léalas antes de modificar el comportamiento de un sistema; lea Configuración para poner en marcha un proyecto y la sección de API para la referencia a nivel de endpoints.

El ecosistema de un vistazo​

ChurchApps está formado por unos 20 repositorios independientes (no es un monorepo). Las aplicaciones cliente se comunican con un pequeño conjunto de APIs de backend mediante HTTPS y WebSocket, y comparten código a través de paquetes npm publicados bajo el ámbito @churchapps.

┌────────────────────────────────┐            ┌──────────────────────────────────────────────┐
│ Clientes │ │ Api — monolito modular central (AWS Lambda) │
│ │ │ │
│ B1Admin panel del personal │ HTTPS │ membresía asistencia contenido │
│ B1App portal de miembros │ ─────────▶ │ donaciones mensajería grupos │
│ + sitios de iglesia│ │ │
│ B1Checkin kiosco de registro │ ◀───WS───▶ │ una base de datos MySQL por módulo (6) │
│ │ └──────────────────────────────────────────────┘
│ FreePlay reproductor de TV │ ┌──────────────────────────────────────────────┐
└───────────────┬────────────────┘ │ LessonsApi — backend de Lessons.church │
│ └──────────────────────────────────────────────┘
│ código compartido vía npm (@churchapps/*)
▼
helpers (interfaces entre aplicaciones) · apphelper (componentes React) · apihelper (utilidades Express/servidor)

Dos reglas estructurales determinan todo lo documentado en esta sección:

  1. Los módulos están aislados. Cada módulo de la API es dueño de su base de datos y de sus tablas; los demás módulos y aplicaciones solo acceden a sus datos a través de sus endpoints REST. Consulte Estructura de módulos.
  2. El código compartido se distribuye como paquetes npm. Las aplicaciones nunca importan el código fuente de otras; todo lo que se reutiliza cruza los límites de los repositorios mediante @churchapps/helpers, @churchapps/apphelper o @churchapps/apihelper. Consulte Bibliotecas compartidas.

Mapas de sistemas​

PáginaQué cubreAbarca
Notificaciones y recordatoriosCómo se le comunica algo a una persona: las dos puertas de envío, la cadena de escalado entre canales y el motor de recordatoriosApi (mensajería), B1Admin, B1App
Arquitectura en tiempo realEl marco de entrega por WebSocket que sustenta el chat, la presencia y la entrega dentro de la aplicaciónApi (mensajería), todas las aplicaciones web
Notificaciones push webEl canal de notificaciones push del navegador: claves VAPID, almacenamiento de suscripciones y entregaApi (mensajería), todas las aplicaciones web
DonacionesProveedores de pago y pasarelas, flujos de donación, fondos/lotes y webhooks de las pasarelasApi (donaciones), apphelper, B1App, B1Admin
Registros de eventosEl modelo comercial de inscripciones: tipos de asistente, selecciones, códigos de descuento, pagos a través de la pasarela de donaciones y la lista de esperaApi (contenido + donaciones), B1App, B1Admin
Registros de entradaRegistro en kiosco y autoregistro, el modelo de datos de asistencia, el enrutamiento de salas, la capa de protección infantil e impresión de etiquetasB1Checkin, B1App, B1Admin, Api (asistencia + membresía)
Constructor de sitios webEl árbol de páginas/secciones/elementos, el contrato de tipos de elemento y sus renderizadores, el blog, las páginas con acceso restringido, SEO y la generación con IAApi (contenido), AskApi, helpers/apphelper, B1Admin, B1App
Enrutamiento de sitios web y multisitioCómo una solicitud se asocia con una iglesia y un sitio concreto, el modelo de datos multisitio siteId y el borde de dominios personalizados con CaddyB1App, Api (membresía + contenido), B1Admin
IntegracionesLa superficie de extensión: OAuth, claves de API, webhooks, proveedores de contenido, MCPApi, bibliotecas compartidas, aplicaciones externas
Registro de auditoría y lotes reversiblesAuditoría activada por defecto de cada modificación en el punto de control de los controladores, y la capa de lotes que hace reversibles las importaciones y las acciones masivasApi (todos los módulos), B1Admin, B1Transfer
MinistryStuffEl servicio de pago de almacenamiento y créditos de mensajes de texto: identidad mediante JWT compartido, S2S con clave de servicio, los puntos de integración de proveedores de mensajes y almacenamiento, y la facturación con StripeMinistryStuffApi, MinistryStuffWeb, Api (contenido + mensajería), paquetes de mensajes de texto/apihelper, B1Admin
Almacenamiento propio (BYOS)Las iglesias vinculan Google Drive, Dropbox, OneDrive o un bucket compatible con S3 para subidas más allá de los 100 MB gratuitos: conexión OAuth, formas de subida por proveedor y la redirección pública de descargaApi (contenido + membresía), paquetes helpers/apphelper, B1Admin, B1App
Commons de contenidoLa base compartida de recursos y envíos que sustenta el contenido generado por usuarios entre productos, y la cola de moderación única, solo para personal, en la Administración del servidor de B1AdminApi (módulo commons), B1Admin, WorshipCommons, Lessons.church, FreeShow
tip

Cuando un cambio altere el funcionamiento de uno de estos sistemas —no solo de una página dentro de una aplicación—, el mapa de sistema correspondiente de esta sección debe actualizarse en el mismo esfuerzo. Así esta sección sigue siendo fiable como primer punto de consulta para los nuevos colaboradores.

Propuestas​

Estos documentos describen trabajos propuestos para su revisión, no el comportamiento del producto disponible.

PropuestaQué cubre
BYOK de TwilioCuenta, claves, servicio y número de teléfono propiedad de la iglesia; alcance de la integración, consentimiento, entrega, estimaciones y verificaciones de publicación
Borrador de incorporación de iglesias a TwilioAjustes propuestos para el formulario de registro de B1, ejemplos de campañas específicas para iglesias y listas de verificación de aprobación y operación