diff --git a/CLAUDE.md b/CLAUDE.md index 36532ed..ae16b58 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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 этот возврат не воспроизводит — проверять в браузере. diff --git a/README.md b/README.md index 3ae2427..e6495f7 100644 --- a/README.md +++ b/README.md @@ -13,8 +13,10 @@ - **📱 Три поверхности, один бэкенд.** Telegram-бот (telegraf), Telegram WebApp и обычный SPA — всё работает поверх одного REST API. Веб собран как PWA (offline, web-push, установка на домашний экран). - **🧱 Чистая архитектура.** Бэкенд — Clean Architecture по модулям (порты в `domain/`, адаптеры в `infrastructure/`, оркестрация в сервисах). Фронтенд — Feature-Sliced Design. Границы слоёв реальны, а не декоративны. - **🌍 Корректные таймзоны и локали.** Все операции с датами уважают 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`: её можно скопировать из карточки или открыть в новой вкладке; после входа сохраняется переход к задаче. +- **🗓 Богатый 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#объяснимое-планирование). +- **Карта спринта.** Вкладка «Карта» строит турнирную сетку задач → историй → эпиков → выбранного спринта. Ветки сворачиваются, поиск раскрывает скрытый путь, полотно поддерживает масштабирование и перемещение. Прогресс считает только задачи выбранного спринта; статус истории и метки релизов показаны отдельно. Из карты доступны быстрый просмотр, постоянные ссылки и создание дочерних элементов. +- **Зависимости задач.** В карточке задачи поле «Зависит от» задаёт предшественников, включая свои задачи из других спринтов и проектов. Карта показывает направленные пунктирные связи и количество незавершённых предшественников. Завершение предшественников снимает ожидание, статус зависимой задачи остаётся прежним. [Как пользоваться](alfy-bot-frontend/README.md#зависимости-задач). - **🔔 Уведомления.** Web-push (VAPID) с подписками на устройство. --- diff --git a/alfy-bot-frontend/README.md b/alfy-bot-frontend/README.md index 394f2cc..7c08a15 100644 --- a/alfy-bot-frontend/README.md +++ b/alfy-bot-frontend/README.md @@ -14,12 +14,22 @@ ## Планирование спринтов +Для связей между отдельными задачами используйте [«Зависит от»](#зависимости-задач). + В Agile-проекте откройте **Бэклог → Планирование**: выберите спринт, задайте цель, бюджет и резерв, отметьте задачи или истории и перенесите их одной командой. Выбор истории переносит её незавершённые задачи; ранее выполненные сохраняют назначение. Последний перенос можно отменить, пока он не конфликтует с последующими изменениями. «Предложить план» показывает объяснимый черновик под бюджет; применению предшествует просмотр состава. Режим **Истории** показывает отдельную доску статусов: проработка, готовность, работа, проверка и выполнение. Названия и порядок настраиваются в «Статусы историй». В карточке истории доступны блокер, зависимости, отложенная дата и архив. Завершение всех задач не закрывает историю автоматически. На активной доске **Фокус** показывает ближайшие действия, блокеры и загрузку. При завершении спринта можно распределить остаток, записать итоги и улучшение. **Бэклог → Итоги** хранит исходный и итоговый состав; для старых спринтов отмечает неполную историю. Минуты — оценки объёма, а задачи без оценки показаны отдельно. +## Зависимости задач + +Чтобы видеть, что мешает начать задачу, откройте её страницу или быстрый просмотр, в блоке **Зависит от** найдите задачу по названию, ключу (`DEP-12`) или номеру (`12`, `#12`) и выберите её. Добавление сохраняется сразу; крестик рядом с задачей удаляет связь. При ошибке остаётся сохранённый набор связей и доступна кнопка повторного сохранения. Например, «Опубликовать демо» зависит от «Свести треки»: пока сведение не выполнено, публикация показывает ожидание. + +На карте спринта нажмите значок связей у задачи или **Все связи**. Стрелка идёт от предшественника к зависимой задаче; пунктир отличает её от иерархии. Панель показывает реальные названия: кнопка прицела раскрывает скрытую задачу, ссылка открывает её страницу. Внешние задачи помечены другим спринтом/проектом и не увеличивают прогресс текущего спринта. + +Завершение всех предшественников снимает ожидание, но не завершает зависимую задачу. Её можно завершить вручную даже при ожидании. Циклы запрещены; неудачное действие не меняет сохранённые связи. Связи сохраняются при переносе задачи, удаляются вместе с ней и не наследуются следующим повторением автоматически. + ## Стек и UI - Vue 3 ` + + diff --git a/alfy-bot-frontend/src/features/goals/ui/GoalPickerContent.vue b/alfy-bot-frontend/src/features/goals/ui/GoalPickerContent.vue index 14e9508..317ca71 100644 --- a/alfy-bot-frontend/src/features/goals/ui/GoalPickerContent.vue +++ b/alfy-bot-frontend/src/features/goals/ui/GoalPickerContent.vue @@ -53,7 +53,7 @@

- Ничего не нашлось + Цели не найдены

Попробуйте другое название @@ -186,11 +186,11 @@ v-if="selectedGoals.length === 0" class="px-3 py-2.5 text-sm text-muted-foreground" > - Ничего не выбрано + Цели не выбраны

- Ничего не нашлось + Цели не найдены

Попробуйте другое название diff --git a/alfy-bot-frontend/src/features/projects/lib/group-link.ts b/alfy-bot-frontend/src/features/projects/lib/group-link.ts new file mode 100644 index 0000000..3b587d4 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/group-link.ts @@ -0,0 +1,8 @@ +const persistedId = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i + +/** Возвращает путь страницы эпика или истории в проекте; временные и некорректные идентификаторы не имеют постоянной ссылки. */ +export function groupLinkPath(projectId: string, groupId: string): string | null { + return persistedId.test(projectId) && persistedId.test(groupId) + ? `/tasks/project/${projectId}/group/${groupId}` + : null +} diff --git a/alfy-bot-frontend/src/features/projects/lib/sprint-map-dependencies.ts b/alfy-bot-frontend/src/features/projects/lib/sprint-map-dependencies.ts new file mode 100644 index 0000000..c6aa84b --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/sprint-map-dependencies.ts @@ -0,0 +1,107 @@ +import type { SprintMapNode } from './sprint-map' +import type { PositionedMapNode } from './sprint-map-layout' +import type { TaskDependencyEdge } from '@/features/tasks/model/task-dependencies' +import type { Task } from '@/features/tasks/model/types' + +export interface SprintMapDependency extends TaskDependencyEdge { + predecessor: Task | null + dependent: Task | null + from: PositionedMapNode | null + to: PositionedMapNode | null + predecessorHidden: boolean + dependentHidden: boolean + completed: boolean + path: string | null + sourcePort: { x: number, y: number } | null + targetPort: { x: number, y: number } | null +} + +export interface SprintMapDependencyInput { + root: SprintMapNode + visibleNodes: PositionedMapNode[] + tasks: Task[] + dependencies: TaskDependencyEdge[] + selectedTaskId: string | null + showAll: boolean +} + +function taskEndpoints(root: SprintMapNode, visibleNodes: PositionedMapNode[]) { + const visible = new Map(visibleNodes.map(item => [item.node.key, item])) + const endpoints = new Map() + function visit(node: SprintMapNode, ancestor: PositionedMapNode | undefined) { + const endpoint = visible.get(node.key) ?? ancestor + if (node.kind === 'task' && node.sourceId && endpoint) + endpoints.set(node.sourceId, endpoint) + node.children.forEach(child => visit(child, endpoint)) + } + visit(root, undefined) + return endpoints +} + +function routeDependencies(links: SprintMapDependency[], visibleNodes: PositionedMapNode[]): number { + const lanes: { start: number, end: number, x: number }[] = [] + let minX = 0 + for (const link of links) { + if (!link.from || !link.to) + continue + const source = { x: link.from.x - 9, y: link.from.y + link.from.height * 2 / 3 } + const target = { x: link.to.x - 11, y: link.to.y + link.to.height / 3 } + const interval = { start: Math.min(source.y, target.y) - 12, end: Math.max(source.y, target.y) + 12 } + let laneX = Math.min(link.from.x, link.to.x) - 40 + while (true) { + const obstacle = visibleNodes.find(item => laneX >= item.x - 12 && laneX <= item.x + item.width + 12 && interval.start <= item.y + item.height && interval.end >= item.y) + if (obstacle) { + laneX = obstacle.x - 24 + continue + } + if (lanes.some(item => Math.abs(item.x - laneX) < 18 && interval.start <= item.end && interval.end >= item.start)) { + laneX -= 18 + continue + } + break + } + lanes.push({ ...interval, x: laneX }) + const direction = target.y >= source.y ? 1 : -1 + const radius = Math.min(12, Math.abs(target.y - source.y) / 2) + link.sourcePort = source + link.targetPort = target + link.path = `M${source.x} ${source.y} H${laneX + radius} Q${laneX} ${source.y} ${laneX} ${source.y + direction * radius} V${target.y - direction * radius} Q${laneX} ${target.y} ${laneX + radius} ${target.y} H${target.x}` + minX = Math.min(minX, laneX - 16) + } + return minX +} + +/** Вычисляет ожидание по текущим задачам и направляет связи от предшественников к видимым узлам; внешние задачи остаются в списке без добавления в дерево. */ +export function deriveSprintMapDependencies(input: SprintMapDependencyInput): { waiting: Map, links: SprintMapDependency[], minX: number } { + const tasks = new Map(input.tasks.map(task => [task.id, task])) + const endpoints = taskEndpoints(input.root, input.visibleNodes) + const waiting = new Map() + const links: SprintMapDependency[] = [] + for (const edge of input.dependencies) { + const predecessor = tasks.get(edge.dependencyId) ?? null + const dependent = tasks.get(edge.taskId) ?? null + if (!predecessor || !dependent) + continue + const completed = predecessor.completed + waiting.set(edge.taskId, (waiting.get(edge.taskId) ?? 0) + (completed ? 0 : 1)) + const from = endpoints.get(edge.dependencyId) ?? null + const to = endpoints.get(edge.taskId) ?? null + if ((!from && !to) || (!input.showAll && edge.taskId !== input.selectedTaskId && edge.dependencyId !== input.selectedTaskId)) + continue + links.push({ + ...edge, + predecessor, + dependent, + from, + to, + completed, + predecessorHidden: !!from && from.node.key !== `task:${edge.dependencyId}`, + dependentHidden: !!to && to.node.key !== `task:${edge.taskId}`, + path: null, + sourcePort: null, + targetPort: null, + }) + } + links.sort((a, b) => a.dependencyId.localeCompare(b.dependencyId) || a.taskId.localeCompare(b.taskId)) + return { waiting, links, minX: routeDependencies(links, input.visibleNodes) } +} diff --git a/alfy-bot-frontend/src/features/projects/lib/sprint-map-layout.ts b/alfy-bot-frontend/src/features/projects/lib/sprint-map-layout.ts new file mode 100644 index 0000000..19640ed --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/sprint-map-layout.ts @@ -0,0 +1,70 @@ +import type { SprintMapNode } from './sprint-map' + +export const MAP_NODE_WIDTH = 264 +export const MAP_NODE_HEIGHT = 156 +export const MAP_COLUMN_GAP = 96 +export const MAP_ROW_GAP = 32 +export const MAP_PADDING = 48 + +export interface PositionedMapNode { + node: SprintMapNode + x: number + y: number + width: number + height: number +} + +export interface MapEdge { + from: string + to: string + path: string +} + +const columns: Record = { task: 0, story: 1, epic: 2, ungrouped: 2, sprint: 3 } + +/** Раскладывает видимые ветки по уровням в пикселях; свёрнутые узлы сохраняют исходные данные и занимают место одной карточки. */ +export function layoutSprintMap(root: SprintMapNode, collapsed: ReadonlySet): { + nodes: PositionedMapNode[] + edges: MapEdge[] + width: number + height: number +} { + const nodes: PositionedMapNode[] = [] + const edges: MapEdge[] = [] + let nextY = MAP_PADDING + + function place(node: SprintMapNode): PositionedMapNode { + const positioned: PositionedMapNode = { + node, + x: MAP_PADDING + columns[node.kind] * (MAP_NODE_WIDTH + MAP_COLUMN_GAP), + y: nextY, + width: MAP_NODE_WIDTH, + height: MAP_NODE_HEIGHT, + } + nodes.push(positioned) + const children = collapsed.has(node.key) ? [] : node.children.map(place) + const first = children[0] + const [last] = children.slice(-1) + if (first && last) + positioned.y = (first.y + last.y) / 2 + else + nextY += MAP_NODE_HEIGHT + MAP_ROW_GAP + + for (const child of children) { + const startX = child.x + child.width + const startY = child.y + child.height / 2 + const endY = positioned.y + positioned.height / 2 + const bendX = positioned.x - MAP_COLUMN_GAP / 2 + edges.push({ from: child.node.key, to: node.key, path: `M${startX} ${startY} H${bendX} V${endY} H${positioned.x}` }) + } + return positioned + } + + place(root) + return { + nodes, + edges, + width: MAP_PADDING * 2 + 4 * MAP_NODE_WIDTH + 3 * MAP_COLUMN_GAP, + height: nextY - MAP_ROW_GAP + MAP_PADDING, + } +} diff --git a/alfy-bot-frontend/src/features/projects/lib/sprint-map.ts b/alfy-bot-frontend/src/features/projects/lib/sprint-map.ts new file mode 100644 index 0000000..97733a7 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/sprint-map.ts @@ -0,0 +1,152 @@ +import type { BoardGroupNode, ProjectColumn, Release, Sprint, StoryWorkflowStatus } from '../model/types' +import type { Task } from '@/features/tasks/model/types' + +export interface SprintMapNode { + key: string + kind: 'sprint' | 'epic' | 'story' | 'task' | 'ungrouped' + sourceId: string | null + title: string + statusLabel: string + statusCategory: string + statusColor: string | null + done: number + total: number + outsideCount: number + blockedReason: string | null + releases: Pick[] + children: SprintMapNode[] +} + +export interface SprintMapInput { + projectId: string + sprint: Sprint + groups: BoardGroupNode[] + tasks: Task[] + columns: ProjectColumn[] + workflow: StoryWorkflowStatus[] + releases: Release[] +} + +function ordered(items: T[]): T[] { + return [...items].sort((a, b) => (a.order ?? 0) - (b.order ?? 0) || a.id.localeCompare(b.id)) +} + +function summary(children: SprintMapNode[]) { + return { + total: children.reduce((sum, child) => sum + child.total, 0), + done: children.reduce((sum, child) => sum + child.done, 0), + outsideCount: children.reduce((sum, child) => sum + child.outsideCount, 0), + } +} + +/** Строит дерево выбранного спринта без изменения исходных сущностей; прогресс учитывает уникальные задачи только его проекта и спринта. */ +export function buildSprintMap(input: SprintMapInput): SprintMapNode { + const { projectId, sprint, workflow } = input + if (sprint.projectId !== projectId) + throw new Error('Спринт принадлежит другому проекту') + + const tasks = ordered([...new Map(input.tasks.filter(task => task.projectId === projectId).map(task => [task.id, task])).values()]) + const selectedTasks = tasks.filter(task => task.sprintId === sprint.id) + const releases = new Map(input.releases.filter(release => release.projectId === projectId).map(release => [release.id, release])) + const columns = new Map(input.columns.filter(column => column.projectId === projectId).map(column => [column.id, column])) + const claimedGroups = new Set() + const claimedTasks = new Set() + + function nodeReleases(releaseId?: string | null): SprintMapNode['releases'] { + const release = releaseId ? releases.get(releaseId) : undefined + return release ? [{ id: release.id, name: release.name, status: release.status }] : [] + } + + function taskNode(task: Task): SprintMapNode { + claimedTasks.add(task.id) + const column = task.columnId ? columns.get(task.columnId) : undefined + return { + key: `task:${task.id}`, + kind: 'task', + sourceId: task.id, + title: task.title, + statusLabel: task.completed ? 'Выполнена' : column?.title ?? 'Без колонки', + statusCategory: task.completed ? 'done' : 'open', + statusColor: task.completed ? null : column?.color ?? null, + done: task.completed ? 1 : 0, + total: 1, + outsideCount: 0, + blockedReason: null, + releases: nodeReleases(task.releaseId), + children: [], + } + } + + function groupNode(group: BoardGroupNode): SprintMapNode | null { + if (group.projectId !== projectId || claimedGroups.has(group.id)) + return null + claimedGroups.add(group.id) + const nested = ordered(group.children).map(groupNode).filter((node): node is SprintMapNode => node !== null) + const children = [...nested, ...selectedTasks.filter(task => task.groupId === group.id && !claimedTasks.has(task.id)).map(taskNode)] + const descendantIds = new Set() + function collectIds(current: BoardGroupNode) { + if (current.projectId !== projectId || descendantIds.has(current.id)) + return + descendantIds.add(current.id) + current.children.forEach(collectIds) + } + collectIds(group) + const outsideCount = tasks.filter(task => task.sprintId !== sprint.id && task.groupId && descendantIds.has(task.groupId)).length + if (children.length === 0 && !(group.type === 'story' && group.sprintId === sprint.id)) + return null + const status = group.type === 'story' + ? workflow.find(status => status.id === group.workflowStatusId) + ?? workflow.find(status => status.category === (group.status === 'done' ? 'done' : 'open')) + : undefined + return { + key: `${group.type}:${group.id}`, + kind: group.type, + sourceId: group.id, + title: group.title, + statusLabel: status?.name ?? (group.status === 'done' ? (group.type === 'story' ? 'Выполнена' : 'Выполнен') : (group.type === 'story' ? 'Открыта' : 'Открыт')), + statusCategory: status?.category ?? (group.status === 'done' ? 'done' : 'open'), + statusColor: status?.color ?? group.color, + ...summary(children), + outsideCount, + blockedReason: group.blockedReason ?? null, + releases: nodeReleases(group.releaseId), + children, + } + } + + const children = ordered(input.groups).map(groupNode).filter((node): node is SprintMapNode => node !== null) + const ungroupedTasks = selectedTasks.filter(task => !claimedTasks.has(task.id)).map(taskNode) + if (ungroupedTasks.length) { + children.push({ + key: `ungrouped:${sprint.id}`, + kind: 'ungrouped', + sourceId: null, + title: 'Без эпика', + statusLabel: '', + statusCategory: 'open', + statusColor: null, + ...summary(ungroupedTasks), + blockedReason: null, + releases: [], + children: ungroupedTasks, + }) + } + return { + key: `sprint:${sprint.id}`, + kind: 'sprint', + sourceId: sprint.id, + title: sprint.name, + statusLabel: { planned: 'Запланирован', active: 'Активный', closed: 'Завершён' }[sprint.status], + statusCategory: { planned: 'open', active: 'in_progress', closed: 'done' }[sprint.status], + statusColor: null, + ...summary(children), + blockedReason: null, + releases: [], + children, + } +} + +/** Возвращает все узлы в порядке обхода от родителя к детям, включая скрываемые на полотне ветки. */ +export function flattenSprintMap(root: SprintMapNode): SprintMapNode[] { + return [root, ...root.children.flatMap(flattenSprintMap)] +} diff --git a/alfy-bot-frontend/src/features/projects/lib/use-group-deletion.ts b/alfy-bot-frontend/src/features/projects/lib/use-group-deletion.ts index afd9802..f5e6bce 100644 --- a/alfy-bot-frontend/src/features/projects/lib/use-group-deletion.ts +++ b/alfy-bot-frontend/src/features/projects/lib/use-group-deletion.ts @@ -1,7 +1,9 @@ import type { BoardGroupNode } from '../model/types' +import { ref } from 'vue' import { useConfirm } from '@/composables/useConfirm' import { useTaskStore } from '@/features/tasks/model/task-store' import { useGroupStore } from '../model/group-store' +import { apiErrorMessage } from './api-error' import { deletionImpact, groupDeletionMessage, groupTaskIds } from './group-tree' /** @@ -10,11 +12,13 @@ import { deletionImpact, groupDeletionMessage, groupTaskIds } from './group-tree * null`) для доски и карточки группы, чтобы они не разошлись. */ export function useGroupDeletion() { + const error = ref(null) const { confirm } = useConfirm() const groupStore = useGroupStore() const taskStore = useTaskStore() async function deleteGroupWithConfirm(projectId: string, group: BoardGroupNode): Promise { + error.value = null const impact = deletionImpact(group, taskStore.tasks) const confirmed = await confirm({ title: group.type === 'epic' ? 'Удалить эпик?' : 'Удалить историю?', @@ -30,7 +34,7 @@ export function useGroupDeletion() { await groupStore.deleteGroup(projectId, group.id) } catch (err) { - console.error('Ошибка удаления группы:', err) + error.value = apiErrorMessage(err, 'Не удалось удалить группу') return false } @@ -39,5 +43,5 @@ export function useGroupDeletion() { return true } - return { deleteGroupWithConfirm } + return { deleteGroupWithConfirm, error } } diff --git a/alfy-bot-frontend/src/features/projects/lib/use-sprint-map-create.ts b/alfy-bot-frontend/src/features/projects/lib/use-sprint-map-create.ts new file mode 100644 index 0000000..38a439c --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/use-sprint-map-create.ts @@ -0,0 +1,76 @@ +import { ref } from 'vue' +import { useTaskStore } from '@/features/tasks/model/task-store' +import { setGroupSprint } from '../api/groups-api' +import { useGroupStore } from '../model/group-store' +import { apiErrorMessage } from './api-error' +import { findGroup } from './group-tree' + +/** Неизменяемый контекст создания; null в releaseId запрещает наследовать выпущенный релиз. */ +export interface SprintMapCreateContext { + projectId: string + sprintId: string + kind: 'task' | 'story' | 'epic' + parentId: string | null + releaseId: string | null +} + +/** Создаёт дочернюю ветку в заданном спринте; повтор продолжает частично сохранённую операцию. */ +export function useSprintMapCreate(context: SprintMapCreateContext, isClosed: () => boolean) { + const groups = useGroupStore() + const tasks = useTaskStore() + const pending = ref(false) + const error = ref('') + const epicId = ref(null) + const storyId = ref(null) + async function submit(title: string, firstStoryTitle = ''): Promise { + if (pending.value) + return null + error.value = '' + if (isClosed()) { + error.value = 'Спринт закрыт. Создание недоступно.' + return null + } + if (!title.trim() || (context.kind === 'epic' && !firstStoryTitle.trim())) { + error.value = 'Заполните название и название первой истории.' + return null + } + pending.value = true + try { + if (context.kind === 'task') { + const task = await tasks.createTask({ + title: title.trim(), + completed: false, + projectId: context.projectId, + sprintId: context.sprintId, + groupId: context.parentId, + releaseId: context.releaseId, + }) + return task.id + } + if (context.kind === 'epic' && !epicId.value) { + const epic = await groups.createGroup(context.projectId, { title: title.trim() }) + epicId.value = epic.id + } + if (!storyId.value) { + const story = await groups.createGroup(context.projectId, { + title: context.kind === 'epic' ? firstStoryTitle.trim() : title.trim(), + parentId: epicId.value ?? context.parentId, + }) + storyId.value = story.id + } + await setGroupSprint(context.projectId, storyId.value, context.sprintId) + const story = findGroup(groups.groupsOf(context.projectId), storyId.value) + if (story) + story.sprintId = context.sprintId + return storyId.value + } + catch (err) { + error.value = apiErrorMessage(err, 'Не удалось создать ветку') + return null + } + finally { + pending.value = false + } + } + return { pending, error, epicId, storyId, submit } +} diff --git a/alfy-bot-frontend/src/features/projects/lib/use-sprint-map-viewport.ts b/alfy-bot-frontend/src/features/projects/lib/use-sprint-map-viewport.ts new file mode 100644 index 0000000..6a7c9ee --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/use-sprint-map-viewport.ts @@ -0,0 +1,128 @@ +import type { Ref } from 'vue' +import { computed, onBeforeUnmount, onMounted, ref } from 'vue' + +interface MapBounds { width: number, height: number, x?: number } +interface MapPoint { x: number, y: number } + +/** Управляет масштабом и положением полотна в пикселях контейнера, не изменяя узлы карты. */ +export function useSprintMapViewport(element: Ref) { + const x = ref(0) + const y = ref(0) + const scale = ref(1) + const minScale = ref(0.08) + const dragging = ref(false) + const size = ref({ width: 960, height: 600 }) + let pointer: { id: number, x: number, y: number } | null = null + let observer: ResizeObserver | undefined + const transform = computed(() => `translate(${x.value}px, ${y.value}px) scale(${scale.value})`) + + function measure() { + const rect = element.value?.getBoundingClientRect() + if (rect?.width && rect.height) + size.value = { width: rect.width, height: rect.height } + } + + function zoom(next: number, point: MapPoint = { x: size.value.width / 2, y: size.value.height / 2 }) { + const clamped = Math.min(1.75, Math.max(minScale.value, next)) + const ratio = clamped / scale.value + x.value = point.x - (point.x - x.value) * ratio + y.value = point.y - (point.y - y.value) * ratio + scale.value = clamped + } + + function focus(point: MapPoint) { + x.value = size.value.width / 2 - point.x * scale.value + y.value = size.value.height / 2 - point.y * scale.value + } + + function fit(bounds: MapBounds) { + measure() + scale.value = Math.max(Number.EPSILON, Math.min(1, (size.value.width - 40) / bounds.width, (size.value.height - 40) / bounds.height)) + minScale.value = Math.min(0.08, scale.value) + focus({ x: (bounds.x ?? 0) + bounds.width / 2, y: bounds.height / 2 }) + } + + function initialize(bounds: MapBounds, root: MapPoint) { + fit(bounds) + if (scale.value < 0.65) { + scale.value = 0.8 + focus(root) + } + } + + function onPointerDown(event: PointerEvent) { + if (event.button !== 0 || (event.target as Element).closest('button, a, input, select, textarea, [data-map-node]')) + return + pointer = { id: event.pointerId, x: event.clientX, y: event.clientY } + dragging.value = true + element.value?.setPointerCapture?.(event.pointerId) + } + + function onPointerMove(event: PointerEvent) { + if (!pointer || pointer.id !== event.pointerId) + return + x.value += event.clientX - pointer.x + y.value += event.clientY - pointer.y + pointer = { id: event.pointerId, x: event.clientX, y: event.clientY } + } + + function onPointerUp(event: PointerEvent) { + if (pointer?.id !== event.pointerId) + return + if (element.value?.hasPointerCapture?.(event.pointerId)) + element.value.releasePointerCapture(event.pointerId) + pointer = null + dragging.value = false + } + + function onWheel(event: WheelEvent) { + if (event.ctrlKey || event.metaKey) { + const rect = element.value?.getBoundingClientRect() + zoom(scale.value * Math.exp(-event.deltaY * 0.008), { x: event.clientX - (rect?.left ?? 0), y: event.clientY - (rect?.top ?? 0) }) + } + else { + x.value -= event.deltaX + y.value -= event.deltaY + } + } + + function onKeyDown(event: KeyboardEvent) { + if (event.target !== event.currentTarget) + return + const delta = 64 + switch (event.key) { + case 'ArrowLeft': + x.value += delta + break + case 'ArrowRight': + x.value -= delta + break + case 'ArrowUp': + y.value += delta + break + case 'ArrowDown': + y.value -= delta + break + case '+': + case '=': + zoom(scale.value * 1.2) + break + case '-': + zoom(scale.value / 1.2) + break + default: return + } + event.preventDefault() + } + + onMounted(() => { + measure() + if (typeof ResizeObserver !== 'undefined' && element.value) { + observer = new ResizeObserver(measure) + observer.observe(element.value) + } + }) + onBeforeUnmount(() => observer?.disconnect()) + + return { x, y, scale, minScale, dragging, transform, zoom, focus, fit, initialize, onPointerDown, onPointerMove, onPointerUp, onWheel, onKeyDown } +} diff --git a/alfy-bot-frontend/src/features/projects/model/board-collapse-store.ts b/alfy-bot-frontend/src/features/projects/model/board-collapse-store.ts new file mode 100644 index 0000000..df806a9 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/model/board-collapse-store.ts @@ -0,0 +1,23 @@ +import { useStorage } from '@vueuse/core' +import { defineStore } from 'pinia' + +export const useBoardCollapseStore = defineStore('board-collapse', () => { + const collapsed = useStorage>('alfy-board-collapsed-stories', {}, undefined, { flush: 'sync' }) + + function isCollapsed(projectId: string, storyId: string): boolean { + const ids = collapsed.value[projectId] + return Array.isArray(ids) && ids.includes(storyId) + } + + function setCollapsed(projectId: string, storyId: string, value: boolean) { + const current = collapsed.value[projectId] + const ids = new Set(Array.isArray(current) ? current : []) + if (value) + ids.add(storyId) + else + ids.delete(storyId) + collapsed.value = { ...collapsed.value, [projectId]: [...ids] } + } + + return { isCollapsed, setCollapsed } +}) diff --git a/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue b/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue index 0b67363..7f648d3 100644 --- a/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue +++ b/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue @@ -266,11 +266,11 @@ watch(() => props.projectId, (id) => { {{ reorderError }}

-
+
import type { BoardGroupNode, ProjectColumn } from '../model/types' import type { Task } from '@/features/tasks/model/types' -import { Plus } from 'lucide-vue-next' +import { ChevronDown, ChevronRight, Plus } from 'lucide-vue-next' import { computed, ref } from 'vue' import { Button } from '@/components/ui/button' import { groupTasksByColumn } from '../lib/agile-layout' +import { useBoardCollapseStore } from '../model/board-collapse-store' import AgileCell from './AgileCell.vue' import GroupActionsMenu from './GroupActionsMenu.vue' import GroupOrderControls from './GroupOrderControls.vue' @@ -38,6 +39,11 @@ const emit = defineEmits<{ const tasksByColumn = computed(() => groupTasksByColumn(props.tasks)) +const collapse = useBoardCollapseStore() +const collapsed = computed({ + get: () => collapse.isCollapsed(props.story.projectId, props.story.id), + set: value => collapse.setCollapsed(props.story.projectId, props.story.id, value), +}) const renaming = ref(false) const addingTask = ref(false) @@ -46,6 +52,11 @@ function commitRename(title: string) { emit('renameGroup', props.story.id, title) } +function startAddingTask() { + collapsed.value = false + addingTask.value = true +} + function handleCreateTask(title: string) { addingTask.value = false emit('createTask', props.story.id, title) @@ -57,6 +68,16 @@ function handleCreateTask(title: string) { class="col-span-full grid [grid-template-columns:subgrid] mt-1" >
+ @@ -106,22 +127,24 @@ function handleCreateTask(title: string) { />
-
+
- +
diff --git a/alfy-bot-frontend/src/features/projects/ui/GroupActionsMenu.vue b/alfy-bot-frontend/src/features/projects/ui/GroupActionsMenu.vue index 3b4587c..d23ffd9 100644 --- a/alfy-bot-frontend/src/features/projects/ui/GroupActionsMenu.vue +++ b/alfy-bot-frontend/src/features/projects/ui/GroupActionsMenu.vue @@ -2,6 +2,7 @@ import type { BoardGroup } from '../model/types' import { CircleCheck, Ellipsis, Palette, Pencil, Plus, Rocket, RotateCcw, SquareArrowOutUpRight, Trash2 } from 'lucide-vue-next' import { computed, ref } from 'vue' +import { RouterLink } from 'vue-router' import { Button } from '@/components/ui/button' import { DropdownMenu, @@ -14,6 +15,7 @@ import { DropdownMenuTrigger, } from '@/components/ui/dropdown-menu' import { apiErrorMessage } from '../lib/api-error' +import { groupLinkPath } from '../lib/group-link' import { PROJECT_COLOR_PALETTE } from '../model/project-color-palette' import { useReleaseStore } from '../model/release-store' @@ -39,6 +41,7 @@ const emit = defineEmits<{ delete: [] }>() +const pagePath = computed(() => groupLinkPath(props.group.projectId, props.group.id)) const isEpic = computed(() => props.group.type === 'epic') const triggerLabel = computed(() => (isEpic.value ? 'Действия с эпиком' : 'Действия с историей')) const toggleDoneLabel = computed(() => (props.group.status === 'done' ? 'Открыть' : 'Закрыть')) @@ -92,6 +95,12 @@ function onCloseAutoFocus(event: Event) { Открыть карточку + + + + Открыть страницу + + Переименовать diff --git a/alfy-bot-frontend/src/features/projects/ui/GroupDetailContent.vue b/alfy-bot-frontend/src/features/projects/ui/GroupDetailContent.vue new file mode 100644 index 0000000..0a8f93f --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/GroupDetailContent.vue @@ -0,0 +1,430 @@ + + +