docs(env): описать живые ключи .env.example, убрать мёртвые

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-конфиге его нет — тоже описан.
This commit is contained in:
2026-08-10 16:09:27 +03:00
parent 1c2a9cd24a
commit 6db142d45a

View File

@@ -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