Настройка окружения

Для разработчиков: Этот гайд описывает настройку локального окружения с автоматической сборкой образа из исходного кода. Этот метод позволяет мгновенно применять изменения в коде. Для простого развертывания готового приложения используйте инструкцию по запуску.

Шаг 1: Клонирование репозитория

git clone https://github.com/TermoStat-SFEDU/TermoStat-Server.git
cd TermoStat-Server

Шаг 2: Создание файла конфигурации

Создайте файл .env в корне проекта. Для разработки рекомендуется включить режим отладки и симуляции данных.

# .env (пример для разработки)
SECRET_KEY=dev-secret-key
DEBUG=1
TEST_MODE=1
ALLOWED_HOSTS=127.0.0.1,localhost

# Настройки БД можно оставить по умолчанию
DB_NAME=sensor_db
DB_USER=sensor_user
DB_PASS=strong_password
DB_HOST=db
DB_PORT=5432

Важно: TEST_MODE=1 активирует генератор тестовых данных. При запуске контейнера база данных будет автоматически заполнена симулированными устройствами и их показаниями за последние 24 часа. Также будет запущена фоновая задача, которая добавляет новые данные каждые 5 секунд.

Шаг 3: Запуск окружения

Используйте docker-compose.yml из репозитория. Он настроен на сборку образа и монтирование исходного кода в контейнер.

Выполните команду:

docker compose up --build

Дождитесь, пока все сервисы запустятся. Сервер будет доступен по адресу http://localhost:8000. Благодаря монтированию тома (volumes: [.:/app]), изменения в файлах будут применяться автоматически (сервер Django перезапустится).

Шаг 4: Создание суперадминистратора

Откройте новый терминал и выполните команду для создания пользователя админ-панели:

docker compose exec web python manage.py createsuperuser

Теперь вы можете войти в админ-панель по адресу http://localhost:8000/admin/.