Update configuration and enhance media processing: add stream token TTL and timeout settings in .env.example, improve error handling in media endpoints, and refactor command handlers for asynchronous operations. Update documentation to reflect current application state and features.

2026-07-25 23:14:55 +03:00
parent a261e261f0
commit 6c18a9da79
42 changed files with 387 additions and 98 deletions
@@ -7,9 +7,12 @@
 **TeleWave** — сервис онлайн-каналов: пользователи смотрят сетку каналов, видео отдаётся из
 хранилища на сервере. Админ управляет каналами и пользователями.

-> Текущее состояние — **база**: вход/регистрация, роли, пользователи, минимальная админка,
-> приветственная главная страница. Каталог каналов и сама раздача видео **не реализованы** —
-> это следующий шаг. Telegram-бот сознательно не делаем.
+> Текущее состояние — **рабочий вертикальный срез**: вход/регистрация, роли, пользователи, админка;
+> библиотека шоу/серий, загрузка и обработка медиа (ffmpeg → HLS-сегменты), реестр изображений,
+> метаданные (TMDb/OMDb), каталог каналов, планировщик эфира (реклама, ТВ-заставки-переходы,
+> weekly-override'ы) и live-раздача HLS с публичным просмотром сетки. Telegram-бот сознательно
+> не делаем. Дальнейшие крупные направления (напр. многоэкземплярное развёртывание, новые доменные
+> фичи) — по сверке с пользователем.

 Архитектура и код-конвенции — прямое зеркало [`D:\Github\PnvPanel`](../PnvPanel) (тот же автор,
 тот же стек), но домен урезан под текущий объём фичи.
@@ -137,9 +140,10 @@ docker compose up -d --build   # только api; postgres — внешний,

 ## Рабочие принципы

- Не начинай крупную реализацию (каталог каналов, раздача видео, транскодинг и т.п.) без сверки
-  с пользователем — это следующий большой этап после базы, архитектурные решения там ещё не приняты.
-  При неоднозначности — вопрос пользователю, не предположение.
+- Базовый вертикальный срез (каналы, планировщик, раздача HLS, обработка медиа) уже реализован —
+  правь его по месту. Но новые крупные направления с непринятыми архитектурными решениями (напр.
+  многоэкземплярное развёртывание, транскод-профили, новые доменные подсистемы) начинай только после
+  сверки с пользователем. При неоднозначности — вопрос пользователю, не предположение.
 - Соблюдай границы слоёв — главный инвариант проекта, как и в PnvPanel.
 - Не коммить и не пуши без явной просьбы.
 - Отвечай пользователю на русском.