mirror of
https://gitverse.ru/kpa39l/vesti.git
synced 2026-09-29 18:05:03 +00:00
kpa39l
fc6d725bd1
- БД: posts.comment TEXT, posts.rewritten_text TEXT (ALTER TABLE, миграция применена)
- GET /candidates: двухпанельный рендер — слева список с группировкой
(source/date/status, свертываемые <details>) + чекбоксы bulk,
справа детали поста (действия, комментарий, пересказ, оригинал с медиа)
- Роуты: POST /candidates/select, /candidates/bulk (approve/reject/reject-old),
/posts/{id}/comment, /posts/{id}/reclassify (qwen), /posts/{id}/rewrite (qwen)
- approve вынесен в impl_approve (переиспользуется bulk-approve: publisher + бандл)
- без JS (только формы); HTML: Jinja2 + Bootstrap 5.3
- Протестировано TestClient: группировка, bulk-reject, comment, reclassify
(реальный qwen), rewrite (реальный qwen), поиск, media, published — зелёные
- openspec: change candidates-mail-ui архивирован (2026-09-13-candidates-mail-ui),
spec влита в openspec/specs/candidates-mail-ui; validate — чисто
- docs: STATUS.md, WALKTHROUGH.md обновлены
112 lines
6.3 KiB
Markdown
112 lines
6.3 KiB
Markdown
# candidates-mail-ui Specification
|
|
|
|
## Purpose
|
|
TBD - created by archiving change candidates-mail-ui. Update Purpose after archive.
|
|
|
|
## Requirements
|
|
|
|
### Requirement: Двухпанельный интерфейс кандидатов
|
|
|
|
Страница кандидатов разделена на две панели: слева список кандидатов (с группировкой),
|
|
справа — детальный просмотр выбранного кандидата с меню действий.
|
|
|
|
#### Scenario: Пользователь открывает список кандидатов
|
|
|
|
Given на странице `GET /candidates`
|
|
When страница загружается
|
|
Then левая панель показывает список кандидатов, правая — детали первого/последнего выбранного
|
|
And активный кандидат подсвечивается
|
|
|
|
#### Scenario: Группировка списка по источнику
|
|
|
|
Given список кандидатов
|
|
When пользователь выбирает группировку «по источнику»
|
|
Then кандидаты сгруппированы по источнику (канал/сайт)
|
|
And каждая группа сворачивается/разворачивается (без JS, через `<details>`)
|
|
|
|
#### Scenario: Группировка по дате поступления
|
|
|
|
When пользователь выбирает группировку «по дате поступления»
|
|
Then кандидаты сгруппированы по дате поступления (сегодня, вчера, ранее)
|
|
And порядок: новые сверху, старые ниже
|
|
|
|
### Requirement: Bulk-операции над выбранными кандидатами
|
|
|
|
Пользователь может выбрать несколько кандидатов (чекбоксы) и выполнить массовое
|
|
действие: одобрить все выбранные / отклонить все выбранные.
|
|
|
|
#### Scenario: Массовое отклонение выбранных
|
|
|
|
Given на левой панели несколько кандидатов с отмеченными чекбоксами
|
|
When пользователь нажимает «Отклонить выбранные»
|
|
Then все отмеченные кандидаты получают статус «отклонён»
|
|
And действие выполняется транзакционно (все или ни одного)
|
|
|
|
#### Scenario: Массовое одобрение выбранных
|
|
|
|
When пользователь нажимает «Одобрить выбранные»
|
|
Then каждый отмеченный кандидат публикуется (вызывается approve-логика)
|
|
|
|
#### Scenario: Отклонение всех старых постов группы
|
|
|
|
Given группа «ранее» (старые посты)
|
|
When пользователь выбирает «отклонить все в группе»
|
|
Then все посты группы получают статус «отклонён»
|
|
|
|
### Requirement: Действия над конкретным кандидатом
|
|
|
|
Правая панель содержит меню действий: Опубликовать, Отклонить, Переклассифицировать,
|
|
Переписать новость под себя, блок «Мой комментарий», оригинальный пост со всеми медиа.
|
|
|
|
#### Scenario: Опубликовать кандидата
|
|
|
|
Given выбран кандидат в правой панели
|
|
When пользователь нажимает «Опубликовать»
|
|
Then пост публикуется (существующая логика approve, publisher)
|
|
|
|
#### Scenario: Отклонить кандидата
|
|
|
|
When пользователь нажимает «Отклонить»
|
|
Then пост получает статус «отклонён» и исчезает из активных кандидатов
|
|
|
|
#### Scenario: Переклассифицировать кандидата
|
|
|
|
When пользователь нажимает «Переклассифицировать»
|
|
Then запускается классификатор для данного поста
|
|
And направление/relevance/interest обновляются, изменения видны на карточке
|
|
|
|
#### Scenario: Переписать новость под себя
|
|
|
|
When пользователь нажимает «Переписать новость»
|
|
Then LLM генерирует черновик пересказа от первого лица (без копипасты)
|
|
And черновик отображается в текстовом поле для редактирования
|
|
And пользователь может отредактировать и затем опубликовать
|
|
|
|
#### Scenario: Комментарий к кандидату
|
|
|
|
Given в правой панели блок «Мой комментарий»
|
|
When пользователь вводит текст и сохраняет
|
|
Then комментарий сохраняется и отображается при повторном открытии кандидата
|
|
|
|
#### Scenario: Оригинальный пост со всеми медиа
|
|
|
|
Given выбран кандидат с медиа
|
|
Then правая панель показывает оригинальный текст поста, все изображения/видео
|
|
(через роут /media/), мета источника (канал, время, views/reactions)
|
|
|
|
### Requirement: Фильтрация и поиск по списку
|
|
|
|
Список кандидатов можно фильтровать по статусу (новые/одобренные/отклонённые)
|
|
и искать по тексту.
|
|
|
|
#### Scenario: Фильтр по статусу
|
|
|
|
Given на странице кандидатов
|
|
When пользователь выбирает фильтр «новые»
|
|
Then в списке остаются только новые кандидаты
|
|
|
|
#### Scenario: Поиск по тексту
|
|
|
|
When пользователь вводит текст в поиск
|
|
Then список фильтруется по вхождению в текст поста
|