Configuration

Усі налаштування передаються через змінні середовища (файл .env або Docker secrets у /run/secrets).

Основні

Змінна	За замовчуванням	Призначення
TELEGRAM_BOT_TOKEN	—	Токен Telegram-бота.
TELEGRAM_CHANNEL_ID	—	ID каналу для публікації (підтримує аліас TELEGRAM_CHAT_ID).
TELEGRAM_WEBHOOK_SECRET	—	Секрет для перевірки вебхуків Telegram API.
ADMIN_CHAT_ID	—	Чат для адміністративних сповіщень.
DATA_DIR	data	Каталог збереження БД/логів/конфігурації.
SECRET_KEY	—	Секрет сесій/API/Heartbeat (обов'язково задавати!).
VAPID_PRIVATE_KEY / VAPID_PUBLIC_KEY	—	Ключі Web Push (VAPID).
VAPID_CONTACT_EMAIL	contact@weby.guru	Контакт для VAPID.
SCHEDULE_API_URL	—	Кастомне джерело графіків відключень.
ALERTS_API_URL	alerts.in.ua	Основне джерело тривог.
TYPED_ALERTS_API_URL	etryvoga	Джерело типізованих загроз (БПЛА, балістика, тактична авіація).
JAAM_ALERTS_API_URL	jaam.net.ua	Резервне джерело швидкої крос-перевірки тривог.
RADIATION_FALLBACK_URL	SaveEcoBot	Резервне джерело радіаційного фону.
POWER_SAFETY_IMAGE	webyhomelab/power-safety-ua:latest	Іммутабельний тег або sha256 digest образу в Compose.
ALLOWED_ORIGINS	https://power.srvrs.top,http://localhost:5050	CORS-оріджини (через кому).
PORT_BINDING	127.0.0.1	Прив'язка порту контейнера (безпека).

Спостережуваність (Observability)

Змінна	За замовчуванням	Призначення
LOG_FORMAT	json	Формат логів: json (Loki/ELK) або console (dev).
LOG_LEVEL	INFO	Рівень логування (DEBUG/INFO/WARNING/ERROR).
OTEL_ENABLED	false	Увімкнути OpenTelemetry-трасування (true/1).
OTEL_EXPORTER_OTLP_ENDPOINT	http://localhost:4318/v1/traces	OTLP/HTTP endpoint колектора.
OTEL_SERVICE_NAME	power-safety-ua	Ім'я сервісу для колектора.
ENVIRONMENT	production	Середовище розгортання.

Приклад увімкнення трасування

OTEL_ENABLED=true
OTEL_EXPORTER_OTLP_ENDPOINT=http://otel-collector:4318/v1/traces
ENVIRONMENT=production

Докладніше — у розділі Observability.