avandClaude Opus 4.8
322bd8aa5b
Влил 3 ADDED (единый список источников, ручное добавление по id/URL, предпросмотр полей до фиксации) и 2 MODIFIED (превью для каждого источника; матч ссылкой в списке источников) требования в openspec/specs/web-ui. Change перенесён в changes/archive. Убрал реализованный пункт из беклога, перецелил ссылки на review-ux.md. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
6.2 KiB
6.2 KiB
1. Ядро: эфемерный предпросмотр источника (worker)
- 1.1 Ввести чистую деривацию «источник → полный самосогласованный набор overrides» (кандидат с title/year → пиннит; без — пустая строка в title/year; нейронка → provider=none + пустые title/year) и переиспользовать её в превью и в коммите — гарантия preview == apply (решение 1a design.md)
- 1.2 Привести команды выбора к этой деривации:
ChooseCandidateу безтайтлового кандидата иClearProviderочищаютovrTitle/ovrYear(пустой строкой) — чинит латентный залипший override - 1.3 Выделить чистый расчёт «план + набор overrides источника → поля +
[]layout.Link» из логикиReviewData(переиспользуяapplyOverrides+toLayoutPlan+layouter.BuildLinks), без записи overrides в БД - 1.4 Расширить
ReviewDataсрезом источников: нейронка (синтетическая строкаprovider=none) + каждый кандидат; для каждого — эффективные поля (тип/название/год), превью путей и признак «активен»; дедуп источников поprovider:id(нейронка — отдельная строка) - 1.5 Тесты worker: превью для неактивного источника не пишет overrides и не создаёт ссылок; пути превью совпадают с результатом применения того же источника; переключение с титульного кандидата на нейронку/ безтайтловый источник не тянет чужие название/год (preview и apply); нейронка-строка = раскладка без тега провайдера
2. Ручное добавление источника (worker + store + httpapi)
- 2.1 Парсер ручного ввода в
httpapi: id или URL записи метабазы →(provider, provider_id)(обратный кproviderURL: themoviedb.org movie/tv, thetvdb, imdb); валидация на входной границе - 2.2 Метод worker «добавить источник вручную»: сохранить
metadata_candidate(provider/id, опц. url; title/year пустые) с дедупом поprovider:id, затем выбрать его (какChooseCandidate) - 2.3 Обработчик POST добавления ручного источника + маршрут; отклонять некорректный ввод сообщением, не меняя активный источник
- 2.4 Тесты: URL → provider+id; невалидный ввод отклонён; дубль id не плодит строку, а выбирает существующую
3. Страница ревью: единый список и предпросмотр (httpapi + шаблон)
- 3.1 Переработать блок «Источник совпадения» в единый список строк из
[]SourceOption: нейронка (первой) + кандидаты баз + ручной ввод; ровно один активный, у активного — матч-ссылка (как сейчас) - 3.2 Строка источника: шапка (провайдер/название/год + маркер активного + кнопка «выбрать») и раскрываемый по клику блок предпросмотра — поля (тип/название/год + пустое место под режиссёра) и целевые пути; данные всех источников предпосчитаны сервером и вложены в страницу
- 3.3 Секцию «Раскладка» оставить отдельной — показывает пути активного источника (как сейчас); инлайн-превью в строках — только для сравнения неактивных до выбора
- 3.4 Клиентский vanilla-JS: раскрытие/скрытие предпосчитанного превью
строки по клику (нативный
<details>или минимальный JS); без доменного пересчёта на клиенте - 3.5 Действия строк формами-раундтрипами: выбрать кандидата
(
ChooseCandidate), снять в пользу нейронки (ClearProvider), добавить вручную; сохранить прежние действия ревью - 3.6 Убедиться, что матч-ссылка и заголовок строки корректны для ручного кандидата с пустыми title/year (деградация до «провайдер + id»)
4. Проверка и приёмка
- 4.1
task testиtask lintзелёные - 4.2 Ручная проверка сценариев спеки: нейронка-строка, переключение кандидатов, снятие в пользу нейронки, ручной ввод по URL, предпросмотр без фиксации
- 4.3
openspec validate review-source-selection --strict - 4.4 Обновить
docs/specs/review-ux.md(источник истины по review-домену до миграции): единый список источников, ручное добавление, предпросмотр, объём Ф3/Ф5 — обязательно (поведение экрана меняется); убрать пункт беклога после archive