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

B1 Admin

B1Admin -- панель администрирования церкви -- одностраничное React-приложение, построенное на Vite и Material-UI. Сотрудники церкви используют его для управления людьми, группами, посещаемостью, пожертвованиями, контентом и многим другим.

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

Настройка​

1. Клонирование репозитория​

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

2. Установка зависимостей​

cd B1Admin
npm install

3. Настройка переменных окружения​

cp dotenv.sample.txt .env

Откройте .env и настройте API-эндпоинты. Вы можете направить их на staging API или на ваш локальный экземпляр API.

4. Запуск сервера разработки​

npm start

Это запускает сервер разработки Vite. Приложение будет доступно в вашем браузере с включённой горячей заменой модулей.

Ключевые переменные окружения​

ПеременнаяОписание
REACT_APP_STAGEНазвание окружения (напр., local, staging, prod)
PORTПорт сервера разработки (по умолчанию: 3101)
REACT_APP_*_APIURL API-эндпоинтов для каждого модуля
Информация

Скрипт postinstall копирует файлы локализации и CSS из @churchapps/apphelper. Если компоненты выглядят без стилей, выполните npm run postinstall вручную.

Основные команды​

КомандаОписание
npm startЗапуск сервера разработки Vite
npm run buildПродакшен-сборка через Vite
npm run testЗапуск сквозных тестов с Playwright
npm run lintЗапуск ESLint с автоисправлением

Технологический стек​

  • React 19 с TypeScript
  • Vite для инструментов сборки и сервера разработки
  • Material-UI 7 для UI-компонентов
  • React Query 5 для управления серверным состоянием
  • Пакеты @churchapps/apphelper* для общих компонентов

Развёртывание​

Продакшен-сборки развёртываются в S3 + CloudFront:

  1. npm run build генерирует статические ресурсы
  2. Ресурсы синхронизируются с S3-бакетом
  3. Запускается инвалидация CloudFront для обслуживания новой версии
Совет

Подробные инструкции по развёртыванию см. в руководстве Развёртывание веб-приложений.