Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
4 changes: 2 additions & 2 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -131,9 +131,9 @@ ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `St

**Спринты: доска — это активный спринт.** Вкладки 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 для повтора назначения без дублей. Закрытый спринт запрещает добавление через карту; существующие редакторы сохраняют свои ограничения.
**Карта спринта.** `/tasks/project/:projectId/map?sprint=:sprintId` показывает выбранный спринт, по умолчанию активный. `buildSprintMap` — чистая проекция текущих сущностей, не исторический отчёт: task→story→epic→sprint, пустые назначенные истории и задачи без группы не теряются. Прогресс не зависит от collapse и не подменяет workflow истории. Двусторонняя mind map в `sprint-map-layout.ts`: спринт в центре, стороны эпиков балансируются по полному размеру веток и не зависят от collapse, потомки располагаются наружу, связи имеют общие ортогональные стволы; карточки горизонтальны и не перекрываются. Уровни детализации в `SprintMapCanvas` задают обзор эпиков/историй/задач, новый scope начинает с эпиков и сохраняет вложенные ветки свёрнутыми при последовательном раскрытии. 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).
**Зависимости задач.** Таблица `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 сериализует записи одной задачи, объединяет ответы разных задач и отвергает снимки старой ревизии. Маршрутизатор зависимостей обходит прямоугольники видимых карточек, включая горизонтальные участки, и возвращает bounds всех направлений для fit. Карта проецирует скрытые концы на видимого предка; реальные имена и внешние ссылки остаются в панели. Не включать зависимости в иерархию/прогресс. Контракт и проверки: [task-dependencies](docs/tasks/task-dependencies.md).

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

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@
- **🌍 Корректные таймзоны и локали.** Все операции с датами уважают IANA-таймзону пользователя; даты в БД хранятся в UTC и сдвигаются к wall-clock пользователя на границе домена. Календарь, локаль и первый день недели — из настроек пользователя.
- **🗓 Богатый UI задач.** Inbox, проекты со списками и board-колонками, повторяющиеся задачи, календарь с drag-create по сетке часов, Pomodoro-таймер, два независимых drag-and-drop-движка (кастомный на PointerEvents + vuedraggable). Agile-проекты включают эпики, истории, спринты и релизы; историю можно перенести в спринт целиком с задачами через меню или drag-and-drop. Стрелки ↑/↓ прямо на доске меняют порядок эпиков и историй внутри эпика; порядок сохраняется после перезагрузки. На доске отображаются группы текущего спринта. Историю или целый эпик можно вернуть в бэклог через меню или MCP `remove_group_from_sprint`: структура сохраняется, задачи других спринтов не меняются. Описание задачи поддерживает Markdown и кликабельные ссылки; исходный текст редактируется по кнопке «Редактировать» с явным сохранением или отменой. Задачи (`/tasks/:taskId`), истории и эпики (`/tasks/project/:projectId/group/:groupId`) открываются на отдельных страницах по постоянным ссылкам. Из карточки можно скопировать ссылку или открыть страницу в новой вкладке; после входа сохраняется исходный адрес. Быстрый просмотр с доски использует тот же редактор. Истории на доске сворачиваются отдельной стрелкой; состояние сохраняется в браузере, добавление задачи раскрывает историю.
- **Спринты и истории.** Настраиваемые статусы историй, блокеры и зависимости, бэклог с планированием по бюджету времени, предложения состава через MCP и сохранённые итоги спринтов. [Инструменты планирования](alfy-mcp/README.md#объяснимое-планирование).
- **Карта спринта.** Вкладка «Карта» строит турнирную сетку задач → историй → эпиков → выбранного спринта. Ветки сворачиваются, поиск раскрывает скрытый путь, полотно поддерживает масштабирование и перемещение. Прогресс считает только задачи выбранного спринта; статус истории и метки релизов показаны отдельно. Из карты доступны быстрый просмотр, постоянные ссылки и создание дочерних элементов.
- **Карта спринта.** Вкладка «Карта» показывает mind map: выбранный спринт в центре, эпики расходятся влево и вправо, истории и задачи продолжают ветки наружу. Уровни «Эпики / Истории / Задачи» управляют детализацией; новый спринт открывается компактным обзором эпиков. Ветки сворачиваются, поиск раскрывает скрытый путь, полотно поддерживает масштабирование и перемещение. Прогресс считает только задачи выбранного спринта; статус истории и метки релизов показаны отдельно. Из карты доступны быстрый просмотр, постоянные ссылки и создание дочерних элементов.
- **Зависимости задач.** В карточке задачи поле «Зависит от» задаёт предшественников, включая свои задачи из других спринтов и проектов. Карта показывает направленные пунктирные связи и количество незавершённых предшественников. Завершение предшественников снимает ожидание, статус зависимой задачи остаётся прежним. [Как пользоваться](alfy-bot-frontend/README.md#зависимости-задач).
- **🔔 Уведомления.** Web-push (VAPID) с подписками на устройство.

Expand Down
6 changes: 6 additions & 0 deletions alfy-bot-frontend/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,12 @@

На активной доске **Фокус** показывает ближайшие действия, блокеры и загрузку. При завершении спринта можно распределить остаток, записать итоги и улучшение. **Бэклог → Итоги** хранит исходный и итоговый состав; для старых спринтов отмечает неполную историю. Минуты — оценки объёма, а задачи без оценки показаны отдельно.

## Карта спринта

Во вкладке **Карта** спринт расположен в центре. Эпики расходятся влево и вправо, истории и задачи продолжают ветки с общими стволами. Сторона эпика сохраняется при сворачивании. Новый спринт открывается обзором эпиков с прогрессом; раскрытие эпика показывает истории, затем можно раскрыть задачи. Кнопки **Эпики / Истории / Задачи** меняют детализацию всей карты. Выбранные свёрнутые ветки сохраняются для проекта и спринта.

Поиск раскрывает путь к задаче и приближает её. **Вся карта** возвращает общий обзор, **На весь экран** разворачивает полотно. Карточки открывают общий быстрый просмотр и постоянные страницы; прогресс учитывает только выбранный спринт.

## Зависимости задач

Чтобы видеть, что мешает начать задачу, откройте её страницу или быстрый просмотр, в блоке **Зависит от** найдите задачу по названию, ключу (`DEP-12`) или номеру (`12`, `#12`) и выберите её. Добавление сохраняется сразу; крестик рядом с задачей удаляет связь. При ошибке остаётся сохранённый набор связей и доступна кнопка повторного сохранения. Например, «Опубликовать демо» зависит от «Свести треки»: пока сведение не выполнено, публикация показывает ожидание.
Expand Down
Loading
Loading