fix(web): keep bulk checkbox selection across post navigation (openspec change keep-bulk-checkboxes)

- Save/restore checked candidate ids in sessionStorage (vesti_bulk_candidates / vesti_bulk_selected) - Restore checks after page reload when opening a post via ?selected=N - Fix selector: checkboxes live outside <form> (form=bulk-form attribute), query input[name=ids] globally - Openspec: new capability candidates-bulk-selection, change archived
2026-09-29 18:05:03 +00:00 · 2026-09-17 00:52:51 +00:00
parent 8777a0c4a4
commit c8fe5f7c85
8 changed files with 208 additions and 6 deletions
@@ -0,0 +1,2 @@
+schema: spec-driven
+created: 2026-09-17
@@ -0,0 +1,34 @@
+## Context
+
+Страницы /candidates и /selected (FastAPI + Jinja2 + Bootstrap, шаблоны web/templates/candidates.html и selected.html) имеют общий паттерн: слева список постов с чекбоксами массового выбора (form bulk-form, input name=ids), справа детали открытого поста. Открытие поста — обычная GET-навигация (?selected=N), которая перезагружает страницу: сервер отдаёт checked только для текущего поста, остальные отметки теряются. Серверный код (web/app.py) менять не требуется — фикс чистого frontend.
+
+## Goals / Non-Goals
+
+**Goals:**
+- Сохранять отметки чекбоксов между перезагрузками страницы (навигация по постам) на /candidates и /selected.
+- Восстанавливать отметки при загрузке; считать sel-count по восстановленному состоянию.
+- Сбрасывать состояние после успешной отправки bulk-формы.
+
+**Non-Goals:**
+- Не менять серверный рендеринг, API, БД.
+- Не делать мульти-выбор «как в трекере» со сложным состоянием на сервере — только сохранение существующих чекбоксов.
+
+## Decisions
+
+1. **Хранилище — sessionStorage браузера (не localStorage, не сервер).**
+   - Отметки нужны только в рамках текущей вкладки/сессии просмотра, серверное состояние не требуется (список кандидатов меняется от краула, ids в sessionStorage «протухнут» — это ок, чекбокс просто не найдётся).
+   - localStorage переживал бы вкладки и захламлялся бы; серверное состояние = лишний API + потеря при «назад».
+   - Ключ: `vesti_bulk_<page>` где page ∈ {candidates, selected}. Изоляция страниц (требование спеки) — автоматически через разные ключи.
+
+2. **JS-инициализация в конце body (block scripts), как существующий скрипт подсчёта.**
+   - После загрузки DOM: прочитать sessionStorage, проставить checked всем чекбоксам ids из сохранённого Set, затем вызвать upd() для счётчика.
+   - Перехват change на чекбоксах: перезапись Set в sessionStorage (add/delete по value).
+   - Перехват submit bulk-form: очистить sessionStorage (отметки отправлены — состояние больше не нужно).
+
+3. **Чекбокс открытого поста** продолжает получать `checked` от сервера (существующая логика `{% if selected and selected.id == p.id %}checked{% endif %}`) — сохраняется текущее поведение; поверх него восстанавливаются остальные.
+
+## Risks / Trade-offs
+
+- [Отметки «протухают» при повторном использовании страницы позже] → ок: sessionStorage живёт до закрытия вкладки; ids не найденных постов игнорируются.
+- [Дублирование кода в двух шаблонах] → приёмлемо: шаблоны уже дублируют bulk-логику; выносить общий JS в static-файл можно позже отдельным change-ом.
+- [Отключённый JS] → до фикса поведение было «отметки сбрасываются при навигации»; после фикса без JS — то же самое, регрессии нет.
@@ -0,0 +1,29 @@
+## Why
+
+При массовом отборе кандидатов пользователь отмечает несколько постов чекбоксами, затем открывает один из них для просмотра (ссылка ?selected=N). Перезагрузка страницы сбрасывает все отмеченные чекбоксы, кроме чекбокса текущего поста, — приходится отмечать их заново, что замедляет работу с потоком кандидатов.
+
+## What Changes
+
+- Сохранять отмеченные чекбоксы постов при переходе по ссылке ?selected=N (открытие поста в правой панели) в списках кандидатов (/candidates) и отобранных (/selected).
+- Механизм: состояние чекбоксов хранится в sessionStorage браузера по ключу с namespace страницы (candidates/selected) и доп. параметрами фильтров; при перезагрузке страницы отмеченные чекбоксы восстанавливаются.
+- Чекбокс открытого поста остаётся отмеченным (текущее поведение сохраняется).
+- При отправке bulk-формы (Отобрать/Отклонить/Обработать и т.д.) состояние очищается, чтобы не «протухали» старые отметки.
+- Счётчик выбранных (badge sel-count) считается по фактически отмеченным чекбоксам после восстановления.
+
+## Capabilities
+
+### New Capabilities
+
+- `candidates-bulk-selection`: сохранение отметок массового выбора кандидатов между перезагрузками страницы при навигации по постам.
+
+## Status: implemented (2026-09-17)
+
+- Реализовано: скрипты сохранения/восстановления чекбоксов из sessionStorage в candidates.html и selected.html (ключи `vesti_bulk_candidates` / `vesti_bulk_selected`).
+- Проверено в браузере (Camofox): отметки 24/52 на /candidates сохранены при открытии поста 52; отметки 109/110 на /selected сохранены при открытии поста 110; изоляция страниц подтверждена; badge sel-count обновляется.
+- Выявлен и исправлен баг: чекбоксы лежат вне `<form>` (атрибут form="bulk-form"), поэтому исходный селектор `#bulk-form input[name="ids"]` не находил их; заменён на `input[name="ids"]`.
+
+## Impact
+
+- Файлы: web/templates/candidates.html, web/templates/selected.html (JS-скрипт восстановления чекбоксов из sessionStorage).
+- Серверный код не меняется (чистый frontend-fix, без изменения API/БД).
+- Сервис: веб VESTI на bigbox, порт 8400; рестарт не требуется (шаблоны перечитываются при перезагрузке страницы).
@@ -0,0 +1,33 @@
+## Purpose
+
+Сохранение отметок массового выбора кандидатов между перезагрузками страницы при просмотре отдельных постов.
+
+## ADDED Requirements
+
+### Requirement: сохранение отметок чекбоксов при навигации по постам
+
+Когда пользователь отмечает несколько постов чекбоксами в списке кандидатов и затем открывает один из постов (переход по ссылке ?selected=N, перезагрузка страницы), отмеченные ранее чекбоксы MUST оставаться отмеченными.
+
+#### Scenario: открытие поста сохраняет отметки
+- **WHEN** пользователь отметил несколько постов чекбоксами в списке кандидатов и открыл один из постов по ссылке ?selected=N
+- **THEN** все ранее отмеченные чекбоксы остаются отмеченными после перезагрузки страницы
+
+#### Scenario: сброс отметок после массовой операции
+- **WHEN** пользователь выполнил массовую операцию (Отобрать/Отклонить) над отмеченными постами
+- **THEN** отметки сбрасываются и счётчик выбранных показывает 0
+
+### Requirement: изоляция состояния по страницам и фильтрам
+
+Состояние чекбоксов MUST храниться отдельно для страницы кандидатов и страницы отобранных, чтобы отметки одной страницы не влияли на другую.
+
+#### Scenario: независимость кандидаты/отобранные
+- **WHEN** пользователь отметил посты на странице кандидатов и перешёл на страницу отобранных
+- **THEN** на странице отобранных не восстанавливаются отметки со страницы кандидатов
+
+### Requirement: счётчик выбранных соответствует восстановленным отметкам
+
+Счётчик выбранных (badge sel-count) MUST отображать количество фактически отмеченных чекбоксов после восстановления состояния при загрузке страницы.
+
+#### Scenario: счётчик после восстановления
+- **WHEN** страница загружена и восстановлены сохранённые отметки чекбоксов
+- **THEN** счётчик показывает количество восстановленных отметок
@@ -0,0 +1,14 @@
+## 1. candidates.html — сохранение чекбоксов
+
+- [x] 1.1 В script-блок candidates.html добавить: чтение сохранённого Set ids из sessionStorage (`vesti_bulk_candidates`), простановку checked восстановленным чекбоксам; verify: после открытия поста ?selected=N ранее отмеченные чекбоксы остаются отмеченными
+- [x] 1.2 В script-блок candidates.html перехватить change чекбоксов (запись/удаление id в sessionStorage) и submit bulk-form (очистка sessionStorage); verify: отметка/снятие чекбокса обновляет sessionStorage, после отправки bulk-формы sessionStorage пуст
+
+## 2. selected.html — сохранение чекбоксов
+
+- [x] 2.1 В script-блок selected.html добавить восстановление чекбоксов из sessionStorage (`vesti_bulk_selected`) по аналогии с candidates.html; verify: отметки сохраняются при навигации по /selected
+- [x] 2.2 В script-блок selected.html перехватить change чекбоксов и submit bulk-form (очистка); verify: после «Обработать моделью»/«Опубликовать» отметки сбрасываются
+
+## 3. Проверка счётчика и интеграции
+
+- [x] 3.1 Проверить, что badge sel-count показывает количество восстановленных отметок после перезагрузки; verify: открыть /candidates, отметить 2-3 поста, открыть пост, счётчик показывает прежнее число
+- [x] 3.2 Проверить изоляцию /candidates и /selected (отметки одной страницы не восстанавливаются на другой); verify: отметить на /candidates, перейти на /selected — там пусто