Configurazione
Questa sezione ti guida nella configurazione di un ambiente di sviluppo locale per i progetti ChurchApps. Puoi puntare il tuo frontend alle API demo condivise per uno sviluppo rapido, oppure eseguire l'intero stack in locale per il lavoro sul backend.
Due approcci
Esistono due modi per sviluppare in locale, a seconda di quanto stack ti serve:
1. Punta alle API demo (il più semplice)
Se stai lavorando su un progetto frontend (applicazione web, app mobile o applicazione desktop), il percorso più veloce è puntare la tua app locale alle API demo condivise. Non serve alcuna configurazione di database o backend.
L'URL base delle API demo è:
https://api.demo.churchapps.org
Ogni modulo API è disponibile con un percorso sotto questa base, ad esempio:
https://api.demo.churchapps.org/membership
https://api.demo.churchapps.org/attendance
https://api.demo.churchapps.org/giving
L'ambiente demo esegue l'ultimo codice presente in main, e i suoi dati di esempio vengono ricreati ogni notte, quindi non aspettarti che ciò che crei lì resti disponibile. (L'ex ambiente di staging, api.staging.churchapps.org, è stato dismesso. Alcuni file .env di esempio potrebbero ancora elencare URL di staging: sostituiscili con gli URL demo o locali.)
Questo approccio ti permette di iniziare a fare modifiche al frontend in pochi minuti. È il percorso consigliato per la maggior parte dei collaboratori.
2. Esegui tutto in locale
Se devi modificare il codice delle API o lavorare offline, puoi eseguire l'intero stack in locale. Questo richiede MySQL 8.0+ e configurazione aggiuntiva. Consulta la guida configurazione locale delle API per istruzioni dettagliate.
Per iniziare
Segui queste pagine in ordine:
- Prerequisiti -- Installa gli strumenti necessari (Node.js, Git, MySQL, ecc.)
- Panoramica dei progetti -- Scopri quali progetti esistono e cosa fanno
- Variabili d'ambiente -- Configura i tuoi file
.envper collegare tutto insieme
Ogni progetto ChurchApps è un repository Git indipendente. Devi clonare solo il/i progetto/i su cui vuoi lavorare.