Aller au contenu principal

Aperçu du projet

ChurchApps se compose d'environ 20 dépôts indépendants, chacun publié sous l'organisation GitHub ChurchApps. Cette page présente un inventaire complet de tous les projets, organisés par catégorie, ainsi que leurs frameworks, ports et relations.

Avant de commencer

  • Installez les prérequis de la catégorie de projet sur laquelle vous souhaitez travailler

API backend​

Toutes les API sont construites avec Node.js, Express et TypeScript, et déployées sur AWS Lambda via Serverless Framework.

ProjetObjectifPort de développementBase de données
ApiMonolithe modulaire central couvrant l'adhésion, la présence, le contenu, les dons, la messagerie et les tâches8084Base MySQL distincte pour chaque module (6 au total)
LessonsApiBackend de Lessons.church--Base MySQL unique lessons
AskApiOutil de requêtes IA propulsé par OpenAI----
info

Le projet Api principal est un monolithe modulaire. Chaque module (adhésion, présence, contenu, dons, messagerie, tâches) possède sa propre base de données et est accessible à un sous-chemin tel que /membership ou /giving. En production, ceux-ci sont exposés sous forme de fonctions Lambda distinctes derrière API Gateway.

Applications web​

ProjetFrameworkPort de développementObjectif
B1AdminReact 19 + Vite + MUI 73101Tableau de bord d'administration de l'église
B1AppNext.js 16 + React 19 + MUI 73301Application publique pour les membres de l'église
LessonsAppNext.js 163501Interface de Lessons.church
B1TransferReact + Vite--Utilitaire d'importation et d'exportation de données
BrochureSitesStatique--Sites web statiques de brochures pour églises

Applications mobiles​

Toutes les applications mobiles utilisent React Native avec Expo.

ProjetObjectifVersions clés
B1CheckinApplication de borne d'enregistrementExpo
LessonsScreenAffichage des leçons sur Android TVExpo
FreePlayLecture de contenu (y compris sur les systèmes d'exploitation pour téléviseurs)Expo
FreeShowRemoteTélécommande mobile pour FreeShowExpo

Bureau​

ProjetPile techniqueObjectif
FreeShowElectron 37 + Svelte 3 + ViteLogiciel de présentation et de culte

Bibliothèques partagées​

Le code partagé est publié sur npm sous l'espace de noms @churchapps et utilisé comme dépendances npm classiques par les projets ci-dessus. Tous les packages partagés résident dans un seul dépôt -- Packages -- géré comme un espace de travail Yarn et publié avec changesets.

PackageObjectifUtilisé par
@churchapps/helpersUtilitaires de base et interfaces TypeScript partagées (DateHelper, ApiHelper, CurrencyHelper, etc.)Tous les projets
@churchapps/apihelperUtilitaires de serveur Express (authentification, contrôleurs de base, accès aux bases de données, intégrations AWS)Toutes les API
@churchapps/apphelperBibliothèque de composants React avec modules en sous-chemins pour la connexion, les dons, les formulaires, le markdown et la création de sites webToutes les applications web
@churchapps/content-providersAbstraction des fournisseurs de contenu tiers (Lessons.church, Planning Center, Dropbox, et autres)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkBoîte à outils d'intégration B1.church : webhooks, client REST, OAuthDéveloppeurs d'intégrations externes
@churchapps/textingAbstraction des fournisseurs de SMSApi

Consultez Bibliothèques partagées pour la configuration de l'espace de travail et le flux de publication.

Relations entre les projets​

Applications frontend      Bibliothèques partagées    API backend
-------------- ---------------- ------------
B1Admin ──────┐
B1App ──────┤ @churchapps/helpers ◄───── Api
LessonsApp ──────┼──► @churchapps/apphelper LessonsApi
FreeShow ──────┘ AskApi
@churchapps/apihelper ◄────┘

Toutes les applications frontend dépendent de @churchapps/helpers. Les applications web dépendent en outre des packages @churchapps/apphelper. Toutes les API backend dépendent à la fois de @churchapps/helpers et de @churchapps/apihelper.

Étapes suivantes​