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.