Aller au contenu principal

B1 Admin

B1Admin est le tableau de bord d'administration de l'église -- une application monopage React construite avec Vite et Material-UI. Le personnel de l'église l'utilise pour gérer les personnes, les groupes, la présence, les dons, le contenu et bien plus encore.

Before You Begin

Installation​

1. Cloner le dépôt​

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

2. Installer les dépendances​

cd B1Admin
npm install

3. Configurer les variables d'environnement​

cp dotenv.sample.txt .env

Ouvrez .env et configurez les points de terminaison de l'API. Vous pouvez les faire pointer vers l'API de démonstration partagée (https://api.demo.churchapps.org) ou vers votre instance locale de l'API. Le fichier d'exemple peut encore répertorier d'anciennes URL de préproduction retirées ; remplacez-les.

4. Démarrer le serveur de développement​

npm start

Cela lance le serveur de développement Vite. L'application sera disponible dans votre navigateur avec le rechargement à chaud (HMR) activé.

Variables d'environnement principales​

VariableDescription
REACT_APP_STAGENom de l'environnement (par ex. demo comme dans le fichier d'exemple, prod ou selfhost)
PORTPort du serveur de développement (par défaut : 3101)
REACT_APP_*_APIURL des points de terminaison de l'API pour chaque module
info

Le script postinstall copie les fichiers de locale et de CSS depuis @churchapps/apphelper. Si des composants apparaissent sans style, exécutez manuellement npm run postinstall.

Commandes principales​

CommandeDescription
npm startDémarrer le serveur de développement Vite
npm run buildBuild de production via Vite
npm run testExécuter les tests de bout en bout avec Playwright
npm run lintExécuter ESLint avec correction automatique

Pile technique​

  • React 19 avec TypeScript
  • Vite pour les outils de build et le serveur de développement
  • Material-UI 7 pour les composants d'interface
  • React Query 5 pour l'état côté serveur
  • @churchapps/apphelper* -- paquets partagés de composants communs

Déploiement​

Les builds de production sont déployés sur S3 + CloudFront :

  1. npm run build génère les ressources statiques
  2. Les ressources sont synchronisées vers un bucket S3
  3. Une invalidation CloudFront est déclenchée pour servir la nouvelle version
astuce

Pour des instructions de déploiement détaillées, consultez le guide Déploiement de l'application web.