Vai al contenuto principale

B1 Admin

B1Admin è la dashboard di amministrazione della chiesa — un'applicazione React a pagina singola costruita con Vite e Material-UI. Il personale della chiesa la usa per gestire persone, gruppi, presenze, donazioni, contenuti e altro.

Prima di iniziare

Configurazione​

1. Clona il repository​

git clone https://github.com/ChurchApps/B1Admin.git

2. Installa le dipendenze​

cd B1Admin
npm install

3. Configura le variabili d'ambiente​

cp dotenv.sample.txt .env

Apri .env e configura gli endpoint delle API. Puoi puntarli all'API demo condivisa (https://api.demo.churchapps.org) oppure alla tua istanza locale dell'API. Il file di esempio potrebbe ancora elencare URL di staging ritirati; sostituiscili.

4. Avvia il server di sviluppo​

npm start

Questo avvia il server di sviluppo Vite. L'app sarà disponibile nel browser con l'hot module replacement attivo.

Variabili d'ambiente principali​

VariabileDescrizione
REACT_APP_STAGENome dell'ambiente (ad esempio demo come nel file di esempio, prod o selfhost)
PORTPorta del server di sviluppo (predefinita: 3101)
REACT_APP_*_APIURL degli endpoint delle API per ciascun modulo
Info

Lo script postinstall copia i file di localizzazione e CSS da @churchapps/apphelper. Se i componenti appaiono senza stile, esegui manualmente npm run postinstall.

Comandi principali​

ComandoDescrizione
npm startAvvia il server di sviluppo Vite
npm run buildBuild di produzione tramite Vite
npm run testEsegue i test end-to-end con Playwright
npm run lintEsegue ESLint con correzione automatica

Stack tecnologico​

  • React 19 con TypeScript
  • Vite per la build e il server di sviluppo
  • Material-UI 7 per i componenti dell'interfaccia
  • React Query 5 per lo stato lato server
  • @churchapps/apphelper* pacchetti per i componenti condivisi

Distribuzione​

Le build di produzione vengono distribuite su S3 + CloudFront:

  1. npm run build genera gli asset statici
  2. Gli asset vengono sincronizzati con un bucket S3
  3. Viene attivata l'invalidazione di CloudFront per servire la nuova versione
Suggerimento

Per le istruzioni dettagliate sulla distribuzione, consulta la guida Distribuzione delle web app.