LessonsApp

LessonsApp -- приложение для управления учебным контентом для Lessons.church. Оно предоставляет интерфейс для создания, организации и публикации церковных учебных программ, построенное на Next.js и React.

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

• Установите Node.js 22+ и Git -- см. Предварительные требования
• Настройте цель API (staging или локальный) -- см. Переменные окружения

Предупреждение

LessonsApp требует Node.js 22 или новее. Более ранние версии не поддерживаются.

Настройка

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

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

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

cd LessonsApp
npm install

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

Скопируйте файл-образец окружения в .env и настройте API-эндпоинты:

cp dotenv.sample.txt .env

Обновите URL API-эндпоинтов, указав staging API или ваш локальный экземпляр API.

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

npm run dev

Сервер разработки Next.js запускается по адресу http://localhost:3501.

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

Команда	Описание
npm run dev	Запуск сервера разработки Next.js на порту 3501
npm run build	Продакшен-сборка через Next.js

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

• Next.js 16 с TypeScript
• React 19 для UI-компонентов
• Пакеты @churchapps/apphelper* для общих компонентов

Информация

LessonsApp взаимодействует с бэкендом LessonsApi, который является отдельным API от основного ChurchApps Api. Убедитесь, что ваше окружение настроено с правильным эндпоинтом Lessons API.

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

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

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

Совет

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