From 6db142d45a3e7d97406dd7bebdd127ff0b1dbb22 Mon Sep 17 00:00:00 2001
From: Max Ronzhin <m.ronzhin@ssphera.ru>
Date: Mon, 10 Aug 2026 16:09:27 +0300
Subject: [PATCH] =?UTF-8?q?docs(env):=20=D0=BE=D0=BF=D0=B8=D1=81=D0=B0?=
 =?UTF-8?q?=D1=82=D1=8C=20=D0=B6=D0=B8=D0=B2=D1=8B=D0=B5=20=D0=BA=D0=BB?=
 =?UTF-8?q?=D1=8E=D1=87=D0=B8=20.env.example,=20=D1=83=D0=B1=D1=80=D0=B0?=
 =?UTF-8?q?=D1=82=D1=8C=20=D0=BC=D1=91=D1=80=D1=82=D0=B2=D1=8B=D0=B5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

MEDIA_URL и VITE_API_URL нигде не читаются (grep по backend/, frontend/src/,
deploy/ не даёт совпадений) — удалены. MEDIA_ROOT и EGRESS_START_TIMEOUT_S
живут в backend/core/config.py, но отсутствовали в .env.example — добавлены
с описанием. LIVEKIT_WS_URL читается в deploy/docker-compose.yml (egress) и
deploy/egress/egress.yaml, в Python-конфиге его нет — тоже описан.
---
 .env.example | 26 +++++++++++++++++++++++---
 1 file changed, 23 insertions(+), 3 deletions(-)

diff --git a/.env.example b/.env.example
index dd9c9ff..20b4439 100644
--- a/.env.example
+++ b/.env.example
@@ -2,6 +2,11 @@
 POSTGRES_USER=vidconf
 POSTGRES_PASSWORD=vidconf
 POSTGRES_DB=vidconf
+# DATABASE_URL нужен ТОЛЬКО для запуска backend/worker на хосте вне docker-сети
+# (см. docs/deploy/dev-setup.md) — внутри контейнеров docker-compose.yml
+# всегда собирает postgresql+asyncpg://${POSTGRES_USER}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB}
+# сам (сессия 37), это значение игнорируя. Держите пароль в этой строке
+# синхронным с POSTGRES_PASSWORD.
 DATABASE_URL=postgresql+asyncpg://vidconf:vidconf@localhost:5432/vidconf
 
 # --- Redis ---
@@ -128,7 +133,7 @@ SMTP_TIMEOUT_S=30
 # --- Версия инстанса (релиз v0.0.1) ---
 # install.sh копирует значение из корневого файла VERSION при каждой
 # установке/обновлении — руками менять не нужно.
-VIDCONF_VERSION=0.0.36
+VIDCONF_VERSION=0.0.37
 
 # --- Профили compose. Дефолт ниже (`media,monitoring`) — только для ручного
 # `docker compose up` БЕЗ install.sh: медиа (LiveKit+coturn) + мониторинг,
@@ -190,7 +195,22 @@ GRAFANA_ADMIN_PASSWORD=change-me-grafana
 # ссылаются на них (проверено grep'ом при харденинге репозитория). Оставлены
 # здесь только для полноты покрытия реальных ключей сервера; вычистить или
 # начать использовать — по итогам Сессии 2 (bug hunt). ---
-MEDIA_URL=http://localhost/media/
-VITE_API_URL=http://localhost
 VITE_LIVEKIT_URL=ws://localhost:7880
 NEXT_PUBLIC_LIVEKIT_URL=ws://localhost:7880
+
+# --- Медиа (аватары пользователей, backend/core/config.py: media_root) ---
+# Каталог, куда сохраняются загруженные файлы (аватары); раздаётся статикой
+# по /media (dev) либо через nginx location /media/ в проде.
+MEDIA_ROOT=media
+
+# --- Egress (backend/core/config.py: egress_start_timeout_s) ---
+# Таймаут ожидания ответа Track Egress (секунды). Когда egress-сервис в
+# деплое не поднят (профиль transcribe отсутствует), не ждать его штатный
+# (гораздо более долгий) таймаут на каждый вызов.
+EGRESS_START_TIMEOUT_S=3.0
+
+# --- LiveKit Egress (deploy/docker-compose.yml, сервис egress; см. также
+# deploy/egress/egress.yaml) — WS-адрес LiveKit ИЗНУТРИ docker-сети, отдельно
+# от LIVEKIT_URL/LIVEKIT_PUBLIC_URL выше (те — для backend/браузера). В
+# backend/core/config.py не читается — потребитель только egress. ---
+LIVEKIT_WS_URL=ws://livekit:7880