B1App
B1App — это публичное приложение для членов церкви, построенное на Next.js. Оно предоставляет участникам возможности работы с профилями, каталогами групп, прямыми трансляциями и страницами пожертвований.
Перед началом работы
- Установите Node.js 22+ и Git — см. Требования
- Настройте цель API (демо или локальную) — см. Переменные окружения
B1App требует Node.js 22 или новее. Более ранние версии не поддерживаются.
Настройка
1. Клонируйте репозиторий
git clone https://github.com/ChurchApps/B1App.git
2. Установите зависимости
cd B1App
npm install
3. Настройте переменные окружения
cp dotenv.sample.txt .env
Откройте .env и настройте URL-адреса конечных точек NEXT_PUBLIC_*_API. Они могут указывать на общий демо-API (https://api.demo.churchapps.org) или на ваш локальный экземпляр API. Пример файла может всё ещё содержать устаревшие адреса тестовых серверов; замените их.
4. Запустите сервер разработки
npm run dev
Сервер разработки Next.js запускается по адресу http://localhost:3301.
Основные команды
| Команда | Описание |
|---|---|
npm run dev | Запуск сервера разработки Next.js на порту 3301 |
npm run build | Продакшен-сборка через Next.js |
npm run test | Запуск сквозных тестов с Playwright |
npm run lint | Запуск линтера Next.js |
Основные переменные окружения
| Переменная | Описание |
|---|---|
NEXT_PUBLIC_*_API | URL-адреса конечных точек API для каждого модуля |
Скрипт postinstall копирует файлы локалей и CSS из @churchapps/apphelper. Если компоненты выглядят без стилей после установки, запустите npm run postinstall вручную.
Стек технологий
- Next.js 16 с TypeScript
- React 19 для UI-компонентов
- Material-UI 7 как дизайн-система
- React Query 5 для серверного состояния
- Пакеты
@churchapps/apphelper*для общих компонентов
Развёртывание
Продакшен-сборки развёртываются в S3 + CloudFront:
npm run buildсоздаёт оптимизированную сборку Next.js- Результат сборки синхронизируется с S3-бакетом
- Запускается инвалидация CloudFront, чтобы отдавать новую версию
Подробные инструкции по развёртыванию см. в руководстве Развёртывание веб-приложений.