Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
8dc4376
docs: plan full issue pages and collapsible stories
Nov 5, 2026
fda9085
feat(tasks): render full task pages with shared preview editor
Nov 5, 2026
b200701
feat(projects): add epic and story pages with shared quick preview
Nov 5, 2026
a90971d
feat(navigation): link group pages and preserve collapsed stories
Nov 5, 2026
45bd17e
docs: record issue pages verification evidence
Nov 5, 2026
f8c2c30
fix(projects): discard stale task snapshots on group navigation
Nov 5, 2026
c7ec9a1
docs: record completed browser checks and race repair
Nov 5, 2026
fb116c1
docs: close issue pages task after independent review
Nov 5, 2026
8ef109d
fix(board): cover column gaps with a single sticky header
Nov 5, 2026
7b43e36
docs: record board header review
Nov 5, 2026
fdc308c
docs: draft tournament release canvas design
Nov 5, 2026
3541eb7
docs: scope tournament canvas to selected sprint
Nov 5, 2026
5280d89
docs: plan sprint tournament canvas implementation
Nov 5, 2026
8c9e614
feat(canvas): project sprint work into a tournament tree
Nov 5, 2026
ae74b15
feat(canvas): add interactive tournament sprint map
Nov 5, 2026
a6a81d5
feat(projects): connect sprint map navigation and creation
Nov 5, 2026
9a6e101
fix(canvas): preserve release state and fit large sprint maps
Nov 5, 2026
8fc2211
docs: record sprint map verification and review
Nov 5, 2026
a323db8
feat(canvas): add fullscreen sprint map
Nov 5, 2026
5b945ed
docs: design and plan task dependencies
Nov 5, 2026
64da258
feat(tasks): add atomic task dependency graph API
Nov 5, 2026
1478057
feat(tasks): edit predecessors in shared task details
Nov 5, 2026
109edf1
feat(canvas): show task dependency paths and waiting state
Nov 5, 2026
845f0cf
docs: document and verify task dependencies
Nov 5, 2026
ccf5e21
fix(canvas): route dependency arrows clear of cards
Nov 5, 2026
5b9f68a
fix(canvas): keep dependency lanes clear of intervening cards
Nov 5, 2026
f8b14de
feat(tasks): save dependency changes directly in task details
Nov 5, 2026
d4bd66c
fix(ui): use consistent project and dependency wording
Nov 5, 2026
e17592d
docs: record dependency UX revisions and verification
Nov 5, 2026
6846eb8
feat(tasks): search dependencies by task key and number
Nov 5, 2026
ab88869
docs: record task number search verification
Nov 5, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,15 +127,21 @@ ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `St

**Agile — тип проекта, а не режим отображения.** `Project.type: 'simple' | 'agile'` задаётся при создании и дальше не меняется; `viewMode` (`'list' | 'board'`) — только настройка отображения обычного проекта, у agile-проекта переключателя видов нет. Любое правило «это agile» читает `type`. Задача из agile-проекта уходит только в другой agile-проект (во Входящие нельзя), и запрет стоит на сервере во всех путях переноса. В `ProjectTaskService.moveTask` источник берётся из `task.projectId`, а не из URL: drop в сайдбаре кладёт в URL проект назначения. У старых agile-проектов в БД остаётся `viewMode = 'agile'` — это след для отката, его никто не читает.

**Agile-доска: колонки задаёт проект, вложенность рисуется поверх сетки.** В agile-проекте эпики и истории (`BoardGroup`, self-nesting ровно на два уровня) — это вложенные рамки **поверх** сквозной колоночной сетки, а не собственные мини-доски: заголовки колонок рендерятся один раз на всю доску, вложенные блоки наследуют сетку через `grid-template-columns: subgrid`. Горизонтальный скролл-контейнер на доске **ровно один** — если дать скролл каждой истории, они разъедутся и колонки перестанут быть сквозными. Оба правила закрыты тестами-сторожами в `tests/features/projects/ui/AgileBoardView.spec.ts`. Задача без `groupId` — нормальное состояние, она попадает в блок «Без эпика», а не исчезает. Кнопки в шапках эпика и истории ставятся сразу за названием, не `ml-auto`: шапка тянется на всю ширину доски, и при доске шире экрана правый край уезжает за прокрутку.
**Agile-доска: колонки задаёт проект, вложенность рисуется поверх сетки.** В agile-проекте эпики и истории (`BoardGroup`, self-nesting ровно на два уровня) — это вложенные рамки **поверх** сквозной колоночной сетки, а не собственные мини-доски: заголовки колонок рендерятся один раз на всю доску, вложенные блоки наследуют сетку через `grid-template-columns: subgrid`. Горизонтальный скролл-контейнер на доске **ровно один** — если дать скролл каждой истории, они разъедутся и колонки перестанут быть сквозными. Сворачивание истории скрывает клетки, сохраняя заголовок, статус и действия; `board-collapse-store` хранит состояние по projectId/storyId в localStorage. Добавление задачи раскрывает историю. Оба правила сетки закрыты тестами-сторожами в `tests/features/projects/ui/AgileBoardView.spec.ts`. Задача без `groupId` — нормальное состояние, она попадает в блок «Без эпика», а не исчезает. Кнопки в шапках эпика и истории ставятся сразу за названием, не `ml-auto`: шапка тянется на всю ширину доски, и при доске шире экрана правый край уезжает за прокрутку.

**Спринты: доска — это активный спринт.** У agile-проекта две вкладки-маршрута: `tasks-project` (доска) и `tasks-project-backlog`. Доска показывает только задачи с `sprintId` активного спринта; без активного спринта — пустое состояние, сетки нет. Планирование (перенос между спринтами и бэклогом, старт, завершение) живёт только на вкладке «Бэклог». Связь задачи со спринтом — одно поле `Task.sprintId`, независимое от эпика и колонки. У задачи в спринте всегда есть колонка: сервер ставит первую колонку проекта, если её нет (`TaskService` и `ProjectTaskService.moveTask`). Задача, созданная на доске, создаётся с `sprintId` активного спринта. Активный спринт в проекте один — это держит и сервис, и уникальный частичный индекс `IDX_sprint_one_active`. `GET /projects/:id/sprints` отдаёт и закрытые (для подписи «(закрыт)» у задачи), экраны фильтруют их сами.
**Спринты: доска — это активный спринт.** Вкладки agile-проекта: `tasks-project` (доска), `tasks-project-backlog`, `tasks-project-releases` и `tasks-project-map`. Доска показывает только задачи с `sprintId` активного спринта; без активного спринта — пустое состояние, сетки нет. Планирование (перенос между спринтами и бэклогом, старт, завершение) живёт только на вкладке «Бэклог». Связь задачи со спринтом — одно поле `Task.sprintId`, независимое от эпика и колонки. У задачи в спринте всегда есть колонка: сервер ставит первую колонку проекта, если её нет (`TaskService` и `ProjectTaskService.moveTask`). Задача, созданная на доске, создаётся с `sprintId` активного спринта. Активный спринт в проекте один — это держит и сервис, и уникальный частичный индекс `IDX_sprint_one_active`. `GET /projects/:id/sprints` отдаёт и закрытые (для подписи «(закрыт)» у задачи), экраны фильтруют их сами.

**Карта спринта.** `/tasks/project/:projectId/map?sprint=:sprintId` показывает выбранный спринт, по умолчанию активный. `buildSprintMap` — чистая проекция текущих сущностей, не исторический отчёт: task→story→epic→sprint, пустые назначенные истории и задачи без группы не теряются. Прогресс не зависит от collapse и не подменяет workflow истории. Раскладка в `sprint-map-layout.ts`, SVG-связи и HTML-карточки в `SprintMapCanvas`; состояние веток хранится отдельно по проекту/спринту. Страница атомарно применяет актуальный снимок загрузки. Новая задача явно получает выбранный sprintId, выпущенный релиз не наследуется; новый эпик создаётся с первой историей. `use-sprint-map-create` сохраняет промежуточные ID для повтора назначения без дублей. Закрытый спринт запрещает добавление через карту; существующие редакторы сохраняют свои ограничения.

**Зависимости задач.** Таблица `task_dependencies` хранит пару `taskId` (зависимая задача) / `dependencyId` (предшественник), оба FK с CASCADE. `GET /api/tasks/dependencies/graph` читает граф владельца; `PUT /api/tasks/:id/dependencies` принимает `{ dependencyIds: string[] }` и возвращает канонический набор только этой задачи. Проверки владельца, frozen-source, self/duplicates и циклов вместе с заменой выполняются в одной `withSqliteAccess`-транзакции, иначе встречные запросы создадут цикл. `Task` API и workflow не меняются: ожидание вычисляется из текущего `completed` предшественников. `TaskDependencies` общий для страницы/preview: добавление/удаление сохраняется сразу, ошибка откатывает отображение, повтор применяет исходное действие к актуальным связям. Во время запроса действия заблокированы; смена задачи сбрасывает локальное состояние. Graph store сериализует записи одной задачи, объединяет ответы разных задач и отвергает снимки старой ревизии. Карта проецирует скрытые концы на видимого предка; реальные имена и внешние ссылки остаются в панели. Не включать зависимости в иерархию/прогресс. Контракт и проверки: [task-dependencies](docs/tasks/task-dependencies.md).

**Релизы: срез по дате выпуска, не по доске.** Третья вкладка agile-проекта — `tasks-project-releases`. Связь — одно поле `Task.releaseId`, независимое от эпика, колонки и спринта; колонку релиз не трогает и на доске не фильтрует. В выпущенный (`released`) релиз задачу назначить нельзя, а «В релиз…» для эпика или истории (`POST …/releases/:id/assign-group`) не забирает задачи из выпущенных релизов — история выпуска не переписывается. Выпуск (`POST …/:id/release`) переносит только незавершённые задачи.

**Ключи задач `ALF-12`: хранится номер, не ключ.** У agile-проекта `taskKeyPrefix` (настройки проекта) и счётчик `nextTaskNumber`; у задачи — `number`, уникальный в проекте. Ключ собирает только `taskKey()` на фронте, поэтому смена префикса не требует миграции. Номер выдаёт `TaskNumberPort.allocate` (атомарный `UPDATE … RETURNING`; SQL начинается с перевода строки — иначе TypeORM отправляет `UPDATE` через `run()` и строки не вернутся). Новый путь появления задачи в agile-проекте обязан звать `allocate`, иначе у задачи не будет ключа; переезд в другой проект выдаёт новый номер. После `moveTask` фронт берёт `number`/`sprintId`/`releaseId` из ответа сервера — сервер меняет их при смене проекта.

**Эпики и истории: одна модалка, навигация крошками.** Карточка группы (`GroupDetailDialog`) смонтирована один раз в `App.vue` и управляется синглтоном `useGroupDetail()`. Задачу из неё открывает `openTaskDetail(task)` — обработчик регистрирует `useTaskDetailHandlers` активного экрана. Переход карточка ↔ задача закрывает одну модалку и открывает другую, стека нет. Перед `confirm` модалку закрывают (как `handleDeleteFromDialog`): `ConfirmDialog` и диалоги на одном `z-50`, и открытая позже модалка перекрывает подтверждение. Дерево групп в `group-store` хранится по проектам (`groupsOf(projectId)`).
**Страницы и быстрый просмотр задач, эпиков и историй.** `TaskView` (`/tasks/:taskId`) и `GroupView` (`/tasks/project/:projectId/group/:groupId`) рендерят общие редакторы `TaskDetailContent` и `GroupDetailContent` без overlay. Те же редакторы встроены в диалоговые оболочки; не дублировать формы для страниц. На странице переходы по иерархии используют обычные ссылки, в preview сохраняют смену диалогов. Канонические ссылки создают `taskLinkPath` и `groupLinkPath`, действия копирования/новой вкладки используют `EntityLinkActions`. Поиск зависимостей ограничивает список кандидатов, выбранные зависимости остаются видимыми.

**Быстрый просмотр групп — singleton.** Карточка группы (`GroupDetailDialog`) смонтирована один раз в `App.vue` и управляется синглтоном `useGroupDetail()`. Задачу из неё открывает `openTaskDetail(task)` — обработчик регистрирует `useTaskDetailHandlers` активного экрана. Переход карточка ↔ задача закрывает одну модалку и открывает другую, стека нет. Перед `confirm` модалку закрывают (как `handleDeleteFromDialog`): `ConfirmDialog` и диалоги на одном `z-50`, и открытая позже модалка перекрывает подтверждение. Дерево групп в `group-store` хранится по проектам (`groupsOf(projectId)`).

**Пункт `DropdownMenu`, открывающий поле ввода, отменяет возврат фокуса.** После выбора пункта reka-ui возвращает фокус на триггер меню, и только что смонтированное поле с автофокусом тут же его теряет (blur → отмена). Образец — `GroupActionsMenu.vue` (`@close-auto-focus` + `preventDefault` только для таких пунктов). happy-dom этот возврат не воспроизводит — проверять в браузере.

Expand Down
Loading
Loading