diff --git a/CLAUDE.md b/CLAUDE.md index 2959263..e679650 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -59,6 +59,8 @@ npm run lint # eslint . ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `StreamableHTTPServerTransport`). Auth — API-токены через бот (`/mcp_token `), хранятся как bcrypt-хеш + 10-char prefix-index в БД (`api_token` entity). Tools — тонкая обёртка над REST `alfy-bot` (1 HTTP-вызов на tool, кроме `get_progress` — 3 параллельных). См. `alfy-mcp/README.md` для подключения из клиентов. +**MCP-планирование спринтов.** `tools/sprints.ts` регистрируется в общем `createServer` для обоих транспортов. Контроллеры спринтов и групп используют `JwtOrApiTokenGuard`, иначе MCP API-токен получает 401. `move_story_to_sprint` вызывает атомарный серверный перенос; не заменять его циклом обновления задач. `complete_sprint` требует явный `moveTo`, `delete_sprint` — `confirm: true`. У задач доступны `groupId`/`sprintId` и фильтр `sprint_id`; создание без `sprintId` наследует спринт истории. Контракты проверяются через реальный MCP SDK в `alfy-mcp/tests/tools/sprints.spec.ts` и HTTP-тест API-токена в `alfy-bot/test/story-sprint.e2e-spec.ts`. + ## Dev (Telegram WebApp через публичные URL) ```bash @@ -89,6 +91,12 @@ ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `St **Env для e2e ставится в `setupFiles`, не в хелпере.** `AppModule` решает, поднимать ли Telegraf, на этапе **импорта модуля** (`const telegramImports = isTelegramEnabled()`). Любой `process.env.ENABLE_TELEGRAM = 'false'` внутри `createTestApp()` опаздывает: `import { AppModule }` в шапке спеки уже отработал, бот стартует и валит весь suite с `401: Bot Token is required`. Поэтому переменные живут в `alfy-bot/test/setup-e2e-env.ts`, подключённом через `setupFiles` в `test/jest-e2e.json`. Не переносить их обратно в хелпер. +**Триггеры SQLite и `synchronize`.** Часть правил CHECK-ом невыразима: SQLite запрещает подзапросы в CHECK, поэтому «родитель обязан быть эпиком» (`board_groups`) и «группа задачи — из её проекта» (`tasks`) сделаны триггерами с `RAISE(ABORT, ...)`. `synchronize` их не знает, а при изменении схемы SQLite-таблица пересобирается (temporary → copy → drop → rename). Триггер на `tasks` читает `board_groups`, и на rename SQLite его перепроверяет — живой триггер **роняет старт** (`no such table: main.board_groups`). Поэтому `DataSource` поднимается через `initializeWithSchemaSync` (`shared/database/create-data-source.ts`): БД открывается без `synchronize`, `dropBoardGroupTriggers` снимает триггеры, затем `synchronize()`; на `OnApplicationBootstrap` их заново ставит `board-group-constraints.service.ts`. Заводя новый триггер, добавь его имя в `BOARD_GROUP_TRIGGER_NAMES`. В тестах пересборку таблицы эмулируй так же, как TypeORM (`foreign_keys = OFF`, temporary → drop → rename): `ALTER TABLE x RENAME TO x_old` молча переписывает тела чужих триггеров на `x_old`, и тест проходит по неверной причине. + +**Мокающие спеки не видят ограничений схемы.** `*.service.spec.ts` мокают репозитории, поэтому `NOT NULL`, CHECK и триггеры там не проверяются в принципе: сервис, забывший проставить `userId`, проходит все юнит-тесты и падает с 500 на живом API. Для сущностей с ограничениями нужен e2e на реальной схеме — образец `alfy-bot/test/board-groups.e2e-spec.ts`. + +**Список сущностей в `test/helpers/test-app.ts` поддерживается руками.** Он уже дважды расходился с `app.module.ts`, и каждый раз весь e2e-набор падал с `Entity metadata for X was not found` — молча, потому что `npm test` e2e не запускает. Добавил сущность в `app.module.ts` — добавь и туда, и прогони `npm run test:e2e`. + **Эндпоинты, возвращающие `UpdateTaskResponse`.** `PATCH /tasks/:id` и `PATCH /tasks/:id/pomodoro` отдают не задачу, а обёртку `{ task, nextInstance?, deletedInstanceId? }` — из-за повторяющихся задач, где завершение порождает следующий инстанс. Потребители должны читать `body.task`, а не `body`. На фронте разбор один — `applyUpdateResponse` в `features/tasks/model/task-store.ts`. **`Task.isOverdue` — это «заморожена», а не «просрочена по дате».** Флаг ставит ночная джоба только повторяющимся задачам с `onMissed: 'freeze'`: инстанс помечается `isOverdue=true`, теряет `recurrence` и становится **иммутабельным** — `task.service.ts` кидает `BadRequestException` на любой PATCH, доступно только удаление. Обычная разовая задача со вчерашним `dueDate` имеет `isOverdue=false` и спокойно редактируется. Поэтому «просроченные» в UI-смысле — это `!completed && dueDate < начало сегодня`, и вычислять их через `isOverdue` нельзя. Единственный источник этого предиката на фронте — `features/tasks/lib/today.ts` (`splitTodayBuckets`), см. `docs/tasks/overdue-recurring-tasks.md`. @@ -117,6 +125,24 @@ ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `St **`VITE_API_URL` задаётся вместе с префиксом `/api`.** `api/client.ts` подставляет переменную в `baseURL` как есть, а вызовы идут как `api.get('/tasks')` — значит для локального бэка нужно `http://localhost:3002/api`, иначе все запросы получают 404. +**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-проекта две вкладки-маршрута: `tasks-project` (доска) и `tasks-project-backlog`. Доска показывает только задачи с `sprintId` активного спринта; без активного спринта — пустое состояние, сетки нет. Планирование (перенос между спринтами и бэклогом, старт, завершение) живёт только на вкладке «Бэклог». Связь задачи со спринтом — одно поле `Task.sprintId`, независимое от эпика и колонки. У задачи в спринте всегда есть колонка: сервер ставит первую колонку проекта, если её нет (`TaskService` и `ProjectTaskService.moveTask`). Задача, созданная на доске, создаётся с `sprintId` активного спринта. Активный спринт в проекте один — это держит и сервис, и уникальный частичный индекс `IDX_sprint_one_active`. `GET /projects/:id/sprints` отдаёт и закрытые (для подписи «(закрыт)» у задачи), экраны фильтруют их сами. + +**Релизы: срез по дате выпуска, не по доске.** Третья вкладка 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)`). + +**Пункт `DropdownMenu`, открывающий поле ввода, отменяет возврат фокуса.** После выбора пункта reka-ui возвращает фокус на триггер меню, и только что смонтированное поле с автофокусом тут же его теряет (blur → отмена). Образец — `GroupActionsMenu.vue` (`@close-auto-focus` + `preventDefault` только для таких пунктов). happy-dom этот возврат не воспроизводит — проверять в браузере. + +**Планирование историй.** Собственный nullable `BoardGroup.releaseId` задаёт релиз для новых задач истории, если при создании не передан `releaseId`; явный `null` или другой релиз имеет приоритет. Назначение истории или эпика атомарно обновляет истории и задачи, сохраняя выпущенные связи. Пустая назначенная история видна в релизе. Выпуск переносит незавершённые задачи и открытые истории; завершённые остаются в выпущенном релизе. Удаление релиза очищает обе связи через FK. + +**Истории в бэклоге.** `BoardGroup.sprintId` хранит плановый спринт истории; пустая история показывается в назначенном блоке. История с задачами также появляется в блоках их спринтов, поэтому индивидуально перенесённые задачи остаются видимыми. Меню строки и drag за ручку истории вызывают `PATCH /projects/:projectId/groups/:id/sprint` с `{ sprintId: UUID | null }`: история и все её задачи вне закрытых спринтов переносятся атомарно, включая скрытые выполненные. Задачи закрытых спринтов сохраняются. Новая задача наследует спринт истории только при отсутствующем `sprintId`; явный `null` оставляет её в бэклоге. Завершение спринта переносит открытые истории, удаление очищает FK. Фильтры не ограничивают перенос и общий счётчик. Для drag историй используется группа `sprint-stories`, для задач — `sprint-backlog`; пустой блок имеет видимую область переноса истории. Drop задачи в строку принимает только задачи той же истории. Новая задача в истории выпущенного релиза создаётся с явным `releaseId: null`; будущий релиз можно выбрать в карточке задачи. + ## Drag-and-drop (две системы — выбирать по контексту) В кодбазе сосуществуют два независимых DnD-стека. Не смешивать. @@ -179,4 +205,4 @@ Add as new ## Domain Data Conventions section\n\n## Domain Data Conventions Add as new ## Bug Diagnosis section\n\n## Bug Diagnosis - Before proposing a CSS/styling fix, reproduce the actual symptom and confirm root cause. State your hypothesis explicitly and ask user to confirm before editing. - For recurring/scheduled-task logic, ensure next-instance dates are 'on-or-after today', not 'next-by-rule from last completion'. -- Always respond in the language the user is writing in (Russian if they write Russian). \ No newline at end of file +- Always respond in the language the user is writing in (Russian if they write Russian). diff --git a/README.md b/README.md index c157b19..0908884 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ - **📱 Три поверхности, один бэкенд.** 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). +- **🗓 Богатый UI задач.** Inbox, проекты со списками и board-колонками, повторяющиеся задачи, календарь с drag-create по сетке часов, Pomodoro-таймер, два независимых drag-and-drop-движка (кастомный на PointerEvents + vuedraggable). Agile-проекты включают эпики, истории, спринты и релизы; историю можно перенести в спринт целиком с задачами через меню или drag-and-drop. - **🔔 Уведомления.** Web-push (VAPID) с подписками на устройство. --- diff --git a/alfy-bot-frontend/src/App.vue b/alfy-bot-frontend/src/App.vue index 96be651..1be57c7 100644 --- a/alfy-bot-frontend/src/App.vue +++ b/alfy-bot-frontend/src/App.vue @@ -1,5 +1,6 @@ @@ -7,6 +8,7 @@ import TaskDragGhost from '@/features/tasks/ui/TaskDragGhost.vue'
+
diff --git a/alfy-bot-frontend/src/features/projects/api/groups-api.ts b/alfy-bot-frontend/src/features/projects/api/groups-api.ts new file mode 100644 index 0000000..79e3869 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/api/groups-api.ts @@ -0,0 +1,32 @@ +import type { BoardGroup, BoardGroupNode, CreateGroupPayload, UpdateGroupPayload } from '../model/types' +import { api } from '@/api/client' + +export function fetchGroups(projectId: string) { + return api.get(`/projects/${projectId}/groups`) +} + +export function createGroup(projectId: string, data: CreateGroupPayload) { + return api.post(`/projects/${projectId}/groups`, data) +} + +export function updateGroup(projectId: string, id: string, data: UpdateGroupPayload) { + return api.patch(`/projects/${projectId}/groups/${id}`, data) +} + +export function deleteGroup(projectId: string, id: string) { + return api.delete(`/projects/${projectId}/groups/${id}`) +} + +export function reorderGroups(projectId: string, orderedIds: string[]) { + return api.patch(`/projects/${projectId}/groups/reorder`, { orderedIds }) +} + +/** Назначает или снимает релиз истории и её задач; возвращает число изменённых задач. */ +export function setGroupRelease(projectId: string, groupId: string, releaseId: string | null) { + return api.patch<{ updated: number }>(`/projects/${projectId}/groups/${groupId}/release`, { releaseId }) +} + +/** Назначает спринт истории и её задач; возвращает число изменённых задач. */ +export function setGroupSprint(projectId: string, groupId: string, sprintId: string | null) { + return api.patch<{ updated: number }>(`/projects/${projectId}/groups/${groupId}/sprint`, { sprintId }) +} diff --git a/alfy-bot-frontend/src/features/projects/api/releases-api.ts b/alfy-bot-frontend/src/features/projects/api/releases-api.ts new file mode 100644 index 0000000..34cc1e8 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/api/releases-api.ts @@ -0,0 +1,32 @@ +import type { + AssignGroupToReleasePayload, + CreateReleasePayload, + Release, + ReleaseActionPayload, + UpdateReleasePayload, +} from '../model/types' +import { api } from '@/api/client' + +export function fetchReleases(projectId: string) { + return api.get(`/projects/${projectId}/releases`) +} + +export function createRelease(projectId: string, data: CreateReleasePayload) { + return api.post(`/projects/${projectId}/releases`, data) +} + +export function updateRelease(projectId: string, id: string, data: UpdateReleasePayload) { + return api.patch(`/projects/${projectId}/releases/${id}`, data) +} + +export function deleteRelease(projectId: string, id: string) { + return api.delete(`/projects/${projectId}/releases/${id}`) +} + +export function releaseRelease(projectId: string, id: string, data: ReleaseActionPayload) { + return api.post(`/projects/${projectId}/releases/${id}/release`, data) +} + +export function assignGroupToRelease(projectId: string, id: string, data: AssignGroupToReleasePayload) { + return api.post<{ updated: number }>(`/projects/${projectId}/releases/${id}/assign-group`, data) +} diff --git a/alfy-bot-frontend/src/features/projects/api/sprints-api.ts b/alfy-bot-frontend/src/features/projects/api/sprints-api.ts new file mode 100644 index 0000000..fd4e7ab --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/api/sprints-api.ts @@ -0,0 +1,32 @@ +import type { + CompleteSprintPayload, + CreateSprintPayload, + Sprint, + StartSprintPayload, + UpdateSprintPayload, +} from '../model/types' +import { api } from '@/api/client' + +export function fetchSprints(projectId: string) { + return api.get(`/projects/${projectId}/sprints`) +} + +export function createSprint(projectId: string, data: CreateSprintPayload) { + return api.post(`/projects/${projectId}/sprints`, data) +} + +export function updateSprint(projectId: string, id: string, data: UpdateSprintPayload) { + return api.patch(`/projects/${projectId}/sprints/${id}`, data) +} + +export function deleteSprint(projectId: string, id: string) { + return api.delete(`/projects/${projectId}/sprints/${id}`) +} + +export function startSprint(projectId: string, id: string, data: StartSprintPayload) { + return api.post(`/projects/${projectId}/sprints/${id}/start`, data) +} + +export function completeSprint(projectId: string, id: string, data: CompleteSprintPayload) { + return api.post(`/projects/${projectId}/sprints/${id}/complete`, data) +} diff --git a/alfy-bot-frontend/src/features/projects/lib/agile-layout.ts b/alfy-bot-frontend/src/features/projects/lib/agile-layout.ts new file mode 100644 index 0000000..51021fb --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/agile-layout.ts @@ -0,0 +1,66 @@ +import type { BoardGroupNode } from '../model/types' +import type { Task } from '@/features/tasks/model/types' + +export interface AgileStoryRow { + story: BoardGroupNode + tasks: Task[] +} + +export interface AgileEpicRow { + kind: 'epic' + epic: BoardGroupNode + stories: AgileStoryRow[] + epicTasks: Task[] +} + +export interface AgileUngroupedRow { + kind: 'ungrouped' + tasks: Task[] +} + +export type AgileRow = AgileEpicRow | AgileUngroupedRow + +export function buildAgileRows(groups: BoardGroupNode[], tasks: Task[]): AgileRow[] { + const sortedEpics = [...groups].sort((a, b) => a.order - b.order) + + const knownGroupIds = new Set() + for (const epic of sortedEpics) { + knownGroupIds.add(epic.id) + for (const story of epic.children) { + knownGroupIds.add(story.id) + } + } + + const rows: AgileRow[] = sortedEpics.map((epic) => { + const sortedStories = [...epic.children].sort((a, b) => a.order - b.order) + const stories: AgileStoryRow[] = sortedStories.map(story => ({ + story, + tasks: tasks.filter(task => task.groupId === story.id), + })) + const epicTasks = tasks.filter(task => task.groupId === epic.id) + + return { kind: 'epic', epic, stories, epicTasks } + }) + + const ungroupedTasks = tasks.filter( + task => !task.groupId || !knownGroupIds.has(task.groupId), + ) + rows.push({ kind: 'ungrouped', tasks: ungroupedTasks }) + + return rows +} + +/** + * Groups tasks by their columnId, preserving `null` (no column assigned) + * as an explicit map key so those tasks are never dropped. + */ +export function groupTasksByColumn(tasks: Task[]): Map { + const map = new Map() + for (const task of tasks) { + const key = task.columnId ?? null + const arr = map.get(key) ?? [] + arr.push(task) + map.set(key, arr) + } + return map +} diff --git a/alfy-bot-frontend/src/features/projects/lib/api-error.ts b/alfy-bot-frontend/src/features/projects/lib/api-error.ts new file mode 100644 index 0000000..5adbd1f --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/api-error.ts @@ -0,0 +1,15 @@ +/** + * Текст ошибки для показа пользователю: сообщение сервера + * (`response.data.message`, массив склеивается через «; »), иначе `message` + * самой ошибки, иначе `fallback`. + */ +export function apiErrorMessage(err: unknown, fallback: string): string { + const serverMessage = (err as { response?: { data?: { message?: unknown } } } | null)?.response?.data?.message + if (typeof serverMessage === 'string' && serverMessage.length > 0) + return serverMessage + if (Array.isArray(serverMessage) && serverMessage.length > 0) + return serverMessage.join('; ') + if (err instanceof Error && err.message.length > 0) + return err.message + return fallback +} diff --git a/alfy-bot-frontend/src/features/projects/lib/backlog-stories.ts b/alfy-bot-frontend/src/features/projects/lib/backlog-stories.ts new file mode 100644 index 0000000..c386d45 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/backlog-stories.ts @@ -0,0 +1,56 @@ +import type { BoardGroupNode } from '../model/types' +import type { Task } from '@/features/tasks/model/types' + +/** Выбранный эпик; all показывает всё, none — задачи без эпика. */ +export type EpicFilter = 'all' | 'none' | string + +/** История с видимыми задачами и прогрессом всех её задач текущего блока. */ +export interface BacklogStory { + story: BoardGroupNode + epic: BoardGroupNode + tasks: Task[] + done: number + total: number +} + +/** Проверяет принадлежность задачи выбранному эпику без изменения данных. */ +export function matchesEpic(task: Task, tree: BoardGroupNode[], filter: EpicFilter): boolean { + if (filter === 'all') + return true + const epic = tree.find(node => node.id === task.groupId || node.children.some(story => story.id === task.groupId)) + return filter === 'none' ? !epic : epic?.id === filter +} + +/** + * Группирует видимые задачи по историям. Истории без задач показываются + * в назначенном спринте; скрытые задачи не делают историю пустой. + * Прогресс считается по полному набору задач блока, независимо от фильтров. + */ +export function backlogStories( + tree: BoardGroupNode[], + visibleTasks: Task[], + projectTasks: Task[], + sprintId: string | null, + filter: EpicFilter, + showCompleted: boolean, +): BacklogStory[] { + return tree.filter(epic => filter === 'all' || epic.id === filter).flatMap(epic => + epic.children.flatMap((story) => { + const all = projectTasks.filter(task => task.groupId === story.id) + const tasks = visibleTasks.filter(task => task.groupId === story.id) + const block = all.filter(task => (task.sprintId ?? null) === sprintId) + const empty = block.length === 0 && (story.sprintId ?? null) === sprintId + && (all.length === 0 || story.sprintId != null) + && (showCompleted || story.status !== 'done') + if (tasks.length === 0 && !empty) + return [] + return [{ story, epic, tasks, done: block.filter(task => task.completed).length, total: block.length }] + }), + ) +} + +/** Возвращает задачи без истории, включая задачи непосредственно в эпике. */ +export function standaloneBacklogTasks(tasks: Task[], tree: BoardGroupNode[]): Task[] { + const storyIds = new Set(tree.flatMap(epic => epic.children.map(story => story.id))) + return tasks.filter(task => !task.groupId || !storyIds.has(task.groupId)) +} diff --git a/alfy-bot-frontend/src/features/projects/lib/group-tree.ts b/alfy-bot-frontend/src/features/projects/lib/group-tree.ts new file mode 100644 index 0000000..5c7f2b4 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/group-tree.ts @@ -0,0 +1,105 @@ +import type { BoardGroupNode } from '../model/types' +import type { Task } from '@/features/tasks/model/types' +import { pluralRu } from '@/lib/plural' + +/** Ищет узел (эпик или историю) по id в дереве групп проекта. */ +export function findGroup(tree: BoardGroupNode[], id: string): BoardGroupNode | undefined { + for (const node of tree) { + if (node.id === id) + return node + const found = findGroup(node.children, id) + if (found) + return found + } + return undefined +} + +/** + * Путь к группе: её родительский эпик (или сама группа, если это эпик) и + * история, если `groupId` указывает на историю. `null`, если id не найден. + */ +export function groupPath( + tree: BoardGroupNode[], + groupId: string, +): { epic: BoardGroupNode, story: BoardGroupNode | null } | null { + for (const epic of tree) { + if (epic.id === groupId) + return { epic, story: null } + const story = epic.children.find(child => child.id === groupId) + if (story) + return { epic, story } + } + return null +} + +/** + * Текст для поля/чипа «Эпик / История»: «Эпик › История» для истории, + * «Эпик» для самого эпика, «Без эпика» для `groupId: null`. `null`, если + * `groupId` указан, но не найден в переданном дереве (дерево ещё грузится). + */ +export function groupLabel(tree: BoardGroupNode[], groupId: string | null): string | null { + if (groupId === null) + return 'Без эпика' + + const path = groupPath(tree, groupId) + if (!path) + return null + + return path.story ? `${path.epic.title} › ${path.story.title}` : path.epic.title +} + +/** + * Id задач, принадлежащих группе: для эпика — id самого эпика и всех его + * историй; для истории — только её собственный id. + */ +export function groupTaskIds(group: BoardGroupNode): string[] { + return [group.id, ...group.children.map(child => child.id)] +} + +/** Прогресс группы: сколько из её задач (см. {@link groupTaskIds}) завершено. */ +export function groupProgress(group: BoardGroupNode, tasks: Task[]): { done: number, total: number } { + const ids = new Set(groupTaskIds(group)) + const groupTasks = tasks.filter(task => task.groupId != null && ids.has(task.groupId)) + return { + done: groupTasks.filter(task => task.completed).length, + total: groupTasks.length, + } +} + +/** + * Последствия удаления группы: число дочерних историй (0 для истории) и + * число задач, которые останутся без группы (задачи самой группы и, для + * эпика, задачи всех его историй). + */ +export function deletionImpact(group: BoardGroupNode, tasks: Task[]): { stories: number, tasks: number } { + const ids = new Set(groupTaskIds(group)) + const affectedTasks = tasks.filter(task => task.groupId != null && ids.has(task.groupId)) + return { + stories: group.children.length, + tasks: affectedTasks.length, + } +} + +/** + * Текст подтверждения удаления эпика/истории: называет последствия + * ({@link deletionImpact}) до подтверждения. Один источник для доски и + * карточки группы — тексты не должны расходиться. + */ +export function groupDeletionMessage(group: BoardGroupNode, impact: { stories: number, tasks: number }): string { + const parts = [`Удалить ${group.type === 'epic' ? 'эпик' : 'историю'} „${group.title}“?`] + + if (group.type === 'epic' && impact.stories > 0) { + const verb = pluralRu(impact.stories, ['удалится', 'удалятся', 'удалятся']) + const word = pluralRu(impact.stories, ['история', 'истории', 'историй']) + parts.push(`Вместе с ним ${verb} ${impact.stories} ${word}.`) + } + + if (impact.tasks > 0) { + const remainVerb = pluralRu(impact.tasks, ['останется', 'останутся', 'останутся']) + const moveVerb = pluralRu(impact.tasks, ['переедет', 'переедут', 'переедут']) + const word = pluralRu(impact.tasks, ['задача', 'задачи', 'задач']) + parts.push(`${impact.tasks} ${word} ${remainVerb} и ${moveVerb} в „Без эпика“.`) + } + + return parts.join(' ') +} diff --git a/alfy-bot-frontend/src/features/projects/lib/release.ts b/alfy-bot-frontend/src/features/projects/lib/release.ts new file mode 100644 index 0000000..39eb873 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/release.ts @@ -0,0 +1,125 @@ +import type { BoardGroupNode, Release } from '../model/types' +import type { Task } from '@/features/tasks/model/types' +import { pluralRu } from '@/lib/plural' +import { groupPath } from './group-tree' +import { parseLocalDate } from './sprint' + +/** + * Корзина задач релиза. `epic = null` — «Без эпика»; `story = null` при + * заданном `epic` — задачи, лежащие прямо на эпике. + */ +export interface ReleaseTaskGroup { + epic: BoardGroupNode | null + story: BoardGroupNode | null + tasks: Task[] +} + +/** Задачи с данным `releaseId` в переданном списке. */ +export function releaseTasks(tasks: Task[], releaseId: string): Task[] { + return tasks.filter(t => t.releaseId === releaseId) +} + +/** Прогресс релиза: число выполненных задач и общее число задач с данным `releaseId`. */ +export function releaseProgress(tasks: Task[], releaseId: string): { done: number, total: number } { + const inRelease = releaseTasks(tasks, releaseId) + return { done: inRelease.filter(t => t.completed).length, total: inRelease.length } +} + +/** + * Просрочен ли релиз: запланирован, дата релиза (`YYYY-MM-DD`, локальный день) + * задана и строго раньше локального дня `today`. Время внутри дня не учитывается; + * выпущенный релиз и релиз без даты не бывают просроченными. + */ +export function isReleaseOverdue(release: Release, today: Date): boolean { + if (release.status !== 'planned' || release.releaseDate === null) + return false + + const start = new Date(today.getFullYear(), today.getMonth(), today.getDate()) + return parseLocalDate(release.releaseDate).getTime() < start.getTime() +} + +/** + * Цель переноса незавершённых задач по умолчанию: id первого запланированного + * релиза по `order`, кроме `currentId`, а если таких нет — `'none'`. + */ +export function defaultReleaseTarget(planned: Release[], currentId: string): 'none' | string { + const first = [...planned].sort((a, b) => a.order - b.order).find(r => r.id !== currentId) + return first ? first.id : 'none' +} + +/** + * Текст подтверждения удаления релиза. При `taskCount > 0` добавляет, что + * задачи останутся без релиза; при 0 — только вопрос. + */ +export function releaseDeletionMessage(release: Release, taskCount: number): string { + const question = `Удалить релиз „${release.name}“?` + if (taskCount <= 0) + return question + + const verb = pluralRu(taskCount, ['останется', 'останутся', 'останутся']) + const word = pluralRu(taskCount, ['задача', 'задачи', 'задач']) + return `${question} ${taskCount} ${word} ${verb} без релиза.` +} + +/** + * Текст для поля/чипа «Релиз»: «Без релиза» для `null`/`undefined`, имя релиза + * для запланированного, «Имя (выпущен)» для выпущенного. `null`, если `releaseId` + * указан, но не найден в переданном списке (релизы ещё грузятся). + */ +export function releaseLabel(releases: Release[], releaseId: string | null | undefined): string | null { + if (releaseId == null) + return 'Без релиза' + + const release = releases.find(r => r.id === releaseId) + if (!release) + return null + + return release.status === 'released' ? `${release.name} (выпущен)` : release.name +} + +/** + * Раскладывает задачи релиза по корзинам (эпик, история). Порядок: эпики по + * `order`; внутри эпика сначала задачи прямо на эпике (`story = null`), затем + * истории по `order`; корзина «Без эпика» (`epic = null`) последней. Пустые + * корзины опускаются, кроме историй, чей собственный релиз равен releaseId. + * При releaseId = null показываются только корзины задач. Задачи с неизвестным `groupId` попадают в «Без эпика», + * порядок задач внутри корзины сохраняется. + */ +export function groupReleaseTasks(tasks: Task[], groups: BoardGroupNode[], releaseId: string | null): ReleaseTaskGroup[] { + const buckets = new Map() + const withoutEpic: Task[] = [] + + for (const task of tasks) { + const path = task.groupId ? groupPath(groups, task.groupId) : null + if (!path) { + withoutEpic.push(task) + continue + } + const key = path.story ? path.story.id : path.epic.id + const bucket = buckets.get(key) + if (bucket) + bucket.push(task) + else + buckets.set(key, [task]) + } + + const byOrder = (a: BoardGroupNode, b: BoardGroupNode) => a.order - b.order + const result: ReleaseTaskGroup[] = [] + + for (const epic of [...groups].sort(byOrder)) { + const own = buckets.get(epic.id) + if (own) + result.push({ epic, story: null, tasks: own }) + + for (const story of [...epic.children].sort(byOrder)) { + const storyTasks = buckets.get(story.id) + if (storyTasks || (releaseId !== null && story.releaseId === releaseId)) + result.push({ epic, story, tasks: storyTasks ?? [] }) + } + } + + if (withoutEpic.length > 0) + result.push({ epic: null, story: null, tasks: withoutEpic }) + + return result +} diff --git a/alfy-bot-frontend/src/features/projects/lib/sprint.ts b/alfy-bot-frontend/src/features/projects/lib/sprint.ts new file mode 100644 index 0000000..a734373 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/sprint.ts @@ -0,0 +1,84 @@ +import type { Sprint } from '../model/types' +import type { Task } from '@/features/tasks/model/types' +import { pluralRu } from '@/lib/plural' + +const MS_PER_DAY = 24 * 60 * 60 * 1000 + +/** Локальная полночь календарного дня `YYYY-MM-DD` (без сдвига по UTC). */ +export function parseLocalDate(iso: string): Date { + const [year, month, day] = iso.split('-').map(Number) + return new Date(year!, month! - 1, day!) +} + +/** + * Задачи спринта внутри проекта. `sprintId === null` — бэклог проекта: + * задачи без спринта (`undefined` и `null` считаются одним и тем же). + */ +export function sprintTasks(tasks: Task[], sprintId: string | null, projectId: string): Task[] { + return tasks.filter(t => t.projectId === projectId && (t.sprintId ?? null) === sprintId) +} + +/** Прогресс спринта: число выполненных задач и общее число задач с данным `sprintId`. */ +export function sprintProgress(tasks: Task[], sprintId: string): { done: number, total: number } { + const inSprint = tasks.filter(t => t.sprintId === sprintId) + return { done: inSprint.filter(t => t.completed).length, total: inSprint.length } +} + +/** + * Сколько календарных дней осталось до `endDate` (`YYYY-MM-DD`, локальная дата). + * В последний день спринта — 0, после окончания — отрицательное число. + * Время внутри дня `today` не учитывается. + */ +export function daysLeft(endDate: string, today: Date): number { + const end = parseLocalDate(endDate) + const start = new Date(today.getFullYear(), today.getMonth(), today.getDate()) + return Math.round((end.getTime() - start.getTime()) / MS_PER_DAY) +} + +/** + * Цель переноса незавершённых задач по умолчанию: id первого запланированного + * спринта по `order`, а если таких нет — `'backlog'`. + */ +export function defaultCompleteTarget(planned: Sprint[]): 'backlog' | string { + const first = [...planned].sort((a, b) => a.order - b.order)[0] + return first ? first.id : 'backlog' +} + +/** + * Последний день спринта длительностью `weeks` недель, начатого `start`: + * `start + weeks * 7 - 1` дней, то есть двухнедельный спринт с понедельника + * 5 октября заканчивается в воскресенье 18 октября. Исходная дата не меняется. + */ +export function sprintEndFromDuration(start: Date, weeks: 1 | 2 | 3 | 4): Date { + return new Date(start.getFullYear(), start.getMonth(), start.getDate() + weeks * 7 - 1) +} + +/** + * Текст подтверждения удаления спринта. При `taskCount > 0` добавляет, что + * задачи вернутся в бэклог; при 0 — только вопрос. + */ +export function sprintDeletionMessage(sprint: Sprint, taskCount: number): string { + const question = `Удалить „${sprint.name}“?` + if (taskCount <= 0) + return question + + const verb = pluralRu(taskCount, ['вернётся', 'вернутся', 'вернутся']) + const word = pluralRu(taskCount, ['задача', 'задачи', 'задач']) + return `${question} ${taskCount} ${word} ${verb} в бэклог.` +} + +/** + * Текст для поля/чипа «Спринт»: «Бэклог» для `null`/`undefined`, имя спринта + * для активного и запланированного, «Имя (закрыт)» для завершённого. `null`, + * если `sprintId` указан, но не найден в переданном списке (спринты ещё грузятся). + */ +export function sprintLabel(sprints: Sprint[], sprintId: string | null | undefined): string | null { + if (sprintId == null) + return 'Бэклог' + + const sprint = sprints.find(s => s.id === sprintId) + if (!sprint) + return null + + return sprint.status === 'closed' ? `${sprint.name} (закрыт)` : sprint.name +} diff --git a/alfy-bot-frontend/src/features/projects/lib/task-key.ts b/alfy-bot-frontend/src/features/projects/lib/task-key.ts new file mode 100644 index 0000000..4b473e0 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/task-key.ts @@ -0,0 +1,30 @@ +import type { Project } from '../model/types' +import type { Task } from '@/features/tasks/model/types' + +/** + * Ключ задачи вида `ALF-12`: префикс проекта и номер задачи. + * Возвращает `null`, если проекта нет, он не agile, префикс не задан или у задачи нет номера. + */ +export function taskKey( + project: Pick | undefined, + task: Pick, +): string | null { + if (project?.type !== 'agile' || !project.taskKeyPrefix) + return null + if (typeof task.number !== 'number') + return null + return `${project.taskKeyPrefix}-${task.number}` +} + +const TASK_KEY_PREFIX_CHARS = /^[A-Z0-9]+$/ + +/** + * Признак заведомо неверного префикса: не пустая строка с символами вне `A-Z0-9` + * или длиннее 10. Точное правило (в том числе «начинается с буквы») проверяет сервер. + */ +export function isObviouslyInvalidTaskKeyPrefix(value: string): boolean { + const prefix = value.trim() + if (prefix.length === 0) + return false + return prefix.length > 10 || !TASK_KEY_PREFIX_CHARS.test(prefix) +} diff --git a/alfy-bot-frontend/src/features/projects/lib/use-agile-dnd.ts b/alfy-bot-frontend/src/features/projects/lib/use-agile-dnd.ts new file mode 100644 index 0000000..058330a --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/use-agile-dnd.ts @@ -0,0 +1,34 @@ +import type { useTaskStore } from '@/features/tasks/model/task-store' + +interface MoveEvent { + added?: { element: { id: string }; newIndex: number } + moved?: { element: { id: string }; newIndex: number } +} + +export function useAgileDnd(taskStore: ReturnType) { + function onTaskChange( + event: MoveEvent, + columnId: string, + groupId: string | null, + projectId: string, + cellTasks: { id: string }[], + ) { + if (event.added) { + const taskId = event.added.element.id + const orderedIds = cellTasks.map(t => t.id) + taskStore.moveTask(taskId, projectId, { + columnId, + groupId, + order: event.added.newIndex, + }) + if (orderedIds.length > 1) { + taskStore.reorderTasks(projectId, orderedIds, columnId) + } + } else if (event.moved) { + const orderedIds = cellTasks.map(t => t.id) + taskStore.reorderTasks(projectId, orderedIds, columnId) + } + } + + return { onTaskChange } +} 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 new file mode 100644 index 0000000..afd9802 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/use-group-deletion.ts @@ -0,0 +1,43 @@ +import type { BoardGroupNode } from '../model/types' +import { useConfirm } from '@/composables/useConfirm' +import { useTaskStore } from '@/features/tasks/model/task-store' +import { useGroupStore } from '../model/group-store' +import { deletionImpact, groupDeletionMessage, groupTaskIds } from './group-tree' + +/** + * Удаление эпика/истории с подтверждением: один и тот же текст подтверждения + * и один и тот же локальный эффект (открепление задач группы — `groupId = + * null`) для доски и карточки группы, чтобы они не разошлись. + */ +export function useGroupDeletion() { + const { confirm } = useConfirm() + const groupStore = useGroupStore() + const taskStore = useTaskStore() + + async function deleteGroupWithConfirm(projectId: string, group: BoardGroupNode): Promise { + const impact = deletionImpact(group, taskStore.tasks) + const confirmed = await confirm({ + title: group.type === 'epic' ? 'Удалить эпик?' : 'Удалить историю?', + message: groupDeletionMessage(group, impact), + confirmText: 'Удалить', + cancelText: 'Отмена', + variant: 'destructive', + }) + if (!confirmed) + return false + + try { + await groupStore.deleteGroup(projectId, group.id) + } + catch (err) { + console.error('Ошибка удаления группы:', err) + return false + } + + const clearedIds = new Set(groupTaskIds(group)) + taskStore.tasks = taskStore.tasks.map(t => (t.groupId && clearedIds.has(t.groupId)) ? { ...t, groupId: null } : t) + return true + } + + return { deleteGroupWithConfirm } +} diff --git a/alfy-bot-frontend/src/features/projects/model/group-store.ts b/alfy-bot-frontend/src/features/projects/model/group-store.ts new file mode 100644 index 0000000..959adbb --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/model/group-store.ts @@ -0,0 +1,211 @@ +import type { BoardGroup, BoardGroupNode, CreateGroupPayload, GroupType, UpdateGroupPayload } from './types' +import { defineStore } from 'pinia' +import { ref } from 'vue' +import * as groupsApi from '../api/groups-api' +import { findGroup } from '../lib/group-tree' + +function replaceNode( + nodes: BoardGroupNode[], + id: string, + updater: (node: BoardGroupNode) => BoardGroupNode, +): BoardGroupNode[] { + return nodes.map((node) => { + if (node.id === id) + return updater(node) + return { ...node, children: replaceNode(node.children, id, updater) } + }) +} + +function removeNode(nodes: BoardGroupNode[], id: string): BoardGroupNode[] { + return nodes + .filter(node => node.id !== id) + .map(node => ({ ...node, children: removeNode(node.children, id) })) +} + +export const useGroupStore = defineStore('groups', () => { + const trees = ref>({}) + const loadingProjects = ref>(new Set()) + const error = ref(null) + + function groupsOf(projectId: string): BoardGroupNode[] { + return trees.value[projectId] ?? [] + } + + function isLoading(projectId: string): boolean { + return loadingProjects.value.has(projectId) + } + + const fetchGroups = async (projectId: string) => { + loadingProjects.value.add(projectId) + error.value = null + + try { + const { data } = await groupsApi.fetchGroups(projectId) + trees.value[projectId] = data + } + catch (err) { + error.value = err instanceof Error ? err.message : 'Ошибка загрузки эпиков' + } + finally { + loadingProjects.value.delete(projectId) + } + } + + async function ensureGroups(projectId: string): Promise { + if (projectId in trees.value || isLoading(projectId)) + return + await fetchGroups(projectId) + } + + const createGroup = async (projectId: string, payload: CreateGroupPayload) => { + const parentId = payload.parentId ?? null + const type: GroupType = parentId ? 'story' : 'epic' + const tempId = `temp-${Date.now()}` + const tree = trees.value[projectId] ?? [] + const siblings = parentId ? (findGroup(tree, parentId)?.children ?? []) : tree + const tempNode: BoardGroupNode = { + id: tempId, + projectId, + parentId, + type, + title: payload.title, + description: payload.description ?? null, + status: 'open', + completedAt: null, + releaseId: null, + sprintId: null, + color: payload.color ?? null, + startDate: payload.startDate ?? null, + dueDate: payload.dueDate ?? null, + order: siblings.length, + children: [], + } + + trees.value[projectId] = parentId + ? replaceNode(tree, parentId, node => ({ + ...node, + children: [...node.children, tempNode], + })) + : [...tree, tempNode] + + try { + const { data } = await groupsApi.createGroup(projectId, payload) + const newNode: BoardGroupNode = { ...data, children: [] } + const current = trees.value[projectId] ?? [] + + trees.value[projectId] = parentId + ? replaceNode(current, parentId, node => ({ + ...node, + children: node.children.map(child => (child.id === tempId ? newNode : child)), + })) + : current.map(node => (node.id === tempId ? newNode : node)) + + return data + } + catch (err) { + const current = trees.value[projectId] ?? [] + trees.value[projectId] = parentId + ? replaceNode(current, parentId, node => ({ + ...node, + children: node.children.filter(child => child.id !== tempId), + })) + : current.filter(node => node.id !== tempId) + throw err + } + } + + const updateGroup = async (projectId: string, groupId: string, payload: UpdateGroupPayload) => { + const tree = trees.value[projectId] ?? [] + const previous = tree + const target = findGroup(tree, groupId) + if (!target) + return + + trees.value[projectId] = replaceNode(tree, groupId, node => ({ ...node, ...payload })) + + try { + const { data } = await groupsApi.updateGroup(projectId, groupId, payload) + trees.value[projectId] = replaceNode(trees.value[projectId] ?? [], groupId, node => ({ ...node, ...data })) + return data + } + catch (err) { + trees.value[projectId] = previous + throw err + } + } + + const deleteGroup = async (projectId: string, groupId: string) => { + const tree = trees.value[projectId] ?? [] + const previous = tree + const target = findGroup(tree, groupId) + if (!target) + return + + trees.value[projectId] = removeNode(tree, groupId) + + try { + await groupsApi.deleteGroup(projectId, groupId) + } + catch (err) { + trees.value[projectId] = previous + throw err + } + } + + const reorderGroups = async (projectId: string, orderedIds: string[]) => { + const tree = trees.value[projectId] ?? [] + const previous = tree + const firstId = orderedIds[0] + const isRootLevel = tree.some(node => node.id === firstId) + + if (isRootLevel) { + trees.value[projectId] = orderedIds + .map((id, i) => { + const node = tree.find(n => n.id === id) + return node ? { ...node, order: i } : null + }) + .filter((n): n is BoardGroupNode => n !== null) + } + else { + const parent = tree.find(epic => epic.children.some(child => child.id === firstId)) + if (parent) { + trees.value[projectId] = replaceNode(tree, parent.id, node => ({ + ...node, + children: orderedIds + .map((id, i) => { + const child = node.children.find(c => c.id === id) + return child ? { ...child, order: i } : null + }) + .filter((c): c is BoardGroupNode => c !== null), + })) + } + } + + try { + await groupsApi.reorderGroups(projectId, orderedIds) + } + catch (err) { + trees.value[projectId] = previous + throw err + } + } + + const toggleGroupDone = async (projectId: string, group: BoardGroup) => { + const nextStatus: 'open' | 'done' = group.status === 'done' ? 'open' : 'done' + return updateGroup(projectId, group.id, { status: nextStatus }) + } + + return { + trees, + error, + groupsOf, + isLoading, + fetchGroups, + ensureGroups, + createGroup, + updateGroup, + deleteGroup, + reorderGroups, + toggleGroupDone, + } +}) diff --git a/alfy-bot-frontend/src/features/projects/model/project-store.ts b/alfy-bot-frontend/src/features/projects/model/project-store.ts index c626e94..52830dd 100644 --- a/alfy-bot-frontend/src/features/projects/model/project-store.ts +++ b/alfy-bot-frontend/src/features/projects/model/project-store.ts @@ -37,9 +37,11 @@ export const useProjectStore = defineStore('projects', () => { title: payload.title, description: payload.description ?? null, viewMode: payload.viewMode ?? 'list', + type: payload.type ?? 'simple', icon: payload.icon ?? null, color: payload.color ?? null, order: projects.value.length, + taskKeyPrefix: payload.taskKeyPrefix ?? null, } projects.value.push(tempProject) diff --git a/alfy-bot-frontend/src/features/projects/model/release-store.ts b/alfy-bot-frontend/src/features/projects/model/release-store.ts new file mode 100644 index 0000000..04df95f --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/model/release-store.ts @@ -0,0 +1,227 @@ +import type { CreateReleasePayload, Release, UpdateReleasePayload } from './types' +import { defineStore } from 'pinia' +import { ref } from 'vue' +import { useTaskStore } from '@/features/tasks/model/task-store' +import * as groupsApi from '../api/groups-api' +import * as releasesApi from '../api/releases-api' +import { useGroupStore } from './group-store' + +function byOrder(a: Release, b: Release): number { + return a.order - b.order +} + +function byReleasedAtDesc(a: Release, b: Release): number { + return Date.parse(b.releasedAt!) - Date.parse(a.releasedAt!) +} + +/** + * Единственный кэш релизов по проектам (`lists[projectId]`). Копий списка + * в компонентах быть не должно. Изменения оптимистичны и откатываются при + * ошибке API; локальные эффекты на задачи применяются только после успеха. + */ +export const useReleaseStore = defineStore('releases', () => { + const lists = ref>({}) + const loadingProjects = ref>(new Set()) + const error = ref(null) + + async function refreshAssignments(projectId: string, includeTasks: boolean): Promise { + const groupStore = useGroupStore() + const taskStore = useTaskStore() + const reads = [groupStore.fetchGroups(projectId)] + if (includeTasks) + reads.push(taskStore.fetchTasks()) + await Promise.all(reads) + const failure = groupStore.error || (includeTasks ? taskStore.error : null) + if (failure) { + error.value = `Изменения сохранены, но не удалось обновить данные: ${failure}` + throw new Error(error.value) + } + error.value = null + } + + /** Все релизы проекта, включая выпущенные, в порядке `order`. Для незагруженного проекта — `[]`. */ + function releasesOf(projectId: string): Release[] { + return lists.value[projectId] ?? [] + } + + /** Запланированные релизы проекта в порядке `order`. */ + function plannedReleasesOf(projectId: string): Release[] { + return releasesOf(projectId).filter(r => r.status === 'planned').sort(byOrder) + } + + /** Выпущенные релизы проекта, самые свежие (по `releasedAt`) первыми. */ + function releasedReleasesOf(projectId: string): Release[] { + return releasesOf(projectId).filter(r => r.status === 'released').sort(byReleasedAtDesc) + } + + function isLoading(projectId: string): boolean { + return loadingProjects.value.has(projectId) + } + + function patchRelease(projectId: string, id: string, patch: Partial) { + lists.value[projectId] = releasesOf(projectId).map(r => (r.id === id ? { ...r, ...patch } : r)) + } + + const fetchReleases = async (projectId: string) => { + loadingProjects.value.add(projectId) + error.value = null + + try { + const { data } = await releasesApi.fetchReleases(projectId) + lists.value[projectId] = data + } + catch (err) { + error.value = err instanceof Error ? err.message : 'Ошибка загрузки релизов' + } + finally { + loadingProjects.value.delete(projectId) + } + } + + /** Загружает релизы проекта, только если они ещё не загружены и не грузятся. */ + async function ensureReleases(projectId: string): Promise { + if (projectId in lists.value || isLoading(projectId)) + return + await fetchReleases(projectId) + } + + const createRelease = async (projectId: string, payload: CreateReleasePayload) => { + const tempId = `temp-${Date.now()}` + const now = new Date().toISOString() + const current = releasesOf(projectId) + const tempRelease: Release = { + id: tempId, + userId: 0, + projectId, + name: payload.name, + description: payload.description ?? null, + startDate: payload.startDate ?? null, + releaseDate: payload.releaseDate ?? null, + status: 'planned', + releasedAt: null, + order: current.length, + createdAt: now, + updatedAt: now, + } + + lists.value[projectId] = [...current, tempRelease] + + try { + const { data } = await releasesApi.createRelease(projectId, payload) + lists.value[projectId] = releasesOf(projectId).map(r => (r.id === tempId ? data : r)) + return data + } + catch (err) { + lists.value[projectId] = releasesOf(projectId).filter(r => r.id !== tempId) + throw err + } + } + + const updateRelease = async (projectId: string, id: string, payload: UpdateReleasePayload) => { + const previous = releasesOf(projectId) + if (!previous.some(r => r.id === id)) + return + + patchRelease(projectId, id, payload) + + try { + const { data } = await releasesApi.updateRelease(projectId, id, payload) + patchRelease(projectId, id, data) + return data + } + catch (err) { + lists.value[projectId] = previous + throw err + } + } + + /** + * Удаляет релиз. После успеха API задачи релиза локально теряют + * `releaseId` (`null`) — сами задачи не удаляются. + */ + const deleteRelease = async (projectId: string, id: string) => { + const previous = releasesOf(projectId) + if (!previous.some(r => r.id === id)) + return + + lists.value[projectId] = previous.filter(r => r.id !== id) + + try { + await releasesApi.deleteRelease(projectId, id) + } + catch (err) { + lists.value[projectId] = previous + throw err + } + + const taskStore = useTaskStore() + taskStore.tasks = taskStore.tasks.map(t => (t.releaseId === id ? { ...t, releaseId: null } : t)) + await refreshAssignments(projectId, false) + } + + /** + * Выпускает запланированный релиз. `moveTo` — `'none'` или id релиза, куда + * уходят незавершённые задачи; после успеха API им локально выставляется + * `releaseId` (`'none'` → `null`), выполненные задачи остаются в выпущенном релизе. + */ + const releaseRelease = async (projectId: string, id: string, moveTo: 'none' | string) => { + const previous = releasesOf(projectId) + if (!previous.some(r => r.id === id)) + return + + patchRelease(projectId, id, { status: 'released' }) + + let data: Release + try { + ({ data } = await releasesApi.releaseRelease(projectId, id, { moveTo })) + } + catch (err) { + lists.value[projectId] = previous + throw err + } + + patchRelease(projectId, id, data) + const targetId = moveTo === 'none' ? null : moveTo + const taskStore = useTaskStore() + taskStore.tasks = taskStore.tasks.map(t => + (t.releaseId === id && !t.completed) ? { ...t, releaseId: targetId } : t, + ) + await refreshAssignments(projectId, false) + return data + } + + /** + * Назначает в релиз все задачи группы (эпик вместе с историями либо + * историю). После успеха API перечитывает задачи и возвращает число + * затронутых задач. + */ + const assignGroup = async (projectId: string, releaseId: string, groupId: string) => { + const { data } = await releasesApi.assignGroupToRelease(projectId, releaseId, { groupId }) + await refreshAssignments(projectId, true) + return data.updated + } + + /** Сохраняет плановый релиз истории и обновляет дерево и задачи после успеха API. */ + async function setStoryRelease(projectId: string, groupId: string, releaseId: string | null): Promise { + const { data } = await groupsApi.setGroupRelease(projectId, groupId, releaseId) + await refreshAssignments(projectId, true) + return data.updated + } + + return { + setStoryRelease, + lists, + error, + releasesOf, + plannedReleasesOf, + releasedReleasesOf, + isLoading, + fetchReleases, + ensureReleases, + createRelease, + updateRelease, + deleteRelease, + releaseRelease, + assignGroup, + } +}) diff --git a/alfy-bot-frontend/src/features/projects/model/sprint-store.ts b/alfy-bot-frontend/src/features/projects/model/sprint-store.ts new file mode 100644 index 0000000..f9f5ece --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/model/sprint-store.ts @@ -0,0 +1,233 @@ +import type { CreateSprintPayload, Sprint, StartSprintPayload, UpdateSprintPayload } from './types' +import { defineStore } from 'pinia' +import { ref } from 'vue' +import { useTaskStore } from '@/features/tasks/model/task-store' +import * as groupsApi from '../api/groups-api' +import * as sprintsApi from '../api/sprints-api' +import { useGroupStore } from './group-store' + +function byOrder(a: Sprint, b: Sprint): number { + return a.order - b.order +} + +/** + * Единственный кэш спринтов по проектам (`lists[projectId]`). Копий списка + * в компонентах быть не должно. Изменения оптимистичны и откатываются при + * ошибке API; локальные эффекты на задачи применяются только после успеха. + */ +export const useSprintStore = defineStore('sprints', () => { + const lists = ref>({}) + const loadingProjects = ref>(new Set()) + const error = ref(null) + + async function refreshAssignments(projectId: string): Promise { + const groupStore = useGroupStore() + const taskStore = useTaskStore() + await Promise.all([groupStore.fetchGroups(projectId), taskStore.fetchTasks()]) + const failure = groupStore.error || taskStore.error + if (failure) { + error.value = `Изменения сохранены, но не удалось обновить данные: ${failure}` + throw new Error(error.value) + } + error.value = null + } + + /** Сохраняет спринт истории и обновляет задачи и дерево после успеха API. */ + async function setStorySprint(projectId: string, storyId: string, sprintId: string | null): Promise { + const { data } = await groupsApi.setGroupSprint(projectId, storyId, sprintId) + await refreshAssignments(projectId) + return data.updated + } + + /** Все спринты проекта, включая завершённые, в порядке `order`. Для незагруженного проекта — `[]`. */ + function sprintsOf(projectId: string): Sprint[] { + return lists.value[projectId] ?? [] + } + + /** Единственный активный спринт проекта или `null`. */ + function activeSprintOf(projectId: string): Sprint | null { + return sprintsOf(projectId).find(s => s.status === 'active') ?? null + } + + /** Запланированные спринты проекта в порядке `order`. */ + function plannedSprintsOf(projectId: string): Sprint[] { + return sprintsOf(projectId).filter(s => s.status === 'planned').sort(byOrder) + } + + function isLoading(projectId: string): boolean { + return loadingProjects.value.has(projectId) + } + + function patchSprint(projectId: string, id: string, patch: Partial) { + lists.value[projectId] = sprintsOf(projectId).map(s => (s.id === id ? { ...s, ...patch } : s)) + } + + const fetchSprints = async (projectId: string) => { + loadingProjects.value.add(projectId) + error.value = null + + try { + const { data } = await sprintsApi.fetchSprints(projectId) + lists.value[projectId] = data + } + catch (err) { + error.value = err instanceof Error ? err.message : 'Ошибка загрузки спринтов' + } + finally { + loadingProjects.value.delete(projectId) + } + } + + /** Загружает спринты проекта, только если они ещё не загружены и не грузятся. */ + async function ensureSprints(projectId: string): Promise { + if (projectId in lists.value || isLoading(projectId)) + return + await fetchSprints(projectId) + } + + const createSprint = async (projectId: string, payload: CreateSprintPayload) => { + const tempId = `temp-${Date.now()}` + const now = new Date().toISOString() + const current = sprintsOf(projectId) + const tempSprint: Sprint = { + id: tempId, + userId: 0, + projectId, + name: payload.name ?? `Спринт ${current.length + 1}`, + goal: payload.goal ?? null, + startDate: null, + endDate: null, + status: 'planned', + completedAt: null, + order: current.length, + createdAt: now, + updatedAt: now, + } + + lists.value[projectId] = [...current, tempSprint] + + try { + const { data } = await sprintsApi.createSprint(projectId, payload) + lists.value[projectId] = sprintsOf(projectId).map(s => (s.id === tempId ? data : s)) + return data + } + catch (err) { + lists.value[projectId] = sprintsOf(projectId).filter(s => s.id !== tempId) + throw err + } + } + + const updateSprint = async (projectId: string, id: string, payload: UpdateSprintPayload) => { + const previous = sprintsOf(projectId) + if (!previous.some(s => s.id === id)) + return + + patchSprint(projectId, id, payload) + + try { + const { data } = await sprintsApi.updateSprint(projectId, id, payload) + patchSprint(projectId, id, data) + return data + } + catch (err) { + lists.value[projectId] = previous + throw err + } + } + + /** + * Удаляет спринт. После успеха API задачи спринта локально уходят в + * бэклог (`sprintId = null`) — сами задачи не удаляются. + */ + const deleteSprint = async (projectId: string, id: string) => { + const previous = sprintsOf(projectId) + if (!previous.some(s => s.id === id)) + return + + lists.value[projectId] = previous.filter(s => s.id !== id) + + try { + await sprintsApi.deleteSprint(projectId, id) + } + catch (err) { + lists.value[projectId] = previous + throw err + } + + const taskStore = useTaskStore() + taskStore.tasks = taskStore.tasks.map(t => (t.sprintId === id ? { ...t, sprintId: null } : t)) + await refreshAssignments(projectId) + } + + /** Запускает запланированный спринт: `active` с датами старта и конца. */ + const startSprint = async (projectId: string, id: string, payload: StartSprintPayload) => { + const previous = sprintsOf(projectId) + if (!previous.some(s => s.id === id)) + return + + patchSprint(projectId, id, { + status: 'active', + startDate: payload.startDate, + endDate: payload.endDate, + ...(payload.goal !== undefined ? { goal: payload.goal } : {}), + }) + + try { + const { data } = await sprintsApi.startSprint(projectId, id, payload) + patchSprint(projectId, id, data) + return data + } + catch (err) { + lists.value[projectId] = previous + throw err + } + } + + /** + * Завершает спринт. `moveTo` — `'backlog'` или id спринта, куда уходят + * незавершённые задачи; после успеха API им локально выставляется + * `sprintId` (`'backlog'` → `null`), выполненные задачи остаются в спринте. + */ + const completeSprint = async (projectId: string, id: string, moveTo: 'backlog' | string) => { + const previous = sprintsOf(projectId) + if (!previous.some(s => s.id === id)) + return + + patchSprint(projectId, id, { status: 'closed' }) + + let data: Sprint + try { + ({ data } = await sprintsApi.completeSprint(projectId, id, { moveTo })) + } + catch (err) { + lists.value[projectId] = previous + throw err + } + + patchSprint(projectId, id, data) + const targetId = moveTo === 'backlog' ? null : moveTo + const taskStore = useTaskStore() + taskStore.tasks = taskStore.tasks.map(t => + (t.sprintId === id && !t.completed) ? { ...t, sprintId: targetId } : t, + ) + await refreshAssignments(projectId) + return data + } + + return { + setStorySprint, + lists, + error, + sprintsOf, + activeSprintOf, + plannedSprintsOf, + isLoading, + fetchSprints, + ensureSprints, + createSprint, + updateSprint, + deleteSprint, + startSprint, + completeSprint, + } +}) diff --git a/alfy-bot-frontend/src/features/projects/model/types.ts b/alfy-bot-frontend/src/features/projects/model/types.ts index 5720b16..3490b61 100644 --- a/alfy-bot-frontend/src/features/projects/model/types.ts +++ b/alfy-bot-frontend/src/features/projects/model/types.ts @@ -1,14 +1,19 @@ export type ViewMode = 'list' | 'board' +export type ProjectType = 'simple' | 'agile' + export interface Project { id: string parentId: string | null title: string description: string | null viewMode: ViewMode + type: ProjectType icon: string | null color: string | null order: number + /** Префикс ключей задач (`ALF` → `ALF-12`), только у agile-проекта; `null` — префикс не задан. */ + taskKeyPrefix: string | null } export interface ProjectColumn { @@ -19,6 +24,46 @@ export interface ProjectColumn { color: string | null } +export type GroupType = 'epic' | 'story' + +export type GroupStatus = 'open' | 'done' + +export interface BoardGroup { + /** Плановый релиз истории; у эпика и незапланированной истории — null. */ + releaseId: string | null + /** Назначенный спринт истории; у эпика и истории в бэклоге — null. */ + sprintId: string | null + id: string + projectId: string + parentId: string | null + type: GroupType + title: string + description: string | null + status: GroupStatus + completedAt: string | null + color: string | null + startDate: string | null + dueDate: string | null + order: number +} + +export interface BoardGroupNode extends BoardGroup { + children: BoardGroupNode[] +} + +export interface CreateGroupPayload { + title: string + parentId?: string | null + description?: string | null + color?: string | null + startDate?: string | null + dueDate?: string | null +} + +export type UpdateGroupPayload = Partial & { + status?: GroupStatus +} + export interface ProjectTreeNode extends Project { children: ProjectTreeNode[] } @@ -28,8 +73,99 @@ export interface CreateProjectPayload { parentId?: string | null description?: string | null viewMode?: ViewMode + type?: ProjectType icon?: string | null color?: string | null + /** Префикс ключей задач, только для agile; `null` очищает. Формат проверяет сервер. */ + taskKeyPrefix?: string | null } export type UpdateProjectPayload = Partial + +/** Статус спринта: `planned` — запланирован, `active` — идёт (не более одного на проект), `closed` — завершён. */ +export type SprintStatus = 'planned' | 'active' | 'closed' + +/** Спринт agile-проекта. Даты — `YYYY-MM-DD` (локальный календарный день), `null` пока спринт не запущен. */ +export interface Sprint { + id: string + userId: number + projectId: string + name: string + goal: string | null + startDate: string | null + endDate: string | null + status: SprintStatus + completedAt: string | null + order: number + createdAt: string + updatedAt: string +} + +/** Без `name` сервер называет спринт «Спринт N». */ +export interface CreateSprintPayload { + name?: string + goal?: string | null +} + +export interface UpdateSprintPayload { + name?: string + goal?: string | null + startDate?: string | null + endDate?: string | null +} + +/** Запуск спринта: `endDate` — последний день спринта включительно. */ +export interface StartSprintPayload { + startDate: string + endDate: string + goal?: string | null +} + +/** Завершение спринта: `moveTo` — `'backlog'` или id запланированного спринта, куда уходят незавершённые задачи. */ +export interface CompleteSprintPayload { + moveTo: 'backlog' | string +} + +/** Статус релиза: `planned` — запланирован, `released` — выпущен (только чтение). */ +export type ReleaseStatus = 'planned' | 'released' + +/** Релиз agile-проекта. Даты — `YYYY-MM-DD` (локальный календарный день), `releasedAt` — ISO-момент выпуска. */ +export interface Release { + id: string + userId: number + projectId: string + name: string + description: string | null + startDate: string | null + releaseDate: string | null + status: ReleaseStatus + releasedAt: string | null + order: number + createdAt: string + updatedAt: string +} + +/** Имя релиза обязательно: естественной нумерации, как у спринтов, нет. */ +export interface CreateReleasePayload { + name: string + description?: string | null + startDate?: string | null + releaseDate?: string | null +} + +export interface UpdateReleasePayload { + name?: string + description?: string | null + startDate?: string | null + releaseDate?: string | null +} + +/** Выпуск релиза: `moveTo` — `'none'` или id запланированного релиза, куда уходят незавершённые задачи. */ +export interface ReleaseActionPayload { + moveTo: 'none' | string +} + +/** Назначение всех задач группы (эпик вместе с историями либо история) в релиз. */ +export interface AssignGroupToReleasePayload { + groupId: string +} diff --git a/alfy-bot-frontend/src/features/projects/model/use-group-detail.ts b/alfy-bot-frontend/src/features/projects/model/use-group-detail.ts new file mode 100644 index 0000000..dfea851 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/model/use-group-detail.ts @@ -0,0 +1,29 @@ +import { readonly, ref } from 'vue' + +interface GroupDetailTarget { + projectId: string + groupId: string +} + +const current = ref(null) + +function open(projectId: string, groupId: string): void { + current.value = { projectId, groupId } +} + +function close(): void { + current.value = null +} + +/** + * Модульный синглтон открытой карточки эпика/истории: какая группа какого + * проекта сейчас показана в модалке. Состояние общее для всех вызовов — + * это одна модалка на всё приложение, а не собственный стейт компонента. + */ +export function useGroupDetail() { + return { + current: readonly(current), + open, + close, + } +} diff --git a/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue b/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue new file mode 100644 index 0000000..aad05f4 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue @@ -0,0 +1,220 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/AgileCell.vue b/alfy-bot-frontend/src/features/projects/ui/AgileCell.vue new file mode 100644 index 0000000..1467367 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/AgileCell.vue @@ -0,0 +1,48 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue b/alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue new file mode 100644 index 0000000..400dace --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue @@ -0,0 +1,203 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/AgileStoryBlock.vue b/alfy-bot-frontend/src/features/projects/ui/AgileStoryBlock.vue new file mode 100644 index 0000000..8f01fb9 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/AgileStoryBlock.vue @@ -0,0 +1,113 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/BacklogEpicsPanel.vue b/alfy-bot-frontend/src/features/projects/ui/BacklogEpicsPanel.vue new file mode 100644 index 0000000..ecc5263 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/BacklogEpicsPanel.vue @@ -0,0 +1,182 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/BacklogStoryRow.vue b/alfy-bot-frontend/src/features/projects/ui/BacklogStoryRow.vue new file mode 100644 index 0000000..8e78665 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/BacklogStoryRow.vue @@ -0,0 +1,149 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/BacklogTaskRow.vue b/alfy-bot-frontend/src/features/projects/ui/BacklogTaskRow.vue new file mode 100644 index 0000000..8076016 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/BacklogTaskRow.vue @@ -0,0 +1,159 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/GroupActionsMenu.vue b/alfy-bot-frontend/src/features/projects/ui/GroupActionsMenu.vue new file mode 100644 index 0000000..c527935 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/GroupActionsMenu.vue @@ -0,0 +1,150 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/GroupDetailDialog.vue b/alfy-bot-frontend/src/features/projects/ui/GroupDetailDialog.vue new file mode 100644 index 0000000..05ca457 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/GroupDetailDialog.vue @@ -0,0 +1,456 @@ + + +