Синхронизация документации и кода

docs/specs/review-ux.md

@@ -2,7 +2,8 @@
 
 Что происходит, когда система не уверена в распознавании и не
 раскладывает файлы автоматически. Когда именно наступает ревью — см.
-[recognition.md](recognition.md); конвенции целевых имён —
+[recognition.md](recognition.md); место состояния `review` в общем потоке —
+[workflow.md](workflow.md); конвенции целевых имён —
 [jellyfin-layout.md](jellyfin-layout.md).
 
 Главный принцип: ревью — это **петля «догадка → подсказка человека →
@@ -82,9 +83,13 @@ Fargo.S02.2015.WEB-DL.1080p.rus.eng                 🟡 review
 
 - **🔁 Уточнить** → бот просит подсказку ответом → перераспознаёт →
   редактирует то же сообщение новым планом. Петля коррекции прямо в чате.
-- **🔢 Выбрать в базе** → кнопки по кандидатам (название · год · id).
-- Точечное переназначение файлов в чат не помещается → **🌐 Открыть в
-  вебе** (deep-link на ту же страницу).
+- Точечное переназначение файлов и выбор кандидата базы в чат не
+  помещаются → **🌐 В вебе** (deep-link на ту же страницу, строится из
+  `telegram.web_base_url`).
+
+> Реально в боте сейчас: ✅ Применить, 📺↔🎬 Тип, 🔁 Уточнить, 🕗 Позже,
+> 🌐 В вебе, ❌ Отклонить. Кнопки «🔢 Выбрать в базе» в чате пока нет —
+> выбор кандидата и ручной ввод id делаются в вебе.
 
 ## Разделение труда
 
@@ -122,7 +127,7 @@ Telegram = одобрить / подсказать / выбрать кандид
 - **«Позже»** паркует загрузку в `deferred` (вернётся в review по
   действию), **«Отклонить»** → `cancelled` (раскладку не делаем), **undo**
   после применения → `reverted` (удаляет только ссылки своего батча, под
-  `media`). Полная карта состояний — в [architecture.md](architecture.md).
+  `media`). Полная карта состояний — в [workflow.md](workflow.md).
 - После отката или отклонения доступна **«Привязать заново»**: перезапускает
   распознавание для той же раздачи (`reverted`/`cancelled → recognizing`) и
   снова приводит в review — раскладка всегда требует ручного подтверждения,
@@ -135,8 +140,12 @@ Telegram = одобрить / подсказать / выбрать кандид
 
 ## Объём по версиям
 
-- **Ф3 (первая версия):** подсказка + перераспознавание; из ручного —
-  переключатель типа, выбор кандидата базы, пометка файла «игнор». Undo —
-  есть.
-- **Ф5:** полный редактор маппинга «файл → серия», ручной режим,
-  подтверждение в Telegram с reply-подсказкой и эскалацией в веб.
+- **Ф3 (готово):** в вебе — подсказка + перераспознавание, «Распознать
+  заново», переключатель типа, выбор кандидата базы / ручной ввод id /
+  «без базы», пометка файла «игнор», «Применить»/«Отклонить»/«Позже»,
+  Undo и «Привязать заново». В Telegram — подтверждение с reply-подсказкой
+  («Уточнить»), переключатель типа, «Позже»/«Отклонить» и эскалация в веб;
+  пинги о входе в review и готовности.
+- **Ф5 (на будущее):** полный редактор маппинга «файл → серия»
+  (правка S·E, «нумеровать подряд»), ручной режим при полном провале LLM,
+  выбор кандидата базы и ввод id прямо в Telegram.