Веб: лента изменений и история в карточке задачи (#77) #78

Merged
aep merged 6 commits from feat/77-feed into main 2026-10-22 11:35:04 +03:00
27 changed files with 889 additions and 20 deletions

View File

@ -24,8 +24,9 @@
| `importer` | разовый импорт CSV-пакета в заметки, сверка с зеркалом | `mirror`, `settings` |
| `cli` | `init`, `serve`, `import`, `mcp`, `tokens`, `agent publish` | `api`, `mcp_server`, `importer`, `release`, `settings`, `db`, `paths` |
`web/` — веб-приложение хаба (React + TypeScript + Vite): вход по клиентскому токену, страницы «Доска» (`/app/board`)
и «Задачи» (`/app/issues`); текущий проект — `?project=<метка>` в адресе (`web/src/projects/`: контекст проекта, выпадающий список «Проект», окно «Новый проект», заглушка «проект не найден»; страницы пересоздаются по `key={project}`); карточка `/app/issues/{key}` — окно поверх страницы, с которой её открыли: `shell/Layout.tsx` рисует
`web/` — веб-приложение хаба (React + TypeScript + Vite): вход по клиентскому токену, страницы «Доска» (`/app/board`),
«Задачи» (`/app/issues`) и «Лента» (`/app/feed`: журнал изменений `GET /changes` за период; `web/src/feed/` — чистые
функции `events.ts` (период, виды, текст события, группировка) и `EventList.tsx`, общий с блоком «История» карточки); текущий проект — `?project=<метка>` в адресе (`web/src/projects/`: контекст проекта, выпадающий список «Проект», окно «Новый проект», заглушка «проект не найден»; страницы пересоздаются по `key={project}`); карточка `/app/issues/{key}` — окно поверх страницы, с которой её открыли: `shell/Layout.tsx` рисует
страницу по адресу из `location.state.background` (`useRoutes` с явным адресом) и `issues/IssueModal.tsx` поверх неё. Собирается `make web` в `src/jira_hub/web/app/`; `api` отдаёт сборку
без токена (`/app/assets/*` — файлы, прочие `/app…` — `index.html`, 503 без сборки), `/` и `/links` перенаправляет на
`/app/board`. Данные — только через HTTP API с клиентским токеном; `mirror.board` отдаёт зеркало без преобразований,

View File

@ -24,7 +24,7 @@
- `uv sync` — установка окружения.
- `uv run jira-hub init --config PATH [--force]` — настройки проекта из `config.example.json`, создание токенов.
- `uv run jira-hub serve [--host] [--port]` — локальный запуск хаба.
- Веб-приложение — `http://127.0.0.1:8790/app/` (доска — `/app/board?project=<метка>`, задачи — `/app/issues?project=<метка>`; вход по клиентскому токену); `/` и `/links` перенаправляют на доску.
- Веб-приложение — `http://127.0.0.1:8790/app/` (доска — `/app/board?project=<метка>`, задачи — `/app/issues?project=<метка>`, лента изменений — `/app/feed?project=<метка>`; вход по клиентскому токену); `/` и `/links` перенаправляют на доску.
- `make web` — сборка приложения (после `git pull` на Mac mini, до перезапуска хаба); `make check` — pytest + lint и тесты фронта; `cd web && npm run dev` — разработка с прокси на тестовый хаб `bash web/scripts/test-hub.sh` (:8791); `cd web && npm run e2e` — Playwright; `cd web && npm run golden` — перегенерировать эталоны доски из `links.html@3931a88` (только при смене фикстур).
- `uv run jira-hub import FOLDER` — импорт CSV-пакета `admin/jira-sync`; `uv run jira-hub mcp [--project <метка>]` — MCP по stdio (с привязкой сессии к проекту); `uv run jira-hub tokens` — показать токены.
- `uv run jira-hub agent publish PATH` — опубликовать версию агента для самообновления (только вверх).

View File

@ -78,7 +78,8 @@ claude mcp add -s user jira-hub -- uv run --project /Users/andrey.epifancev/proj
| Инструмент | Параметры | Результат |
|---|---|---|
| `issues` | фильтры как у `GET /issues`, `limit` | таблица задач проекта сессии |
| `issue` | `key` | поля, связи, заметки, последние команды |
| `issue` | `key` | поля, связи, заметки, последние команды, комментарии, 5 последних изменений («изменения (N)») |
| `changes` | `hours`, `since`, `until` (ISO; без смещения — местное время), `kinds` (`status`, `description`, `dates`, `comment`, `other` или `all`), `key` | лента изменений по задачам: что закрылось, правки описания, сроки, новые комментарии; по умолчанию — с начала суток; без привязки — только с `key` |
| `notes_set` | `key`, поля заметок | обновлённые заметки |
| `batch_create` | `title`, `commands` (у `ensure_attachment` вместо `file` можно `path` — абсолютный путь к локальному файлу до 10 МБ) | `id`, оценка длительности, число команд |
| `batch_status` | `id` | статусы команд, ошибки, оценка остатка |
@ -89,7 +90,7 @@ claude mcp add -s user jira-hub -- uv run --project /Users/andrey.epifancev/proj
| `projects` | нет | проекты хаба: метка, название, доска, тип доски, число задач; проект сессии отмечен |
| `project_create` | `label`, `name`, `board_id` (необязательно) | проект заведён, пакет обновления `#N`, готовый фрагмент `.mcp.json` для репозитория проекта |
| `agent_status` | нет | онлайн/офлайн, версия, текущая команда, 429 за сутки |
| `sync_log` | `limit` | последние загрузки состояния |
| `sync_log` | `limit` | последние загрузки состояния и «журнал: принят / нет» |
| `settings_get`, `settings_set` | ключ, значение | значение / новая `settings_version` |
Автор команд из MCP: `claude`; из API без автора: `api`; из веб-приложения: `viewer`.
@ -170,12 +171,14 @@ uv run jira-hub agent publish ../jira-agent/src/agent.py
| `GET /agent/commands/{id}` | агент | команда по id |
| `POST /agent/commands/{id}/result` | агент | отчёт о выполнении (идемпотентно) |
| `POST /agent/state` | агент | загрузка состояния задач пачками |
| `POST /agent/history` | агент | журнал изменений Jira пачками (агент v13+, по `history` в `refresh`) → `{accepted, duplicates}`; повторы отбрасываются, неверная пачка — 422 `bad_history` |
| `GET /agent/known-keys` | агент | ключи зеркала |
| `GET /agent/release` | агент | опубликованная версия агента `{version, sha256, content}`; 404 `no_release` |
| `GET /agent/files/{sha256}` | агент | файл вложения `{file, size, content}` (`content` — base64); 404 `no_file` |
| `GET /projects`, `POST /projects` | клиент | проекты `{projects: […]}` (метка, название, `board_id`, `board_type`, число задач) / завести `{label, name, board_id?, author?}` → 201 `{project, batch_id}` и пакет «Новый проект <метка>» (`refresh` по общей JQL); 409 `project_exists`, 422 `bad_project`, 422 `bad_batch` (постановка `refresh` отказана) |
| `GET /issues` | клиент | фильтры `project` (метка; неизвестная — 404), `sprint`, `assignee`, `work_kind`, `fact_status`, `status`, `label`, `epic`, `neighbor`, `q`, `hide_closed` (`1` — без задач в статусах из настройки `closed_statuses`, по умолчанию «Готово», «Снято»), `limit`, `offset` |
| `GET /issues/{key}` | клиент | задача целиком |
| `GET /issues/{key}` | клиент | задача целиком, с комментариями и журналом изменений `changes` (новые сверху) |
| `GET /changes` | клиент | лента изменений: `since`, `until` (ISO со смещением или `Z`, иначе 422; по умолчанию — последние 24 ч), `project` (только свои задачи), `key`, `kinds`, `limit` (до 2000) → `{since, until, truncated, changes}` |
| `GET /board` | клиент | `?project=<метка>` (неизвестная — 404): снимок для доски — свои задачи проекта, соседи (связи в обе стороны) и эпики своих задач, с `fact_status`/`work_kind`; связи — те, у которых хотя бы один конец — своя задача проекта (без `project` — все задачи и связи), `last_sync` — последний успешный полный прогон |
| `GET /`, `GET /links` | — | перенаправление на `/app/board` |
| `PUT /issues/{key}/note` | клиент | заметки (частично) |
@ -184,7 +187,7 @@ uv run jira-hub agent publish ../jira-agent/src/agent.py
| `POST /commands/{id}/retry`, `POST /commands/{id}/cancel` | клиент | повтор (новый пакет; `project` в теле — отказ, если команда не из этого проекта) / отмена (`force` для взятой) |
| `POST /refresh` | клиент | `{keys}`, `{jql}` или `{full: true}` (общая JQL по меткам всех проектов; проектов нет — 422 «нет проектов») |
| `POST /files` | клиент | загрузить файл вложения `{content: base64}` → `{file: sha256, size}`; не base64 — 400, пустой — 422 `empty_file`, больше 10 МБ (10 485 760 байт) — 413 `too_large`; повтор того же содержимого — тот же `file` |
| `GET /agent`, `GET /sync-runs` | клиент | состояние агента (с `release`, `update_state`, `launcher_version`, `agent_reported`, `update_hint`), журнал загрузок |
| `GET /agent`, `GET /sync-runs` | клиент | состояние агента (с `release`, `update_state`, `launcher_version`, `agent_reported`, `update_hint`), журнал загрузок (`history_at` — когда принят журнал изменений полного прогона) |
| `GET /settings`, `PUT /settings` | клиент | настройки (PUT частично, поднимает `settings_version`; ответ — все настройки после записи, как у GET); `base_jql` вычисляется из проектов (без проектов — `null`), запись `base_jql` и `board_id` — 422 |
```bash
@ -194,7 +197,7 @@ curl -s -H "Authorization: Bearer $TOKEN" "http://127.0.0.1:8790/issues?sprint=
## Веб-приложение
Адреса: `http://127.0.0.1:8790/app/` — доска `/app/board?project=<метка>`, задачи `/app/issues?project=<метка>`, карточка `/app/issues/{key}` — окно поверх списка или доски (закрытие — ✕, Esc, щелчок по фону; прямой адрес открывает окно поверх списка задач); `/` и
Адреса: `http://127.0.0.1:8790/app/` — доска `/app/board?project=<метка>`, задачи `/app/issues?project=<метка>`, лента изменений `/app/feed?project=<метка>` (период и виды событий, история — и в карточке задачи), карточка `/app/issues/{key}` — окно поверх списка или доски (закрытие — ✕, Esc, щелчок по фону; прямой адрес открывает окно поверх списка задач); `/` и
`/links` перенаправляют на доску. Вход по клиентскому токену (`uv run jira-hub tokens`), токен хранится в браузере;
`localhost` и `127.0.0.1` — разные сайты для браузера, токен и раскладка у каждого свои. Выкатка на Mac mini:

View File

@ -0,0 +1,87 @@
# Лента изменений в веб-приложении — Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** страница «Лента» (`/app/feed`) и блок «История» в карточке задачи поверх готовых `GET /changes` и
`GET /issues/{key}.changes`.
**Architecture:** модуль `web/src/feed/`: чистые функции `events.ts` (период, виды из адреса, текст события,
группировка), компонент `EventList.tsx` (общий для ленты и карточки), страница `FeedPage.tsx`. Маршрут — `shell/pages.tsx`,
раздел — `shell/Sidebar.tsx`, запрос — `api/queries.ts` (`useChanges`, ключ `["changes", …]`), перечитывание после
«Обновить из Jira» — `shell/RefreshProvider.tsx`.
**Tech Stack:** React 19 + TypeScript, TanStack Query, react-router, Vitest + Testing Library, Playwright.
**Spec:** `openspec/changes/web-feed/` (proposal, design 1–7, `specs/web-app/spec.md`: MODIFIED «Оболочка и адреса»,
ADDED «Лента изменений», «История в карточке задачи»). Контракт хаба — `openspec/specs/hub-api/spec.md` «Лента
изменений», «История задачи в карточке».
**Worktree:** `/Users/andrey.epifancev/projects/jira-bridge/jira-hub/.wt/feed`, ветка `feat/77-feed` (aep/jira-hub#77).
## Global Constraints
- Бэкенд (`src/jira_hub/`) не меняется.
- Тексты событий — ровно по спеке: «статус «было» → «стало»», «описание изменено», «срок ДД.ММ → ДД.ММ» / «плановое начало …» / «плановое окончание …», «комментарий: <300 символов…>», «<подпись>: «было» → «стало»» (значения до 80 символов с «…», пустое — «—»).
- Подписи прочих полей: `assignee` исполнитель, `Sprint` спринт, `labels` метки, `priority` приоритет, `summary` тема, `epic_link` эпик, `Link` связь, `Attachment` вложение, `resolution` резолюция; иначе имя поля как есть.
- Период: `2h` | `today` (по умолчанию, в адрес не пишется) | `yesterday` | `7d`; границы по местному времени, в запрос — `toISOString()`. `limit=2000`.
- Виды: `status`, `description`, `dates`, `comment`, `other`; по умолчанию первые четыре (в адрес не пишутся); подписи флажков «Статусы», «Описание», «Сроки», «Комментарии», «Прочие поля».
- Цвета и отступы — только токены дизайн-системы (`styles/tokens.css`), базовые компоненты из `web/src/ui/`; `dangerouslySetInnerHTML` не появляется; новых зависимостей нет.
- Коммиты — с `(#77)` и строкой `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`. Зелёный — `make check` и `cd web && npm run e2e`.
- Решения вне спеки и плана — в `openspec/changes/web-feed/design.md`, раздел «Decisions made without discussion», маркер `R-n`.
## Review Focus
1. Ответ хаба без `changes` у карточки (старый хаб) и пустой `changes: []` — карточка не падает: нет блока / «изменений нет» (тесты в Task 3).
2. Событие с `at = null`, `author = null`, `from`/`to` = null — строка без «null»/«Invalid Date» (тест в Task 1).
3. Адрес с мусором `period=foo`, `kinds=status,foo` — страница не падает: период по умолчанию, неизвестные виды отброшены (тест в Task 1).
4. Смена проекта в панели на открытой ленте — запрос по новому проекту, период и виды из адреса сохраняются (тест в Task 2).
5. Длинный однословный текст комментария/значения — не ломает ширину (CSS `overflow-wrap: anywhere`) и нет горизонтальной прокрутки на 390 px (e2e в Task 2).
---
### Task 1: `feed/events.ts`, тип события, запрос `useChanges`, перечитывание
**Files:**
- Create: `web/src/feed/events.ts`, `web/src/feed/events.test.ts`
- Modify: `web/src/api/types.ts` (`ChangeEvent`, `ChangesResponse`, `IssueDetail.changes?: ChangeEvent[]`), `web/src/api/queries.ts` (`qk.changes`, `useChanges`), `web/src/shell/RefreshProvider.tsx` (инвалидация `["changes"]`), `web/src/shell/refresh.test.tsx` (ожидание)
**Interfaces (produces):**
- `type ChangeKind = "status" | "description" | "dates" | "comment" | "other"`; `interface ChangeEvent { at: string | null; key?: string; summary?: string | null; status?: string | null; kind: ChangeKind; field: string; author: string | null; from: string | null; to: string | null; from_value: string | null; to_value: string | null }`; `interface ChangesResponse { since: string; until: string; truncated: boolean; changes: ChangeEvent[] }`.
- `type Period = "2h" | "today" | "yesterday" | "7d"`; `PERIODS: { value: Period; label: string }[]` (2 часа, Сегодня, Вчера, 7 дней); `parsePeriod(v: string | null): Period`; `periodRange(p: Period, now: Date): { since: Date; until: Date }`.
- `KINDS: { value: ChangeKind; label: string }[]`, `DEFAULT_KINDS`; `parseKinds(v: string | null): ChangeKind[]` (неизвестные отброшены, `null`/пусто → по умолчанию); `kindsParam(k: ChangeKind[]): string | null` (`null` для набора по умолчанию).
- `eventTime(at: string | null, now: Date, alwaysDate = false): string` (`ЧЧ:ММ` / `ДД.ММ ЧЧ:ММ` / «—»); `eventText(e: ChangeEvent): string`; `groupByIssue(events: ChangeEvent[]): { key: string; summary: string | null; status: string | null; events: ChangeEvent[] }[]`.
- `useChanges(q: { project: string; since: string; until: string; kinds: string }, enabled: boolean)` → `useQuery<ChangesResponse>`, ключ `qk.changes(q) = ["changes", q]`, `limit: 2000`.
- [ ] **Step 1: Tests** — `events.test.ts`: `periodRange` для всех четырёх при `now = new Date(2026, 9, 22, 14, 5)` (today → 22.10 00:00–14:05; yesterday → 21.10 00:00–22.10 00:00; 2h → 12:05; 7d → 15.10 14:05); `parsePeriod("foo") === "today"`; `parseKinds("status,foo") → ["status"]`, `parseKinds(null)` → по умолчанию; `kindsParam(DEFAULT_KINDS) === null`; `eventText` на каждом виде (статус, описание, срок по `from_value` `2026-10-23` → «срок 23.10 → —», плановое окончание со строкой без ISO-значения, комментарий 350 символов → 300 + «…», прочее `assignee` → «исполнитель: «—» → «ivanov»», незнакомое поле — как есть); `eventTime(null, …) === "—"`, сегодня — `ЧЧ:ММ`, вчера — `21.10 ЧЧ:ММ`, `alwaysDate` — с датой; `groupByIssue` — порядок групп по первому появлению. `refresh.test.tsx` — после пакета инвалидируется и `["changes"]`.
- [ ] **Step 2: Run** `cd web && npx vitest run src/feed src/shell/refresh.test.tsx` — FAIL
- [ ] **Step 3: Implement**
- [ ] **Step 4: Run** `make check` — зелёный
- [ ] **Step 5: Commit** — `Лента: события, период и запрос /changes (#77)`
### Task 2: Страница «Лента», раздел в панели
**Files:**
- Create: `web/src/feed/FeedPage.tsx`, `web/src/feed/EventList.tsx`, `web/src/feed/feed.css`, `web/src/feed/FeedPage.test.tsx`, `web/e2e/feed.spec.ts`
- Modify: `web/src/shell/pages.tsx` (`/feed` под `ProjectGate`), `web/src/shell/Sidebar.tsx` (`Section` + «Лента», значок `IconHistory` в `ui/icons.tsx`), `web/src/shell/Layout.tsx` (если там список разделов для `section`), `web/src/shell/Sidebar.test.tsx`
**Interfaces:**
- `FeedPage({ project }: { project: string })` — `PageHeader` «Лента» с подзаголовком «N событий · ДД.ММ ЧЧ:ММ — ДД.ММ ЧЧ:ММ», `Segmented` периода (кнопки, запись в адрес через `setSearchParams`), флажки видов (`Checkbox`), `EventList` по группам; пустые/ошибка/truncated — `Notice` с текстами спеки.
- `EventList({ events, now, alwaysDate }: { events: ChangeEvent[]; now: Date; alwaysDate?: boolean })` — `<ul>` строк «время · автор · текст».
- Группа: `IssueLink` с ключом, тема, `Badge` статуса.
- [ ] **Step 1: Tests** — `FeedPage.test.tsx` (через `App` и `mockFetch`, как `Sidebar.test.tsx`): сценарии спеки «Что закрылось за два часа» (адрес и параметры запроса), «Карточка из ленты» (клик по ключу → диалог карточки, закрытие → лента с тем же `period`), «Пустой период», `truncated`, ошибка 500 с «Повторить», все флажки сняты → подсказка и нет запроса; Review Focus 3 (`period=foo&kinds=status,foo`) и 4 (смена проекта). `Sidebar.test.tsx` — раздел «Лента» ведёт на `/feed?project=…` и отмечается `aria-current`. `e2e/feed.spec.ts` — засеять журнал агентским `POST /agent/history` (элементы с `created` = сейчас, ключи из фикстуры `hub-basic`), открыть «Лента», увидеть событие, открыть карточку; на 390 px нет горизонтальной прокрутки.
- [ ] **Step 2: Run** `cd web && npx vitest run src/feed src/shell` — FAIL
- [ ] **Step 3: Implement**
- [ ] **Step 4: Run** `make check` и `cd web && npm run e2e` — зелёные
- [ ] **Step 5: Commit** — `Страница «Лента» и раздел в панели (#77)`
### Task 3: «История» в карточке, документация
**Files:**
- Modify: `web/src/issues/IssueCard.tsx` (блок `History` после `Comments`), `web/src/issues/IssueCard.test.tsx`, `ARCHITECTURE.md` (раздел `web/`: страница «Лента», `feed/`), `CLAUDE.md` репозитория (адрес `/app/feed` в «Команды»)
- [ ] **Step 1: Tests** — сценарий спеки «Карточка с историей» (12 событий → 10 + «Показать все (12)» → 12), `changes: []` → «изменений нет», без поля `changes` → нет заголовка «История» (Review Focus 1); строки — с датой (`alwaysDate`).
- [ ] **Step 2: Run** `cd web && npx vitest run src/issues/IssueCard.test.tsx` — FAIL
- [ ] **Step 3: Implement**, документация
- [ ] **Step 4: Run** `make check` и `cd web && npm run e2e` — зелёные
- [ ] **Step 5: Commit** — `История изменений в карточке задачи (#77)`

View File

@ -0,0 +1,2 @@
schema: spec-driven
created: 2026-10-22

View File

@ -0,0 +1,42 @@
## Context
`main` 78a0d78. Веб-приложение — React 19 + TanStack Query, страницы рисует `shell/Layout.tsx` по `shell/pages.tsx`,
разделы — `shell/Sidebar.tsx` (`SECTIONS`), проект — `ProjectGate`, карточка — окно `IssueModal` поверх страницы
(`IssueLink`/`useOpenIssue` с `openCardState`). Запросы — `api/queries.ts` (`qk`), перечитывание после «Обновить из
Jira» — `shell/RefreshProvider.tsx`. Хаб: `GET /changes` (`since`/`until` — ISO со смещением, иначе 422; `kinds`,
`project`, `limit` ≤ 2000, ответ `{since, until, truncated, changes}`), `GET /issues/{key}.changes`.
## Decisions
1. **Модуль `web/src/feed/`**: `events.ts` — чистые функции (границы периода, разбор `kinds` из адреса, текст события,
группировка по задаче), `EventList.tsx` — список событий (лента и карточка), `FeedPage.tsx` — страница, `feed.css`.
2. **Период — переключатель из четырёх, а не календарь**: покрывает «за пару часов» и «за сегодня» владельца; «Вчера» и
«7 дней» — утренний разбор и неделя. Границы считаются по местному времени браузера, в запрос уходят
`toISOString()` (UTC с `Z`) — хаб принимает `Z`, пояс не теряется.
3. **`limit` = 2000** (максимум хаба) — неделя активного проекта помещается; иначе `truncated` с подсказкой.
4. **Подписи прочих полей** — словарь в `events.ts`; незнакомые — имя поля Jira.
5. **Комментарий в ленте — простой текст** (300 символов одной строкой), без вики-разметки: лента — обзор, полный текст
— в карточке.
6. **История в карточке — 10 последних с «Показать все»**; блок в основной колонке после комментариев.
7. **Перечитывание**: ключ запроса `["changes", {project, period, kinds}]`, границы периода считаются в момент запроса
(окно всегда «до сейчас»); `RefreshProvider` после пакета инвалидирует `["changes"]`; при возврате на вкладку —
`refetchOnWindowFocus: true` у `useChanges` (в клиенте приложения по умолчанию оно выключено). Подзаголовок берёт
окно из ответа хаба.
## Decisions made without discussion
1. 2026-10-22 — **все решения выше (1–7) — мои**: владелец сказал «начинай» без обсуждения интерфейса. Цена ошибки:
переделка вёрстки страницы; бэкенд не затронут.
2. 2026-10-22 — **R-1: смена проекта на ленте сохраняет `period` и `kinds`** (`Layout.select`). Обоснование: они от
проекта не зависят; фильтры доски и списка по-прежнему сбрасываются. Цена ошибки: нет.
3. 2026-10-22 — **R-2: снятые все флажки пишутся в адрес как `kinds=none`.** Обоснование: пустое значение означало бы
набор по умолчанию. Цена ошибки: «none» виден в адресе.
4. 2026-10-22 — **R-3: в e2e флажок — щелчок и ожидание `toBeChecked`, а не `locator.check`.** Обоснование: флажок
управляемый, состояние приходит из адреса после навигации роутера. Цена ошибки: нет.
5. 2026-10-22 — **R-4 (по C-1/C-2 финального ревью): границы периода — в момент запроса, ключ кэша без них;
`refetchOnWindowFocus: true` у ленты.** Обоснование: замороженная при открытии граница «до» не давала перечитыванию
показать новые события, а фокус вкладки в приложении не перечитывал ничего. Цена ошибки: лишний запрос `/changes`
при возврате на вкладку (не чаще раза в 30 с — `staleTime`).
6. 2026-10-22 — **R-5 (follow-up M-5 финального ревью): адрес без единого известного вида — набор по умолчанию, а не
пустой; пустой набор — только явное `kinds=none`.** Обоснование: ссылка с устаревшим видом не должна открывать
пустую ленту. Цена ошибки: нет.

View File

@ -0,0 +1,25 @@
## Why
Хаб уже хранит журнал изменений задач (change-history, #70): лента `GET /changes` и история задачи в
`GET /issues/{key}`, в MCP — инструмент `changes`. Владелец хочет видеть то же в веб-приложении: что закрылось и
поменялось за последние часы или за день, и как менялась задача — в её карточке. Решение владельца 22.10.2026: делать
веб-часть после редизайна (#69), теперь он закрыт; детали интерфейса владелец отдал на усмотрение («начинай»).
## What Changes
- Новый раздел «Лента» в боковой панели и страница `/app/feed`: период (2 часа / Сегодня / Вчера / 7 дней), флажки видов
событий, события сгруппированы по задаче, ключ открывает карточку окном.
- Блок «История» в карточке задачи.
- Бэкенд не меняется.
## Non-Goals
- Свой интервал дат (календарь) — переключателя периодов достаточно; при нужде — позже.
- Лента по всем проектам сразу и по соседям проекта.
- Уведомления о новых событиях, автообновление по таймеру.
- Отображение текста правки описания (было/стало) — только факт правки.
## Anti-Goals
- Лента молча показывает не тот период (часовой пояс).
- Страница или карточка ломается на старом хабе без `changes`.

View File

@ -0,0 +1,94 @@
## MODIFIED Requirements
### Requirement: Оболочка и адреса
Приложение SHALL открываться под префиксом `/app/` и иметь страницы `/app/board` (доска связей), `/app/issues` (список
задач), `/app/feed` (лента изменений, требование «Лента изменений») и `/app/issues/{key}` (карточка задачи — окно поверх страницы, требование «Карточка задачи»); `/app` и `/app/` SHALL вести на `/app/board`, неизвестный путь —
на страницу «не найдено» со ссылками на разделы. Боковая панель SHALL быть закреплена у левого края окна на всю его
высоту и MUST NOT прокручиваться вместе со страницей; страница занимает остальную ширину. Сверху вниз панель SHALL
содержать: название «Хаб Jira» и кнопку «Свернуть панель»; выпадающий список проектов («<метка> — <название>», текущий
отмечен, в конце «+ Новый проект…»; требование «Проект в приложении»); разделы «Доска связей», «Задачи» и «Лента» — вертикальным
списком ссылок со значками (текущий отмечен `aria-current="page"`); внизу — блок данных Jira с действием «Обновить из
Jira» (требование «Обновление из Jira»), переключатель темы (требование «Тема») и меню с действием «Сменить токен».
Свёрнутая панель SHALL быть узкой полосой с теми же действиями значками: «Развернуть панель», метка текущего проекта,
разделы, «Обновить из Jira» с точкой состояния агента, тема, меню; названия — в подсказках и `aria-label`. Свёртка
SHALL храниться в `localStorage` под ключом `jira-hub-sidebar` (`collapsed`; без записи — развёрнута). На экранах уже
640 px панели в потоке нет: сверху SHALL быть закреплена строка с кнопкой «Меню», названием и кнопкой «Обновить из
Jira»; «Меню» открывает развёрнутую панель поверх страницы, панель закрывается выбором раздела, клавишей Escape или
щелчком мимо неё. Горизонтальной прокрутки страницы на любой ширине нет.
Неожиданная ошибка отрисовки страницы SHALL показываться сообщением с кнопкой «Перезагрузить», не пустым экраном.
#### Scenario: Переход между разделами
- **WHEN** на доске в боковой панели выбран раздел «Задачи»
- **THEN** адрес — `/app/issues` с текущим проектом, показан список задач; «назад» возвращает на доску
#### Scenario: Раздел «Лента»
- **WHEN** на доске в боковой панели выбран раздел «Лента»
- **THEN** адрес — `/app/feed` с текущим проектом, показана лента изменений за сегодня; раздел отмечен в панели
#### Scenario: Сменить токен
- **WHEN** в меню боковой панели выбрано «Сменить токен»
- **THEN** токен очищен, показан экран входа
#### Scenario: Панель на месте при прокрутке
- **WHEN** доска прокручена до самого низа
- **THEN** боковая панель видна целиком на прежнем месте: разделы и «Обновить из Jira» доступны без прокрутки вверх
#### Scenario: Свёрнутая панель
- **WHEN** нажата «Свернуть панель», страница перезагружена
- **THEN** панель свёрнута в полосу значков, доска шире; значок «Задачи» открывает список задач; «Развернуть панель»
возвращает полную панель
#### Scenario: Узкий экран
- **WHEN** ширина окна 390 px, нажата «Меню», в панели выбран раздел «Задачи»
- **THEN** панель открылась поверх страницы, после выбора закрыта, показан список задач; горизонтальной прокрутки нет
## ADDED Requirements
### Requirement: Лента изменений
Страница `/app/feed?project=<метка>` SHALL показывать события журнала изменений своих задач текущего проекта за период
(`GET /changes` с `project`, `since`, `until`, `kinds`). Период SHALL выбираться переключателем «2 часа» / «Сегодня» /
«Вчера» / «7 дней» (по умолчанию «Сегодня»; границы — по местному времени браузера: «Сегодня» — с начала текущих суток
до сейчас, «Вчера» — с начала прошлых суток до начала текущих) и храниться в адресе (`period=2h|today|yesterday|7d`;
«Сегодня» в адрес не пишется). Виды событий SHALL выбираться флажками «Статусы», «Описание», «Сроки», «Комментарии»,
«Прочие поля» (по умолчанию все, кроме «Прочие поля») и храниться в адресе (`kinds=` через запятую; набор по умолчанию в
адрес не пишется; в адресе нет ни одного известного вида — набор по умолчанию); снятые все флажки — сообщение «выберите
хотя бы один вид», запроса нет.
События SHALL быть сгруппированы по задаче; задачи — по времени последнего события, новые сверху. У группы: ключ —
ссылка на карточку задачи (окно поверх ленты, требование «Карточка задачи»), тема и текущий статус; под ней события по
времени, новые сверху, каждое — время (`ЧЧ:ММ`, с датой `ДД.ММ`, если событие не в текущих сутках), автор и текст:
статус — «статус «было» → «стало»»; описание — «описание изменено»; срок, плановое начало и окончание — «срок ДД.ММ →
ДД.ММ» (дата по значению `from_value`/`to_value`, иначе строка журнала; пустое — «—»); комментарий — «комментарий:» и
первые 300 символов текста одной строкой с «…»; прочие поля — «<название поля>: «было» → «стало»» (значения до 80
символов с «…»), где название — подпись из словаря приложения (исполнитель, спринт, метки, приоритет, тема, эпик, связь,
вложение, резолюция), иначе имя поля Jira. Подзаголовок страницы — число событий и границы периода. Событий нет —
сообщение «за период изменений нет»; `truncated` — сообщение «показаны последние N событий — выберите период короче».
Ошибка хаба — сообщение с кнопкой «Повторить». Ленту SHALL перечитывать завершение «Обновить из Jira» (вместе со списками
задач) и возврат на вкладку браузера.
#### Scenario: Что закрылось за два часа
- **WHEN** открыта лента проекта AWPCA, выбран период «2 часа», сняты все флажки, кроме «Статусы»
- **THEN** адрес — `/app/feed?project=AWPCA&period=2h&kinds=status`; запрос `GET /changes?project=AWPCA&since=<сейчас − 2 ч>&kinds=status`;
задачи сгруппированы, у каждой — события «ЧЧ:ММ автор: статус «В работе» → «Готово»»
#### Scenario: Карточка из ленты
- **WHEN** в ленте нажат ключ AURORA-9002
- **THEN** поверх ленты открыто окно карточки AURORA-9002; закрытие окна возвращает ленту с тем же периодом
#### Scenario: Пустой период
- **WHEN** за выбранный период событий нет
- **THEN** показано «за период изменений нет»
#### Scenario: Вчера
- **WHEN** выбран период «Вчера», сейчас 22.10 14:05 местного времени
- **THEN** запрос с `since` = 21.10 00:00 и `until` = 22.10 00:00 местного времени
### Requirement: История в карточке задачи
Карточка задачи SHALL показывать в основной колонке после комментариев блок «История (N)» — события `changes` из
`GET /issues/{key}` (все виды, новые сверху) в том же виде, что в ленте, всегда с датой. Видны 10 последних событий,
остальные — по кнопке «Показать все (N)»; без событий — подсказка «изменений нет»; ответ хаба без поля `changes` —
блока нет.
#### Scenario: Карточка с историей
- **WHEN** открыта карточка задачи с 12 событиями журнала
- **THEN** блок «История (12)» показывает 10 последних событий и кнопку «Показать все (12)»; после нажатия — все 12

46
web/e2e/feed.spec.ts Normal file
View File

@ -0,0 +1,46 @@
import { expect, test } from "@playwright/test";
import { HUB_URL } from "../playwright.config.ts";
import { login, tokens } from "./hub.ts";
// журнал изменений засевается агентским маршрутом, как его шлёт агент v13 (#70); id записей уникальны на прогон
async function seedHistory() {
const run = Date.now();
const created = new Date(Date.now() - 10 * 60_000).toISOString();
const changes = [
{ history_id: `e2e-${run}-1`, seq: 0, key: "AURORA-9002", created, author: "Петров Пётр", field_id: "status",
field_name: "status", from: "1", from_string: "В работе", to: "2", to_string: "Готово" },
{ history_id: `e2e-${run}-2`, seq: 0, key: "AURORA-9002", created, author: "Петров Пётр", field_id: "assignee",
field_name: "assignee", from: null, from_string: null, to: "x".repeat(200), to_string: "Очень-длинное-имя-без-пробелов-".repeat(8) },
];
const r = await fetch(HUB_URL + "/agent/history", { method: "POST", headers: { Authorization: "Bearer " + tokens().agent, "Content-Type": "application/json" }, body: JSON.stringify({ changes }) });
expect(r.ok).toBe(true);
}
test("лента: событие за сегодня, карточка окном поверх ленты, история в карточке", async ({ page }) => {
await seedHistory();
await login(page, "/app/feed?project=AWPCA");
const group = page.getByTestId("feed-group").filter({ has: page.getByRole("link", { name: "AURORA-9002", exact: true }) });
await expect(group.getByText("статус «В работе» → «Готово»").first()).toBeVisible();
const other = page.getByRole("checkbox", { name: "Прочие поля" });
await other.click(); // флажок управляемый: состояние приходит из адреса после навигации
await expect(other).toBeChecked();
await expect(page).toHaveURL(/kinds=status%2Cdescription%2Cdates%2Ccomment%2Cother|kinds=status,description,dates,comment,other/);
await expect(group.getByText(/исполнитель:/).first()).toBeVisible();
await group.getByRole("link", { name: "AURORA-9002", exact: true }).click();
const d = page.getByRole("dialog");
await expect(d.getByRole("heading", { name: "API свода" })).toBeVisible();
await expect(d.getByRole("heading", { name: /^История \(\d+\)$/ })).toBeVisible();
await expect(d.getByTestId("history").getByText("статус «В работе» → «Готово»").first()).toBeVisible();
await page.keyboard.press("Escape");
await expect(page.getByRole("dialog")).toHaveCount(0);
await expect(page.getByTestId("page-feed")).toBeVisible();
});
test("лента на 390 px: нет горизонтальной прокрутки при длинных значениях", async ({ page }) => {
await seedHistory();
await page.setViewportSize({ width: 390, height: 844 });
await login(page, "/app/feed?project=AWPCA&kinds=status,other");
await expect(page.getByTestId("feed-group").first()).toBeVisible();
const overflow = await page.evaluate(() => document.documentElement.scrollWidth - window.innerWidth);
expect(overflow).toBeLessThanOrEqual(0);
});

View File

@ -1,6 +1,6 @@
import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import { api } from "./client.ts";
import type { BoardSnapshot, CreatedProject, HubSettings, IssueDetail, IssueRow, Note, NoteFields, Project } from "./types.ts";
import type { BoardSnapshot, ChangesResponse, CreatedProject, HubSettings, IssueDetail, IssueRow, Note, NoteFields, Project } from "./types.ts";
// фильтры списка в адресе; hide_closed в адрес не пишется — его выводит список из флажка «скрыть закрытые» (closed=1 — снят)
export const ISSUE_FILTER_NAMES = ["sprint", "assignee", "work_kind", "status", "label", "epic", "neighbor", "q"] as const;
@ -14,8 +14,23 @@ export const qk = {
boardAll: ["board"] as const, // префикс: все снимки досок сразу (инвалидация)
issues: (f: IssueFilters) => ["issues", f] as const,
issue: (key: string) => ["issue", key] as const,
changes: (q: ChangesQuery) => ["changes", q] as const,
};
// лента изменений: в ключе — проект, период и виды; границы считаются в момент запроса (bounds), поэтому перечитывание
// (после «Обновить из Jira», при возврате на вкладку) берёт окно «до сейчас», а не до открытия страницы (C-1, C-2);
// limit — максимум хаба (design web-feed #3)
export interface ChangesQuery { project: string; period: string; kinds: string }
export const CHANGES_LIMIT = 2000;
export const useChanges = (q: ChangesQuery, bounds: () => { since: Date; until: Date }, enabled = true) =>
useQuery({
queryKey: qk.changes(q), enabled, refetchOnWindowFocus: true,
queryFn: () => {
const { since, until } = bounds();
return api.get<ChangesResponse>("/changes", { project: q.project, kinds: q.kinds, since: since.toISOString(), until: until.toISOString(), limit: CHANGES_LIMIT });
},
});
export const useSettings = () =>
useQuery({ queryKey: qk.settings, queryFn: () => api.get<HubSettings>("/settings"), staleTime: Infinity });

View File

@ -41,6 +41,14 @@ export interface IssueLinkOut { target_key: string; link_type: string; summary:
export interface IssueLinkIn { source_key: string; link_type: string; summary: string | null; status: string | null }
// комментарий задачи из Jira (зеркало хаба, агент v10+): текст и время — как в Jira
export interface IssueComment { comment_id: string; author: string | null; created: string | null; updated: string | null; body: string }
// событие журнала изменений (GET /changes, GET /issues/{key}.changes; в истории задачи нет key/summary/status)
export type ChangeKind = "status" | "description" | "dates" | "comment" | "other";
export interface ChangeEvent {
at: string | null; key?: string; summary?: string | null; status?: string | null; kind: ChangeKind; field: string;
author: string | null; from: string | null; to: string | null; from_value: string | null; to_value: string | null;
}
export interface ChangesResponse { since: string; until: string; truncated: boolean; changes: ChangeEvent[] }
export interface IssueDetail extends IssueRow {
epic_summary: string | null;
links_out: IssueLinkOut[];
@ -48,6 +56,7 @@ export interface IssueDetail extends IssueRow {
note: Note | null;
commands: IssueCommand[];
comments: IssueComment[];
changes?: ChangeEvent[]; // хаб до журнала изменений (#70) поля не шлёт
}
export type BatchStatus = "queued" | "running" | "done" | "cancelled";

View File

@ -0,0 +1,20 @@
import type { ChangeEvent } from "../api/types.ts";
import { eventText, eventTime } from "./events.ts";
import "./feed.css";
// строки событий журнала: время, автор, что изменилось (лента и история в карточке; spec web-app «Лента изменений»)
export function EventList({ events, now, alwaysDate = false }: { events: ChangeEvent[]; now: Date; alwaysDate?: boolean }) {
return (
<ul className="feed-events">
{events.map((e, n) => (
<li key={n} className="feed-event">
<span className="feed-event__time">{eventTime(e.at, now, alwaysDate)}</span>
<span className="feed-event__body">
<span className="feed-event__author">{e.author ?? "—"}</span>{" "}
<span className="feed-event__text">{eventText(e)}</span>
</span>
</li>
))}
</ul>
);
}

View File

@ -0,0 +1,187 @@
import { render, screen, waitFor, within } from "@testing-library/react";
import userEvent from "@testing-library/user-event";
import { readFileSync } from "node:fs";
import { join } from "node:path";
import { createMemoryRouter } from "react-router";
import { focusManager } from "@tanstack/react-query";
import { act } from "@testing-library/react";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { App } from "../App.tsx";
import type { ChangeEvent } from "../api/types.ts";
import { setToken } from "../auth/token.ts";
import settings from "../board/__fixtures__/settings.json";
import { routes } from "../routes.tsx";
import { json, mockFetch } from "../test/fetchMock.ts";
import { issue } from "../test/issueFixtures.ts";
const SNAP = JSON.parse(readFileSync(join(import.meta.dirname, "..", "board", "__fixtures__", "hub-basic.board.json"), "utf8"));
const A = { label: "AWPCA", name: "АРМ КА", board_id: null, board_type: null, created_at: "", issues_count: 9 };
const B = { label: "STOCKS", name: "Запасы", board_id: null, board_type: null, created_at: "", issues_count: 1 };
const minutesAgo = (m: number) => new Date(Date.now() - m * 60_000).toISOString();
const ev = (over: Partial<ChangeEvent>): ChangeEvent => ({
at: minutesAgo(30), key: "AURORA-9002", summary: "API свода", status: "Готово", kind: "status", field: "status",
author: "Петров Пётр", from: "В работе", to: "Готово", from_value: null, to_value: null, ...over,
});
type Changes = { since?: string; until?: string; truncated?: boolean; changes: ChangeEvent[] } | Response;
function hub(changes: () => Changes = () => ({ changes: [] })) {
const calls: URL[] = [];
mockFetch((method, url) => {
const k = `${method} ${url.pathname}`;
if (k === "GET /changes") {
calls.push(url);
const r = changes();
return r instanceof Response ? r : json(200, { since: "", until: "", truncated: false, ...r });
}
if (k === "GET /projects") return json(200, { projects: [A, B] });
if (k === "GET /settings") return json(200, settings);
if (k === "GET /board") return json(200, SNAP);
if (k === "GET /issues") return json(200, { issues: [] });
if (k === "GET /batches") return json(200, { batches: [] });
if (k === "GET /agent") return json(200, { online: true, last_seen_at: null });
if (k.startsWith("GET /issues/")) return json(200, issue(decodeURIComponent(url.pathname.split("/").pop()!)));
return json(404, { error: "not_found" });
});
return calls;
}
const open = (path: string) => {
const router = createMemoryRouter(routes, { initialEntries: [path], basename: "/app" });
render(<App router={router} />);
return router;
};
const page = () => screen.findByTestId("page-feed");
describe("лента изменений", () => {
beforeEach(() => { setToken("tok"); localStorage.clear(); });
afterEach(() => { vi.useRealTimers(); focusManager.setFocused(undefined); });
it("C-1/C-2: возврат на вкладку перечитывает ленту с границей «до» на момент запроса", async () => {
vi.useFakeTimers({ toFake: ["Date"] });
vi.setSystemTime(new Date(2026, 9, 22, 10, 0));
const calls = hub();
open("/app/feed?project=AWPCA");
await page();
await waitFor(() => expect(calls.length).toBe(1));
expect(new Date(calls[0].searchParams.get("until")!).getTime()).toBe(new Date(2026, 9, 22, 10, 0).getTime());
vi.setSystemTime(new Date(2026, 9, 22, 11, 30));
act(() => { focusManager.setFocused(false); focusManager.setFocused(true); });
await waitFor(() => expect(calls.length).toBe(2));
expect(new Date(calls[1].searchParams.get("until")!).getTime()).toBe(new Date(2026, 9, 22, 11, 30).getTime());
expect(new Date(calls[1].searchParams.get("since")!).getTime()).toBe(new Date(2026, 9, 22, 0, 0).getTime());
});
it("по умолчанию — «Сегодня», виды без «Прочих полей», события сгруппированы по задаче", async () => {
const calls = hub(() => ({ changes: [
ev({}), ev({ key: "AURORA-9001", summary: "Схема", status: "В работе", kind: "comment", field: "comment", from: null, to: "Готово к проверке" }),
ev({ at: minutesAgo(40), kind: "description", field: "description" }),
] }));
open("/app/feed?project=AWPCA");
await page();
const groups = await screen.findAllByTestId("feed-group");
expect(groups.map((g) => within(g).getByRole("link").textContent)).toEqual(["AURORA-9002", "AURORA-9001"]);
expect(within(groups[0]).getByText("API свода")).toBeInTheDocument();
expect(within(groups[0]).getByText(/статус «В работе» → «Готово»/)).toBeInTheDocument();
expect(within(groups[0]).getByText("описание изменено")).toBeInTheDocument();
expect(within(groups[1]).getByText("комментарий: Готово к проверке")).toBeInTheDocument();
const q = calls[0].searchParams;
expect(q.get("project")).toBe("AWPCA");
expect(q.get("kinds")).toBe("status,description,dates,comment");
const midnight = new Date(); midnight.setHours(0, 0, 0, 0);
expect(new Date(q.get("since")!).getTime()).toBe(midnight.getTime());
expect(q.get("limit")).toBe("2000");
expect(screen.getByRole("radio", { name: "Сегодня" })).toHaveAttribute("aria-checked", "true");
expect(screen.getByText(/3 события/)).toBeInTheDocument();
});
it("«Что закрылось за два часа»: период и виды в адресе и в запросе", async () => {
const calls = hub();
const router = open("/app/feed?project=AWPCA");
await page();
await userEvent.click(screen.getByRole("radio", { name: "2 часа" }));
for (const name of ["Описание", "Сроки", "Комментарии"]) await userEvent.click(screen.getByRole("checkbox", { name }));
await waitFor(() => expect(router.state.location.search).toBe("?project=AWPCA&period=2h&kinds=status"));
expect(router.state.location.pathname).toBe("/app/feed");
await waitFor(() => expect(calls.at(-1)!.searchParams.get("kinds")).toBe("status"));
const since = new Date(calls.at(-1)!.searchParams.get("since")!).getTime();
expect(Math.abs(Date.now() - 2 * 3600_000 - since)).toBeLessThan(60_000);
});
it("карточка из ленты — окно поверх, закрытие возвращает ленту с тем же периодом", async () => {
hub(() => ({ changes: [ev({})] }));
const router = open("/app/feed?project=AWPCA&period=7d");
await page();
await userEvent.click(await screen.findByRole("link", { name: "AURORA-9002" }));
const d = await screen.findByRole("dialog");
expect(await within(d).findByRole("heading", { name: "Тема AURORA-9002" })).toBeInTheDocument();
expect(screen.getByTestId("page-feed")).toBeInTheDocument();
await userEvent.click(within(d).getAllByRole("button", { name: "Закрыть" })[0]);
await waitFor(() => expect(screen.queryByRole("dialog")).toBeNull());
expect(router.state.location.pathname + router.state.location.search).toBe("/app/feed?project=AWPCA&period=7d");
});
it("M-1: /app/feed без project — проект дописывается в адрес", async () => {
hub();
const router = open("/app/feed");
await page();
await waitFor(() => expect(router.state.location.search).toBe("?project=AWPCA"));
});
it("M-3/M-6/M-7: подсказка truncated над группами, автор без имени — «—», группы не регионы", async () => {
hub(() => ({ truncated: true, changes: [ev({ author: null })] }));
open("/app/feed?project=AWPCA");
const notice = await screen.findByText("показаны последние 1 событий — выберите период короче");
const group = screen.getByTestId("feed-group");
expect(notice.compareDocumentPosition(group) & Node.DOCUMENT_POSITION_FOLLOWING).toBeTruthy();
expect(within(group).getByText("—", { selector: ".feed-event__author" })).toBeInTheDocument();
expect(within(screen.getByTestId("page-feed")).queryAllByRole("region")).toHaveLength(0);
});
it("пустой период, truncated, ошибка с «Повторить»", async () => {
let mode: "empty" | "truncated" | "error" = "empty";
hub(() => mode === "error" ? json(500, { error: "boom", detail: "сбой" })
: mode === "truncated" ? { truncated: true, changes: [ev({})] } : { changes: [] });
open("/app/feed?project=AWPCA");
expect(await screen.findByText("за период изменений нет")).toBeInTheDocument();
mode = "truncated";
await userEvent.click(screen.getByRole("radio", { name: "Вчера" }));
expect(await screen.findByText("показаны последние 1 событий — выберите период короче")).toBeInTheDocument();
mode = "error";
await userEvent.click(screen.getByRole("radio", { name: "7 дней" }));
const retry = await screen.findByRole("button", { name: "Повторить" });
mode = "empty";
await userEvent.click(retry);
expect(await screen.findByText("за период изменений нет")).toBeInTheDocument();
});
it("все флажки сняты — подсказка, запроса нет", async () => {
const calls = hub();
open("/app/feed?project=AWPCA&kinds=status");
await page();
await waitFor(() => expect(calls.length).toBe(1));
await userEvent.click(screen.getByRole("checkbox", { name: "Статусы" }));
expect(await screen.findByText("выберите хотя бы один вид")).toBeInTheDocument();
expect(calls.length).toBe(1);
});
it("мусор в адресе: период по умолчанию, неизвестные виды отброшены", async () => {
const calls = hub();
open("/app/feed?project=AWPCA&period=foo&kinds=status,foo");
await page();
await waitFor(() => expect(calls.length).toBeGreaterThan(0));
expect(screen.getByRole("radio", { name: "Сегодня" })).toHaveAttribute("aria-checked", "true");
expect(calls[0].searchParams.get("kinds")).toBe("status");
expect(screen.getByRole("checkbox", { name: "Статусы" })).toBeChecked();
expect(screen.getByRole("checkbox", { name: "Сроки" })).not.toBeChecked();
});
it("смена проекта: запрос по новому проекту, период и виды сохраняются", async () => {
const calls = hub();
const router = open("/app/feed?project=AWPCA&period=2h&kinds=status");
await page();
await userEvent.selectOptions(screen.getByRole("combobox", { name: "Проект" }), "STOCKS");
await waitFor(() => expect(calls.at(-1)!.searchParams.get("project")).toBe("STOCKS"));
expect(calls.at(-1)!.searchParams.get("kinds")).toBe("status");
expect(router.state.location.pathname).toBe("/app/feed");
expect(router.state.location.search).toBe("?project=STOCKS&period=2h&kinds=status");
});
});

78
web/src/feed/FeedPage.tsx Normal file
View File

@ -0,0 +1,78 @@
import { useMemo } from "react";
import { useSearchParams } from "react-router";
import { useChanges } from "../api/queries.ts";
import type { ChangeKind } from "../api/types.ts";
import { IssueLink } from "../issues/IssueLink.tsx";
import { Badge, Button, Checkbox, Notice, PageHeader, Panel, Segmented } from "../ui/index.ts";
import { EventList } from "./EventList.tsx";
import { groupByIssue, KINDS, kindsParam, parseKinds, parsePeriod, PERIODS, periodRange, type Period } from "./events.ts";
import "./feed.css";
const pad = (n: number) => String(n).padStart(2, "0");
const stamp = (d: Date) => isNaN(d.getTime()) ? "—" : `${pad(d.getDate())}.${pad(d.getMonth() + 1)} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
function plural(n: number): string {
const m10 = n % 10, m100 = n % 100;
if (m10 === 1 && m100 !== 11) return "событие";
if (m10 >= 2 && m10 <= 4 && (m100 < 12 || m100 > 14)) return "события";
return "событий";
}
// лента изменений проекта за период (spec web-app «Лента изменений», design web-feed 1–7)
export function FeedPage({ project }: { project: string }) {
const [params, setParams] = useSearchParams();
const period = parsePeriod(params.get("period"));
const kinds = useMemo(() => parseKinds(params.get("kinds")), [params]);
// границы считает запрос в момент выполнения (C-1): ключ кэша — проект, период и виды
const changes = useChanges({ project, period, kinds: kinds.join(",") }, () => periodRange(period, new Date()), kinds.length > 0);
const now = new Date(changes.dataUpdatedAt || Date.now()); // «текущие сутки» для времени событий — на момент ответа
const setParam = (name: string, value: string | null) => setParams((p) => {
const n = new URLSearchParams(p);
if (value) n.set(name, value); else n.delete(name);
return n;
});
const choosePeriod = (p: Period) => setParam("period", p === "today" ? null : p);
const toggleKind = (k: ChangeKind, on: boolean) => {
const next = on ? [...kinds, k] : kinds.filter((x) => x !== k);
setParam("kinds", next.length ? kindsParam(next) : "none"); // пустой набор — явное «none», иначе адрес вернул бы умолчание
};
const data = changes.data;
const groups = useMemo(() => groupByIssue(data?.changes ?? []), [data]);
const count = data?.changes.length ?? 0;
// окно — из ответа хаба: подзаголовок совпадает с тем, что показано
const subtitle = kinds.length && data ? `${count} ${plural(count)} · ${stamp(new Date(data.since))} — ${stamp(new Date(data.until))}` : undefined;
return (
<div data-testid="page-feed" className="feed">
<PageHeader title="Лента" subtitle={subtitle} />
<div className="feed__controls">
<Segmented label="Период" value={period} options={PERIODS} onChange={choosePeriod} />
<div className="feed__kinds" role="group" aria-label="Виды событий">
{KINDS.map((k) => (
<Checkbox key={k.value} label={k.label} checked={kinds.includes(k.value)}
onChange={(e) => toggleKind(k.value, e.currentTarget.checked)} />
))}
</div>
</div>
{!kinds.length && <Notice tone="info">выберите хотя бы один вид</Notice>}
{kinds.length > 0 && changes.isError && (
<Notice tone="error" action={<Button onClick={() => void changes.refetch()}>Повторить</Button>}>{(changes.error as Error).message}</Notice>
)}
{kinds.length > 0 && changes.isPending && <p className="feed__hint">Загрузка…</p>}
{data && !count && <Notice tone="info">за период изменений нет</Notice>}
{data?.truncated && <Notice tone="warning">{`показаны последние ${count} событий — выберите период короче`}</Notice>}
{groups.map((g) => (
<Panel key={g.key} className="feed-group" data-testid="feed-group">
<header className="feed-group__head">
<IssueLink issueKey={g.key} className="feed-group__key" />
<span className="feed-group__sum">{g.summary ?? "нет в зеркале"}</span>
{g.status && <Badge>{g.status}</Badge>}
</header>
<EventList events={g.events} now={now} />
</Panel>
))}
</div>
);
}

View File

@ -0,0 +1,81 @@
import { describe, expect, it } from "vitest";
import type { ChangeEvent } from "../api/types.ts";
import { DEFAULT_KINDS, eventText, eventTime, groupByIssue, kindsParam, parseKinds, parsePeriod, periodRange } from "./events.ts";
const NOW = new Date(2026, 9, 22, 14, 5);
const ev = (over: Partial<ChangeEvent> = {}): ChangeEvent => ({
at: "2026-10-22T08:15:00Z", key: "X", summary: "Тема", status: "Готово", kind: "status", field: "status",
author: "Петров", from: "В работе", to: "Готово", from_value: null, to_value: null, ...over,
});
describe("период", () => {
it("границы по местному времени", () => {
expect(periodRange("today", NOW)).toEqual({ since: new Date(2026, 9, 22, 0, 0), until: NOW });
expect(periodRange("yesterday", NOW)).toEqual({ since: new Date(2026, 9, 21, 0, 0), until: new Date(2026, 9, 22, 0, 0) });
expect(periodRange("2h", NOW)).toEqual({ since: new Date(2026, 9, 22, 12, 5), until: NOW });
expect(periodRange("7d", NOW)).toEqual({ since: new Date(2026, 9, 15, 14, 5), until: NOW });
});
it("мусор в адресе — «Сегодня»", () => {
expect(parsePeriod("foo")).toBe("today");
expect(parsePeriod(null)).toBe("today");
expect(parsePeriod("7d")).toBe("7d");
});
});
describe("виды", () => {
it("неизвестные отброшены, пусто — по умолчанию", () => {
expect(parseKinds("status,foo")).toEqual(["status"]);
expect(parseKinds(null)).toEqual(DEFAULT_KINDS);
expect(parseKinds("")).toEqual(DEFAULT_KINDS);
expect(parseKinds("foo")).toEqual(DEFAULT_KINDS); // M-5: ни одного известного — набор по умолчанию
expect(parseKinds("none")).toEqual([]);
});
it("набор по умолчанию в адрес не пишется", () => {
expect(kindsParam([...DEFAULT_KINDS])).toBeNull();
expect(kindsParam(["comment", "status"])).toBe("status,comment");
});
});
describe("текст события", () => {
it("статус, описание, сроки", () => {
expect(eventText(ev())).toBe("статус «В работе» → «Готово»");
expect(eventText(ev({ kind: "description", field: "description" }))).toBe("описание изменено");
expect(eventText(ev({ kind: "dates", field: "duedate", from: "2026-10-23 00:00:00.0", to: null, from_value: "2026-10-23", to_value: null })))
.toBe("срок 23.10 → —");
expect(eventText(ev({ kind: "dates", field: "planned_end", from: "сырое", to: "30/окт/26", from_value: null, to_value: "2026-10-30" })))
.toBe("плановое окончание сырое → 30.10");
expect(eventText(ev({ kind: "dates", field: "planned_start", from: null, to: null }))).toBe("плановое начало — → —");
});
it("комментарий — 300 символов одной строкой", () => {
const t = eventText(ev({ kind: "comment", field: "comment", from: null, to: "а\n" + "к".repeat(350) }));
expect(t).toBe("комментарий: " + ("а " + "к".repeat(350)).slice(0, 300) + "…"); // M-4: 300 символов текста
expect(eventText(ev({ kind: "comment", field: "comment", from: null, to: null }))).toBe("комментарий: —"); // M-6
});
it("прочие поля — подпись из словаря или имя поля", () => {
expect(eventText(ev({ kind: "other", field: "assignee", from: null, to: "ivanov" }))).toBe("исполнитель: «—» → «ivanov»");
expect(eventText(ev({ kind: "other", field: "Компания", from: "А", to: "Б" }))).toBe("Компания: «А» → «Б»");
expect(eventText(ev({ kind: "other", field: "summary", from: "x".repeat(100), to: "y" })))
.toBe(`тема: «${"x".repeat(79)}…» → «y»`);
});
});
describe("время события", () => {
it("сегодня — ЧЧ:ММ, иначе с датой, без времени — прочерк", () => {
expect(eventTime(new Date(2026, 9, 22, 11, 15).toISOString(), NOW)).toBe("11:15");
expect(eventTime(new Date(2026, 9, 21, 9, 5).toISOString(), NOW)).toBe("21.10 09:05");
expect(eventTime(new Date(2026, 9, 22, 11, 15).toISOString(), NOW, true)).toBe("22.10 11:15");
expect(eventTime(null, NOW)).toBe("—");
expect(eventTime("мусор", NOW)).toBe("—");
});
});
describe("группировка", () => {
it("группы в порядке первого появления, у группы тема и статус", () => {
const g = groupByIssue([ev({ key: "Y", summary: "Вторая", status: null }), ev(), ev({ key: "Y", summary: "Вторая", status: null })]);
expect(g.map((x) => [x.key, x.summary, x.status, x.events.length])).toEqual([["Y", "Вторая", null, 2], ["X", "Тема", "Готово", 1]]);
});
});

95
web/src/feed/events.ts Normal file
View File

@ -0,0 +1,95 @@
import type { ChangeEvent, ChangeKind } from "../api/types.ts";
// период ленты: границы по местному времени браузера; «Сегодня» — по умолчанию и в адрес не пишется (spec web-app «Лента изменений»)
export type Period = "2h" | "today" | "yesterday" | "7d";
export const PERIODS: { value: Period; label: string }[] = [
{ value: "2h", label: "2 часа" }, { value: "today", label: "Сегодня" }, { value: "yesterday", label: "Вчера" }, { value: "7d", label: "7 дней" },
];
export const parsePeriod = (v: string | null): Period => (PERIODS.some((p) => p.value === v) ? (v as Period) : "today");
export function periodRange(p: Period, now: Date): { since: Date; until: Date } {
const midnight = new Date(now.getFullYear(), now.getMonth(), now.getDate());
switch (p) {
case "2h": return { since: new Date(now.getTime() - 2 * 3600_000), until: now };
case "yesterday": return { since: new Date(now.getFullYear(), now.getMonth(), now.getDate() - 1), until: midnight };
case "7d": return { since: new Date(now.getFullYear(), now.getMonth(), now.getDate() - 7, now.getHours(), now.getMinutes(), now.getSeconds(), now.getMilliseconds()), until: now };
default: return { since: midnight, until: now };
}
}
export const KINDS: { value: ChangeKind; label: string }[] = [
{ value: "status", label: "Статусы" }, { value: "description", label: "Описание" }, { value: "dates", label: "Сроки" },
{ value: "comment", label: "Комментарии" }, { value: "other", label: "Прочие поля" },
];
export const DEFAULT_KINDS: ChangeKind[] = ["status", "description", "dates", "comment"];
// виды из адреса: неизвестные отбрасываются; пусто или ни одного известного — набор по умолчанию (M-5); «none» — пустой набор (R-2)
export function parseKinds(v: string | null): ChangeKind[] {
if (v === "none") return [];
const asked = (v ?? "").split(",").map((s) => s.trim());
const known = KINDS.map((k) => k.value).filter((k) => asked.includes(k));
return known.length ? known : [...DEFAULT_KINDS];
}
// в адрес — в порядке KINDS; набор по умолчанию не пишется
export function kindsParam(kinds: ChangeKind[]): string | null {
const ordered = KINDS.map((k) => k.value).filter((k) => kinds.includes(k));
return ordered.join(",") === DEFAULT_KINDS.join(",") ? null : ordered.join(",");
}
const pad = (n: number) => String(n).padStart(2, "0");
// «ЧЧ:ММ» для событий текущих суток, иначе «ДД.ММ ЧЧ:ММ»; без времени — «—»
export function eventTime(at: string | null, now: Date, alwaysDate = false): string {
const d = at ? new Date(at) : null;
if (!d || isNaN(d.getTime())) return "—";
const hm = `${pad(d.getHours())}:${pad(d.getMinutes())}`;
const sameDay = d.getFullYear() === now.getFullYear() && d.getMonth() === now.getMonth() && d.getDate() === now.getDate();
return sameDay && !alwaysDate ? hm : `${pad(d.getDate())}.${pad(d.getMonth() + 1)} ${hm}`;
}
const FIELD_LABELS: Record<string, string> = {
assignee: "исполнитель", Sprint: "спринт", labels: "метки", priority: "приоритет", summary: "тема", epic_link: "эпик",
Link: "связь", Attachment: "вложение", resolution: "резолюция",
};
const DATE_LABELS: Record<string, string> = { duedate: "срок", planned_start: "плановое начало", planned_end: "плановое окончание" };
const oneLine = (s: string | null) => (s ?? "").replace(/\s+/g, " ").trim();
const cut = (s: string, n: number) => (s.length <= n ? s : s.slice(0, n - 1) + "…");
const dash = (s: string | null) => (s ? s : "—");
// дата события сроков: по значению вида ГГГГ-ММ-ДД, иначе строка журнала как есть
function day(value: string | null, text: string | null): string {
const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(value ?? "");
return m ? `${m[3]}.${m[2]}` : dash(text);
}
export function eventText(e: ChangeEvent): string {
switch (e.kind) {
case "status": return `статус «${dash(e.from)}» → «${dash(e.to)}»`;
case "description": return "описание изменено";
case "dates": return `${DATE_LABELS[e.field] ?? e.field} ${day(e.from_value, e.from)} → ${day(e.to_value, e.to)}`;
case "comment": { // первые 300 символов текста и «…» (M-4); без текста — «—» (M-6)
const s = oneLine(e.to);
return "комментарий: " + (!s ? "—" : s.length <= 300 ? s : s.slice(0, 300) + "…");
}
default: {
const v = (s: string | null) => (s ? cut(oneLine(s), 80) : "—");
return `${FIELD_LABELS[e.field] ?? e.field}: «${v(e.from)}» → «${v(e.to)}»`;
}
}
}
export interface IssueGroup { key: string; summary: string | null; status: string | null; events: ChangeEvent[] }
// лента уже новые сверху: группы — в порядке первого появления задачи
export function groupByIssue(events: ChangeEvent[]): IssueGroup[] {
const groups = new Map<string, IssueGroup>();
for (const e of events) {
const key = e.key ?? "";
let g = groups.get(key);
if (!g) groups.set(key, (g = { key, summary: e.summary ?? null, status: e.status ?? null, events: [] }));
g.events.push(e);
}
return [...groups.values()];
}

16
web/src/feed/feed.css Normal file
View File

@ -0,0 +1,16 @@
/* лента изменений (spec web-app «Лента изменений»): только токены дизайн-системы */
.feed{display:flex;flex-direction:column;gap:var(--space-4);padding-top:var(--space-6)}
.feed .ui-page-header{margin-bottom:0}
.feed__controls{display:flex;flex-wrap:wrap;align-items:center;gap:var(--space-3) var(--space-5)}
.feed__kinds{display:flex;flex-wrap:wrap;align-items:center;gap:var(--space-2) var(--space-4)}
.feed__hint{margin:0;color:var(--color-text-secondary)}
.feed-group{display:flex;flex-direction:column;gap:var(--space-3);min-width:0}
.feed-group__head{display:flex;flex-wrap:wrap;align-items:center;gap:var(--space-2)}
.feed-group__key{font-family:var(--font-mono);font-size:13px;color:var(--color-action-primary);text-decoration:none}
.feed-group__key:hover{text-decoration:underline}
.feed-group__sum{font-weight:600;min-width:0;overflow-wrap:anywhere}
.feed-events{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:var(--space-2)}
.feed-event{display:flex;gap:var(--space-3);font-size:var(--fs-body);line-height:var(--lh-body);min-width:0}
.feed-event__time{flex:0 0 auto;font-family:var(--font-mono);font-size:13px;color:var(--color-text-secondary);white-space:nowrap}
.feed-event__body{min-width:0;overflow-wrap:anywhere;color:var(--color-text-primary)}
.feed-event__author{font-weight:600}

View File

@ -450,3 +450,35 @@ describe("карточка задачи", () => {
err.mockRestore();
});
});
describe("история в карточке", () => {
beforeEach(() => { setToken("tok"); localStorage.clear(); });
const hist = (n: number) => Array.from({ length: n }, (_, i) => ({
at: new Date(2026, 9, 20, 9, i).toISOString(), kind: "status" as const, field: "status", author: "Петров",
from: "a", to: `s${i}`, from_value: null, to_value: null,
}));
it("12 событий: видны 10 последних и «Показать все (12)», после нажатия — все", async () => {
mockFetch((_m, url) => url.pathname === "/settings" ? json(200, settings) : json(200, issue("AURORA-9001", { changes: hist(12) })));
open("/issues/AURORA-9001");
const sec = await screen.findByTestId("history");
expect(within(sec).getByRole("heading", { name: "История (12)" })).toBeInTheDocument();
expect(within(sec).getAllByRole("listitem")).toHaveLength(10);
expect(within(sec).getAllByRole("listitem")[0]).toHaveTextContent(/^20\.10 09:00/); // с датой всегда
await userEvent.click(within(sec).getByRole("button", { name: "Показать все (12)" }));
expect(within(sec).getAllByRole("listitem")).toHaveLength(12);
});
it("пустая история — «изменений нет»; без поля changes (старый хаб) — блока нет", async () => {
let body = issue("AURORA-9001", { changes: [] });
mockFetch((_m, url) => url.pathname === "/settings" ? json(200, settings) : json(200, body));
open("/issues/AURORA-9001");
const sec = await screen.findByTestId("history");
expect(within(sec).getByText("изменений нет")).toBeInTheDocument();
cleanup();
body = issue("AURORA-9002");
open("/issues/AURORA-9002");
await screen.findByRole("heading", { name: "Тема AURORA-9002" });
expect(screen.queryByTestId("history")).toBeNull();
});
});

View File

@ -2,9 +2,10 @@ import { type RefObject, useLayoutEffect, useRef, useState } from "react";
import { ApiError } from "../api/client.ts";
import { useClosedStatuses } from "../api/closed.ts";
import { useIssue, useSettings } from "../api/queries.ts";
import type { IssueComment, IssueDetail } from "../api/types.ts";
import type { ChangeEvent, IssueComment, IssueDetail } from "../api/types.ts";
import { JIRA_URL } from "../board/constants.ts";
import { fmtDate, fmtStamp } from "../board/model/util.ts";
import { EventList } from "../feed/EventList.tsx";
import { groupLinks, isOverdue, todayISO } from "./card.ts";
import { useCommentsHidden } from "./commentsPref.ts";
import { IssueLink } from "./IssueLink.tsx";
@ -69,6 +70,7 @@ export function IssueCard({ issueKey: key, onClose }: { issueKey: string; onClos
<Links issue={i} linkTypes={(settings.data?.link_types ?? {}) as Record<string, string>} />
{i.description && <Description text={i.description} projectKey={settings.data?.project_key} />}
<Comments items={i.comments ?? []} projectKey={settings.data?.project_key} />
{i.changes && <History items={i.changes} />}
</div>
<Panel className="side">
<Notes key={i.key} issue={i} />
@ -178,6 +180,22 @@ function Comments({ items, projectKey }: { items: IssueComment[]; projectKey?: s
);
}
const HISTORY_SHOWN = 10;
// журнал изменений задачи: 10 последних, остальное — по «Показать все» (spec web-app «История в карточке задачи»)
function History({ items }: { items: ChangeEvent[] }) {
const [all, setAll] = useState(false);
const shown = all ? items : items.slice(0, HISTORY_SHOWN);
return (
<section className="history" data-testid="history">
<div className="sec-head"><h3>История ({items.length})</h3></div>
{!items.length && <p className="hint">изменений нет</p>}
{items.length > 0 && <EventList events={shown} now={new Date()} alwaysDate />}
{!all && items.length > HISTORY_SHOWN && <Button variant="ghost" className="more" onClick={() => setAll(true)}>{`Показать все (${items.length})`}</Button>}
</section>
);
}
function OtherFields({ issue: i }: { issue: IssueDetail }) {
const rows: [string, string | null][] = [
["Тип", i.issue_type], ["Приоритет", i.priority], ["Автор", i.reporter], ["Метки", i.labels.join(", ") || null],

View File

@ -60,7 +60,7 @@ export function Layout() {
: resolveProject(urlLabel, rememberedProject(), projects.data), [projects.isPending, projects.error, projects.data, urlLabel]);
const okLabel = state.kind === "ok" ? state.project.label : null;
const fromUrl = state.kind === "ok" && state.fromUrl;
const onPage = at === "/board" || at === "/issues";
const onPage = at === "/board" || at === "/issues" || at === "/feed";
useEffect(() => { if (okLabel) rememberProject(okLabel); }, [okLabel]);
// выбранный проект записывается в адрес без новой записи истории; с открытой карточкой адрес не трогаем (design 10)
useEffect(() => {
@ -70,8 +70,11 @@ export function Layout() {
}, [okLabel, fromUrl, issueKey, onPage, at, pageLocation.search, navigate]);
const [newOpen, setNewOpen] = useState(false);
const section = at === "/issues" || at === "/board" ? at : null;
const select = useCallback((label: string) => { void navigate({ pathname: section ?? "/board", search: withProject("", label) }); }, [navigate, section]);
const section = at === "/issues" || at === "/board" || at === "/feed" ? at : null;
// смена проекта: фильтры доски и списка — проектные и сбрасываются; период и виды ленты от проекта не зависят (R-1)
const select = useCallback((label: string) => {
void navigate({ pathname: section ?? "/board", search: withProject(section === "/feed" ? pageLocation.search : "", label) });
}, [navigate, section, pageLocation.search]);
const ctx = useMemo<ProjectCtx>(() => ({ state, projects: projects.data ?? [], select, openNew: () => setNewOpen(true) }),
[state, projects.data, select]);
@ -80,7 +83,7 @@ export function Layout() {
<ProjectContext value={ctx}>
<div className="shell">
<Sidebar section={section} project={okLabel} />
<main className={"page" + (section !== "/issues" ? " page--board" : "")}>
<main className={"page" + (section !== "/issues" && section !== "/feed" ? " page--board" : "")}>
<ErrorBoundary key={at}>{page}</ErrorBoundary>
</main>
</div>

View File

@ -5,7 +5,7 @@ export function NotFound() {
return (
<div className="crash">
<Notice tone="warning" title={<h2>Страница не найдена</h2>}>
Разделы приложения: <Link to="/board">Доска связей</Link>, <Link to="/issues">Задачи</Link>.
Разделы приложения: <Link to="/board">Доска связей</Link>, <Link to="/issues">Задачи</Link>, <Link to="/feed">Лента</Link>.
</Notice>
</div>
);

View File

@ -95,7 +95,7 @@ export function RefreshProvider({ children, pollMs = POLL_MS }: { children: Reac
skipPickup.current = qc.getQueryCache().findAll({ queryKey: qk.boardAll, type: "active" }).length;
// T4.1: перечитывание могло упасть (успеха нет, счётчик не уменьшился) — по его завершению счётчик гасится в любом случае
void qc.invalidateQueries({ queryKey: qk.boardAll }).finally(() => { skipPickup.current = 0; });
for (const key of [["issues"], ["issue"], qk.projects]) void qc.invalidateQueries({ queryKey: key });
for (const key of [["issues"], ["issue"], ["changes"], qk.projects]) void qc.invalidateQueries({ queryKey: key });
}, [qc]);
useEffect(() => {

View File

@ -52,6 +52,16 @@ describe("боковая панель", () => {
expect(screen.getByRole("link", { name: "Доска связей" })).not.toHaveAttribute("aria-current");
});
it("раздел «Лента» ведёт на /feed с проектом и отмечается как текущий", async () => {
hub({ "GET /changes": () => json(200, { since: "", until: "", truncated: false, changes: [] }) });
open("/app/feed?project=AWPCA");
expect(await screen.findByTestId("page-feed")).toBeInTheDocument();
const nav = within(bar()).getByRole("navigation", { name: "Разделы" });
await waitFor(() => expect(within(nav).getByRole("link", { name: "Лента" })).toHaveAttribute("href", "/app/feed?project=AWPCA"));
expect(within(nav).getByRole("link", { name: "Лента" })).toHaveAttribute("aria-current", "page");
expect(within(nav).getByRole("link", { name: "Задачи" })).not.toHaveAttribute("aria-current");
});
it("на странице «не найдено» ни один раздел не активен; ссылки в сообщении ведут на разделы", async () => {
hub();
open("/app/nowhere?project=AWPCA");
@ -62,6 +72,7 @@ describe("боковая панель", () => {
const main = within(screen.getByRole("main"));
expect(main.getByRole("link", { name: "Доска связей" })).toHaveAttribute("href", "/app/board");
expect(main.getByRole("link", { name: "Задачи" })).toHaveAttribute("href", "/app/issues");
expect(main.getByRole("link", { name: "Лента" })).toHaveAttribute("href", "/app/feed"); // M-2
expect(screen.getByRole("alert")).toHaveTextContent("Страница не найдена");
});

View File

@ -4,17 +4,18 @@ import { Link } from "react-router";
import { clearToken } from "../auth/token.ts";
import { withProject } from "../projects/current.ts";
import { ProjectPicker } from "../projects/ProjectPicker.tsx";
import { IconBoard, IconButton, IconClose, IconList, IconMenu, IconSidebar, Menu, MenuItem, ThemeSwitch } from "../ui/index.ts";
import { IconBoard, IconButton, IconClose, IconHistory, IconList, IconMenu, IconSidebar, Menu, MenuItem, ThemeSwitch } from "../ui/index.ts";
import { DataStatus } from "./DataStatus.tsx";
import { useJiraRefresh } from "./refresh.ts";
import { refreshText } from "./refreshStatus.ts";
import { readSidebar, saveSidebar } from "./sidebarPref.ts";
export type Section = "/board" | "/issues";
export type Section = "/board" | "/issues" | "/feed";
const SECTIONS: { to: Section; label: string; icon: React.ReactNode }[] = [
{ to: "/board", label: "Доска связей", icon: <IconBoard /> },
{ to: "/issues", label: "Задачи", icon: <IconList /> },
{ to: "/feed", label: "Лента", icon: <IconHistory /> },
];
// узкий экран (<640 px): панель не в потоке, а выезжает по кнопке «Меню» из закреплённой строки (design 4)

View File

@ -1,5 +1,6 @@
import { Navigate, type RouteObject } from "react-router";
import { BoardPage } from "../board/BoardPage.tsx";
import { FeedPage } from "../feed/FeedPage.tsx";
import { IssuesPage } from "../issues/IssuesPage.tsx";
import { ProjectGate } from "../projects/ProjectGate.tsx";
import { NotFound } from "./NotFound.tsx";
@ -9,5 +10,6 @@ export const PAGE_ROUTES: RouteObject[] = [
{ path: "/", element: <Navigate to="/board" replace /> },
{ path: "/board", element: <ProjectGate>{(p) => <BoardPage key={p.label} project={p.label} />}</ProjectGate> },
{ path: "/issues", element: <ProjectGate>{(p) => <IssuesPage key={p.label} project={p.label} />}</ProjectGate> },
{ path: "/feed", element: <ProjectGate>{(p) => <FeedPage key={p.label} project={p.label} />}</ProjectGate> },
{ path: "*", element: <NotFound /> },
];

View File

@ -180,7 +180,7 @@ describe("RefreshProvider", () => {
await waitFor(() => expect(h.count("GET /issues")).toBe(2));
});
it("инвалидируются ключи board, issues, issue, projects (шпион)", async () => {
it("инвалидируются ключи board, issues, issue, projects, changes (шпион)", async () => {
const client = makeQueryClient();
const spy = vi.spyOn(client, "invalidateQueries");
hub({ "GET /batches/:id": () => batch("done") });
@ -188,7 +188,7 @@ describe("RefreshProvider", () => {
await act(() => result.current.start());
await waitFor(() => expect(result.current.event).toEqual({ kind: "batch-done", id: 7 }));
const keys = spy.mock.calls.map(([f]) => (f as { queryKey: unknown[] }).queryKey[0]);
expect(keys).toEqual(expect.arrayContaining(["board", "issues", "issue", "projects"]));
expect(keys).toEqual(expect.arrayContaining(["board", "issues", "issue", "projects", "changes"]));
});
it("track(9) опрашивает пакет 9 без POST /refresh", async () => {

View File

@ -35,4 +35,5 @@ export const IconOpen = make(<><path d="M5 12h14"/><path d="M13 6l6 6-6 6"/></>)
export const IconBoard = make(<><rect x="3" y="4" width="7" height="6" rx="1.5"/><rect x="14" y="4" width="7" height="6" rx="1.5"/><rect x="8.5" y="15" width="7" height="6" rx="1.5"/><path d="M10 7h4M6.5 10v2.5h5.5V15"/></>);
export const IconList = make(<><path d="M9 6h11M9 12h11M9 18h11"/><path d="M4 6h1M4 12h1M4 18h1"/></>);
export const IconMenu = make(<><path d="M4 6h16M4 12h16M4 18h16"/></>);
export const IconHistory = make(<><path d="M4 12a8 8 0 1 0 2.3-5.7"/><path d="M4 4v4h4"/><path d="M12 8v4l3 2"/></>);
export const IconSidebar = make(<><rect x="3" y="4" width="18" height="16" rx="2"/><path d="M9 4v16"/></>);