Web app per seguire le celebrazioni nella Basilica di San Pietro
Liturgia Digitale sostituisce il materiale cartaceo delle messe: i fedeli aprono testi, canti e lingue dal telefono, ma solo dentro la Basilica. H2App ha vinto la richiesta di offerta della Fabbrica di San Pietro e ha costruito la PWA e il modulo di pubblicazione nella Dashboard FSP.
Contesto e premesse
Un nuovo modo innovativo per seguire la liturgia
La Fabbrica di San Pietro cura conservazione, manutenzione e valorizzazione della Basilica. Aveva bisogno di un supporto liturgico digitale per le celebrazioni: messale, liturgia della Parola e canti, al posto della carta, consultabili dai dispositivi dei fedeli e governati dal cerimoniere.
Una piattaforma già in esercizio, senza il sorgente
I contenuti dovevano vivere nella Dashboard FSP, il backoffice già usato per sorveglianza, flussi e biglietteria. H2App ha integrato il modulo senza disporre del codice della piattaforma esistente.
Usabile solo in Basilica
I testi non devono uscire dal perimetro. La web app verifica posizione (GPS) e rete Wi-Fi della Basilica; le regole (SSID, raggio) si impostano dal pannello, non nel codice.
Audio in lingua, da un servizio terzo
Dove la celebrazione ha la traduzione del Dicastero per la Comunicazione, la scheda rimanda all'ascolto (Vatican Vox) tramite API, con cache per non saturare le chiamate.
La soluzione di H2App
Una PWA per i fedeli, un modulo per chi pubblica
Abbiamo scelto una progressive web app invece di un'app da store: i fedeli aprono il QR (o il link) all'ingresso, senza installare nulla e senza licenze di pubblicazione. Lato ente, cerimoniere e maestro del coro pubblicano testi e canti nel backoffice.
QR all'ingresso
Niente registrazione. Il fedele inquadra il codice ricevuto in Basilica e apre la web app sul proprio telefono.
Controllo di perimetro
GPS del device e reti Wi-Fi della Basilica decidono se i contenuti si possono consultare. Fuori dal raggio, no.
Liturgia del giorno
Lista delle celebrazioni, lingua, testi e canti della messa in corso, audio di traduzione se disponibile.
Web app per i fedeli
La giornata liturgica, in più lingue
Aprendo una celebrazione si legge il testo (messale, liturgia della Parola, canti) e, dove previsto, lo spartito. Se il Dicastero espone lo streaming, un riquadro invita a seguire l'audio su Vatican Vox.
La home elenca le messe del giorno — ora, altare, titolo, lingue — e il selettore passa fra italiano, spagnolo, inglese e francese senza un'app nativa.
Backoffice nella Dashboard FSP
Chi pubblica la liturgia non esce dal pannello dell'ente
Gli operatori autenticati — con un permesso dedicato già previsto dalla Dashboard FSP — inseriscono, modificano e programmano testi e canti per la celebrazione. L'elenco orari arriva dal planning delle messe (Planning PME); da lì si apre la scheda da pubblicare.
Ogni modifica resta tracciata (operatore, data, tipo di contenuto). Gli amministratori hanno un pannello di statistiche di consultazione, con export. SSID, coordinate e raggio di accesso si configurano nello stesso backoffice.
Scelte di progetto
Perché una PWA, e perché agganciata alla FSP
Niente store per il fedele
Un'app nativa avrebbe chiesto licenze di pubblicazione e un'installazione in coda all'ingresso. La PWA si apre dal QR, si aggiorna senza passare dagli store, e resta comunque usabile da smartphone e tablet.
Il perimetro è un requisito, non un orpello
I contenuti liturgici restano nella Basilica. Geofence e Wi-Fi sono il criterio d'uso, configurabile dal pannello: nome rete, coordinate, raggio.
Due sistemi che non si toccano il codice
Laravel parla con il MySQL già in essere e con le API di traduzione. React è la PWA. L'integrazione con la Dashboard FSP è avvenuta dall'esterno, sul perimetro che l'ente ha messo a disposizione.
Il progetto in pillole
- Cliente
- Fabbrica di San Pietro
- Settore
- Culto e religione
- Pubblicazione
- 2026
- Piattaforme
- PWA e modulo in Dashboard FSP
- Accesso
- QR in Basilica, senza vetrina pubblica
- Target utenti
- Fedeli; cerimonieri e maestri del coro
Strumenti utilizzati
React 18
Laravel 11
PHP 8
MySQL
Intorno alla piattaforma
- Dashboard FSP
- Planning PME
- API Dicastero / Vatican Vox
- Azure (infrastruttura dell'ente)
React è la PWA dei fedeli. Laravel gestisce contenuti, permessi, log e le chiamate alle API di traduzione, sul MySQL già usato dalla Dashboard FSP. Il deploy segue le pipeline Azure e il repository Git dell'ente.
Il risultato
Seguire la celebrazione senza il foglietto
I fedeli hanno un'alternativa digitale al cartaceo, in più lingue. L'ente pubblica e programma i contenuti dallo stesso backoffice delle altre attività quotidiane. Non c'è un URL pubblico: il rilascio è interno alla Basilica.
Autonomia per chi è in Basilica
Orario, altare, testi e canti della celebrazione in corso si consultano dal telefono, nella lingua scelta, senza un operatore che distribuisca fogli.
Copertura multilingua
La stessa scheda si legge in italiano, inglese, spagnolo o francese. L'audio di traduzione, quando il Dicastero lo espone, sta sulla scheda.
I contenuti restano in Basilica
Geolocalizzazione e Wi-Fi chiudono la consultazione al perimetro. Fuori da quel raggio la web app non è uno strumento da portare a casa.
Cosa abbiamo consegnato
- PWA React per i fedeli
- Modulo Liturgia in Dashboard FSP
- Gestione testi, canti e lingue
- Programmazione per celebrazione
- Geofence GPS e Wi-Fi configurabile
- Accesso da QR code
- Integrazione API di traduzione
- Tracciamento modifiche
- Statistiche di consultazione
