Sistema de letras y servicios de adoración
Canal de visualización de letras en vivo
propresenter-poller lee el estado de las diapositivas/presentaciones de ProPresenter y escribe en la caché compartida de letras; lyrics-websocket lee esa caché y difunde los cambios. El poller también suministra campos de cuenta regresiva. El escritor de caché utiliza un archivo temporal y un cambio de nombre para evitar JSON de lector parcial. Fuentes:
portal · lyrics/poll_propresenter.php, portal · lyrics/countdown_poller.php,
portal · lyrics/cache_writer.php, portal · lyrics/server.php.
Systemd ejecuta ambos demonios PHP desde la copia de producción de Portal. Sus archivos de configuración de caché seleccionan /run/riveroaks-lyrics; el difusor escucha en todas las interfaces en el puerto 8081. Las pantallas públicas/estáticas y los clientes LAN/iPad comparten ese difusor, mientras que nginx suministra rutas proxy locales /ws. Fuentes:
infra · portal/hosts/rocc-db/files/etc/systemd/system/lyrics-websocket.service,
infra · portal/hosts/rocc-db/files/etc/systemd/system/lyrics-websocket.service.d/lyrics-cache.conf,
infra · portal/hosts/rocc-db/files/etc/systemd/system/propresenter-poller.service.d/lyrics-cache.conf,
portal · lyrics/server.php,
infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf.
El difusor normal es solo de lectura; las escrituras de control de alineación entrantes requieren la opción explícita de demostración. Un latido de socket prueba la actividad del difusor, no los datos recientes de ProPresenter. El vigilante separado verifica la salud del canal y puede reiniciar un demonio de letras fallido; inspeccione su lógica de recuperación/estado limitada antes de la intervención manual. Fuentes: portal · lyrics/server.php,
infra · portal/hosts/rocc-db/files/usr/local/sbin/riveroaks-lyrics-watchdog.
Proxy de ProPresenter de solo lectura para iPads
El vhost privado de letras expone rutas proxy GET exactas para temporizadores, listas de reproducción, índice de diapositivas y estado de presentación. Algunas rutas llamadas focus pueden alterar el enfoque en el lado de ProPresenter a pesar de usar GET; el proxy es limitado, no un permiso general para llamar a puntos finales arbitrarios de ProPresenter. Estas rutas permanecen detrás de la ACL de origen privado. Fuente:
infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf.
Visor de canciones y adaptador de Planning Center
El adaptador PHP recupera tipos/planes/elementos de servicio de PCO en el lado del servidor. El vhost de letras LAN permite el adaptador exacto para los paneles de control; el visor interactivo de canciones tiene su propio nombre de host protegido por Authentik. Las credenciales de PCO no se colocan en la configuración del iPad. Fuentes: portal · lyrics/songs/api.php,
portal · lyrics/songs/service_elements.php,
infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf,
infra · nginx/hosts/rocc-db/sites-enabled/songs.riveroaks.cc.conf.
Seguidor de letras (riveroaks/infrastructure/lyric-follower)
El servicio de sombra persistente consume el estado local de WebSocket/ProPresenter de letras y Q-SYS LTC sobre QRC. La unidad ejecuta un contenedor restringido de raíz de solo lectura, une el observador en el bucle de retorno 8094 y el soporte de reproducción en 8095, y monta un directorio de estado persistente. Esta es una aplicación separada del poller de visualización de PHP. Fuentes: infrastructure/lyric-follower · systemd/ro-lyric-shadow.service,
infrastructure/lyric-follower · src/lyric_follower/rehearsal.py,
infrastructure/lyric-follower · src/lyric_follower/qrc.py.
LIVE_TRIGGER_ENABLED = False bloquea la activación en vivo persistente. OFF, SHADOW y ADVISORY son los modos seguros actuales del operador; la repetición atendida tiene una ruta controlada separada. El modelo de seguridad de escalera Asistida/Automática describe la calificación futura, no la operación de servicio autónoma activa. Fuentes:
infrastructure/lyric-follower · src/lyric_follower/pp_agent.py,
infrastructure/lyric-follower · src/lyric_follower/assisted_replay.py,
infrastructure/lyric-follower · src/lyric_follower/rehearsal.py, infrastructure/lyric-follower · docs/safety-model.md.
El control del navegador pasa por Authentik; los controles LAN limitados y el acceso al feed de captura son excepciones separadas. Consulte límites de confianza. Fuente: infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf.
La decisión sobre el texto de la letra cambió durante este proyecto: ADR 0008 registra la aprobación para retener el texto para entrenamiento, y lyric_text.py implementa ayudantes de almacenamiento. No utilice el contrato de solo hash de la columna de eventos como una declaración general sobre todo el almacenamiento del seguidor/captura. Fuentes:
infrastructure/lyric-follower · docs/adr/0008-store-lyric-text-for-training.md,
infrastructure/lyric-follower · src/lyric_follower/lyric_text.py.
Evaluador híbrido desactivado por defecto
La rama principal actual también contiene una biblioteca híbrida de seguidor ASR/código de tiempo y una CLI de evaluación sin conexión. Devuelve decisiones de retención/seguimiento/propuesta y no tiene actuador ni transporte de red. La configuración rechaza el uso de producción habilitado; todas las decisiones no son elegibles para acción en vivo. El ensayo y la reproducción persistente no importan este evaluador. Fusionar la biblioteca no habilita la operación Asistida o Automática. Fuentes:
infrastructure/lyric-follower · src/lyric_follower/hybrid_follower.py,
infrastructure/lyric-follower · docs/hybrid-dev-test.md.
El seguimiento de NDI distingue de manera similar la calificación de desarrollo nativo de la instalación atendida en Mac de captura. El éxito en pruebas de montaje/CI no establece una versión de grabadora de producción ni autoriza el reemplazo de una prueba de captura mantenida por separado. Fuente:
infrastructure/lyric-follower · docs/NDI_DAYTIME_ACCEPTANCE.md.
Captura de datos de adoración
El mismo repositorio contiene una grabadora nativa de audio/NDI para macOS. Obtiene ranuras de grabación de PCO filtradas a través del servicio de programación de captura en el bucle de retorno 8096 detrás de una ruta nginx dedicada protegida por portador; el generador de feeds permanece en el lado del servidor. No utiliza la API canónica del personal para las lecturas del horario. Fuentes: infrastructure/lyric-follower · macos/WorshipDataCaptureApp/Sources/WorshipDataCaptureApp/PlanningCenterCatalog.swift,
infrastructure/lyric-follower · server/planning_center_api.py,
infrastructure/lyric-follower · server/planning-center-feed.php,
infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf.
Las compilaciones y pruebas de CI de Linux para la rueda; la calificación nativa, la firma, la liberación del paquete, el alcance de Jamf, la activación segura y la verificación en tiempo de ejecución son pasos del operador separados. La instalación de un paquete no establece la versión del proceso en ejecución. Fuente: infrastructure/lyric-follower · .gitlab-ci.yml, infrastructure/lyric-follower · docs/deployment-pipeline.md.
Comunicaciones y feeds de pánico
La rama de características de transcripción contiene el productor: firma instantáneas limitadas para el carril de API seleccionado, publica el estado y los latidos cambiados/más recientes, y continúa la transcripción local si la publicación falla. Esta fuente es evidencia de rama de características, no prueba de implementación desde main. Fuentes:
infrastructure/lyric-follower · macos/WorshipDataCaptureApp/Sources/WorshipDataCaptureApp/CommsPublisher.swift,
infrastructure/lyric-follower · macos/WorshipDataCaptureApp/Sources/WorshipDataCaptureCore/Transcription.swift,
infrastructure/lyric-follower · docs/deployment-pipeline.md.
Las rutas de la API dirigen las comunicaciones/pánico al Portal de desarrollo. PHP verifica HMAC y el orden, y escribe atómicamente en /run/riveroaks-comms-<lane>/{state,panic}.json. Las alias privadas de nginx apuntan a instantáneas de desarrollo. Fuentes:
portal-api · src/contract.ts, portal · dashboard/api/mobile/v1/comms-ingest.php,
portal · dashboard/api/mobile/v1/panic-ingest.php,
portal · dashboard/api/mobile/v1/lib/comms.php,
infra · nginx/hosts/rocc-db/sites-enabled/lyrics.riveroaks.cc.conf.
El difusor envía type=comms, kind=comms|panic solo a clientes de socket que optan por participar; las lecturas REST de iPad siguen siendo una solución alternativa. Las instantáneas de más de 15 segundos se marcan como fuera de línea; las líneas finales pueden permanecer visibles. La opción de participar no es control de acceso: consulte la brecha de verificación del borde público. Fuentes: portal · lyrics/comms_feed.php,
portal-ios · RiverOaksServiceDashboard/Models/DashboardModels.swift,
portal-ios · RiverOaksServiceDashboard/ViewModel/DashboardViewModel.swift.
Cronología del servicio (riveroaks/infrastructure/service-timeline)
La columna de eventos de Fase 0 escribe observaciones en SQLite WAL local antes del envío por red. Los lotes ordenados cruzan mTLS más HMAC hacia un colector y MariaDB. El registro de eventos es de solo adición; los puntos de control del productor son mutables y se actualizan en la misma transacción que las inserciones de eventos. Se verifican duplicados y se rechazan huecos en la secuencia. Fuentes: infrastructure/service-timeline · src/service_timeline/spool.py,
infrastructure/service-timeline · src/service_timeline/client.py,
infrastructure/service-timeline · src/service_timeline/signing.py,
infrastructure/service-timeline · src/service_timeline/storage.py,
infrastructure/service-timeline · database/roles.sql.example.
El productor de ProPresenter es de solo lectura y registra hashes de identidad/texto de señales. El registro de medios y los marcadores del operador tienen sus propios comandos de spool locales. No hay una conexión API central ni una etapa de implementación automática en la implementación revisada. Fuentes: infrastructure/service-timeline · src/service_timeline/propresenter.py,
infrastructure/service-timeline · src/service_timeline/media.py,
infrastructure/service-timeline · src/service_timeline/marker.py,
infrastructure/service-timeline · .gitlab-ci.yml, infrastructure/service-timeline · README.md.
Monitoreo AV
El panel de control lee la acústica y el código de tiempo a través de los feeds LAN del Monitor de Servicio. El colector separado de salud de señal AV proporciona un puente acústico Q-SYS; Q-SYS/Node-RED puede publicar alertas de Portal firmadas. Estas rutas de monitoreo no colocan la API central en el bucle síncrono de control de letras. Fuentes:
portal-ios · docs/IPAD_SERVICE_DASHBOARD.md,
infrastructure/av-signal-health · README.md,
infrastructure/av-signal-health · docs/qsys-acoustics-rta-bridge.md,
infra · nodered/instances/telegram/qsys-portal-alert.js,
infrastructure/lyric-follower · docs/safety-model.md.
Qué depende de qué
El impacto de la falla es una inferencia de las rutas de origen anteriores, no una prueba de interrupción realizada. Consulte matriz de fallas y runbooks.
| Dependencia perdida | Impacto esperado |
|---|---|
| Ruta de la API central/VPC | Fallan las llamadas nativas del personal y las páginas web basadas en API; la publicación de nuevas comunicaciones falla. La visualización de letras local y el control local pueden continuar si sus dependencias LAN permanecen saludables |
rocc-db/PHP/SQL |
Dominio de falla compartido amplio para datos/autenticación de Portal y servicios locales de letras/control; los procesos Mac/Pi independientes pueden permanecer en ejecución |
| ProPresenter | Fallan las nuevas observaciones de letras/diapositivas/cuentas regresivas en vivo; el latido del transporte por sí solo aún puede parecer activo |
| PCO | Fallan las nuevas recuperaciones de planes/horarios; el comportamiento de caché/reserva depende del adaptador individual, por lo que no se garantiza la operación sin conexión universal |
| Colector/red para la cronología | Los productores pueden almacenar en búfer localmente dentro de la capacidad configurada; el vaciado/reproducción requiere la recuperación del colector sin omitir huecos |
| APNs | La API de alertas en primer plano sigue siendo un transporte separado; las notificaciones en segundo plano pueden retrasarse/faltar |