Saltar a contenido

Servidor de origen del portal (rocc-db)

La IaC revisada apunta al origen del Portal en 10.200.24.42:80; nginx sirve raíces de producción y desarrollo separadas a través de PHP-FPM 8.1. El código de la aplicación proviene de riveroaks/portal; los listeners y los archivos de servicio de host son propiedad de riveroaks/infra. Fuentes: portal-api · infra/modules/portal-platform/main.tf, infra · nginx/hosts/rocc-db/sites-enabled/ro.church.conf, infra · deploy/targets/nginx/rocc-db.json.

Cómo llegan las solicitudes

Punto de entrada Comportamiento del origen Evidencia
API Central Servicio VPC a puerto HTTP de origen fijo; el Host configurado selecciona el vhost del Portal coincidente portal-api · src/index.ts, portal-api · infra/modules/portal-platform/main.tf
portal.ro.church /usr/share/nginx/portal/dashboard → PHP-FPM infra · nginx/hosts/rocc-db/sites-enabled/ro.church.conf
dev.portal.ro.church /usr/share/nginx/html/dev-portal/dashboard → PHP-FPM infra · nginx/hosts/rocc-db/sites-enabled/ro.church.conf
Letras públicas Páginas de visualización estática exactas; otras rutas denegadas/redirigidas según se declara infra · nginx/hosts/rocc-db/sites-enabled/ro.church.conf
Letras privadas TLS, ACL de origen, WebSocket, rutas PHP/proxy estrechas y alias de instantáneas infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf
Visor de canciones Visor interactivo protegido por Authentik; el adaptador de red LAN separado permanece disponible para los paneles infra · nginx/hosts/rocc-db/sites-enabled/songs.riveroaks.cc.conf, portal · lyrics/songs/api.php

Estos archivos establecen listeners y rutas de aplicación, no cada DNS público, Tunnel, Access o configuración de proxy ascendente. El inventario/manual de conectores se encuentra en infra · docs/deploy/riveroaks-cloudflared.md; verifique la cadena de enrutamiento externa por separado antes de modificarla.

La aplicación Portal (riveroaks/portal)

Ruta Responsabilidad Evidencia
dashboard/api/mobile/v1/ Adaptadores de API canónicos; validación de token/sesión, cuenta actual/RBAC portal · dashboard/api/mobile/v1/lib/runtime.php, portal · dashboard/api/mobile/v1/bootstrap.php
dashboard/v2/api/ BFF web y callback de OAuth portal · dashboard/v2/api/lib/client.php
dashboard/login/ Inicio de sesión del navegador / integración con Google portal · dashboard/login/google_login.php
lyrics/ Pollster de visualización, emisor, adaptador de canciones portal · lyrics/poll_propresenter.php, portal · lyrics/server.php, portal · lyrics/songs/api.php
database/, scripts/ Herramientas aditivas de esquema y para trabajadores/instalación/migración portal · .gitlab-ci.yml

El origen PHP es la autoridad para la identidad, los permisos y los registros comerciales del Portal. Los datos SQL no se copian al Worker de la API como una segunda autoridad. La revisión de invalidación de tickets de la API es un almacén de estado separado y limitado. Fuentes: portal · dashboard/api/mobile/v1/lib/tokens.php, portal · dashboard/api/mobile/v1/lib/runtime.php, portal-api · src/ticket-live-hub.ts.

Bases de datos y límite de desarrollo

La identidad/RBAC y los tokens móviles tienen respaldo SQL; los tickets, los gastos y el presupuesto tienen sus propios límites de base de datos de aplicación. Consulte la auditoría de aislamiento y el código de migración para conocer los objetivos reales en lugar de derivar un nombre de base de datos del nombre de host. Fuentes: portal · docs/MOBILE_API.md, portal · scripts/verify-environment-database-isolation.php.

El desarrollo utiliza intencionalmente el libro mayor del presupuesto de tecnología de producción. La auditoría de implementación de desarrollo permite bases de datos compartidas (--allow-shared-database). Por lo tanto, una compilación de TestFlight o un nombre de host de API de desarrollo no autorizan la creación de entradas de presupuesto desechables. Otros recursos compartidos incluyen el origen físico, el grupo PHP y el conector VPC. Fuentes: portal · docs/technology-budget-sql-ledger.md, portal · .gitlab-ci.yml, portal-api · infra/modules/portal-platform/main.tf.

Trabajadores en segundo plano en rocc-db

Familia de trabajadores Rol Fuente
propresenter-poller, lyrics-websocket Productor de diapositivas/caché y emisor de Ratchet infra · portal/hosts/rocc-db/files/etc/systemd/system/propresenter-poller.service, infra · portal/hosts/rocc-db/files/etc/systemd/system/lyrics-websocket.service
Vigía de letras Verificación periódica de estado y recuperación dirigida de demonios de letras infra · portal/hosts/rocc-db/files/etc/systemd/system/riveroaks-lyrics-watchdog.timer, infra · portal/hosts/rocc-db/files/usr/local/sbin/riveroaks-lyrics-watchdog
mobile-apns-* Entrega de notificaciones push portal · scripts/mobile-apns-worker.php, portal · scripts/systemd/mobile-apns-dev.service
sermon-slide-* Extracción, entrega a ProPresenter, notificación y telemetría portal · scripts/install-sermon-slide-workers.sh, portal · scripts/sermon-slide-propresenter-worker.py
Actualizaciones de Jamf OS Flujo de trabajo en segundo plano de dispositivos administrados portal · docs/JAMF_OS_UPDATE_ASSISTANT.md
Vigilancia de almacenamiento de archivos Flujo de trabajo de estado del almacenamiento portal · docs/files-storage-reliability.md
Sincronización de tickets/tareas Procesamiento de la bandeja de salida de integración portal · scripts/ticket-tasks-sync.php
Vigilancia del estado del flujo de trabajo Monitoreo de frescura/trabajadores fallidos portal · scripts/workflow-health-watch.py

La presencia de unidades/configuración demuestra la ejecución prevista, no que un temporizador específico esté actualmente habilitado o que su última ejecución haya tenido éxito. La verificación pertenece al manual correspondiente.

Automatización de diapositivas de sermones (un flujo de extremo a extremo)

Las cargas ingresan al flujo de trabajo del Portal, que registra versiones/trabajo de la bandeja de salida y utiliza Google Drive más contenido en caché privado. La extracción genera datos de diapositivas; el trabajador de ProPresenter construye/entrega presentaciones a través de un receptor restringido en la Mac. El Keynote original tiene un destino de adoración separado. Los trabajadores de notificación y telemetría rastrean la finalización. Fuentes: portal · dashboard/v2/sermon-slides/process-upload.php, portal · scripts/sermon-slide-extraction-worker.py, portal · scripts/sermon-slide-propresenter-worker.py, portal · scripts/sermon-propresenter-receive.py, portal · scripts/sermon-worship-receive.sh, portal · scripts/sermon-slide-notification-worker.py.

El receptor importa/coloca el contenido; la entrega de contenido no debe confundirse con la activación de una señal en vivo. Consulte portal · docs/SERMON_PROPRESENTER_LIVE_DEPLOYMENT.md y portal · docs/SERMON_WORKFLOW_ALERT_RECOVERY.md antes de una recuperación o repetición. El diagrama de arquitectura se encuentra en Diagramas.

Despliegue

dev apunta a /usr/share/nginx/html/dev-portal; main apunta a /usr/share/nginx/portal. CI maneja la reconciliación de checkout, los pasos requeridos de aplicación/verificación de esquema y la verificación de humo. Revise las reglas de trabajo reales del carril: los trabajos de configuración manual no se implican por un despliegue de código exitoso. Fuentes: portal · .gitlab-ci.yml, portal · .gitlab-ci.yml.

La activación del demonio de letras está separada de la copia de archivos PHP: el asistente reinicia los procesos de larga duración y verifica la actividad y la actualización de WebSocket. Su guardia normal se pospone los domingos de 07:00 a 13:30 y los miércoles/jueves de 18:00 a 21:30 (America/New_York), o mientras el estado de código de tiempo/grabación esté activo. Existe una bandera de fuerza, por lo que esta es una guardia de carril normal, no una garantía inquebrantable. Fuente: portal · .gitlab/activate-lyrics-services.sh.

Cloudflare Workers alrededor del Portal

Formularios, Correo electrónico y Enlaces cortos tienen contratos, datos y carriles de despliegue independientes. Sus flujos de datos detallados y enlaces de origen se encuentran en Clientes y publicadores.

Observabilidad

El manual de observabilidad del Portal describe los búferes de aplicación/nginx y el envío de Alloy a Loki/Grafana. Utilice un ID de solicitud opaco para correlacionar un error de API; no pegue cargas útiles de solicitud, tokens, transcripciones o datos personales en una tarea. Fuentes: portal · docs/PORTAL_OBSERVABILITY.md, portal-api · src/index.ts.