Перейти к основному содержимому

Обзор проекта

ChurchApps состоит примерно из 20 независимых репозиториев, каждый из которых опубликован в организации ChurchApps на GitHub. На этой странице приведён полный перечень всех проектов по категориям, а также их фреймворки, порты и взаимосвязи.

Перед началом работы

Бэкенд API​

Все API построены на Node.js, Express и TypeScript и развёртываются в AWS Lambda с помощью Serverless Framework.

ПроектНазначениеПорт для разработкиБаза данных
ApiОсновной модульный монолит, охватывающий членство, посещаемость, контент, пожертвования, сообщения и служение8084Отдельная база MySQL для каждого модуля (всего 6)
LessonsApiБэкенд Lessons.church--Единая база MySQL lessons
AskApiИнструмент для AI-запросов на основе OpenAI----
Информация

Основной проект Api представляет собой модульный монолит. Каждый модуль (membership, attendance, content, giving, messaging, doing) имеет собственную базу данных и доступен по подпути, например /membership или /giving. В продакшене они открыты как отдельные функции Lambda за API Gateway.

Веб-приложения​

ПроектФреймворкПорт для разработкиНазначение
B1AdminReact 19 + Vite + MUI 73101Панель администрирования церкви
B1AppNext.js 16 + React 19 + MUI 73301Публичное приложение для прихожан
LessonsAppNext.js 163501Фронтенд Lessons.church
B1TransferReact + Vite--Утилита импорта и экспорта данных
BrochureSitesСтатические сайты--Статические брошюрные сайты церквей

Мобильные приложения​

Все мобильные приложения построены на React Native с использованием Expo.

ПроектНазначениеКлючевые версии
B1CheckinПриложение киоска для регистрации приходаExpo
LessonsScreenОтображение уроков на Android TVExpo
FreePlayВоспроизведение контента (включая TV OS)Expo
FreeShowRemoteМобильный пульт дистанционного управления для FreeShowExpo

Десктопное приложение​

ПроектСтекНазначение
FreeShowElectron 37 + Svelte 3 + ViteПрограммное обеспечение для презентаций и богослужений

Общие библиотеки​

Общий код публикуется в npm в области @churchapps и используется перечисленными выше проектами как обычные npm-зависимости. Все общие пакеты находятся в одном репозитории — Packages, который управляется как рабочее пространство Yarn и выпускается с помощью changesets.

ПакетНазначениеИспользуется в
@churchapps/helpersБазовые утилиты и общие интерфейсы TypeScript (DateHelper, ApiHelper, CurrencyHelper и др.)Все проекты
@churchapps/apihelperУтилиты сервера Express (аутентификация, базовые контроллеры, доступ к базе данных, интеграции с AWS)Все API
@churchapps/apphelperБиблиотека React-компонентов с подмодулями для входа, пожертвований, форм, Markdown и создания сайтовВсе веб-приложения
@churchapps/content-providersАбстракция для сторонних поставщиков контента (Lessons.church, Planning Center, Dropbox и другие)Api, B1Admin, B1App, FreePlay
@churchapps/integration-sdkНабор инструментов интеграции B1.church: вебхуки, REST-клиент, OAuthВнешние разработчики интеграций
@churchapps/textingАбстракция для провайдеров SMSApi

Настройку рабочего пространства и процесс выпуска см. в разделе Общие библиотеки.

Связи между проектами​

Фронтенд-приложения        Общие библиотеки           Бэкенд API
-------------- ---------------- ------------
B1Admin ──────┐
B1App ──────┤ @churchapps/helpers ◄───── Api
LessonsApp ──────┼──► @churchapps/apphelper LessonsApi
FreeShow ──────┘ AskApi
@churchapps/apihelper ◄────┘

Все фронтенд-приложения зависят от @churchapps/helpers. Веб-приложения дополнительно зависят от пакетов @churchapps/apphelper. Все бэкенд API зависят как от @churchapps/helpers, так и от @churchapps/apihelper.

Следующие шаги​