From a09fe7301b8ddb746851ec5792cfd8cb22fc583a Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 10:47:41 +0500 Subject: [PATCH 01/99] docs(task): design and plan for agile board epics and stories --- docs/tasks/agile-board-epics-stories.md | 312 ++++++++++++++++++++++++ 1 file changed, 312 insertions(+) create mode 100644 docs/tasks/agile-board-epics-stories.md diff --git a/docs/tasks/agile-board-epics-stories.md b/docs/tasks/agile-board-epics-stories.md new file mode 100644 index 0000000..a29b206 --- /dev/null +++ b/docs/tasks/agile-board-epics-stories.md @@ -0,0 +1,312 @@ +# Agile-доска: эпики и истории (этап 1 — отображение) + +**Status:** executing +**Branch:** feat/agile-board +**Worktree:** .worktrees/feat-agile-board +**Mode:** interactive + +## Design + +Спроектировано на Miro-борде [uXjVNAsstT8](https://miro.com/app/board/uXjVNAsstT8=). Артефакты: + +- [Док «Решения и этапы»](https://miro.com/app/board/uXjVNAsstT8=/?moveToWidget=3458764681138724721) — источник истины по решениям +- [Макет v2 — десктоп](https://miro.com/app/board/uXjVNAsstT8=/?moveToWidget=3458764681139606182) +- [Макет — мобилка 390px](https://miro.com/app/board/uXjVNAsstT8=/?moveToWidget=3458764681139606183) +- [ERD v2](https://miro.com/app/board/uXjVNAsstT8=/?moveToWidget=3458764681140262185) + +Design закрыт и переспрашиванию не подлежит. Ниже — самодостаточный пересказ, чтобы работать по файлу без доступа к борду. + +### Зачем + +На доске проекта сегодня есть только колонки-статусы: задачи лежат плоским списком внутри колонки. Нет способа увидеть, что задача принадлежит крупному куску работы. Нужна группировка «эпик → история → задачи» на **одной** доске, вместе со статусами, а не на отдельном экране. + +### Решение 1 — эпик и история это новая сущность `BoardGroup` + +Self-nesting внутри проекта: `parentId = null` → эпик, `parentId = <эпик>` → история. Ровно два уровня. Задача получает nullable `groupId`. + +Почему не переиспользовать дерево проектов (`Project.parentId` уже есть, стоило бы ноль изменений схемы): эпики и истории полезли бы в сайдбар-навигацию, а создание истории стало бы созданием проекта — с иконкой, цветом и своим `viewMode`. Навигация и структура работы это разные вещи. + +Почему не `parentId` + `type` на `Task` (как в Jira): два псевдо-типа задач протекли бы во все существующие списки — Inbox, Сегодня, календарь, таймер, поиск, повторяющиеся задачи. В каждый пришлось бы вставлять фильтр, и каждый новый экран был бы обязан про него помнить. Цена размазана по всему фронту и никогда не заканчивается. + +Отдельная сущность локализует цену: задачи остаются задачами везде, проекты остаются навигацией, группировка существует только на Agile-доске. + +### Решение 2 — колонки задаёт проект, эпик и история их не заводят + +Три оси: + +- **X — статус.** `ProjectColumn`, уже существует, не меняем. +- **Y — группировка.** `BoardGroup` как вложенные рамки. +- **Z — фокус.** Спринт. Этап 2, вне скоупа. Не строка и не колонка, а фильтр всей доски (`Task.sprintId`) — поэтому ляжет сверху, не трогая X и Y. + +Заголовки колонок рендерятся **один раз на всю доску**. Эпик и история — вложенные рамки *поверх* сквозной колоночной сетки, а не собственные мини-доски. Смысл: вертикаль «В работе» не прерывается ни эпиком, ни историей, поэтому видно всю работу в статусе по всему проекту сразу. + +Отклонённый вариант (v1 на борде): подпись строки в левом gutter ~200px. На 390px это половина экрана под подписи. + +### Решение 3 — раскладка на CSS subgrid, скролл-контейнер один + +Колоночная сетка живёт на корне доски. Вложенные рамки наследуют её через `grid-template-columns: subgrid`. Это то, что гарантирует выравнивание ячеек на любой глубине без ручного пересчёта ширин. + +Рамки рисуются в запасе между краем колонки и карточкой (~22px), поэтому карточка не сдвигается ни на пиксель независимо от вложенности. + +**Мобилка 390px:** колонка ~260px, видно полторы. Горизонтальный скролл-контейнер **ровно один, на всю доску**. Если дать скролл каждой истории отдельно — истории разъедутся по горизонтали и сквозные колонки перестанут быть сквозными, то есть сломается ровно то, ради чего всё делалось. Заголовки колонок — `position: sticky` по верху. + +### Решение 4 — закрытие эпика только вручную + +Эпик закрывает человек; на закрытых эпиках позже будут собираться релизы. Автоматического «все дети готовы → эпик готов» нет: прогресс показываем, закрыть может только явное действие. + +Отсюда у `BoardGroup` собственное состояние `status: 'open' | 'done'` + `completedAt`. Это **не** то же самое, что «все задачи выполнены», и хранится отдельно. + +Роли и сущность `Release` из формулировки «принимается менеджером» — не в этом этапе. В Alfy сегодня один пользователь; закрывающий это владелец проекта. + +### Решение 5 — у задач в agile-проекте блок целей скрыт + +`goalIds` у задачи остаётся в модели, но в `TaskDetailDialog` блок целей не показывается, когда проект в режиме `agile`. + +Тонкость, зафиксированная сознательно: признак «agile-задача» сейчас выразим только через `viewMode` проекта, а `viewMode` это настройка отображения — её переключают туда-сюда. Получается, что смена режима просмотра меняет поведение UI. Поэтому вариант выбран мягкий: **скрываем в UI, ничего не удаляем и не запрещаем на бэке**. Уже проставленные `goalIds` остаются целыми, переключение режима полностью обратимо. Явный флаг проекта (`type: 'simple' | 'agile'`) честнее, но это отдельное решение — см. «Осталось открытым». + +### Решение 6 — дефолтные колонки для agile-проекта + +Обнаружено при разборе кода: **дефолтных колонок в проекте не создаётся вообще**, `ProjectColumn` заводит только пользователь руками. Значит решение «первая колонка называется *К выполнению*, а слово *Бэклог* зарезервировано за спринтовым измерением» не к чему прицепить — переименовывать нечего. + +Поэтому: при создании проекта с `viewMode: 'agile'` (и при переключении на `agile`, если колонок ещё нет) засеваем три колонки — **К выполнению / В работе / Готово**. Даёт сразу рабочую доску и закрепляет договорённость про имена. + +Слово «Бэклог» как имя колонки не используем: на этапе 2 бэклог станет отдельным экраном со списком задач без спринта, и колонка с тем же именем породила бы задачу «в колонке Бэклог, но внутри активного спринта». + +### Модель + +``` +BoardGroup (новая таблица board_groups) + id uuid PK + userId int + projectId uuid FK -> projects, CASCADE + parentId uuid FK -> board_groups, nullable, CASCADE + type 'epic' | 'story' + title string + description text | null + status 'open' | 'done' default 'open' + completedAt datetime | null + color text | null + order int + createdAt / updatedAt + +Task + + groupId uuid FK -> board_groups, nullable, SET NULL + +Project + viewMode: 'list' | 'board' | 'agile' (было 'list' | 'board') +``` + +### Политика базы — защита в три уровня + +Все три уровня обязательны, ни один в одиночку не закрывает задачу. + +**1. CHECK-констрейнты** через `@Check(...)` на сущности, `synchronize: true` создаёт их сам: + +- `type IN ('epic','story')` +- `status IN ('open','done')` +- `parentId <> id` +- `(parentId IS NULL AND type = 'epic') OR (parentId IS NOT NULL AND type = 'story')` + +**2. Триггеры SQLite.** Главное правило — «родитель обязан быть эпиком» — CHECK-ом невыразимо: нужен подзапрос к строке родителя, а SQLite подзапросы в CHECK запрещает. Значит `BEFORE INSERT` и `BEFORE UPDATE` с `RAISE(ABORT, ...)`: + +- если у вставляемой/обновляемой группы `parentId` не NULL, у родителя `parentId` обязан быть NULL — иначе появляется третий уровень; +- группе, у которой уже есть дети, нельзя проставить `parentId` — иначе эпик с историями задним числом превращается в историю, и третий уровень появляется с другой стороны; +- `task.groupId` обязан указывать на группу того же проекта, что `task.projectId`. + +**3. Валидация в сервисе** — не вместо триггеров, а вместе: триггер отдаёт сырую ошибку SQLite, и без сервисной проверки клиент получит 500 вместо внятного 400. + +**Ловушка, из-за которой это не разовая работа.** Триггеры не описываются декораторами TypeORM, `synchronize` их не создаёт. Хуже: при изменении схемы SQLite пересоздаёт таблицу (rename → create → copy → drop) и **молча роняет все триггеры на ней**. Поэтому `CREATE TRIGGER IF NOT EXISTS` должен выполняться на каждом старте приложения после synchronize — идемпотентным `BoardGroupConstraintsMigrationService` в `shared/database/`, рядом с остальными миграционными сервисами. Иначе защита однажды исчезнет при правке соседнего поля, и никто не заметит. + +### Скоуп этапа 1 + +Входит: + +- сущность `BoardGroup` + CRUD + триггеры + `Task.groupId` +- `viewMode: 'agile'` + засев дефолтных колонок +- `AgileBoardView` — отображение вложенности на сквозной колоночной сетке, десктоп и мобилка +- перетаскивание задач между ячейками (меняет `columnId` + `groupId` + `order`) +- создание/переименование/удаление эпиков и историй, ручное закрытие эпика +- скрытие блока целей в agile-проекте + +Не входит (этап 2, только не мешать): + +- `Sprint`, `Task.sprintId`, экран бэклога, фильтр по спринту +- хлебные крошки «Проект › Эпик › История» в диалоге задачи — но `groupId` обязан приходить в обычной выдаче задач, чтобы потом это не потребовало отдельного запроса +- роли, `Release` +- третий уровень вложенности + +### Осталось открытым + +- Признак «agile-проект»: остаётся `viewMode` или заводится явный флаг проекта. +- Третий уровень вложенности — если когда-нибудь понадобится. + +### Invariants + +- Глубина ровно 2. Эпик нельзя прикрепить к истории — ни через API, ни в обход сервиса, напрямую в репозиторий. +- Группе с детьми нельзя проставить `parentId`. +- `parentId <> id`. +- `parentId IS NULL` тогда и только тогда, когда `type = 'epic'`. +- `group.projectId` и `task.projectId` совпадают. Перенос задачи в другой проект обнуляет `groupId`. +- Удаление эпика каскадит на его истории, но **не удаляет задачи** — им ставится `groupId = null`, они падают в блок «Без эпика». +- Задача без `groupId` — нормальное состояние, а не ошибка. Доска обязана показывать проект, в котором нет ни одного эпика. +- `status = 'done'` у эпика ставится только явным действием и не выводится из состояния детей. +- Заголовки колонок рендерятся один раз на доску; горизонтальный скролл-контейнер на доске ровно один. +- Существующие гварды `viewMode === 'list'` в `project-column.service.ts` и `project-task.service.ts` остаются рабочими: `agile` проходит их так же, как `board`. + +### Principles + +- Группировка не протекает за пределы Agile-доски: ни бейджей в списках, ни в календаре, ни в таймере. +- `viewMode` управляет только отображением. Ни одно необратимое доменное действие не завязывается на него. +- Ячейка это пересечение колонки и группы, а не самостоятельная сущность. В БД её нет. +- Схема готовится под спринты, но ничего спринтового в этапе 1 не появляется. + +### TDD + +**Да** — для бэкенда и чистых утилит. Констрейнты, триггеры, правила глубины и раскладка задач по ячейкам детерминированы, а регрессия здесь означает молча испорченные данные. Тест на потерю триггеров при пересоздании таблицы обязателен и обязан бить **напрямую в репозиторий, мимо сервиса**, иначе он проверяет сервисную валидацию, а не защиту БД. + +Компонентные тесты Vue — после реализации, по образцу существующих в `alfy-bot-frontend/tests/`. + +## Plan + +Approach: `BoardGroup` заводится как второй столп внутри существующего `ProjectModule` — зеркало `project-column.*` по всем четырём слоям, потому что у групп та же форма жизни (принадлежат проекту, упорядочены, CRUD под `projects/:projectId/...`). Бэкенд идёт снизу вверх: сущность → защита в БД → API → интеграция в существующие потоки. Фронт следом: данные → рендер → взаимодействие. + +**Поправка к вводной.** Перетаскивание на доске идёт не через `PATCH /tasks/:id`, а через `PATCH /projects/:projectId/tasks/:taskId/move` — см. `use-board-dnd.ts:17` → `task-store.moveTask` → `ProjectTaskService.moveTask`. Поэтому `groupId` протаскивается через `MoveTaskDto` и `TaskRepositoryPort.updatePosition`, а `applyUpdateResponse` здесь ни при чём. + +### Phase 1 — сущность, порт, репозиторий + +- **1.1** `alfy-bot/src/shared/entities/board-group.entity.ts` (create) + - `@Entity('board_groups') class BoardGroup` — поля по разделу «Модель» Design. + - `@Check('CHK_board_group_type', "type IN ('epic','story')")`, `@Check('CHK_board_group_status', "status IN ('open','done')")`, `@Check('CHK_board_group_not_self', 'parentId <> id')`, `@Check('CHK_board_group_depth', "(parentId IS NULL AND type = 'epic') OR (parentId IS NOT NULL AND type = 'story')")`. + - `@ManyToOne(() => BoardGroup)` на `parentId`, `onDelete: 'CASCADE'`; `@ManyToOne(() => Project)`, `onDelete: 'CASCADE'`. + - Invariants: `parentId <> id`; согласованность `parentId` и `type`. +- **1.2** `alfy-bot/src/shared/entities/index.ts:13-15` (modify) — `export { BoardGroup } from './board-group.entity'`. +- **1.3** `alfy-bot/src/shared/entities/task.entity.ts:60,103-107` (modify) + - `groupId: string | null` рядом с `columnId`; `@ManyToOne(() => BoardGroup, { nullable: true, onDelete: 'SET NULL' })`. + - Invariant: удаление эпика не удаляет задачи — им ставится `groupId = null`. +- **1.4** `alfy-bot/src/app.module.ts:20-35,59-74` (modify) — `BoardGroup` в импорт и в `entities`. +- **1.5** `alfy-bot/src/modules/project/domain/board-group-repository.port.ts` (create) + - `findAllByProject(projectId: string): Promise` — плоский список, дерево собирает сервис. + - `findById(id: string, projectId: string): Promise` + - `countChildren(id: string): Promise` + - `create(data: Partial): Promise` / `save` / `delete` / `reorder(updates: { id: string; order: number }[])` +- **1.6** `alfy-bot/src/modules/project/infrastructure/typeorm-board-group.repository.ts` (create) — зеркало `typeorm-project-column.repository.ts:16-47`. +- Commit: `feat(project): add BoardGroup entity and repository` + +### Phase 2 — защита в БД (TDD, тесты первыми) + +- **2.1** `alfy-bot/src/shared/database/board-group-constraints.service.ts` (create) + - `class BoardGroupConstraintsMigrationService implements OnApplicationBootstrap` — по образцу `schedule-migration.service.ts:1-10`, инжектит `DataSource`. + - `onApplicationBootstrap()` → `CREATE TRIGGER IF NOT EXISTS` ×5, идемпотентно, на каждом старте. + - Триггеры: `trg_board_group_parent_must_be_epic` (BEFORE INSERT / BEFORE UPDATE), `trg_board_group_no_reparent_with_children` (BEFORE UPDATE), `trg_task_group_same_project` (BEFORE INSERT / BEFORE UPDATE на `tasks`). + - Invariants: глубина ровно 2; группе с детьми нельзя проставить `parentId`; `group.projectId` = `task.projectId`. +- **2.2** `alfy-bot/src/app.module.ts:36-39,90-96` (modify) — импорт и провайдер. +- Ключевой фрагмент — правило, которое CHECK-ом невыразимо: + ```sql + CREATE TRIGGER IF NOT EXISTS trg_board_group_parent_must_be_epic + BEFORE INSERT ON board_groups + WHEN NEW.parentId IS NOT NULL + BEGIN + SELECT RAISE(ABORT, 'board_group: parent must be an epic') + WHERE (SELECT parentId FROM board_groups WHERE id = NEW.parentId) IS NOT NULL; + END; + ``` +- Commit: `feat(project): enforce BoardGroup depth with SQLite triggers` + +### Phase 3 — CRUD групп + +- **3.1** `alfy-bot/src/modules/project/dto/create-group.dto.ts`, `update-group.dto.ts` (create) — `title`, `parentId?`, `description?`, `color?`; update дополнительно `status?: 'open' | 'done'`. +- **3.2** `alfy-bot/src/modules/project/board-group.service.ts` (create) + - `validateProjectAccess` — копия `project-column.service.ts:20-27`. + - `getTree(userId, projectId): Promise` — плоский список из репозитория в дерево эпиков с `children`. + - `create(userId, projectId, dto)` — если `parentId` задан, родитель обязан существовать, лежать в этом же проекте и иметь `parentId === null`; иначе `BadRequestException`. `type` выводится из `parentId`, клиент его не присылает. + - `update(userId, projectId, id, dto)` — при смене `parentId` проверяет `countChildren(id) === 0`; при `status: 'done'` ставит `completedAt = new Date()`, при `'open'` — `null`. + - `delete`, `reorder` — как у колонок. + - Invariants: `status` меняется только явным действием и не выводится из детей. +- **3.3** `alfy-bot/src/modules/project/board-group.controller.ts` (create) — `@Controller('projects/:projectId/groups')`, порядок роутов как в `project-column.controller.ts:31-79`: `@Patch('reorder')` **до** `@Patch(':id')`. +- **3.4** `alfy-bot/src/modules/project/project.module.ts:19,23-37` (modify) — `BoardGroup` в `forFeature`, контроллер, биндинг порта, сервис. +- Commit: `feat(project): CRUD for epics and stories` + +### Phase 4 — viewMode 'agile', засев колонок, groupId в move + +- **4.1** `alfy-bot/src/shared/entities/project.entity.ts:32` (modify) — `viewMode: 'list' | 'board' | 'agile'`. +- **4.2** `alfy-bot/src/modules/project/dto/create-project.dto.ts:19-22`, `update-project.dto.ts:19-22` (modify) — `@IsIn(['list','board','agile'])` + тип. +- **4.3** `alfy-bot/src/modules/project/project.service.ts:14,37-46,48-71` (modify) + - Конструктор получает `ProjectColumnRepositoryPort`. + - `create` — после создания проекта с `viewMode === 'agile'` засевает `К выполнению / В работе / Готово` с `order` 0/1/2. + - `update` — при переходе на `'agile'` засевает те же три, только если у проекта колонок ещё нет. + - `private async seedAgileColumns(projectId: string): Promise` +- **4.4** `alfy-bot/src/modules/project/dto/move-task.dto.ts:10-19` (modify) — `groupId?: string | null`. +- **4.5** `alfy-bot/src/modules/project/project-task.service.ts:18,47-99` (modify) + - Инжектит `BoardGroupRepositoryPort`; `targetGroupId` разбирается как `targetColumnId` на строке 49. + - Если `targetGroupId` задан — группа обязана существовать в `targetProjectId`, иначе `NotFoundException`. + - Строки 69 и 76 (`viewMode === 'list'`) **не трогаем**: `agile` проходит их так же, как `board`. +- **4.6** `alfy-bot/src/modules/task/task.service.ts` (modify) — в `update`: если `projectId` меняется, `groupId` обнуляется в той же записи. + - Иначе триггер `trg_task_group_same_project` отклонит апдейт и клиент получит 500 вместо переноса. Путь реальный: задачу можно перенести в другой проект через `PATCH /tasks/:id`, минуя `moveTask`. + - Invariant: перенос задачи в другой проект обнуляет `groupId`. +- **4.7** `alfy-bot/src/modules/task/domain/task-repository.port.ts:35-41` + `infrastructure/typeorm-task.repository.ts:118-131` (modify) — `updatePosition` получает `groupId: string | null` после `columnId`. + - Единственный продовый вызов — `project-task.service.ts:93`. Ломаются пять ассертов в `project-task.service.spec.ts:143,161,181,203,221` и мок в `overdue-recurring.service.spec.ts:62` — обновить. +- Commit: `feat(project): agile view mode, default columns, group in task move` + +### Phase 5 — фронт: данные и рендер + +- **5.1** `alfy-bot-frontend/src/features/projects/model/types.ts:1,3-11` (modify) — `ViewMode` + `'agile'`; интерфейсы `BoardGroup`, `BoardGroupNode`, payload-типы. +- **5.2** `alfy-bot-frontend/src/features/projects/api/groups-api.ts` (create) — зеркало `columns-api.ts:14-27` на `/projects/:id/groups`. +- **5.3** `alfy-bot-frontend/src/features/projects/model/group-store.ts` (create) — по образцу `column-store.ts`: `groups`, `loading`, `fetchGroups`, `createGroup`, `updateGroup`, `deleteGroup`, `reorderGroups`, `toggleEpicDone`. +- **5.4** `alfy-bot-frontend/src/features/projects/lib/agile-layout.ts` (create) — чистая функция раскладки, тестируется без DOM. + - `buildAgileRows(groups: BoardGroupNode[], tasks: Task[]): AgileRow[]` — эпики по порядку, внутри истории, затем «задачи эпика без истории», в конце всегда «Без эпика». + - Invariants: задача без `groupId` — норма; проект без эпиков рендерится. +- **5.5** `AgileBoardView.vue`, `AgileEpicBlock.vue`, `AgileStoryBlock.vue`, `AgileCell.vue` (create, `features/projects/ui/`) + - `AgileBoardView` владеет колоночной сеткой и **единственным** `overflow-x-auto`; вложенные блоки — `grid-template-columns: subgrid`. Заголовки колонок — `sticky top-0`, рендерятся один раз. + - Invariants: заголовки один раз на доску; скролл-контейнер ровно один. +- **5.6** `ViewModeToggle.vue:14-25` (modify) — третья кнопка `agile`, иконка `Rows3`. +- **5.7** `alfy-bot-frontend/src/views/ProjectView.vue:31,98,189` (modify) — `isAgileMode`, ветка рендера, `handleViewModeChange` расширяет каст типа. +- Commit: `feat(projects): agile board view with nested epics and stories` + +### Phase 6 — DnD, скрытие целей, компонентные тесты + +- **6.1** `alfy-bot-frontend/src/features/projects/lib/use-agile-dnd.ts` (create) — по образцу `use-board-dnd.ts:13-25`, но передаёт `groupId` ячейки в `moveTask`. +- **6.2** `alfy-bot-frontend/src/features/tasks/model/task-store.ts:289` (modify) — `moveTask` payload получает `groupId?: string | null`. +- **6.3** Все `AgileCell` получают общий `:group="{ name: 'agile-tasks' }"` — иначе перетаскивание между эпиками не работает. +- **6.4** `alfy-bot-frontend/src/features/tasks/ui/TaskDetailDialog.vue:166,260,489-490,624` (modify) — блок целей и его drawer скрываются, когда проект задачи в режиме `agile`. Ничего не удаляется и не отправляется на бэк. + - Invariant: `viewMode` управляет только отображением; действие обратимо. +- Commit: `feat(projects): agile drag-and-drop, hide goals in agile projects` + +### Test strategy + +TDD (тесты первыми) — фазы 1-4: + +- `board-group-constraints.service.spec.ts` — на реальном SQLite in-memory `DataSource`, запись **напрямую через репозиторий, мимо сервиса**: + - вставка группы с `parentId`, указывающим на историю → отклонена; + - проставление `parentId` группе, у которой есть дети → отклонено; + - `parentId = id` → отклонено; + - `type = 'epic'` при непустом `parentId` → отклонено; + - `task.groupId` из чужого проекта → отклонено; + - **пересоздание таблицы** (`ALTER TABLE ... RENAME` + `CREATE` + повторный вызов `onApplicationBootstrap`) → защита снова работает. Это тест на ту самую ловушку `synchronize`. +- `board-group.service.spec.ts` — попытка вложить в историю отдаёт 400, а не 500; удаление эпика каскадит на истории и обнуляет `groupId` у задач; `status: 'done'` проставляет `completedAt`, `'open'` — обнуляет. +- `project.service.spec.ts` — создание `agile`-проекта засевает три колонки с ожидаемыми именами; `list` и `board` не засевают ничего; переключение на `agile` при уже существующих колонках не засевает. +- `project-column.service.spec.ts` — `viewMode: 'agile'` проходит гвард строки 44 (колонку создать можно). +- `project-task.service.spec.ts` — `move` с `groupId` чужого проекта → 404; с валидным → `updatePosition` получает `groupId`. +- `task.service.spec.ts` — смена `projectId` через `PATCH /tasks/:id` обнуляет `groupId` (иначе триггер отдаёт 500). + +После реализации — фронт: + +- `agile-layout.spec.ts` — порядок строк; задачи без `groupId` попадают в «Без эпика»; проект без групп рендерится одной строкой. +- `AgileBoardView.spec.ts` — заголовки колонок отрисованы ровно один раз; горизонтальный скролл-контейнер ровно один (защита инварианта из Design); задача рендерится в ячейке на пересечении своей колонки и своей группы. +- `TaskDetailDialog.spec.ts` — блок целей отсутствует при `viewMode: 'agile'` и присутствует при `board`. + +### Order & dependencies + +1 → 2 → 3 → 4 последовательны. 5 зависит от 3 и 4 (нужны API и `groupId` в задаче). 6 зависит от 5. + +### Open questions / risks / rollback + +- **`subgrid`.** Поддержка Chrome 117+, Safari 16+, Firefox 71+ — для PWA приемлемо. Риск невелик: ширины колонок фиксированы в px, поэтому при отсутствии `subgrid` вложенные блоки могут повторить `repeat(N, var(--col-w))` и выровняются так же. Фолбэк не пишем заранее, но он однострочный. +- **Совместимость.** `Task.groupId` — новая nullable-колонка, `synchronize` добавит её, существующие строки получат `null`. CHECK-констрейнты ставятся только на новую таблицу, где нарушать нечего. Расширение `viewMode` обратно совместимо: существующие проекты остаются `list`/`board`. Смена сигнатуры `updatePosition` — внутренняя, единственный продовый вызов правится в той же фазе. +- **Триггеры против `synchronize`.** Главный риск задачи: при любом будущем изменении схемы `board_groups` или `tasks` SQLite пересоздаст таблицу и уронит триггеры. Митигация — фаза 2 (пересоздание на каждом старте) плюс тест на пересоздание таблицы. Без этого теста защита деградирует молча. +- **Rollback.** Фича аддитивная: пока пользователь не переключил проект в `agile`, ничего из этого не исполняется. Откат — убрать третью кнопку из `ViewModeToggle`. + +## Verify + + +## Conclusion + From 14ce249fc9dddb2399218ef149364bf6dac1dcaa Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 10:51:28 +0500 Subject: [PATCH 02/99] feat(project): add BoardGroup entity and repository --- alfy-bot/src/app.module.ts | 2 + .../domain/board-group-repository.port.ts | 11 +++ .../typeorm-board-group.repository.ts | 52 +++++++++++++ .../typeorm-report-answer.repository.spec.ts | 2 + .../src/shared/entities/board-group.entity.ts | 73 +++++++++++++++++++ alfy-bot/src/shared/entities/index.ts | 1 + alfy-bot/src/shared/entities/task.entity.ts | 11 +++ alfy-bot/test/helpers/test-app.ts | 2 + 8 files changed, 154 insertions(+) create mode 100644 alfy-bot/src/modules/project/domain/board-group-repository.port.ts create mode 100644 alfy-bot/src/modules/project/infrastructure/typeorm-board-group.repository.ts create mode 100644 alfy-bot/src/shared/entities/board-group.entity.ts diff --git a/alfy-bot/src/app.module.ts b/alfy-bot/src/app.module.ts index 43b8647..e112b20 100644 --- a/alfy-bot/src/app.module.ts +++ b/alfy-bot/src/app.module.ts @@ -30,6 +30,7 @@ import { PushSubscription, Project, ProjectColumn, + BoardGroup, ApiToken, Link, } from './shared/entities'; @@ -69,6 +70,7 @@ const telegramImports = isTelegramEnabled() PushSubscription, Project, ProjectColumn, + BoardGroup, ApiToken, Link, ], diff --git a/alfy-bot/src/modules/project/domain/board-group-repository.port.ts b/alfy-bot/src/modules/project/domain/board-group-repository.port.ts new file mode 100644 index 0000000..c74dd2c --- /dev/null +++ b/alfy-bot/src/modules/project/domain/board-group-repository.port.ts @@ -0,0 +1,11 @@ +import { BoardGroup } from '../../../shared/entities'; + +export abstract class BoardGroupRepositoryPort { + abstract findAllByProject(projectId: string): Promise; + abstract findById(id: string, projectId: string): Promise; + abstract countChildren(id: string): Promise; + abstract create(data: Partial): Promise; + abstract save(group: BoardGroup): Promise; + abstract delete(id: string, projectId: string): Promise; + abstract reorder(updates: { id: string; order: number }[]): Promise; +} diff --git a/alfy-bot/src/modules/project/infrastructure/typeorm-board-group.repository.ts b/alfy-bot/src/modules/project/infrastructure/typeorm-board-group.repository.ts new file mode 100644 index 0000000..9569fc6 --- /dev/null +++ b/alfy-bot/src/modules/project/infrastructure/typeorm-board-group.repository.ts @@ -0,0 +1,52 @@ +import { Injectable } from '@nestjs/common'; +import { InjectRepository } from '@nestjs/typeorm'; +import { Repository } from 'typeorm'; +import { BoardGroup } from '../../../shared/entities'; +import { BoardGroupRepositoryPort } from '../domain/board-group-repository.port'; + +@Injectable() +export class TypeOrmBoardGroupRepository extends BoardGroupRepositoryPort { + constructor( + @InjectRepository(BoardGroup) + private repo: Repository, + ) { + super(); + } + + async findAllByProject(projectId: string): Promise { + return this.repo.find({ + where: { projectId }, + order: { order: 'ASC' }, + }); + } + + async findById(id: string, projectId: string): Promise { + return this.repo.findOne({ where: { id, projectId } }); + } + + async countChildren(id: string): Promise { + return this.repo.count({ where: { parentId: id } }); + } + + async create(data: Partial): Promise { + const entity = this.repo.create(data); + return this.repo.save(entity); + } + + async save(group: BoardGroup): Promise { + return this.repo.save(group); + } + + async delete(id: string, projectId: string): Promise { + const group = await this.findById(id, projectId); + if (!group) return false; + await this.repo.remove(group); + return true; + } + + async reorder(updates: { id: string; order: number }[]): Promise { + await Promise.all( + updates.map(({ id, order }) => this.repo.update(id, { order })), + ); + } +} diff --git a/alfy-bot/src/modules/report/infrastructure/typeorm-report-answer.repository.spec.ts b/alfy-bot/src/modules/report/infrastructure/typeorm-report-answer.repository.spec.ts index da91ad3..ce073aa 100644 --- a/alfy-bot/src/modules/report/infrastructure/typeorm-report-answer.repository.spec.ts +++ b/alfy-bot/src/modules/report/infrastructure/typeorm-report-answer.repository.spec.ts @@ -2,6 +2,7 @@ import { DataSource, Repository } from 'typeorm'; import { ApiToken, AuthMethod, + BoardGroup, Goal, Project, ProjectColumn, @@ -19,6 +20,7 @@ import { TypeOrmReportAnswerRepository } from './typeorm-report-answer.repositor const ALL_ENTITIES = [ ApiToken, AuthMethod, + BoardGroup, Goal, Project, ProjectColumn, diff --git a/alfy-bot/src/shared/entities/board-group.entity.ts b/alfy-bot/src/shared/entities/board-group.entity.ts new file mode 100644 index 0000000..a2a119c --- /dev/null +++ b/alfy-bot/src/shared/entities/board-group.entity.ts @@ -0,0 +1,73 @@ +import { + Check, + Column, + CreateDateColumn, + Entity, + JoinColumn, + ManyToOne, + PrimaryGeneratedColumn, + UpdateDateColumn, +} from 'typeorm'; +import { Project } from './project.entity'; + +@Entity('board_groups') +@Check('CHK_board_group_type', "type IN ('epic','story')") +@Check('CHK_board_group_status', "status IN ('open','done')") +@Check('CHK_board_group_not_self', 'parentId <> id') +@Check( + 'CHK_board_group_depth', + "(parentId IS NULL AND type = 'epic') OR (parentId IS NOT NULL AND type = 'story')", +) +export class BoardGroup { + @PrimaryGeneratedColumn('uuid') + id: string; + + @Column() + userId: number; + + @Column() + projectId: string; + + @Column({ type: 'text', nullable: true }) + parentId: string | null; + + @Column({ type: 'text' }) + type: 'epic' | 'story'; + + @Column() + title: string; + + @Column({ type: 'text', nullable: true }) + description: string | null; + + @Column({ type: 'text', default: 'open' }) + status: 'open' | 'done'; + + @Column({ type: 'datetime', nullable: true }) + completedAt: Date | null; + + @Column({ type: 'text', nullable: true }) + color: string | null; + + @Column({ type: 'integer', default: 0 }) + order: number; + + @CreateDateColumn() + createdAt: Date; + + @UpdateDateColumn() + updatedAt: Date; + + @ManyToOne(() => Project, { + onDelete: 'CASCADE', + }) + @JoinColumn({ name: 'projectId' }) + project: Project; + + @ManyToOne(() => BoardGroup, { + nullable: true, + onDelete: 'CASCADE', + }) + @JoinColumn({ name: 'parentId' }) + parent: BoardGroup | null; +} diff --git a/alfy-bot/src/shared/entities/index.ts b/alfy-bot/src/shared/entities/index.ts index 53909f0..7b8ae69 100644 --- a/alfy-bot/src/shared/entities/index.ts +++ b/alfy-bot/src/shared/entities/index.ts @@ -11,5 +11,6 @@ export { TimerSession } from './timer-session.entity'; export { PushSubscription } from './push-subscription.entity'; export { Project } from './project.entity'; export { ProjectColumn } from './project-column.entity'; +export { BoardGroup } from './board-group.entity'; export { ApiToken } from './api-token.entity'; export { Link } from './link.entity'; diff --git a/alfy-bot/src/shared/entities/task.entity.ts b/alfy-bot/src/shared/entities/task.entity.ts index a88ae5f..9302261 100644 --- a/alfy-bot/src/shared/entities/task.entity.ts +++ b/alfy-bot/src/shared/entities/task.entity.ts @@ -12,6 +12,7 @@ import { User } from './user.entity'; import { PomodoroConfig } from './pomodoro-config.entity'; import { Project } from './project.entity'; import { ProjectColumn } from './project-column.entity'; +import { BoardGroup } from './board-group.entity'; import type { ChecklistData } from '../types/checklist.types'; import type { RecurrenceRule } from '../types/recurrence.types'; @@ -59,6 +60,9 @@ export class Task { @Column({ type: 'text', nullable: true }) columnId: string | null; + @Column({ type: 'text', nullable: true }) + groupId: string | null; + @Column({ type: 'integer', default: 0 }) order: number; @@ -107,6 +111,13 @@ export class Task { @JoinColumn({ name: 'columnId' }) column: ProjectColumn | null; + @ManyToOne(() => BoardGroup, { + nullable: true, + onDelete: 'SET NULL', + }) + @JoinColumn({ name: 'groupId' }) + group: BoardGroup | null; + @ManyToOne(() => Task, { nullable: true }) @JoinColumn({ name: 'recurringParentId' }) recurringParent: Task | null; diff --git a/alfy-bot/test/helpers/test-app.ts b/alfy-bot/test/helpers/test-app.ts index 3b9d239..ad7e658 100644 --- a/alfy-bot/test/helpers/test-app.ts +++ b/alfy-bot/test/helpers/test-app.ts @@ -15,6 +15,7 @@ import { ReportAnswer, Project, ProjectColumn, + BoardGroup, } from '../../src/shared/entities'; export interface TestContext { @@ -42,6 +43,7 @@ export async function createTestApp(): Promise { ReportAnswer, Project, ProjectColumn, + BoardGroup, ], synchronize: true, }); From 67f0e2a8f7b6424cac383417927e06798ae16c1b Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 12:08:52 +0500 Subject: [PATCH 03/99] fix(test): repair pre-existing e2e breakage Three independent causes, all predating this branch (verified by running the suite at a93d0e5, where all 3 suites / 32 tests failed): - EmailService reads SMTP_HOST/SMTP_USER/SMTP_PASS via getOrThrow in its constructor, so the missing keys killed the Nest app at boot. - web-goal-reports-routing builds its own TestingModule and never provided TaskGoalQueryPort, which GoalController started requiring. - test-app.ts hand-maintains an entity list that had drifted from app.module.ts, missing AuthMethod, PushSubscription, ApiToken and Link. The entity-list drift is the same failure mode that BoardGroup hit in the previous commit. Worth replacing the hand-maintained list with a shared ALL_ENTITIES export, but that touches app.module.ts and is left out here. --- alfy-bot/test/helpers/test-app.ts | 8 ++++++++ alfy-bot/test/setup-e2e-env.ts | 8 ++++++++ alfy-bot/test/web-goal-reports-routing.e2e-spec.ts | 8 ++++++++ 3 files changed, 24 insertions(+) diff --git a/alfy-bot/test/helpers/test-app.ts b/alfy-bot/test/helpers/test-app.ts index ad7e658..826f81e 100644 --- a/alfy-bot/test/helpers/test-app.ts +++ b/alfy-bot/test/helpers/test-app.ts @@ -16,6 +16,10 @@ import { Project, ProjectColumn, BoardGroup, + AuthMethod, + PushSubscription, + ApiToken, + Link, } from '../../src/shared/entities'; export interface TestContext { @@ -44,6 +48,10 @@ export async function createTestApp(): Promise { Project, ProjectColumn, BoardGroup, + AuthMethod, + PushSubscription, + ApiToken, + Link, ], synchronize: true, }); diff --git a/alfy-bot/test/setup-e2e-env.ts b/alfy-bot/test/setup-e2e-env.ts index c7854bf..cfa7461 100644 --- a/alfy-bot/test/setup-e2e-env.ts +++ b/alfy-bot/test/setup-e2e-env.ts @@ -5,3 +5,11 @@ process.env.ENABLE_TELEGRAM = 'false'; process.env.BOT_TOKEN = 'test-bot-token'; process.env.JWT_SECRET = 'test-secret'; + +// EmailService reads SMTP_HOST/SMTP_USER/SMTP_PASS with getOrThrow in its +// constructor, so a missing key kills the whole Nest app at boot — every e2e +// suite fails with an unrelated "Configuration key does not exist". Same +// import-time reasoning as the Telegram vars above: this has to live here. +process.env.SMTP_HOST = 'smtp.test.local'; +process.env.SMTP_USER = 'e2e@test.local'; +process.env.SMTP_PASS = 'test-password'; diff --git a/alfy-bot/test/web-goal-reports-routing.e2e-spec.ts b/alfy-bot/test/web-goal-reports-routing.e2e-spec.ts index 2a5f441..cc64932 100644 --- a/alfy-bot/test/web-goal-reports-routing.e2e-spec.ts +++ b/alfy-bot/test/web-goal-reports-routing.e2e-spec.ts @@ -6,6 +6,7 @@ import { GoalService } from '../src/modules/goal/application/goal.service'; import { GoalReportController } from '../src/modules/report/goal-report.controller'; import { ReportService } from '../src/modules/report/application/report.service'; import { JwtOrApiTokenGuard } from '../src/modules/auth/guards/jwt-or-api-token.guard'; +import { TaskGoalQueryPort } from '../src/modules/task/domain/task-goal-query.port'; // Routing regression: GoalController and GoalReportController share the `goals` // prefix. GoalController is registered FIRST here (mirrors AppModule, which imports @@ -27,6 +28,12 @@ describe('Web goal reports routing (e2e)', () => { getGoalReportStatus: jest.fn(), getReportQueue: jest.fn(), }; + // GoalController gained a TaskGoalQueryPort dependency; this suite builds its + // own TestingModule, so the port has to be provided here or nothing compiles. + const taskGoals = { + listByGoal: jest.fn(), + replaceTaskLinksForGoal: jest.fn(), + }; beforeAll(async () => { const moduleRef = await Test.createTestingModule({ @@ -34,6 +41,7 @@ describe('Web goal reports routing (e2e)', () => { providers: [ { provide: GoalService, useValue: goalService }, { provide: ReportService, useValue: reportService }, + { provide: TaskGoalQueryPort, useValue: taskGoals }, ], }) .overrideGuard(JwtOrApiTokenGuard) From 00bcedde857ede3081988fd20d0da5cc388c0f34 Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 12:20:05 +0500 Subject: [PATCH 04/99] feat(project): enforce BoardGroup depth with SQLite triggers CHECK constraints on BoardGroup can express self-references and the epic/story-vs-parentId shape, but not rules that need to look at other rows: a story's parent must itself be an epic (depth stays exactly 2), a group with children can't be reparented, and a task's groupId must belong to a group in the same project. BoardGroupConstraintsMigrationService creates the five SQLite triggers for these idempotently on every onApplicationBootstrap, since synchronize's rename/create/copy/drop dance silently drops triggers whenever board_groups' schema changes. --- alfy-bot/src/app.module.ts | 2 + .../board-group-constraints.service.spec.ts | 200 ++++++++++++++++++ .../board-group-constraints.service.ts | 82 +++++++ 3 files changed, 284 insertions(+) create mode 100644 alfy-bot/src/shared/database/board-group-constraints.service.spec.ts create mode 100644 alfy-bot/src/shared/database/board-group-constraints.service.ts diff --git a/alfy-bot/src/app.module.ts b/alfy-bot/src/app.module.ts index e112b20..cb8252b 100644 --- a/alfy-bot/src/app.module.ts +++ b/alfy-bot/src/app.module.ts @@ -35,6 +35,7 @@ import { Link, } from './shared/entities'; import { ScheduleMigrationService } from './shared/database/schedule-migration.service'; +import { BoardGroupConstraintsMigrationService } from './shared/database/board-group-constraints.service'; import { QuestionMigrationService } from './shared/database/question-migration.service'; import { AuthMethodMigrationService } from './shared/database/auth-method-migration.service'; import { RecurringSeriesRepairService } from './shared/database/recurring-series-repair.service'; @@ -95,6 +96,7 @@ const telegramImports = isTelegramEnabled() QuestionMigrationService, AuthMethodMigrationService, RecurringSeriesRepairService, + BoardGroupConstraintsMigrationService, ], }) export class AppModule {} diff --git a/alfy-bot/src/shared/database/board-group-constraints.service.spec.ts b/alfy-bot/src/shared/database/board-group-constraints.service.spec.ts new file mode 100644 index 0000000..700d67d --- /dev/null +++ b/alfy-bot/src/shared/database/board-group-constraints.service.spec.ts @@ -0,0 +1,200 @@ +import { DataSource, Repository } from 'typeorm'; +import { + BoardGroup, + PomodoroConfig, + Project, + ProjectColumn, + Task, + User, +} from '../entities'; +import { BoardGroupConstraintsMigrationService } from './board-group-constraints.service'; + +describe('BoardGroupConstraintsMigrationService (in-memory sqlite)', () => { + let dataSource: DataSource; + let groupRepo: Repository; + let taskRepo: Repository; + let service: BoardGroupConstraintsMigrationService; + + const USER_ID = 1; + const PROJECT_A = 'project-a'; + const PROJECT_B = 'project-b'; + + beforeEach(async () => { + dataSource = new DataSource({ + type: 'sqlite', + database: ':memory:', + entities: [ + User, + Project, + ProjectColumn, + Task, + PomodoroConfig, + BoardGroup, + ], + synchronize: true, + }); + await dataSource.initialize(); + + await dataSource.getRepository(User).save({ id: USER_ID }); + await dataSource.getRepository(Project).save([ + { id: PROJECT_A, userId: USER_ID, title: 'Project A' }, + { id: PROJECT_B, userId: USER_ID, title: 'Project B' }, + ]); + + groupRepo = dataSource.getRepository(BoardGroup); + taskRepo = dataSource.getRepository(Task); + + service = new BoardGroupConstraintsMigrationService(dataSource); + await service.onApplicationBootstrap(); + }); + + afterEach(async () => { + await dataSource.destroy(); + }); + + async function makeEpic(id: string, projectId = PROJECT_A) { + return groupRepo.save({ + id, + userId: USER_ID, + projectId, + parentId: null, + type: 'epic', + title: `Epic ${id}`, + }); + } + + async function makeStory( + id: string, + parentId: string, + projectId = PROJECT_A, + ) { + return groupRepo.save({ + id, + userId: USER_ID, + projectId, + parentId, + type: 'story', + title: `Story ${id}`, + }); + } + + it('1. rejects a group whose parentId points to a non-epic (history) group', async () => { + await makeEpic('epic-1'); + await makeStory('story-1', 'epic-1'); + + await expect( + groupRepo.save({ + id: 'story-2', + userId: USER_ID, + projectId: PROJECT_A, + parentId: 'story-1', + type: 'story', + title: 'Story 2 (invalid parent)', + }), + ).rejects.toThrow(); + }); + + it('2. rejects setting parentId on a group that already has children', async () => { + await makeEpic('epic-1'); + await makeStory('story-1', 'epic-1'); + await makeEpic('epic-2'); + + const epic1 = await groupRepo.findOneByOrFail({ id: 'epic-1' }); + epic1.parentId = 'epic-2'; + epic1.type = 'story'; + + await expect(groupRepo.save(epic1)).rejects.toThrow(); + }); + + it('3. rejects parentId = id (self reference)', async () => { + await expect( + groupRepo.save({ + id: 'epic-self', + userId: USER_ID, + projectId: PROJECT_A, + parentId: 'epic-self', + type: 'story', + title: 'Self referencing', + }), + ).rejects.toThrow(); + }); + + it('4. rejects type=epic with a non-null parentId', async () => { + await makeEpic('epic-1'); + + await expect( + groupRepo.save({ + id: 'bad-epic', + userId: USER_ID, + projectId: PROJECT_A, + parentId: 'epic-1', + type: 'epic', + title: 'Epic with parent', + }), + ).rejects.toThrow(); + }); + + it('5. rejects a task whose groupId points to a group from another project', async () => { + await makeEpic('epic-1', PROJECT_A); + await makeStory('story-1', 'epic-1', PROJECT_A); + + await expect( + taskRepo.save({ + id: 'task-1', + userId: USER_ID, + title: 'Cross-project task', + projectId: PROJECT_B, + groupId: 'story-1', + }), + ).rejects.toThrow(); + }); + + it('6. re-protects after the table is recreated (as synchronize does on schema change)', async () => { + const rows: { sql: string }[] = await dataSource.query( + 'SELECT sql FROM sqlite_master WHERE type = ? AND name = ?', + ['table', 'board_groups'], + ); + const originalSql = rows[0].sql; + + await makeEpic('epic-1'); + await makeStory('story-1', 'epic-1'); + + // Simulate what TypeORM's `synchronize` does when the board_groups schema + // changes: rename away, recreate with the original DDL, copy rows, drop + // the renamed table. This is exactly the sequence that silently drops + // every trigger attached to the table. + await dataSource.query( + 'ALTER TABLE board_groups RENAME TO board_groups_old', + ); + await dataSource.query(originalSql); + await dataSource.query( + 'INSERT INTO board_groups SELECT * FROM board_groups_old', + ); + await dataSource.query('DROP TABLE board_groups_old'); + + // Without re-running the migration service, the trigger protection is gone. + await expect( + groupRepo.save({ + id: 'story-2', + userId: USER_ID, + projectId: PROJECT_A, + parentId: 'story-1', + type: 'story', + title: 'Story 2 (invalid parent, post schema-change)', + }), + ).resolves.toBeDefined(); + + await service.onApplicationBootstrap(); + + await expect( + groupRepo.save({ + id: 'story-3', + userId: USER_ID, + projectId: PROJECT_A, + parentId: 'story-1', + type: 'story', + title: 'Story 3 (invalid parent, post re-migration)', + }), + ).rejects.toThrow(); + }); +}); diff --git a/alfy-bot/src/shared/database/board-group-constraints.service.ts b/alfy-bot/src/shared/database/board-group-constraints.service.ts new file mode 100644 index 0000000..4d2eb56 --- /dev/null +++ b/alfy-bot/src/shared/database/board-group-constraints.service.ts @@ -0,0 +1,82 @@ +import { Injectable, Logger, OnApplicationBootstrap } from '@nestjs/common'; +import { DataSource } from 'typeorm'; + +/** + * SQLite triggers enforcing BoardGroup invariants that CHECK constraints + * cannot express (they need to look at other rows): + * + * - a group's parent must itself be a top-level group (an epic) — depth is + * exactly 2, an epic can never be attached under a story; + * - a group that already has children cannot be reparented (turned into a + * story); + * - a task's groupId must reference a group belonging to the same project + * as the task. + * + * `synchronize: true` recreates the board_groups/tasks tables (rename → + * create → copy → drop) whenever their schema changes, which silently drops + * every trigger attached to them. This service re-creates the triggers + * idempotently on every application bootstrap so the protection survives + * schema changes. + */ +@Injectable() +export class BoardGroupConstraintsMigrationService implements OnApplicationBootstrap { + private readonly logger = new Logger( + BoardGroupConstraintsMigrationService.name, + ); + + constructor(private readonly dataSource: DataSource) {} + + async onApplicationBootstrap() { + await this.dataSource.query(` + CREATE TRIGGER IF NOT EXISTS trg_board_group_parent_must_be_epic_insert + BEFORE INSERT ON board_groups + WHEN NEW.parentId IS NOT NULL + BEGIN + SELECT RAISE(ABORT, 'board_group: parent must be an epic') + WHERE (SELECT parentId FROM board_groups WHERE id = NEW.parentId) IS NOT NULL; + END; + `); + + await this.dataSource.query(` + CREATE TRIGGER IF NOT EXISTS trg_board_group_parent_must_be_epic_update + BEFORE UPDATE ON board_groups + WHEN NEW.parentId IS NOT NULL + BEGIN + SELECT RAISE(ABORT, 'board_group: parent must be an epic') + WHERE (SELECT parentId FROM board_groups WHERE id = NEW.parentId) IS NOT NULL; + END; + `); + + await this.dataSource.query(` + CREATE TRIGGER IF NOT EXISTS trg_board_group_no_reparent_with_children + BEFORE UPDATE ON board_groups + WHEN NEW.parentId IS NOT NULL + BEGIN + SELECT RAISE(ABORT, 'board_group: cannot reparent a group that has children') + WHERE EXISTS (SELECT 1 FROM board_groups WHERE parentId = OLD.id); + END; + `); + + await this.dataSource.query(` + CREATE TRIGGER IF NOT EXISTS trg_task_group_same_project_insert + BEFORE INSERT ON tasks + WHEN NEW.groupId IS NOT NULL + BEGIN + SELECT RAISE(ABORT, 'task: group must belong to the same project as the task') + WHERE (SELECT projectId FROM board_groups WHERE id = NEW.groupId) IS NOT NEW.projectId; + END; + `); + + await this.dataSource.query(` + CREATE TRIGGER IF NOT EXISTS trg_task_group_same_project_update + BEFORE UPDATE ON tasks + WHEN NEW.groupId IS NOT NULL + BEGIN + SELECT RAISE(ABORT, 'task: group must belong to the same project as the task') + WHERE (SELECT projectId FROM board_groups WHERE id = NEW.groupId) IS NOT NEW.projectId; + END; + `); + + this.logger.log('board_groups/tasks constraint triggers ensured'); + } +} From cb364c7ada4f6840d3b9b19bd1008042145ab532 Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 12:38:56 +0500 Subject: [PATCH 05/99] feat(project): CRUD for epics and stories --- .../modules/project/board-group.controller.ts | 80 ++++ .../project/board-group.service.spec.ts | 364 ++++++++++++++++++ .../modules/project/board-group.service.ts | 159 ++++++++ .../modules/project/dto/create-group.dto.ts | 23 ++ .../modules/project/dto/update-group.dto.ts | 10 + .../src/modules/project/project.module.ts | 14 +- 6 files changed, 648 insertions(+), 2 deletions(-) create mode 100644 alfy-bot/src/modules/project/board-group.controller.ts create mode 100644 alfy-bot/src/modules/project/board-group.service.spec.ts create mode 100644 alfy-bot/src/modules/project/board-group.service.ts create mode 100644 alfy-bot/src/modules/project/dto/create-group.dto.ts create mode 100644 alfy-bot/src/modules/project/dto/update-group.dto.ts diff --git a/alfy-bot/src/modules/project/board-group.controller.ts b/alfy-bot/src/modules/project/board-group.controller.ts new file mode 100644 index 0000000..fddfc26 --- /dev/null +++ b/alfy-bot/src/modules/project/board-group.controller.ts @@ -0,0 +1,80 @@ +import { + Body, + Controller, + Delete, + Get, + Param, + Patch, + Post, + Request, + UseGuards, +} from '@nestjs/common'; +import { ApiBearerAuth, ApiOperation, ApiTags } from '@nestjs/swagger'; +import { JwtAuthGuard } from '../auth/guards/jwt-auth.guard'; +import { JwtPayload } from '../auth/strategies/jwt.strategy'; +import { BoardGroupService } from './board-group.service'; +import { CreateGroupDto } from './dto/create-group.dto'; +import { UpdateGroupDto } from './dto/update-group.dto'; +import { ReorderDto } from './dto/reorder.dto'; + +interface AuthRequest extends Request { + user: JwtPayload; +} + +@ApiTags('board-groups') +@ApiBearerAuth() +@UseGuards(JwtAuthGuard) +@Controller('projects/:projectId/groups') +export class BoardGroupController { + constructor(private readonly groupService: BoardGroupService) {} + + @Get() + @ApiOperation({ summary: 'Дерево эпиков/историй проекта' }) + async getTree( + @Request() req: AuthRequest, + @Param('projectId') projectId: string, + ) { + return this.groupService.getTree(req.user.sub, projectId); + } + + @Post() + @ApiOperation({ summary: 'Создать эпик или историю' }) + async create( + @Request() req: AuthRequest, + @Param('projectId') projectId: string, + @Body() dto: CreateGroupDto, + ) { + return this.groupService.create(req.user.sub, projectId, dto); + } + + @Patch('reorder') + @ApiOperation({ summary: 'Изменить порядок групп' }) + async reorder( + @Request() req: AuthRequest, + @Param('projectId') projectId: string, + @Body() dto: ReorderDto, + ) { + return this.groupService.reorder(req.user.sub, projectId, dto.orderedIds); + } + + @Patch(':id') + @ApiOperation({ summary: 'Обновить эпик или историю' }) + async update( + @Request() req: AuthRequest, + @Param('projectId') projectId: string, + @Param('id') id: string, + @Body() dto: UpdateGroupDto, + ) { + return this.groupService.update(req.user.sub, projectId, id, dto); + } + + @Delete(':id') + @ApiOperation({ summary: 'Удалить эпик или историю' }) + async delete( + @Request() req: AuthRequest, + @Param('projectId') projectId: string, + @Param('id') id: string, + ) { + return this.groupService.delete(req.user.sub, projectId, id); + } +} diff --git a/alfy-bot/src/modules/project/board-group.service.spec.ts b/alfy-bot/src/modules/project/board-group.service.spec.ts new file mode 100644 index 0000000..6f28820 --- /dev/null +++ b/alfy-bot/src/modules/project/board-group.service.spec.ts @@ -0,0 +1,364 @@ +import { Test, TestingModule } from '@nestjs/testing'; +import { + NotFoundException, + BadRequestException, + ForbiddenException, +} from '@nestjs/common'; +import { BoardGroupService } from './board-group.service'; +import { BoardGroupRepositoryPort } from './domain/board-group-repository.port'; +import { ProjectRepositoryPort } from './domain/project-repository.port'; +import { BoardGroup, Project } from '../../shared/entities'; + +function makeProject(overrides: Partial = {}): Project { + const p = new Project(); + Object.assign(p, { + id: 'proj-1', + userId: 1, + parentId: null, + title: 'Проект', + description: null, + viewMode: 'board' as const, + icon: null, + color: null, + order: 0, + createdAt: new Date(), + updatedAt: new Date(), + columns: [], + children: [], + ...overrides, + }); + return p; +} + +function makeGroup(overrides: Partial = {}): BoardGroup { + const g = new BoardGroup(); + Object.assign(g, { + id: 'group-1', + userId: 1, + projectId: 'proj-1', + parentId: null, + type: 'epic' as const, + title: 'Эпик', + description: null, + status: 'open' as const, + completedAt: null, + color: null, + order: 0, + createdAt: new Date(), + updatedAt: new Date(), + ...overrides, + }); + return g; +} + +describe('BoardGroupService', () => { + let service: BoardGroupService; + let groupRepo: Record; + let projRepo: Record; + + beforeEach(async () => { + groupRepo = { + findAllByProject: jest.fn().mockResolvedValue([]), + findById: jest.fn().mockResolvedValue(null), + countChildren: jest.fn().mockResolvedValue(0), + create: jest + .fn() + .mockImplementation((data) => Promise.resolve(makeGroup(data))), + save: jest.fn().mockImplementation((group) => Promise.resolve(group)), + delete: jest.fn().mockResolvedValue(true), + reorder: jest.fn().mockResolvedValue(undefined), + }; + + projRepo = { + findAllByUser: jest.fn().mockResolvedValue([]), + findById: jest.fn().mockResolvedValue(null), + findByIdWithRelations: jest.fn().mockResolvedValue(null), + create: jest.fn(), + save: jest.fn(), + delete: jest.fn(), + reorder: jest.fn(), + }; + + const module: TestingModule = await Test.createTestingModule({ + providers: [ + BoardGroupService, + { provide: BoardGroupRepositoryPort, useValue: groupRepo }, + { provide: ProjectRepositoryPort, useValue: projRepo }, + ], + }).compile(); + + service = module.get(BoardGroupService); + }); + + // ── getTree ───────────────────────────────────────────────────── + + describe('getTree', () => { + it('собирает плоский список в дерево: эпики верхнего уровня с вложенными историями, в порядке order', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + const epicA = makeGroup({ id: 'epic-a', order: 0 }); + const epicB = makeGroup({ id: 'epic-b', order: 1 }); + const storyA1 = makeGroup({ + id: 'story-a1', + type: 'story', + parentId: 'epic-a', + order: 0, + }); + const storyA2 = makeGroup({ + id: 'story-a2', + type: 'story', + parentId: 'epic-a', + order: 1, + }); + groupRepo.findAllByProject.mockResolvedValue([ + epicA, + epicB, + storyA1, + storyA2, + ]); + + const tree = await service.getTree(1, 'proj-1'); + + expect(tree).toHaveLength(2); + expect(tree[0].id).toBe('epic-a'); + expect(tree[0].children).toHaveLength(2); + expect(tree[0].children[0].id).toBe('story-a1'); + expect(tree[0].children[1].id).toBe('story-a2'); + expect(tree[1].id).toBe('epic-b'); + expect(tree[1].children).toHaveLength(0); + }); + + it('бросает NotFoundException если проект не найден', async () => { + await expect(service.getTree(1, 'nope')).rejects.toThrow( + NotFoundException, + ); + }); + }); + + // ── create ────────────────────────────────────────────────────── + + describe('create', () => { + it('создаёт эпик без parentId', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + groupRepo.findAllByProject.mockResolvedValue([makeGroup({ order: 0 })]); + + await service.create(1, 'proj-1', { title: 'Новый эпик' }); + + expect(groupRepo.create).toHaveBeenCalledWith( + expect.objectContaining({ + projectId: 'proj-1', + parentId: null, + type: 'epic', + title: 'Новый эпик', + order: 1, + }), + ); + }); + + it('создаёт историю с parentId у существующего эпика', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + const epic = makeGroup({ id: 'epic-1', parentId: null }); + groupRepo.findById.mockResolvedValue(epic); + groupRepo.findAllByProject.mockResolvedValue([]); + + await service.create(1, 'proj-1', { + title: 'Новая история', + parentId: 'epic-1', + }); + + expect(groupRepo.create).toHaveBeenCalledWith( + expect.objectContaining({ + parentId: 'epic-1', + type: 'story', + title: 'Новая история', + order: 0, + }), + ); + }); + + it('бросает BadRequestException если родитель не найден', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + groupRepo.findById.mockResolvedValue(null); + + await expect( + service.create(1, 'proj-1', { title: 'X', parentId: 'nope' }), + ).rejects.toThrow(BadRequestException); + }); + + it('бросает BadRequestException при попытке вложить группу в историю (parent.parentId !== null)', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + const story = makeGroup({ + id: 'story-1', + type: 'story', + parentId: 'epic-1', + }); + groupRepo.findById.mockResolvedValue(story); + + await expect( + service.create(1, 'proj-1', { title: 'X', parentId: 'story-1' }), + ).rejects.toThrow(BadRequestException); + }); + + it('бросает NotFoundException если проект не найден', async () => { + await expect(service.create(1, 'nope', { title: 'X' })).rejects.toThrow( + NotFoundException, + ); + }); + + it('бросает ForbiddenException если проект принадлежит другому пользователю', async () => { + projRepo.findById.mockResolvedValue(makeProject({ userId: 999 })); + + await expect(service.create(1, 'proj-1', { title: 'X' })).rejects.toThrow( + ForbiddenException, + ); + }); + }); + + // ── update ────────────────────────────────────────────────────── + + describe('update', () => { + // CHK_board_group_not_self поймает это и в БД, но сырая ошибка SQLite + // дойдёт до клиента как 500. Сервис обязан отдать 400 — как это уже + // сделано для проектов в project.service.ts. + it('отдаёт 400 при попытке сделать группу родителем самой себе', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + groupRepo.findById.mockResolvedValue(makeGroup({ id: 'group-1' })); + groupRepo.countChildren.mockResolvedValue(0); + + await expect( + service.update(1, 'proj-1', 'group-1', { parentId: 'group-1' }), + ).rejects.toThrow(BadRequestException); + + expect(groupRepo.save).not.toHaveBeenCalled(); + }); + + it('обновляет title группы', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + groupRepo.findById.mockResolvedValue(makeGroup()); + + await service.update(1, 'proj-1', 'group-1', { + title: 'Новый заголовок', + }); + + expect(groupRepo.save).toHaveBeenCalledWith( + expect.objectContaining({ title: 'Новый заголовок' }), + ); + }); + + it('status: done ставит completedAt', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + groupRepo.findById.mockResolvedValue( + makeGroup({ status: 'open', completedAt: null }), + ); + + await service.update(1, 'proj-1', 'group-1', { status: 'done' }); + + expect(groupRepo.save).toHaveBeenCalledWith( + expect.objectContaining({ + status: 'done', + completedAt: expect.any(Date), + }), + ); + }); + + it('status: open обнуляет completedAt', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + groupRepo.findById.mockResolvedValue( + makeGroup({ status: 'done', completedAt: new Date() }), + ); + + await service.update(1, 'proj-1', 'group-1', { status: 'open' }); + + expect(groupRepo.save).toHaveBeenCalledWith( + expect.objectContaining({ status: 'open', completedAt: null }), + ); + }); + + it('бросает BadRequestException при смене parentId, если у группы есть дети', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + groupRepo.findById.mockResolvedValue( + makeGroup({ id: 'epic-1', parentId: null }), + ); + groupRepo.countChildren.mockResolvedValue(2); + + await expect( + service.update(1, 'proj-1', 'epic-1', { parentId: 'epic-2' }), + ).rejects.toThrow(BadRequestException); + }); + + it('разрешает смену parentId, если у группы нет детей и новый родитель — эпик верхнего уровня', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + const target = makeGroup({ id: 'epic-1', parentId: null }); + groupRepo.findById + .mockResolvedValueOnce(target) + .mockResolvedValueOnce(makeGroup({ id: 'epic-2', parentId: null })); + groupRepo.countChildren.mockResolvedValue(0); + + await service.update(1, 'proj-1', 'epic-1', { parentId: 'epic-2' }); + + expect(groupRepo.save).toHaveBeenCalledWith( + expect.objectContaining({ parentId: 'epic-2', type: 'story' }), + ); + }); + + it('бросает NotFoundException если группа не найдена', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + + await expect( + service.update(1, 'proj-1', 'nope', { title: 'X' }), + ).rejects.toThrow(NotFoundException); + }); + + it('бросает ForbiddenException если проект принадлежит другому пользователю', async () => { + projRepo.findById.mockResolvedValue(makeProject({ userId: 999 })); + + await expect( + service.update(1, 'proj-1', 'group-1', { title: 'X' }), + ).rejects.toThrow(ForbiddenException); + }); + }); + + // ── delete ────────────────────────────────────────────────────── + + describe('delete', () => { + it('удаляет группу (каскад историй/обнуление groupId у задач обеспечен FK)', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + + await service.delete(1, 'proj-1', 'epic-1'); + + expect(groupRepo.delete).toHaveBeenCalledWith('epic-1', 'proj-1'); + }); + + it('бросает NotFoundException если группа не найдена', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + groupRepo.delete.mockResolvedValue(false); + + await expect(service.delete(1, 'proj-1', 'nope')).rejects.toThrow( + NotFoundException, + ); + }); + }); + + // ── reorder ───────────────────────────────────────────────────── + + describe('reorder', () => { + it('обновляет порядок групп по переданным ID', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + + await service.reorder(1, 'proj-1', ['group-3', 'group-1', 'group-2']); + + expect(groupRepo.reorder).toHaveBeenCalledWith([ + { id: 'group-3', order: 0 }, + { id: 'group-1', order: 1 }, + { id: 'group-2', order: 2 }, + ]); + }); + + it('бросает BadRequestException если массив пустой', async () => { + projRepo.findById.mockResolvedValue(makeProject()); + + await expect(service.reorder(1, 'proj-1', [])).rejects.toThrow( + BadRequestException, + ); + }); + }); +}); diff --git a/alfy-bot/src/modules/project/board-group.service.ts b/alfy-bot/src/modules/project/board-group.service.ts new file mode 100644 index 0000000..7a51eb1 --- /dev/null +++ b/alfy-bot/src/modules/project/board-group.service.ts @@ -0,0 +1,159 @@ +import { + Injectable, + NotFoundException, + BadRequestException, + ForbiddenException, +} from '@nestjs/common'; +import { BoardGroup } from '../../shared/entities'; +import { BoardGroupRepositoryPort } from './domain/board-group-repository.port'; +import { ProjectRepositoryPort } from './domain/project-repository.port'; +import { CreateGroupDto } from './dto/create-group.dto'; +import { UpdateGroupDto } from './dto/update-group.dto'; + +export interface BoardGroupNode extends BoardGroup { + children: BoardGroupNode[]; +} + +@Injectable() +export class BoardGroupService { + constructor( + private readonly groupRepo: BoardGroupRepositoryPort, + private readonly projectRepo: ProjectRepositoryPort, + ) {} + + private async validateProjectAccess(userId: number, projectId: string) { + const project = await this.projectRepo.findById(projectId, userId); + if (!project) + throw new NotFoundException(`Project #${projectId} not found`); + if (project.userId !== userId) + throw new ForbiddenException('Project belongs to another user'); + return project; + } + + async getTree(userId: number, projectId: string): Promise { + await this.validateProjectAccess(userId, projectId); + const groups = await this.groupRepo.findAllByProject(projectId); + + const nodeById = new Map(); + for (const group of groups) { + nodeById.set(group.id, { ...group, children: [] }); + } + + const roots: BoardGroupNode[] = []; + for (const group of groups) { + const node = nodeById.get(group.id) as BoardGroupNode; + if (group.parentId) { + const parent = nodeById.get(group.parentId); + if (parent) parent.children.push(node); + } else { + roots.push(node); + } + } + + return roots; + } + + async create( + userId: number, + projectId: string, + dto: CreateGroupDto, + ): Promise { + await this.validateProjectAccess(userId, projectId); + + let type: 'epic' | 'story' = 'epic'; + let parentId: string | null = null; + + if (dto.parentId) { + const parent = await this.groupRepo.findById(dto.parentId, projectId); + if (!parent || parent.parentId !== null) { + throw new BadRequestException( + 'Parent must be a top-level epic in this project', + ); + } + type = 'story'; + parentId = dto.parentId; + } + + const existing = await this.groupRepo.findAllByProject(projectId); + const siblings = existing.filter((g) => g.parentId === parentId); + const nextOrder = siblings.length; + + return this.groupRepo.create({ + projectId, + parentId, + type, + title: dto.title, + description: dto.description ?? null, + color: dto.color ?? null, + order: nextOrder, + }); + } + + async update( + userId: number, + projectId: string, + id: string, + dto: UpdateGroupDto, + ): Promise { + await this.validateProjectAccess(userId, projectId); + + const group = await this.groupRepo.findById(id, projectId); + if (!group) throw new NotFoundException(`Group #${id} not found`); + + if (dto.parentId !== undefined && dto.parentId !== group.parentId) { + if (dto.parentId === id) { + throw new BadRequestException('Group cannot be its own parent'); + } + + const childCount = await this.groupRepo.countChildren(id); + if (childCount > 0) { + throw new BadRequestException( + 'Cannot reparent a group that has children', + ); + } + + const parent = await this.groupRepo.findById(dto.parentId, projectId); + if (!parent || parent.parentId !== null) { + throw new BadRequestException( + 'Parent must be a top-level epic in this project', + ); + } + + group.parentId = dto.parentId; + group.type = 'story'; + } + + if (dto.title !== undefined) group.title = dto.title; + if (dto.description !== undefined) group.description = dto.description; + if (dto.color !== undefined) group.color = dto.color; + + if (dto.status !== undefined) { + group.status = dto.status; + group.completedAt = dto.status === 'done' ? new Date() : null; + } + + return this.groupRepo.save(group); + } + + async delete(userId: number, projectId: string, id: string): Promise { + await this.validateProjectAccess(userId, projectId); + + const deleted = await this.groupRepo.delete(id, projectId); + if (!deleted) throw new NotFoundException(`Group #${id} not found`); + } + + async reorder( + userId: number, + projectId: string, + orderedIds: string[], + ): Promise { + await this.validateProjectAccess(userId, projectId); + + if (orderedIds.length === 0) { + throw new BadRequestException('Ordered IDs array cannot be empty'); + } + + const updates = orderedIds.map((id, index) => ({ id, order: index })); + await this.groupRepo.reorder(updates); + } +} diff --git a/alfy-bot/src/modules/project/dto/create-group.dto.ts b/alfy-bot/src/modules/project/dto/create-group.dto.ts new file mode 100644 index 0000000..ba1379a --- /dev/null +++ b/alfy-bot/src/modules/project/dto/create-group.dto.ts @@ -0,0 +1,23 @@ +import { IsOptional, IsString, IsUUID } from 'class-validator'; +import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger'; + +export class CreateGroupDto { + @ApiProperty({ example: 'Онбординг пользователей' }) + @IsString() + title: string; + + @ApiPropertyOptional({ example: 'epic-uuid' }) + @IsOptional() + @IsUUID('4') + parentId?: string; + + @ApiPropertyOptional({ example: 'Описание эпика' }) + @IsOptional() + @IsString() + description?: string; + + @ApiPropertyOptional({ example: '#00ff00' }) + @IsOptional() + @IsString() + color?: string; +} diff --git a/alfy-bot/src/modules/project/dto/update-group.dto.ts b/alfy-bot/src/modules/project/dto/update-group.dto.ts new file mode 100644 index 0000000..81604de --- /dev/null +++ b/alfy-bot/src/modules/project/dto/update-group.dto.ts @@ -0,0 +1,10 @@ +import { PartialType, ApiPropertyOptional } from '@nestjs/swagger'; +import { IsIn, IsOptional } from 'class-validator'; +import { CreateGroupDto } from './create-group.dto'; + +export class UpdateGroupDto extends PartialType(CreateGroupDto) { + @ApiPropertyOptional({ enum: ['open', 'done'] }) + @IsOptional() + @IsIn(['open', 'done']) + status?: 'open' | 'done'; +} diff --git a/alfy-bot/src/modules/project/project.module.ts b/alfy-bot/src/modules/project/project.module.ts index 5eee062..e4c8866 100644 --- a/alfy-bot/src/modules/project/project.module.ts +++ b/alfy-bot/src/modules/project/project.module.ts @@ -1,28 +1,33 @@ import { Module } from '@nestjs/common'; import { TypeOrmModule } from '@nestjs/typeorm'; -import { Project, ProjectColumn } from '../../shared/entities'; +import { Project, ProjectColumn, BoardGroup } from '../../shared/entities'; import { AuthModule } from '../auth/auth.module'; import { TaskModule } from '../task/task.module'; import { ProjectRepositoryPort } from './domain/project-repository.port'; import { ProjectColumnRepositoryPort } from './domain/project-column-repository.port'; +import { BoardGroupRepositoryPort } from './domain/board-group-repository.port'; import { TypeOrmProjectRepository } from './infrastructure/typeorm-project.repository'; import { TypeOrmProjectColumnRepository } from './infrastructure/typeorm-project-column.repository'; +import { TypeOrmBoardGroupRepository } from './infrastructure/typeorm-board-group.repository'; import { ProjectService } from './project.service'; import { ProjectColumnService } from './project-column.service'; +import { BoardGroupService } from './board-group.service'; import { ProjectTaskService } from './project-task.service'; import { ProjectController } from './project.controller'; import { ProjectColumnController } from './project-column.controller'; +import { BoardGroupController } from './board-group.controller'; import { ProjectTaskController } from './project-task.controller'; @Module({ imports: [ - TypeOrmModule.forFeature([Project, ProjectColumn]), + TypeOrmModule.forFeature([Project, ProjectColumn, BoardGroup]), AuthModule, TaskModule, ], controllers: [ ProjectController, ProjectColumnController, + BoardGroupController, ProjectTaskController, ], providers: [ @@ -31,8 +36,13 @@ import { ProjectTaskController } from './project-task.controller'; provide: ProjectColumnRepositoryPort, useClass: TypeOrmProjectColumnRepository, }, + { + provide: BoardGroupRepositoryPort, + useClass: TypeOrmBoardGroupRepository, + }, ProjectService, ProjectColumnService, + BoardGroupService, ProjectTaskService, ], exports: [ProjectService], From 32b784baacf2f2eccbc2b673f5a23165b496e53f Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 12:54:07 +0500 Subject: [PATCH 06/99] feat(project): agile view mode, default columns, group in task move MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Project.viewMode gains 'agile'; create/update DTOs validate it. - ProjectService seeds К выполнению/В работе/Готово columns on agile project creation, and on switching an existing project to agile if it has no columns yet. - MoveTaskDto accepts groupId; ProjectTaskService validates it exists in the target project before passing it to TaskRepositoryPort.updatePosition. - TaskService.update nulls groupId when projectId changes, so the trg_task_group_same_project trigger doesn't reject the PATCH. --- .../modules/project/dto/create-project.dto.ts | 6 +- .../src/modules/project/dto/move-task.dto.ts | 5 + .../modules/project/dto/update-project.dto.ts | 6 +- .../project/project-column.service.spec.ts | 9 ++ .../project/project-task.service.spec.ts | 84 ++++++++++++++++- .../modules/project/project-task.service.ts | 14 +++ .../modules/project/project.service.spec.ts | 93 +++++++++++++++++++ .../src/modules/project/project.service.ts | 38 +++++++- .../task/domain/task-repository.port.ts | 1 + .../infrastructure/typeorm-task.repository.ts | 2 + .../src/modules/task/task.service.spec.ts | 40 ++++++++ alfy-bot/src/modules/task/task.service.ts | 12 +++ .../src/shared/entities/project.entity.ts | 2 +- 13 files changed, 299 insertions(+), 13 deletions(-) diff --git a/alfy-bot/src/modules/project/dto/create-project.dto.ts b/alfy-bot/src/modules/project/dto/create-project.dto.ts index fa874fa..f801e53 100644 --- a/alfy-bot/src/modules/project/dto/create-project.dto.ts +++ b/alfy-bot/src/modules/project/dto/create-project.dto.ts @@ -16,10 +16,10 @@ export class CreateProjectDto { @IsUUID() parentId?: string; - @ApiPropertyOptional({ example: 'list', enum: ['list', 'board'] }) + @ApiPropertyOptional({ example: 'list', enum: ['list', 'board', 'agile'] }) @IsOptional() - @IsIn(['list', 'board']) - viewMode?: 'list' | 'board'; + @IsIn(['list', 'board', 'agile']) + viewMode?: 'list' | 'board' | 'agile'; @ApiPropertyOptional({ example: 'star' }) @IsOptional() diff --git a/alfy-bot/src/modules/project/dto/move-task.dto.ts b/alfy-bot/src/modules/project/dto/move-task.dto.ts index cfdc215..bb3eee5 100644 --- a/alfy-bot/src/modules/project/dto/move-task.dto.ts +++ b/alfy-bot/src/modules/project/dto/move-task.dto.ts @@ -12,6 +12,11 @@ export class MoveTaskDto { @IsUUID() columnId?: string | null; + @ApiPropertyOptional({ example: '550e8400-e29b-41d4-a716-446655440002' }) + @IsOptional() + @IsUUID() + groupId?: string | null; + @ApiPropertyOptional({ example: 0 }) @IsOptional() @IsNumber() diff --git a/alfy-bot/src/modules/project/dto/update-project.dto.ts b/alfy-bot/src/modules/project/dto/update-project.dto.ts index 061519a..f3e0489 100644 --- a/alfy-bot/src/modules/project/dto/update-project.dto.ts +++ b/alfy-bot/src/modules/project/dto/update-project.dto.ts @@ -16,10 +16,10 @@ export class UpdateProjectDto { @IsOptional() parentId?: string | null; - @ApiPropertyOptional({ example: 'list', enum: ['list', 'board'] }) + @ApiPropertyOptional({ example: 'list', enum: ['list', 'board', 'agile'] }) @IsOptional() - @IsIn(['list', 'board']) - viewMode?: 'list' | 'board'; + @IsIn(['list', 'board', 'agile']) + viewMode?: 'list' | 'board' | 'agile'; @ApiPropertyOptional({ description: 'Set to null to remove icon' }) @IsOptional() diff --git a/alfy-bot/src/modules/project/project-column.service.spec.ts b/alfy-bot/src/modules/project/project-column.service.spec.ts index b055731..8c152b2 100644 --- a/alfy-bot/src/modules/project/project-column.service.spec.ts +++ b/alfy-bot/src/modules/project/project-column.service.spec.ts @@ -159,6 +159,15 @@ describe('ProjectColumnService', () => { BadRequestException, ); }); + + it('позволяет создать колонку в agile-проекте', async () => { + projRepo.findById.mockResolvedValue(makeProject({ viewMode: 'agile' })); + colRepo.findAllByProject.mockResolvedValue([]); + + await expect( + service.create(1, 'proj-1', { title: 'X' }), + ).resolves.toBeDefined(); + }); }); // ── update ────────────────────────────────────────────────────── diff --git a/alfy-bot/src/modules/project/project-task.service.spec.ts b/alfy-bot/src/modules/project/project-task.service.spec.ts index e65ba61..3994f21 100644 --- a/alfy-bot/src/modules/project/project-task.service.spec.ts +++ b/alfy-bot/src/modules/project/project-task.service.spec.ts @@ -7,8 +7,9 @@ import { import { ProjectTaskService } from './project-task.service'; import { ProjectRepositoryPort } from './domain/project-repository.port'; import { ProjectColumnRepositoryPort } from './domain/project-column-repository.port'; +import { BoardGroupRepositoryPort } from './domain/board-group-repository.port'; import { TaskRepositoryPort } from '../task/domain/task-repository.port'; -import { Project, ProjectColumn, Task } from '../../shared/entities'; +import { Project, ProjectColumn, BoardGroup, Task } from '../../shared/entities'; function makeProject(overrides: Partial = {}): Project { const p = new Project(); @@ -46,6 +47,27 @@ function makeColumn(overrides: Partial = {}): ProjectColumn { return c; } +function makeGroup(overrides: Partial = {}): BoardGroup { + const g = new BoardGroup(); + Object.assign(g, { + id: 'group-1', + userId: 1, + projectId: 'proj-1', + parentId: null, + type: 'epic', + title: 'Эпик', + description: null, + status: 'open', + completedAt: null, + color: null, + order: 0, + createdAt: new Date(), + updatedAt: new Date(), + ...overrides, + }); + return g; +} + function makeTask(overrides: Partial = {}): Task { const t = new Task(); Object.assign(t, { @@ -75,6 +97,7 @@ describe('ProjectTaskService — move & reorder', () => { let service: ProjectTaskService; let projRepo: Record; let colRepo: Record; + let groupRepo: Record; let taskRepo: Record; beforeEach(async () => { @@ -97,6 +120,16 @@ describe('ProjectTaskService — move & reorder', () => { reorder: jest.fn(), }; + groupRepo = { + findAllByProject: jest.fn().mockResolvedValue([]), + findById: jest.fn().mockResolvedValue(null), + countChildren: jest.fn().mockResolvedValue(0), + create: jest.fn(), + save: jest.fn(), + delete: jest.fn(), + reorder: jest.fn(), + }; + taskRepo = { findAllByUser: jest.fn().mockResolvedValue([]), findById: jest.fn().mockResolvedValue(null), @@ -110,8 +143,11 @@ describe('ProjectTaskService — move & reorder', () => { findAllByProject: jest.fn().mockResolvedValue([]), updatePosition: jest .fn() - .mockImplementation((taskId, _userId, projectId, columnId, order) => - Promise.resolve(makeTask({ id: taskId, projectId, columnId, order })), + .mockImplementation( + (taskId, _userId, projectId, columnId, groupId, order) => + Promise.resolve( + makeTask({ id: taskId, projectId, columnId, order, groupId }), + ), ), reorderTasks: jest.fn().mockResolvedValue(undefined), }; @@ -121,6 +157,7 @@ describe('ProjectTaskService — move & reorder', () => { ProjectTaskService, { provide: ProjectRepositoryPort, useValue: projRepo }, { provide: ProjectColumnRepositoryPort, useValue: colRepo }, + { provide: BoardGroupRepositoryPort, useValue: groupRepo }, { provide: TaskRepositoryPort, useValue: taskRepo }, ], }).compile(); @@ -145,6 +182,7 @@ describe('ProjectTaskService — move & reorder', () => { 1, 'proj-1', null, + null, 0, ); }); @@ -163,6 +201,7 @@ describe('ProjectTaskService — move & reorder', () => { 1, null, null, + null, 0, ); }); @@ -183,6 +222,7 @@ describe('ProjectTaskService — move & reorder', () => { 1, 'proj-1', 'col-1', + null, 2, ); }); @@ -205,6 +245,7 @@ describe('ProjectTaskService — move & reorder', () => { 1, 'proj-1', 'col-2', + null, 0, ); }); @@ -223,6 +264,7 @@ describe('ProjectTaskService — move & reorder', () => { 1, 'proj-1', null, + null, 5, ); }); @@ -331,6 +373,42 @@ describe('ProjectTaskService — move & reorder', () => { }), ).rejects.toThrow(BadRequestException); }); + + it('бросает NotFoundException если groupId не существует в целевом проекте', async () => { + taskRepo.findById.mockResolvedValue(makeTask()); + projRepo.findById.mockResolvedValue(makeProject({ viewMode: 'agile' })); + groupRepo.findById.mockResolvedValue(null); + + await expect( + service.moveTask(1, 'proj-1', 'task-1', { + projectId: 'proj-1', + groupId: 'group-other', + order: 0, + }), + ).rejects.toThrow(NotFoundException); + }); + + it('передаёт валидный groupId в updatePosition', async () => { + taskRepo.findById.mockResolvedValue(makeTask()); + projRepo.findById.mockResolvedValue(makeProject({ viewMode: 'agile' })); + groupRepo.findById.mockResolvedValue(makeGroup()); + + await service.moveTask(1, 'proj-1', 'task-1', { + projectId: 'proj-1', + groupId: 'group-1', + order: 0, + }); + + expect(groupRepo.findById).toHaveBeenCalledWith('group-1', 'proj-1'); + expect(taskRepo.updatePosition).toHaveBeenCalledWith( + 'task-1', + 1, + 'proj-1', + null, + 'group-1', + 0, + ); + }); }); // ── reorderTasks ──────────────────────────────────────────────── diff --git a/alfy-bot/src/modules/project/project-task.service.ts b/alfy-bot/src/modules/project/project-task.service.ts index c32bd2b..8470c41 100644 --- a/alfy-bot/src/modules/project/project-task.service.ts +++ b/alfy-bot/src/modules/project/project-task.service.ts @@ -6,6 +6,7 @@ import { } from '@nestjs/common'; import { ProjectRepositoryPort } from './domain/project-repository.port'; import { ProjectColumnRepositoryPort } from './domain/project-column-repository.port'; +import { BoardGroupRepositoryPort } from './domain/board-group-repository.port'; import { TaskRepositoryPort } from '../task/domain/task-repository.port'; import { MoveTaskDto } from './dto/move-task.dto'; import { ReorderTasksDto } from './dto/reorder-tasks.dto'; @@ -15,6 +16,7 @@ export class ProjectTaskService { constructor( private readonly projectRepo: ProjectRepositoryPort, private readonly columnRepo: ProjectColumnRepositoryPort, + private readonly groupRepo: BoardGroupRepositoryPort, private readonly taskRepo: TaskRepositoryPort, ) {} @@ -47,6 +49,7 @@ export class ProjectTaskService { const targetProjectId = dto.projectId !== undefined ? dto.projectId : currentProjectId; const targetColumnId = dto.columnId !== undefined ? dto.columnId : null; + const targetGroupId = dto.groupId !== undefined ? dto.groupId : null; // Cannot set column without project if (targetColumnId && !targetProjectId) { @@ -90,11 +93,22 @@ export class ProjectTaskService { throw new NotFoundException(`Column #${targetColumnId} not found`); } + // Validate group + if (targetGroupId && targetProjectId) { + const group = await this.groupRepo.findById( + targetGroupId, + targetProjectId, + ); + if (!group) + throw new NotFoundException(`Group #${targetGroupId} not found`); + } + return this.taskRepo.updatePosition( taskId, userId, targetProjectId, targetColumnId, + targetGroupId, order, ); } diff --git a/alfy-bot/src/modules/project/project.service.spec.ts b/alfy-bot/src/modules/project/project.service.spec.ts index aa2696d..8c7d09b 100644 --- a/alfy-bot/src/modules/project/project.service.spec.ts +++ b/alfy-bot/src/modules/project/project.service.spec.ts @@ -6,6 +6,7 @@ import { } from '@nestjs/common'; import { ProjectService } from './project.service'; import { ProjectRepositoryPort } from './domain/project-repository.port'; +import { ProjectColumnRepositoryPort } from './domain/project-column-repository.port'; import { Project } from '../../shared/entities'; function makeProject(overrides: Partial = {}): Project { @@ -32,6 +33,7 @@ function makeProject(overrides: Partial = {}): Project { describe('ProjectService', () => { let service: ProjectService; let repo: Record; + let columnRepo: Record; beforeEach(async () => { repo = { @@ -46,10 +48,20 @@ describe('ProjectService', () => { reorder: jest.fn().mockResolvedValue(undefined), }; + columnRepo = { + findAllByProject: jest.fn().mockResolvedValue([]), + findById: jest.fn().mockResolvedValue(null), + create: jest.fn().mockResolvedValue(undefined), + save: jest.fn(), + delete: jest.fn(), + reorder: jest.fn(), + }; + const module: TestingModule = await Test.createTestingModule({ providers: [ ProjectService, { provide: ProjectRepositoryPort, useValue: repo }, + { provide: ProjectColumnRepositoryPort, useValue: columnRepo }, ], }).compile(); @@ -180,6 +192,42 @@ describe('ProjectService', () => { ).rejects.toThrow(NotFoundException); }); + it('создание agile-проекта засевает три колонки по умолчанию', async () => { + const result = await service.create(1, { + title: 'Спринт', + viewMode: 'agile', + }); + + expect(columnRepo.create).toHaveBeenCalledTimes(3); + expect(columnRepo.create.mock.calls.map((call) => call[0])).toEqual([ + expect.objectContaining({ + projectId: result.id, + title: 'К выполнению', + order: 0, + }), + expect.objectContaining({ + projectId: result.id, + title: 'В работе', + order: 1, + }), + expect.objectContaining({ + projectId: result.id, + title: 'Готово', + order: 2, + }), + ]); + }); + + it('создание list-проекта не засевает колонки', async () => { + await service.create(1, { title: 'Список' }); + expect(columnRepo.create).not.toHaveBeenCalled(); + }); + + it('создание board-проекта не засевает колонки', async () => { + await service.create(1, { title: 'Доска', viewMode: 'board' }); + expect(columnRepo.create).not.toHaveBeenCalled(); + }); + it('бросает ForbiddenException если parentId указывает на проект другого пользователя', async () => { repo.findById.mockResolvedValue(makeProject({ userId: 999 })); @@ -321,6 +369,51 @@ describe('ProjectService', () => { service.update(1, 'proj-1', { parentId: 'proj-2' }), ).rejects.toThrow(ForbiddenException); }); + + it('переключение на agile засевает три колонки, если у проекта их ещё нет', async () => { + repo.findById.mockResolvedValue(makeProject({ viewMode: 'list' })); + columnRepo.findAllByProject.mockResolvedValue([]); + + await service.update(1, 'proj-1', { viewMode: 'agile' }); + + expect(columnRepo.create).toHaveBeenCalledTimes(3); + expect(columnRepo.create.mock.calls.map((call) => call[0])).toEqual([ + expect.objectContaining({ + projectId: 'proj-1', + title: 'К выполнению', + order: 0, + }), + expect.objectContaining({ + projectId: 'proj-1', + title: 'В работе', + order: 1, + }), + expect.objectContaining({ + projectId: 'proj-1', + title: 'Готово', + order: 2, + }), + ]); + }); + + it('переключение на agile не засевает колонки, если они уже есть', async () => { + repo.findById.mockResolvedValue(makeProject({ viewMode: 'board' })); + columnRepo.findAllByProject.mockResolvedValue([ + { id: 'col-1', projectId: 'proj-1', title: 'To Do', order: 0 }, + ]); + + await service.update(1, 'proj-1', { viewMode: 'agile' }); + + expect(columnRepo.create).not.toHaveBeenCalled(); + }); + + it('обновление без изменения viewMode на agile не засевает колонки', async () => { + repo.findById.mockResolvedValue(makeProject({ viewMode: 'list' })); + + await service.update(1, 'proj-1', { title: 'Новый' }); + + expect(columnRepo.create).not.toHaveBeenCalled(); + }); }); // ── delete ────────────────────────────────────────────────────── diff --git a/alfy-bot/src/modules/project/project.service.ts b/alfy-bot/src/modules/project/project.service.ts index 981a7a5..f5efd09 100644 --- a/alfy-bot/src/modules/project/project.service.ts +++ b/alfy-bot/src/modules/project/project.service.ts @@ -6,12 +6,18 @@ import { } from '@nestjs/common'; import { Project } from '../../shared/entities'; import { ProjectRepositoryPort } from './domain/project-repository.port'; +import { ProjectColumnRepositoryPort } from './domain/project-column-repository.port'; import { CreateProjectDto } from './dto/create-project.dto'; import { UpdateProjectDto } from './dto/update-project.dto'; +const AGILE_DEFAULT_COLUMNS = ['К выполнению', 'В работе', 'Готово']; + @Injectable() export class ProjectService { - constructor(private readonly projectRepo: ProjectRepositoryPort) {} + constructor( + private readonly projectRepo: ProjectRepositoryPort, + private readonly columnRepo: ProjectColumnRepositoryPort, + ) {} async getAll(userId: number): Promise { return this.projectRepo.findAllByUser(userId); @@ -34,7 +40,7 @@ export class ProjectService { throw new ForbiddenException('Parent project belongs to another user'); } - return this.projectRepo.create({ + const created = await this.projectRepo.create({ userId, title: dto.title, description: dto.description, @@ -43,6 +49,12 @@ export class ProjectService { icon: dto.icon, color: dto.color, }); + + if (created.viewMode === 'agile') { + await this.seedAgileColumns(created.id); + } + + return created; } async update( @@ -66,8 +78,28 @@ export class ProjectService { throw new ForbiddenException('Parent project belongs to another user'); } + const isSwitchingToAgile = + dto.viewMode === 'agile' && project.viewMode !== 'agile'; + Object.assign(project, dto); - return this.projectRepo.save(project); + const saved = await this.projectRepo.save(project); + + if (isSwitchingToAgile) { + const existingColumns = await this.columnRepo.findAllByProject( + saved.id, + ); + if (existingColumns.length === 0) { + await this.seedAgileColumns(saved.id); + } + } + + return saved; + } + + private async seedAgileColumns(projectId: string): Promise { + for (const [order, title] of AGILE_DEFAULT_COLUMNS.entries()) { + await this.columnRepo.create({ projectId, title, order }); + } } async delete(userId: number, id: string): Promise { diff --git a/alfy-bot/src/modules/task/domain/task-repository.port.ts b/alfy-bot/src/modules/task/domain/task-repository.port.ts index 8315277..cb8c0f2 100644 --- a/alfy-bot/src/modules/task/domain/task-repository.port.ts +++ b/alfy-bot/src/modules/task/domain/task-repository.port.ts @@ -37,6 +37,7 @@ export abstract class TaskRepositoryPort { userId: number, projectId: string | null, columnId: string | null, + groupId: string | null, order: number, ): Promise; abstract reorderTasks( diff --git a/alfy-bot/src/modules/task/infrastructure/typeorm-task.repository.ts b/alfy-bot/src/modules/task/infrastructure/typeorm-task.repository.ts index e95442c..2a87074 100644 --- a/alfy-bot/src/modules/task/infrastructure/typeorm-task.repository.ts +++ b/alfy-bot/src/modules/task/infrastructure/typeorm-task.repository.ts @@ -120,12 +120,14 @@ export class TypeOrmTaskRepository extends TaskRepositoryPort { userId: number, projectId: string | null, columnId: string | null, + groupId: string | null, order: number, ): Promise { const task = await this.findById(taskId, userId); if (!task) return null; task.projectId = projectId; task.columnId = columnId; + task.groupId = groupId; task.order = order; return this.taskRepo.save(task); } diff --git a/alfy-bot/src/modules/task/task.service.spec.ts b/alfy-bot/src/modules/task/task.service.spec.ts index e3f96f1..096ab38 100644 --- a/alfy-bot/src/modules/task/task.service.spec.ts +++ b/alfy-bot/src/modules/task/task.service.spec.ts @@ -269,6 +269,46 @@ describe('TaskService', () => { ).rejects.toThrow(BadRequestException); expect(repo.save).not.toHaveBeenCalled(); }); + + it('смена projectId обнуляет groupId в той же записи', async () => { + repo.findById.mockResolvedValue( + makeTask({ projectId: 'proj-1', groupId: 'group-1' }), + ); + + const result = await service.update(1, 'task-1', { + projectId: 'proj-2', + }); + + expect(repo.save).toHaveBeenCalledWith( + expect.objectContaining({ projectId: 'proj-2', groupId: null }), + ); + expect(result.task.groupId).toBeNull(); + }); + }); + + describe('moveToInbox', () => { + // Тот же случай, что и смена projectId в update: задача уезжает из + // проекта, а groupId указывает на группу этого проекта. Триггер + // trg_task_group_same_project отклонит такую запись, и клиент получит + // 500 вместо переноса в Inbox. + it('обнуляет groupId вместе с projectId и columnId', async () => { + repo.findById.mockResolvedValue( + makeTask({ + projectId: 'proj-1', + columnId: 'col-1', + groupId: 'group-1', + }), + ); + await service.moveToInbox(1, 'task-1', { order: 0 }); + + expect(repo.save).toHaveBeenCalledWith( + expect.objectContaining({ + projectId: null, + columnId: null, + groupId: null, + }), + ); + }); }); describe('update — reschedule recurring dueDate', () => { diff --git a/alfy-bot/src/modules/task/task.service.ts b/alfy-bot/src/modules/task/task.service.ts index ac80ba3..0637521 100644 --- a/alfy-bot/src/modules/task/task.service.ts +++ b/alfy-bot/src/modules/task/task.service.ts @@ -220,11 +220,20 @@ export class TaskService { const isUncompletingRecurring = dto.completed === false && task.completed && task.recurrence; + // Moving a task to a different project detaches it from its board group — + // the trg_task_group_same_project trigger rejects a groupId that no + // longer matches the task's projectId. + const isChangingProject = + dto.projectId !== undefined && dto.projectId !== task.projectId; + // Apply only defined scalar fields (skip undefined to avoid clobbering existing values) const defined = Object.fromEntries( Object.entries(rest).filter(([, v]) => v !== undefined), ); Object.assign(task, defined); + if (isChangingProject) { + task.groupId = null; + } if (dueDate !== undefined) { const newDue = dueDate ? new Date(dueDate) : null; if ((rescheduleScope ?? 'this') === 'subsequent') { @@ -584,6 +593,9 @@ export class TaskService { task.projectId = null; task.columnId = null; + // Группа принадлежит проекту, из которого задача уезжает — оставить + // groupId значит нарваться на trg_task_group_same_project и отдать 500. + task.groupId = null; task.order = order; return this.attachGoalIdsOne(userId, await this.taskRepo.save(task)); } diff --git a/alfy-bot/src/shared/entities/project.entity.ts b/alfy-bot/src/shared/entities/project.entity.ts index d57d226..f789f4e 100644 --- a/alfy-bot/src/shared/entities/project.entity.ts +++ b/alfy-bot/src/shared/entities/project.entity.ts @@ -29,7 +29,7 @@ export class Project { description: string | null; @Column({ type: 'text', default: 'list' }) - viewMode: 'list' | 'board'; + viewMode: 'list' | 'board' | 'agile'; @Column({ type: 'text', nullable: true }) icon: string | null; From 7fdc937dbb7a141bca484f757ff24aa525661e97 Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 13:12:02 +0500 Subject: [PATCH 07/99] feat(projects): agile board view with nested epics and stories --- .../src/features/projects/api/groups-api.ts | 22 ++ .../src/features/projects/lib/agile-layout.ts | 51 +++++ .../features/projects/model/group-store.ts | 207 ++++++++++++++++++ .../src/features/projects/model/types.ts | 34 ++- .../features/projects/ui/AgileBoardView.vue | 124 +++++++++++ .../src/features/projects/ui/AgileCell.vue | 26 +++ .../features/projects/ui/AgileEpicBlock.vue | 95 ++++++++ .../features/projects/ui/AgileStoryBlock.vue | 45 ++++ .../features/projects/ui/ViewModeToggle.vue | 46 ++-- .../src/features/tasks/model/types.ts | 1 + alfy-bot-frontend/src/views/ProjectView.vue | 41 +++- .../projects/lib/agile-layout.spec.ts | 105 +++++++++ .../projects/ui/ViewModeToggle.spec.ts | 8 +- 13 files changed, 777 insertions(+), 28 deletions(-) create mode 100644 alfy-bot-frontend/src/features/projects/api/groups-api.ts create mode 100644 alfy-bot-frontend/src/features/projects/lib/agile-layout.ts create mode 100644 alfy-bot-frontend/src/features/projects/model/group-store.ts create mode 100644 alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue create mode 100644 alfy-bot-frontend/src/features/projects/ui/AgileCell.vue create mode 100644 alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue create mode 100644 alfy-bot-frontend/src/features/projects/ui/AgileStoryBlock.vue create mode 100644 alfy-bot-frontend/tests/features/projects/lib/agile-layout.spec.ts 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..7824144 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/api/groups-api.ts @@ -0,0 +1,22 @@ +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 }) +} 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..b7533c5 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/lib/agile-layout.ts @@ -0,0 +1,51 @@ +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 +} 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..964e307 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/model/group-store.ts @@ -0,0 +1,207 @@ +import type { BoardGroup, BoardGroupNode, CreateGroupPayload, UpdateGroupPayload } from './types' +import { defineStore } from 'pinia' +import { ref } from 'vue' +import * as groupsApi from '../api/groups-api' + +function findNode(nodes: BoardGroupNode[], id: string): BoardGroupNode | undefined { + for (const node of nodes) { + if (node.id === id) + return node + const found = findNode(node.children, id) + if (found) + return found + } + return undefined +} + +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 groups = ref([]) + const currentProjectId = ref(null) + const loading = ref(false) + const error = ref(null) + + const fetchGroups = async (projectId: string) => { + loading.value = true + error.value = null + currentProjectId.value = projectId + + try { + const { data } = await groupsApi.fetchGroups(projectId) + groups.value = data + } + catch (err) { + error.value = err instanceof Error ? err.message : 'Ошибка загрузки эпиков' + } + finally { + loading.value = false + } + } + + const createGroup = async (projectId: string, payload: CreateGroupPayload) => { + const parentId = payload.parentId ?? null + const type: 'epic' | 'story' = parentId ? 'story' : 'epic' + const tempId = `temp-${Date.now()}` + const siblings = parentId ? (findNode(groups.value, parentId)?.children ?? []) : groups.value + const tempNode: BoardGroupNode = { + id: tempId, + projectId, + parentId, + type, + title: payload.title, + description: payload.description ?? null, + status: 'open', + completedAt: null, + color: payload.color ?? null, + order: siblings.length, + children: [], + } + + if (parentId) { + groups.value = replaceNode(groups.value, parentId, node => ({ + ...node, + children: [...node.children, tempNode], + })) + } + else { + groups.value = [...groups.value, tempNode] + } + + try { + const { data } = await groupsApi.createGroup(projectId, payload) + const newNode: BoardGroupNode = { ...data, children: [] } + + if (parentId) { + groups.value = replaceNode(groups.value, parentId, node => ({ + ...node, + children: node.children.map(child => (child.id === tempId ? newNode : child)), + })) + } + else { + groups.value = groups.value.map(node => (node.id === tempId ? newNode : node)) + } + + return data + } + catch (err) { + if (parentId) { + groups.value = replaceNode(groups.value, parentId, node => ({ + ...node, + children: node.children.filter(child => child.id !== tempId), + })) + } + else { + groups.value = groups.value.filter(node => node.id !== tempId) + } + throw err + } + } + + const updateGroup = async (projectId: string, groupId: string, payload: UpdateGroupPayload) => { + const previous = groups.value + const target = findNode(groups.value, groupId) + if (!target) + return + + groups.value = replaceNode(groups.value, groupId, node => ({ ...node, ...payload })) + + try { + const { data } = await groupsApi.updateGroup(projectId, groupId, payload) + groups.value = replaceNode(groups.value, groupId, node => ({ ...node, ...data })) + return data + } + catch (err) { + groups.value = previous + throw err + } + } + + const deleteGroup = async (projectId: string, groupId: string) => { + const previous = groups.value + const target = findNode(groups.value, groupId) + if (!target) + return + + groups.value = removeNode(groups.value, groupId) + + try { + await groupsApi.deleteGroup(projectId, groupId) + } + catch (err) { + groups.value = previous + throw err + } + } + + const reorderGroups = async (projectId: string, orderedIds: string[]) => { + const previous = groups.value + const firstId = orderedIds[0] + const isRootLevel = groups.value.some(node => node.id === firstId) + + if (isRootLevel) { + groups.value = orderedIds + .map((id, i) => { + const node = groups.value.find(n => n.id === id) + return node ? { ...node, order: i } : null + }) + .filter((n): n is BoardGroupNode => n !== null) + } + else { + const parent = groups.value.find(epic => epic.children.some(child => child.id === firstId)) + if (parent) { + groups.value = replaceNode(groups.value, 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) { + groups.value = previous + throw err + } + } + + const toggleEpicDone = async (projectId: string, epic: BoardGroup) => { + const nextStatus: 'open' | 'done' = epic.status === 'done' ? 'open' : 'done' + return updateGroup(projectId, epic.id, { status: nextStatus }) + } + + return { + groups, + currentProjectId, + loading, + error, + fetchGroups, + createGroup, + updateGroup, + deleteGroup, + reorderGroups, + toggleEpicDone, + } +}) diff --git a/alfy-bot-frontend/src/features/projects/model/types.ts b/alfy-bot-frontend/src/features/projects/model/types.ts index 5720b16..d4a4de6 100644 --- a/alfy-bot-frontend/src/features/projects/model/types.ts +++ b/alfy-bot-frontend/src/features/projects/model/types.ts @@ -1,4 +1,4 @@ -export type ViewMode = 'list' | 'board' +export type ViewMode = 'list' | 'board' | 'agile' export interface Project { id: string @@ -19,6 +19,38 @@ export interface ProjectColumn { color: string | null } +export type GroupType = 'epic' | 'story' + +export type GroupStatus = 'open' | 'done' + +export interface BoardGroup { + id: string + projectId: string + parentId: string | null + type: GroupType + title: string + description: string | null + status: GroupStatus + completedAt: string | null + color: 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 +} + +export type UpdateGroupPayload = Partial & { + status?: GroupStatus +} + export interface ProjectTreeNode extends Project { children: ProjectTreeNode[] } 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..e98ae3e --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue @@ -0,0 +1,124 @@ + + + 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..5d3d0c9 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/AgileCell.vue @@ -0,0 +1,26 @@ + + + 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..1728416 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue @@ -0,0 +1,95 @@ + + + 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..6bae549 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/AgileStoryBlock.vue @@ -0,0 +1,45 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/ViewModeToggle.vue b/alfy-bot-frontend/src/features/projects/ui/ViewModeToggle.vue index 52ed7c3..7f25fd2 100644 --- a/alfy-bot-frontend/src/features/projects/ui/ViewModeToggle.vue +++ b/alfy-bot-frontend/src/features/projects/ui/ViewModeToggle.vue @@ -1,9 +1,21 @@ + + - - diff --git a/alfy-bot-frontend/src/features/tasks/model/types.ts b/alfy-bot-frontend/src/features/tasks/model/types.ts index f939189..7559aaa 100644 --- a/alfy-bot-frontend/src/features/tasks/model/types.ts +++ b/alfy-bot-frontend/src/features/tasks/model/types.ts @@ -43,6 +43,7 @@ export interface Task { onMissed?: 'shift' | 'freeze' projectId?: string | null columnId?: string | null + groupId?: string | null order?: number parentId?: string goalIds?: number[] diff --git a/alfy-bot-frontend/src/views/ProjectView.vue b/alfy-bot-frontend/src/views/ProjectView.vue index 65c1ffd..59231dc 100644 --- a/alfy-bot-frontend/src/views/ProjectView.vue +++ b/alfy-bot-frontend/src/views/ProjectView.vue @@ -8,6 +8,7 @@ import PageContainer from '@/components/PageContainer.vue' import { useConfirm } from '@/composables/useConfirm' import { useColumnStore } from '@/features/projects/model/column-store' import { useProjectStore } from '@/features/projects/model/project-store' +import AgileBoardView from '@/features/projects/ui/AgileBoardView.vue' import BoardView from '@/features/projects/ui/BoardView.vue' import GroupedListView from '@/features/projects/ui/GroupedListView.vue' import ViewModeToggle from '@/features/projects/ui/ViewModeToggle.vue' @@ -29,6 +30,7 @@ const projectId = computed(() => route.params.projectId as string) const projectStore = useProjectStore() const project = computed(() => projectStore.projectMap.get(projectId.value)) const isBoardMode = computed(() => project.value?.viewMode === 'board') +const isAgileMode = computed(() => project.value?.viewMode === 'agile') const showCompleted = useShowCompleted(projectId) const hideOverdue = useHideOverdue(projectId) @@ -73,7 +75,8 @@ const filteredTasks = computed(() => { .sort((a, b) => { const w = (t: Task) => (t.isOverdue ? 2 : 0) + (t.completed ? 1 : 0) const wd = w(a) - w(b) - if (wd !== 0) return wd + if (wd !== 0) + return wd return (a.order ?? 0) - (b.order ?? 0) }) }) @@ -95,7 +98,7 @@ const { insertionIndex } = useReorderList({ }) async function handleViewModeChange(mode: string) { - await projectStore.updateProject(projectId.value, { viewMode: mode as 'list' | 'board' }) + await projectStore.updateProject(projectId.value, { viewMode: mode as 'list' | 'board' | 'agile' }) } async function handleAddTask(taskData: Omit) { @@ -154,8 +157,8 @@ watch(projectId, (id) => { diff --git a/alfy-bot-frontend/src/features/tasks/model/task-store.ts b/alfy-bot-frontend/src/features/tasks/model/task-store.ts index a7dcf3e..56b1d69 100644 --- a/alfy-bot-frontend/src/features/tasks/model/task-store.ts +++ b/alfy-bot-frontend/src/features/tasks/model/task-store.ts @@ -286,14 +286,15 @@ export const useTaskStore = defineStore('tasks', () => { } } - const moveTask = async (taskId: string, projectId: string | null, payload: { columnId?: string | null; order?: number }) => { + const moveTask = async (taskId: string, projectId: string | null, payload: { columnId?: string | null; groupId?: string | null; order?: number }) => { const task = tasks.value.find(t => t.id === taskId) if (!task) return - const previous = { projectId: task.projectId, columnId: task.columnId, order: task.order } + const previous = { projectId: task.projectId, columnId: task.columnId, groupId: task.groupId, order: task.order } task.projectId = projectId if (payload.columnId !== undefined) task.columnId = payload.columnId + if (payload.groupId !== undefined) task.groupId = payload.groupId if (payload.order !== undefined) task.order = payload.order try { @@ -307,6 +308,7 @@ export const useTaskStore = defineStore('tasks', () => { } catch (err) { task.projectId = previous.projectId task.columnId = previous.columnId + task.groupId = previous.groupId task.order = previous.order throw err } diff --git a/alfy-bot-frontend/src/features/tasks/ui/TaskDetailDialog.vue b/alfy-bot-frontend/src/features/tasks/ui/TaskDetailDialog.vue index cda388e..e1a4dbf 100644 --- a/alfy-bot-frontend/src/features/tasks/ui/TaskDetailDialog.vue +++ b/alfy-bot-frontend/src/features/tasks/ui/TaskDetailDialog.vue @@ -165,6 +165,7 @@ :recurrence="localRecurrence" :goals-label="goalsChipLabel" :goals-set="localGoalIds.length > 0" + :hide-goals="isAgileProject" :editable="effectiveEditable" class="-mx-7 border-y border-border/40" @select="activeDrawer = ($event as DrawerField)" @@ -258,6 +259,7 @@ /> @@ -719,6 +721,15 @@ const projectTitle = computed(() => : null, ) +// Agile-projects group tasks by epic/story instead of goals — the goals +// block is hidden while the task's project is in agile mode. This is a +// display-only toggle: existing goalIds are never touched here. +const isAgileProject = computed(() => + localProjectId.value + ? projectStore.projectMap.get(localProjectId.value)?.viewMode === 'agile' + : false, +) + function onProjectChange(value: string | null) { localProjectId.value = value emitUpdate({ projectId: value }) diff --git a/alfy-bot-frontend/src/features/tasks/ui/TaskPropertyChips.vue b/alfy-bot-frontend/src/features/tasks/ui/TaskPropertyChips.vue index 3115378..15a5668 100644 --- a/alfy-bot-frontend/src/features/tasks/ui/TaskPropertyChips.vue +++ b/alfy-bot-frontend/src/features/tasks/ui/TaskPropertyChips.vue @@ -47,6 +47,7 @@ const props = defineProps<{ recurrence: RecurrenceRule | null goalsLabel: string goalsSet: boolean + hideGoals?: boolean editable: boolean }>() @@ -69,12 +70,14 @@ const chips = computed(() => [ label: props.projectTitle || 'Входящие', isSet: !!props.projectTitle, }, - { - key: 'goals', - icon: Target, - label: props.goalsLabel, - isSet: props.goalsSet, - }, + ...(props.hideGoals + ? [] + : [{ + key: 'goals', + icon: Target, + label: props.goalsLabel, + isSet: props.goalsSet, + }]), { key: 'dueDate', icon: CalendarIcon, diff --git a/alfy-bot-frontend/tests/features/projects/lib/use-agile-dnd.spec.ts b/alfy-bot-frontend/tests/features/projects/lib/use-agile-dnd.spec.ts new file mode 100644 index 0000000..bb30dc4 --- /dev/null +++ b/alfy-bot-frontend/tests/features/projects/lib/use-agile-dnd.spec.ts @@ -0,0 +1,101 @@ +import { describe, expect, it, vi } from 'vitest' +import { useAgileDnd } from '@/features/projects/lib/use-agile-dnd' + +function makeTaskStore() { + return { + moveTask: vi.fn(), + reorderTasks: vi.fn(), + } as any +} + +describe('useAgileDnd', () => { + describe('onTaskChange', () => { + it('при добавлении вызывает moveTask с columnId и groupId ячейки', () => { + const taskStore = makeTaskStore() + const { onTaskChange } = useAgileDnd(taskStore) + + onTaskChange( + { added: { element: { id: 'task-1' }, newIndex: 2 } }, + 'col-2', + 'epic-1', + 'proj-1', + [{ id: 'task-1' }], + ) + + expect(taskStore.moveTask).toHaveBeenCalledWith('task-1', 'proj-1', { + columnId: 'col-2', + groupId: 'epic-1', + order: 2, + }) + }) + + it('дорожка «Без колонки» передаёт columnId: null', () => { + const taskStore = makeTaskStore() + const { onTaskChange } = useAgileDnd(taskStore) + + onTaskChange( + { added: { element: { id: 'task-1' }, newIndex: 0 } }, + null, + 'epic-1', + 'proj-1', + [{ id: 'task-1' }], + ) + + expect(taskStore.moveTask).toHaveBeenCalledWith('task-1', 'proj-1', { + columnId: null, + groupId: 'epic-1', + order: 0, + }) + }) + + it('блок «Без эпика» передаёт groupId: null', () => { + const taskStore = makeTaskStore() + const { onTaskChange } = useAgileDnd(taskStore) + + onTaskChange( + { added: { element: { id: 'task-1' }, newIndex: 0 } }, + 'col-1', + null, + 'proj-1', + [{ id: 'task-1' }], + ) + + expect(taskStore.moveTask).toHaveBeenCalledWith('task-1', 'proj-1', { + columnId: 'col-1', + groupId: null, + order: 0, + }) + }) + + it('при добавлении с несколькими задачами также реордерит ячейку', () => { + const taskStore = makeTaskStore() + const { onTaskChange } = useAgileDnd(taskStore) + + onTaskChange( + { added: { element: { id: 'task-1' }, newIndex: 1 } }, + 'col-1', + 'story-1', + 'proj-1', + [{ id: 'task-2' }, { id: 'task-1' }], + ) + + expect(taskStore.reorderTasks).toHaveBeenCalledWith('proj-1', ['task-2', 'task-1'], 'col-1') + }) + + it('при перестановке внутри ячейки реордерит по её задачам', () => { + const taskStore = makeTaskStore() + const { onTaskChange } = useAgileDnd(taskStore) + + onTaskChange( + { moved: { element: { id: 'task-1' }, newIndex: 0 } }, + 'col-1', + 'epic-1', + 'proj-1', + [{ id: 'task-1' }, { id: 'task-2' }], + ) + + expect(taskStore.reorderTasks).toHaveBeenCalledWith('proj-1', ['task-1', 'task-2'], 'col-1') + expect(taskStore.moveTask).not.toHaveBeenCalled() + }) + }) +}) diff --git a/alfy-bot-frontend/tests/features/tasks/ui/TaskDetailDialog.spec.ts b/alfy-bot-frontend/tests/features/tasks/ui/TaskDetailDialog.spec.ts new file mode 100644 index 0000000..1a2ec23 --- /dev/null +++ b/alfy-bot-frontend/tests/features/tasks/ui/TaskDetailDialog.spec.ts @@ -0,0 +1,138 @@ +import type { Project } from '@/features/projects/model/types' +import type { Task } from '@/features/tasks/model/types' +import { flushPromises, mount } from '@vue/test-utils' +import { createPinia, setActivePinia } from 'pinia' +import { beforeEach, describe, expect, it, vi } from 'vitest' +import GoalPicker from '@/features/goals/ui/GoalPicker.vue' +import { useProjectStore } from '@/features/projects/model/project-store' +import TaskDetailDialog from '@/features/tasks/ui/TaskDetailDialog.vue' + +vi.mock('@/api/client', () => ({ + api: { + get: vi.fn(), + post: vi.fn(), + patch: vi.fn(), + delete: vi.fn(), + put: vi.fn(), + }, +})) + +vi.mock('@/api/goals', () => ({ + fetchGoals: vi.fn().mockResolvedValue([]), +})) + +function makeProject(overrides: Partial = {}): Project { + return { + id: 'proj-1', + parentId: null, + title: 'Проект', + description: null, + viewMode: 'board', + icon: null, + color: null, + order: 0, + ...overrides, + } +} + +function makeTask(overrides: Partial = {}): Task { + return { + id: 'task-1', + title: 'Задача', + completed: false, + projectId: null, + goalIds: [1], + ...overrides, + } as Task +} + +const stubs = { + ProjectPicker: true, + ProjectPickerContent: true, + GoalPickerContent: true, + RecurrencePicker: true, + RecurrencePickerContent: true, + PomodoroSettings: true, + TagsEditor: true, + PriorityPickerContent: true, + DeadlinePickerContent: true, + DueDatePickerContent: true, + LocationPickerContent: true, + Calendar: true, +} + +describe('taskDetailDialog — блок целей и agile-проекты', () => { + beforeEach(() => { + setActivePinia(createPinia()) + }) + + it('показывает GoalPicker, когда проект задачи в режиме board', async () => { + const projectStore = useProjectStore() + projectStore.projects = [makeProject({ id: 'proj-board', viewMode: 'board' })] + + const wrapper = mount(TaskDetailDialog, { + props: { + task: makeTask({ projectId: 'proj-board' }), + open: true, + }, + global: { stubs }, + }) + await flushPromises() + + expect(wrapper.findComponent(GoalPicker).exists()).toBe(true) + }) + + it('скрывает GoalPicker, когда проект задачи в режиме agile', async () => { + const projectStore = useProjectStore() + projectStore.projects = [makeProject({ id: 'proj-agile', viewMode: 'agile' })] + + const wrapper = mount(TaskDetailDialog, { + props: { + task: makeTask({ projectId: 'proj-agile' }), + open: true, + }, + global: { stubs }, + }) + await flushPromises() + + expect(wrapper.findComponent(GoalPicker).exists()).toBe(false) + }) + + it('показывает GoalPicker для задачи без проекта (Inbox)', async () => { + const wrapper = mount(TaskDetailDialog, { + props: { + task: makeTask({ projectId: null }), + open: true, + }, + global: { stubs }, + }) + await flushPromises() + + expect(wrapper.findComponent(GoalPicker).exists()).toBe(true) + }) + + it('возвращает GoalPicker при переключении проекта обратно в board', async () => { + const projectStore = useProjectStore() + projectStore.projects = [ + makeProject({ id: 'proj-agile', viewMode: 'agile' }), + makeProject({ id: 'proj-board', viewMode: 'board' }), + ] + + const wrapper = mount(TaskDetailDialog, { + props: { + task: makeTask({ projectId: 'proj-agile', goalIds: [1, 2] }), + open: true, + }, + global: { stubs }, + }) + await flushPromises() + + expect(wrapper.findComponent(GoalPicker).exists()).toBe(false) + + await wrapper.setProps({ task: makeTask({ projectId: 'proj-board', goalIds: [1, 2] }) }) + await flushPromises() + + expect(wrapper.findComponent(GoalPicker).exists()).toBe(true) + expect(wrapper.findComponent(GoalPicker).props('modelValue')).toEqual([1, 2]) + }) +}) From a869353f9f9448b1549b0f7164c1200e31590174 Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 13:33:59 +0500 Subject: [PATCH 10/99] fix(project): keep task group on moves that do not send groupId MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit use-board-dnd sends move without groupId, so treating an absent field as "clear it" meant one drag in board mode silently pulled a task out of its epic — an irreversible domain change driven by a display setting, which the design explicitly forbids. Absent groupId now means "leave unchanged", explicit null means "ungroup". The exception is a move to a different project: the group belongs to the old project, so carrying it over would trip trg_task_group_same_project. --- .../project/project-task.service.spec.ts | 74 +++++++++++++++++++ .../modules/project/project-task.service.ts | 15 +++- 2 files changed, 88 insertions(+), 1 deletion(-) diff --git a/alfy-bot/src/modules/project/project-task.service.spec.ts b/alfy-bot/src/modules/project/project-task.service.spec.ts index 3994f21..a53a472 100644 --- a/alfy-bot/src/modules/project/project-task.service.spec.ts +++ b/alfy-bot/src/modules/project/project-task.service.spec.ts @@ -84,6 +84,7 @@ function makeTask(overrides: Partial = {}): Task { checklist: null, projectId: null, columnId: null, + groupId: null, order: 0, pomodoroConfig: null, createdAt: new Date(), @@ -388,6 +389,79 @@ describe('ProjectTaskService — move & reorder', () => { ).rejects.toThrow(NotFoundException); }); + // Обычная board-доска (use-board-dnd) groupId не присылает вообще. + // Если трактовать отсутствие как «обнулить», то переключение проекта из + // agile в board и одно перетаскивание молча выкинут задачу из эпика — + // необратимое доменное действие, завязанное на настройку отображения. + it('сохраняет существующий groupId, если он не пришёл в запросе', async () => { + taskRepo.findById.mockResolvedValue( + makeTask({ projectId: 'proj-1', groupId: 'group-1' }), + ); + projRepo.findById.mockResolvedValue(makeProject({ viewMode: 'board' })); + colRepo.findById.mockResolvedValue(makeColumn()); + groupRepo.findById.mockResolvedValue(makeGroup()); + + await service.moveTask(1, 'proj-1', 'task-1', { + projectId: 'proj-1', + columnId: 'col-1', + order: 0, + }); + + expect(taskRepo.updatePosition).toHaveBeenCalledWith( + 'task-1', + 1, + 'proj-1', + 'col-1', + 'group-1', + 0, + ); + }); + + // Группа принадлежит старому проекту — тащить её за собой нельзя, иначе + // сработает триггер trg_task_group_same_project. + it('обнуляет groupId при переезде в другой проект, даже если он не пришёл', async () => { + taskRepo.findById.mockResolvedValue( + makeTask({ projectId: 'proj-1', groupId: 'group-1' }), + ); + projRepo.findById.mockResolvedValue(makeProject({ id: 'proj-2' })); + + await service.moveTask(1, 'proj-1', 'task-1', { + projectId: 'proj-2', + order: 0, + }); + + expect(taskRepo.updatePosition).toHaveBeenCalledWith( + 'task-1', + 1, + 'proj-2', + null, + null, + 0, + ); + }); + + it('обнуляет groupId, когда null пришёл явно', async () => { + taskRepo.findById.mockResolvedValue(makeTask({ groupId: 'group-1' })); + projRepo.findById.mockResolvedValue(makeProject({ viewMode: 'agile' })); + colRepo.findById.mockResolvedValue(makeColumn()); + + await service.moveTask(1, 'proj-1', 'task-1', { + projectId: 'proj-1', + columnId: 'col-1', + groupId: null, + order: 0, + }); + + expect(taskRepo.updatePosition).toHaveBeenCalledWith( + 'task-1', + 1, + 'proj-1', + 'col-1', + null, + 0, + ); + }); + it('передаёт валидный groupId в updatePosition', async () => { taskRepo.findById.mockResolvedValue(makeTask()); projRepo.findById.mockResolvedValue(makeProject({ viewMode: 'agile' })); diff --git a/alfy-bot/src/modules/project/project-task.service.ts b/alfy-bot/src/modules/project/project-task.service.ts index 8470c41..9ae5938 100644 --- a/alfy-bot/src/modules/project/project-task.service.ts +++ b/alfy-bot/src/modules/project/project-task.service.ts @@ -49,7 +49,20 @@ export class ProjectTaskService { const targetProjectId = dto.projectId !== undefined ? dto.projectId : currentProjectId; const targetColumnId = dto.columnId !== undefined ? dto.columnId : null; - const targetGroupId = dto.groupId !== undefined ? dto.groupId : null; + // Асимметрия с columnId намеренная. Обычная board-доска шлёт move без + // groupId, и трактовка "не пришло значит обнулить" стирала бы эпик у + // задачи после одного перетаскивания в режиме board — то есть настройка + // отображения выполняла бы необратимое доменное действие. Отсутствие + // поля значит "не трогать", явный null значит "убрать из группы". + // Исключение — переезд в другой проект: группа принадлежит старому + // проекту, тащить её за собой нельзя. + const keepsProject = targetProjectId === task.projectId; + const targetGroupId = + dto.groupId !== undefined + ? dto.groupId + : keepsProject + ? task.groupId + : null; // Cannot set column without project if (targetColumnId && !targetProjectId) { From 5c6474c0836aa79e15184f5e9356e32914156749 Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 13:40:34 +0500 Subject: [PATCH 11/99] fix(project): set userId when creating a board group MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Creating any epic or story returned 500: board_groups.userId is NOT NULL and the service never populated it. The whole feature was non-functional through the real API. 449 unit tests missed it because board-group.service.spec.ts mocks the repository, so schema constraints are never exercised there. Coverage for that gap now lives in test/board-groups.e2e-spec.ts, which drives the real HTTP API against a real SQLite schema — reverting this one line turns that suite red. --- .../modules/project/board-group.service.ts | 1 + alfy-bot/test/board-groups.e2e-spec.ts | 197 ++++++++++++++++++ 2 files changed, 198 insertions(+) create mode 100644 alfy-bot/test/board-groups.e2e-spec.ts diff --git a/alfy-bot/src/modules/project/board-group.service.ts b/alfy-bot/src/modules/project/board-group.service.ts index 7a51eb1..566df32 100644 --- a/alfy-bot/src/modules/project/board-group.service.ts +++ b/alfy-bot/src/modules/project/board-group.service.ts @@ -79,6 +79,7 @@ export class BoardGroupService { const nextOrder = siblings.length; return this.groupRepo.create({ + userId, projectId, parentId, type, diff --git a/alfy-bot/test/board-groups.e2e-spec.ts b/alfy-bot/test/board-groups.e2e-spec.ts new file mode 100644 index 0000000..e960502 --- /dev/null +++ b/alfy-bot/test/board-groups.e2e-spec.ts @@ -0,0 +1,197 @@ +import request from 'supertest'; +import { INestApplication } from '@nestjs/common'; +import { createTestApp } from './helpers/test-app'; + +// Эти сценарии живут в e2e, а не в board-group.service.spec.ts, намеренно. +// Сервисный спек мокает репозиторий, поэтому ограничения схемы там не +// проверяются вообще — из-за этого NOT NULL на board_groups.userId проехал +// мимо 449 юнит-тестов, и создание любого эпика падало с 500 на живом API. +describe('Board groups (e2e)', () => { + let app: INestApplication; + let token: string; + let projectId: string; + + beforeAll(async () => { + const ctx = await createTestApp(); + app = ctx.app; + token = ctx.token; + }); + + afterAll(async () => { + await app.close().catch(() => {}); + }); + + const auth = () => `Bearer ${token}`; + + describe('agile-проект', () => { + it('создаётся и засевает три колонки в нужном порядке', async () => { + const { body: project } = await request(app.getHttpServer()) + .post('/api/projects') + .set('Authorization', auth()) + .send({ title: 'Agile e2e', viewMode: 'agile' }) + .expect(201); + + expect(project.viewMode).toBe('agile'); + projectId = project.id; + + const { body: columns } = await request(app.getHttpServer()) + .get(`/api/projects/${projectId}/columns`) + .set('Authorization', auth()) + .expect(200); + + expect(columns.map((c: { title: string }) => c.title)).toEqual([ + 'К выполнению', + 'В работе', + 'Готово', + ]); + }); + + it('list-проект колонок не засевает', async () => { + const { body: project } = await request(app.getHttpServer()) + .post('/api/projects') + .set('Authorization', auth()) + .send({ title: 'List e2e', viewMode: 'list' }) + .expect(201); + + const { body: columns } = await request(app.getHttpServer()) + .get(`/api/projects/${project.id}/columns`) + .set('Authorization', auth()) + .expect(200); + + expect(columns).toEqual([]); + }); + }); + + describe('эпики и истории', () => { + let epicId: string; + let storyId: string; + + it('создаёт эпик — регрессия на NOT NULL userId', async () => { + const { body } = await request(app.getHttpServer()) + .post(`/api/projects/${projectId}/groups`) + .set('Authorization', auth()) + .send({ title: 'Онбординг' }) + .expect(201); + + expect(body).toMatchObject({ + type: 'epic', + parentId: null, + status: 'open', + }); + expect(body.userId).toBeDefined(); + epicId = body.id; + }); + + it('создаёт историю внутри эпика', async () => { + const { body } = await request(app.getHttpServer()) + .post(`/api/projects/${projectId}/groups`) + .set('Authorization', auth()) + .send({ title: 'Экран входа', parentId: epicId }) + .expect(201); + + expect(body).toMatchObject({ type: 'story', parentId: epicId }); + storyId = body.id; + }); + + it('отдаёт дерево: эпик с вложенной историей', async () => { + const { body } = await request(app.getHttpServer()) + .get(`/api/projects/${projectId}/groups`) + .set('Authorization', auth()) + .expect(200); + + expect(body).toHaveLength(1); + expect(body[0].id).toBe(epicId); + expect(body[0].children.map((c: { id: string }) => c.id)).toEqual([ + storyId, + ]); + }); + + it('третий уровень отклоняется с 400, а не с 500', async () => { + await request(app.getHttpServer()) + .post(`/api/projects/${projectId}/groups`) + .set('Authorization', auth()) + .send({ title: 'Третий уровень', parentId: storyId }) + .expect(400); + }); + + it('группа не может стать родителем самой себе — 400', async () => { + await request(app.getHttpServer()) + .patch(`/api/projects/${projectId}/groups/${storyId}`) + .set('Authorization', auth()) + .send({ parentId: storyId }) + .expect(400); + }); + + it('закрытие эпика проставляет completedAt, открытие — обнуляет', async () => { + const { body: done } = await request(app.getHttpServer()) + .patch(`/api/projects/${projectId}/groups/${epicId}`) + .set('Authorization', auth()) + .send({ status: 'done' }) + .expect(200); + expect(done.completedAt).not.toBeNull(); + + const { body: reopened } = await request(app.getHttpServer()) + .patch(`/api/projects/${projectId}/groups/${epicId}`) + .set('Authorization', auth()) + .send({ status: 'open' }) + .expect(200); + expect(reopened.completedAt).toBeNull(); + }); + }); + + describe('задача в ячейке', () => { + let taskId: string; + let columnId: string; + let storyId: string; + + beforeAll(async () => { + const { body: columns } = await request(app.getHttpServer()) + .get(`/api/projects/${projectId}/columns`) + .set('Authorization', auth()); + columnId = columns[1].id; + + const { body: tree } = await request(app.getHttpServer()) + .get(`/api/projects/${projectId}/groups`) + .set('Authorization', auth()); + storyId = tree[0].children[0].id; + + const { body: task } = await request(app.getHttpServer()) + .post('/api/tasks') + .set('Authorization', auth()) + .send({ title: 'OAuth через Telegram', projectId }) + .expect(201); + taskId = task.id; + }); + + it('move проставляет колонку и группу одним запросом', async () => { + const { body } = await request(app.getHttpServer()) + .patch(`/api/projects/${projectId}/tasks/${taskId}/move`) + .set('Authorization', auth()) + .send({ projectId, columnId, groupId: storyId, order: 0 }) + .expect(200); + + expect(body).toMatchObject({ columnId, groupId: storyId }); + }); + + it('move без groupId группу не сбрасывает', async () => { + const { body } = await request(app.getHttpServer()) + .patch(`/api/projects/${projectId}/tasks/${taskId}/move`) + .set('Authorization', auth()) + .send({ projectId, columnId, order: 1 }) + .expect(200); + + expect(body.groupId).toBe(storyId); + }); + + it('перенос во Входящие обнуляет группу без 500', async () => { + const { body } = await request(app.getHttpServer()) + .patch(`/api/tasks/${taskId}/move-to-inbox`) + .set('Authorization', auth()) + .send({}) + .expect(200); + + expect(body.projectId).toBeNull(); + expect(body.groupId).toBeNull(); + }); + }); +}); From da68d0214ae2b6374edb9ffc10fa32c466c00679 Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 13:41:36 +0500 Subject: [PATCH 12/99] docs(task): record verify results for agile board --- docs/tasks/agile-board-epics-stories.md | 50 ++++++++++++++++++++++++- 1 file changed, 49 insertions(+), 1 deletion(-) diff --git a/docs/tasks/agile-board-epics-stories.md b/docs/tasks/agile-board-epics-stories.md index a29b206..00eab5c 100644 --- a/docs/tasks/agile-board-epics-stories.md +++ b/docs/tasks/agile-board-epics-stories.md @@ -306,7 +306,55 @@ TDD (тесты первыми) — фазы 1-4: - **Rollback.** Фича аддитивная: пока пользователь не переключил проект в `agile`, ничего из этого не исполняется. Откат — убрать третью кнопку из `ViewModeToggle`. ## Verify - + +**Result:** passed (после одного провала и починки) + +Positive: +- `POST /projects {viewMode:'agile'}` → 201, `GET .../columns` отдаёт `К выполнению | В работе | Готово` в порядке 0/1/2 +- `POST .../groups {title}` → 201, `type: 'epic'`, `parentId: null` +- `POST .../groups {title, parentId: <эпик>}` → 201, `type: 'story'` +- `GET .../groups` → дерево: эпик с вложенной историей +- `PATCH .../tasks/:id/move {columnId, groupId}` → задача получает оба поля одним запросом +- `PATCH .../groups/:id {status:'done'}` → `completedAt` проставлен, `'open'` → обнулён + +Negative: +- третий уровень (`parentId` = история) → **400**, не 500 +- группа родитель самой себе → **400** +- `move` с `groupId` чужого проекта → 404 + +Invariants (записью напрямую в SQLite, мимо приложения): +- группа под историю → `board_group: parent must be an epic` +- эпик с детьми превратить в историю → `cannot reparent a group that has children` +- `task.groupId` из чужого проекта → `task: group must belong to the same project as the task` +- данные после всех четырёх попыток целы +- в живой БД стоят все 5 триггеров, лог старта: `board_groups/tasks constraint triggers ensured` +- `move` без `groupId` группу сохраняет; `move-to-inbox` обнуляет её и отдаёт 200 + +Smoke: живой бэкенд `PORT=3099 ENABLE_TELEGRAM=false npm run start:dev`, весь путь пройден curl-ом — от создания agile-проекта до переноса задачи во Входящие. + +Notes: первый прогон **провалился** — `POST /projects/:id/groups` отдавал 500: `NOT NULL constraint failed: board_groups.userId`, сервис не проставлял `userId`. То есть создание любого эпика было сломано, а фича целиком нерабочей. 449 юнит-тестов этого не видели, потому что `board-group.service.spec.ts` мокает репозиторий и ограничения схемы там не проверяются в принципе. Починено в `5c6474c`; заодно заведён `test/board-groups.e2e-spec.ts` (11 тестов на реальном HTTP и реальной схеме) — откат той единственной строки красит этот сьют, проверено. + +Отдельно: порт 3002 занят чужим инстансом (dev-сервер пользователя), проверка велась на 3099. Чужой процесс не затронут. ## Conclusion + +### Deviations from plan + +- Фаза 1 дополнительно правит два файла с собственными списками сущностей, которых в плане не было — `typeorm-report-answer.repository.spec.ts` и `test/helpers/test-app.ts`. Оба строят свой `DataSource`, и после появления связи `Task` → `BoardGroup` падали с `Entity metadata for Task#group was not found`. Проверено прямым сравнением: без правки `test-app.ts` e2e даёт именно эту ошибку, с правкой — уходит дальше. + +- Вне плана: коммит `67f0e2a` чинит предсуществующую поломку e2e (все 3 сьюта / 32 теста падали уже на базовом `a93d0e5`). Сделано по явному решению пользователя, чтобы у `up:uverify` был интеграционный сигнал. Причины: SMTP-ключи не заданы в `setup-e2e-env.ts`; `TaskGoalQueryPort` не провайдился в `web-goal-reports-routing.e2e-spec.ts`; список сущностей в `test-app.ts` отстал от `app.module.ts`. После — 32/32 зелёные. + +- Фаза 3: `order` считается в пределах братьев (эпики соревнуются между собой, истории — внутри своего эпика), а не глобально по проекту. План этого не уточнял; без этого `getTree` не смог бы отдать корректный порядок на обоих уровнях. +- Фаза 3: `UpdateGroupDto.parentId` остался ненулевым, поэтому историю нельзя разжаловать обратно в эпик через `parentId: null`. Design такого сценария не требует, перенос истории между эпиками работает. +- Фаза 3: реализатор сознательно не поставил проверку `parentId === id` в сервисе, положившись на CHECK в БД. Это нарушало бы Design — клиент получал бы 500 вместо 400 (подтверждено тестом: сервис возвращал группу с `parentId === id`, отказ приходил только из SQLite). Проверка добавлена диспетчером в тот же коммит, по образцу `project.service.ts:57-59`. +- Фаза 6: правка `TaskPropertyChips.vue` (нет в списке файлов фазы) — добавлен опциональный проп `hideGoals`. Компонент собирает список чипов внутри себя, механизма исключения не было, а без этого чип целей остался бы виден в agile-проекте. +- Фаза 6: `moveTask` трактовал отсутствующий `groupId` как «обнулить», а `use-board-dnd.ts:17` его не шлёт вообще. Значит переключение проекта в режим «Доска» плюс одно перетаскивание молча выкидывали задачу из эпика — необратимое доменное действие, завязанное на настройку отображения, что Design прямо запрещает. Починено отдельным коммитом `a869353`: отсутствие поля значит «не трогать», явный `null` — «убрать из группы», переезд в другой проект — обнулить (группа принадлежит старому проекту). Фикс вскрыл соседний случай: перенесённый `groupId` валидировался против целевого проекта и при переезде дал бы 404 вместо обнуления. +- Фаза 5: `groupId` добавлен во фронтовый тип `Task` (`features/tasks/model/types.ts`), в списке файлов фазы этого не было. Без него раскладка не типизируется, а с бэкенда поле и так приходит. +- Фаза 5: задачи с `columnId === null` не рендерились на доске вообще — все три компонента фильтровали через `if (task.columnId)`. В agile-проекте это массовый случай: задача, созданная обычным добавлением, колонки не получает и просто исчезала бы с доски. Починено отдельным коммитом по образцу `BoardView.vue:97-98`, который для таких задач держит отдельную дорожку. +- Фаза 4: план назвал только `TaskService.update` как путь, где смена проекта обязана обнулять `groupId`. Consistency-проход нашёл второй такой путь — `TaskService.moveToInbox` (`task.service.ts:594`), он обнулял `projectId` и `columnId`, но не `groupId`. Перенос сгруппированной задачи в Inbox упирался бы в `trg_task_group_same_project` и отдавал 500. Тест и фикс добавлены диспетчером в тот же коммит. +- Фаза 2 проверена мутацией, а не только своим спеком: безусловный `RAISE(ABORT)` в триггере на `tasks` роняет 22 e2e-теста, значит триггеры действительно живут в собранном приложении, а не только в изолированном `DataSource` юнит-спека. Побочная находка: мутация «отказывать когда `groupId` не совпадает с проектом» e2e не ломает — задачи в `tasks.e2e-spec.ts` создаются без проекта, поэтому кросс-проектный путь триггера покрыт только юнит-тестом. + +### Known risks + +- **Список сущностей в `test/helpers/test-app.ts` поддерживается руками и уже дважды разошёлся с `app.module.ts`** — на `Link`/`ApiToken`/`AuthMethod`/`PushSubscription` (до этой ветки) и на `BoardGroup` (в фазе 1). Каждый раз это ломает весь e2e-набор целиком и молча, потому что `npm test` его не запускает. Устойчивое лечение — общий экспорт `ALL_ENTITIES` из `shared/entities/index.ts`, используемый и в `app.module.ts`, и в тестах. Не сделано: выходит за скоуп задачи, требует правки `app.module.ts`. From b8861fc52af92881d0b41f4036be4f484cf40ace Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 13:54:56 +0500 Subject: [PATCH 13/99] test(project): cover epic deletion cascade on real data MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Review finding: the plan promised a test that deleting an epic cascades to its stories while its tasks survive with groupId nulled, but nothing exercised it — the unit test only asserted the repository mock was called and attributed the cascade to the FK without ever proving it. Deleting an epic is destructive, so "the FK probably handles it" is not good enough: a foreign_keys pragma being off, or a wrong onDelete, would take the user's tasks with it. --- .../project/board-group.service.spec.ts | 5 +- alfy-bot/test/board-groups.e2e-spec.ts | 61 +++++++++++++++++++ 2 files changed, 65 insertions(+), 1 deletion(-) diff --git a/alfy-bot/src/modules/project/board-group.service.spec.ts b/alfy-bot/src/modules/project/board-group.service.spec.ts index 6f28820..8e0a075 100644 --- a/alfy-bot/src/modules/project/board-group.service.spec.ts +++ b/alfy-bot/src/modules/project/board-group.service.spec.ts @@ -320,7 +320,10 @@ describe('BoardGroupService', () => { // ── delete ────────────────────────────────────────────────────── describe('delete', () => { - it('удаляет группу (каскад историй/обнуление groupId у задач обеспечен FK)', async () => { + // Сам каскад (истории удаляются, задачи выживают с groupId = null) + // проверяется на реальных данных в test/board-groups.e2e-spec.ts — + // здесь репозиторий замокан, поведение БД тут непроверяемо. + it('делегирует удаление репозиторию', async () => { projRepo.findById.mockResolvedValue(makeProject()); await service.delete(1, 'proj-1', 'epic-1'); diff --git a/alfy-bot/test/board-groups.e2e-spec.ts b/alfy-bot/test/board-groups.e2e-spec.ts index e960502..cc71d1b 100644 --- a/alfy-bot/test/board-groups.e2e-spec.ts +++ b/alfy-bot/test/board-groups.e2e-spec.ts @@ -183,6 +183,67 @@ describe('Board groups (e2e)', () => { expect(body.groupId).toBe(storyId); }); + // Разрушающая операция: если PRAGMA foreign_keys окажется выключенным + // или onDelete не тем, пользователь потеряет задачи вместе с эпиком. + // Юнит-спек это не ловит — там репозиторий замокан. + it('удаление эпика уносит истории, но задачи выживают с groupId = null', async () => { + const { body: epic } = await request(app.getHttpServer()) + .post(`/api/projects/${projectId}/groups`) + .set('Authorization', auth()) + .send({ title: 'Биллинг' }) + .expect(201); + + const { body: story } = await request(app.getHttpServer()) + .post(`/api/projects/${projectId}/groups`) + .set('Authorization', auth()) + .send({ title: 'Тарифы', parentId: epic.id }) + .expect(201); + + const makeTaskIn = async (title: string, groupId: string) => { + const { body: task } = await request(app.getHttpServer()) + .post('/api/tasks') + .set('Authorization', auth()) + .send({ title, projectId }) + .expect(201); + await request(app.getHttpServer()) + .patch(`/api/projects/${projectId}/tasks/${task.id}/move`) + .set('Authorization', auth()) + .send({ projectId, groupId, order: 0 }) + .expect(200); + return task.id as string; + }; + + const taskUnderStory = await makeTaskIn('Страница тарифов', story.id); + const taskUnderEpic = await makeTaskIn('Аналитика конверсии', epic.id); + + await request(app.getHttpServer()) + .delete(`/api/projects/${projectId}/groups/${epic.id}`) + .set('Authorization', auth()) + .expect(200); + + const { body: tree } = await request(app.getHttpServer()) + .get(`/api/projects/${projectId}/groups`) + .set('Authorization', auth()) + .expect(200); + const remaining = tree.flatMap((e: { id: string; children: { id: string }[] }) => [ + e.id, + ...e.children.map((c) => c.id), + ]); + expect(remaining).not.toContain(epic.id); + expect(remaining).not.toContain(story.id); + + const { body: tasks } = await request(app.getHttpServer()) + .get('/api/tasks') + .set('Authorization', auth()) + .expect(200); + + for (const id of [taskUnderStory, taskUnderEpic]) { + const survivor = tasks.find((t: { id: string }) => t.id === id); + expect(survivor).toBeDefined(); + expect(survivor.groupId).toBeNull(); + } + }); + it('перенос во Входящие обнуляет группу без 500', async () => { const { body } = await request(app.getHttpServer()) .patch(`/api/tasks/${taskId}/move-to-inbox`) From 5914a77c7e643cc51759b9b11db07147a7d38ddb Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 13:55:24 +0500 Subject: [PATCH 14/99] docs(task): conclude agile board epics and stories --- docs/tasks/agile-board-epics-stories.md | 28 +++++++++++++++++++++++-- 1 file changed, 26 insertions(+), 2 deletions(-) diff --git a/docs/tasks/agile-board-epics-stories.md b/docs/tasks/agile-board-epics-stories.md index 00eab5c..8fbc809 100644 --- a/docs/tasks/agile-board-epics-stories.md +++ b/docs/tasks/agile-board-epics-stories.md @@ -1,6 +1,6 @@ # Agile-доска: эпики и истории (этап 1 — отображение) -**Status:** executing +**Status:** done **Branch:** feat/agile-board **Worktree:** .worktrees/feat-agile-board **Mode:** interactive @@ -337,7 +337,31 @@ Notes: первый прогон **провалился** — `POST /projects/:i Отдельно: порт 3002 занят чужим инстансом (dev-сервер пользователя), проверка велась на 3099. Чужой процесс не затронут. ## Conclusion - + +Outcome: Agile-доска этапа 1 реализована и работает на живом API — `b8861fc`. + +Invariants: +- Глубина ровно 2, эпик нельзя прикрепить к истории — 400 через API, `RAISE(ABORT)` при записи напрямую в SQLite мимо приложения. +- Группе с детьми нельзя проставить `parentId` — триггер, проверено прямой записью. +- `parentId <> id` — 400 в сервисе (не 500), плюс CHECK в схеме. +- `parentId IS NULL` ⟺ `type = 'epic'` — CHECK, выводится сервером, клиент `type` не присылает. +- `group.projectId` = `task.projectId`; перенос в другой проект обнуляет `groupId` — триггер плюс три пути в коде (`update`, `moveToInbox`, `moveTask`). +- Удаление эпика уносит истории, но не задачи — проверено на реальных данных в e2e. +- Задача без `groupId` и задача без `columnId` рендерятся, а не исчезают — компонентный тест. +- Заголовки колонок один раз на доску, скролл-контейнер ровно один — компонентные тесты-сторожа. +- `status = 'done'` только явным действием — e2e на `completedAt` в обе стороны. +- Гварды `viewMode === 'list'` продолжают работать, `agile` проходит их как `board`. + +Review findings: +- Important: план обещал тест на каскад удаления эпика, но каскад не проверялся нигде — юнит-тест лишь убеждался, что у мока дёрнули `delete`, а корректность приписывалась FK без доказательства. Закрыто в `b8861fc` e2e-тестом на реальных данных; заодно исправлен вводивший в заблуждение комментарий в юнит-спеке. + +Future work: +- Экран бэклога и спринты (`Sprint`, `Task.sprintId`, фильтр доски). Обоснование: Design, раздел «Скоуп этапа 1» — явно вынесено в этап 2. +- Хлебные крошки «Проект › Эпик › История» в диалоге задачи. Обоснование: решение 4 в Design — «пока нет, дальше посмотрим»; `groupId` уже приходит в обычной выдаче задач, поэтому отдельного запроса это не потребует. +- Явный флаг проекта вместо `viewMode` как признака agile. Обоснование: раздел «Осталось открытым» — сознательно отложенное решение. +- Общий экспорт `ALL_ENTITIES` вместо руками поддерживаемого списка сущностей в `test/helpers/test-app.ts`. Обоснование: новый факт, обнаруженный по ходу — список разошёлся с `app.module.ts` дважды за одну задачу и оба раза молча ронял весь e2e-набор. + +Verified by: смоук на живом бэкенде (`PORT=3099`), включая запись напрямую в SQLite мимо приложения для проверки триггеров; мутационная проверка, что триггеры действительно активны в собранном приложении. ### Deviations from plan From 5d9ee7809bdadf732a89f438456bb21b769f5620 Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Wed, 19 Aug 2026 13:56:16 +0500 Subject: [PATCH 15/99] docs: note SQLite trigger fragility, mock-spec blind spot, agile board layout rules --- CLAUDE.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index f981c3b..9e6a0d4 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -89,6 +89,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`) сделано триггерами с `RAISE(ABORT, ...)`. Триггеры не описываются декораторами TypeORM, `synchronize` их не создаёт, а при изменении схемы SQLite пересоздаёт таблицу (rename → create → copy → drop) и **молча роняет все триггеры на ней**. Поэтому `CREATE TRIGGER IF NOT EXISTS` выполняется на каждом старте идемпотентным сервисом — `shared/database/board-group-constraints.service.ts`. Заводя новый триггер, клади его туда же и покрывай тестом на пересоздание таблицы, иначе защита однажды исчезнет при правке соседнего поля. + +**Мокающие спеки не видят ограничений схемы.** `*.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`. # Frontend architecture (FSD-like) @@ -113,6 +119,8 @@ 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-доска: колонки задаёт проект, вложенность рисуется поверх сетки.** У проекта три режима — `list`, `board`, `agile`. В `agile` эпики и истории (`BoardGroup`, self-nesting ровно на два уровня) — это вложенные рамки **поверх** сквозной колоночной сетки, а не собственные мини-доски: заголовки колонок рендерятся один раз на всю доску, вложенные блоки наследуют сетку через `grid-template-columns: subgrid`. Горизонтальный скролл-контейнер на доске **ровно один** — если дать скролл каждой истории, они разъедутся и колонки перестанут быть сквозными. Оба правила закрыты тестами-сторожами в `tests/features/projects/ui/AgileBoardView.spec.ts`. Задача без `groupId` и задача без `columnId` — нормальные состояния, они попадают в блок «Без эпика» и дорожку «Без колонки», а не исчезают. + ## Drag-and-drop (две системы — выбирать по контексту) В кодбазе сосуществуют два независимых DnD-стека. Не смешивать. From 4847aecba74a6c5503e8ff21cf715e28c069fb86 Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Thu, 20 Aug 2026 08:35:05 +0500 Subject: [PATCH 16/99] fix(projects): make the whole agile cell accept a drop MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The sortable list inside a cell sized itself to its content, so an empty cell in a row 88px tall accepted drops only in a 20px strip at the top — 68px of dead zone. Aiming at the visibly empty cell of another column dropped the card outside any list and it snapped back, which reads as "tasks don't move between columns". Measured before: cellH 88 / dropH 20. After: cellH 88 / dropH 76 (the remaining 12px is the cell's own padding). --- alfy-bot-frontend/src/features/projects/ui/AgileCell.vue | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/alfy-bot-frontend/src/features/projects/ui/AgileCell.vue b/alfy-bot-frontend/src/features/projects/ui/AgileCell.vue index 026a1f4..07054de 100644 --- a/alfy-bot-frontend/src/features/projects/ui/AgileCell.vue +++ b/alfy-bot-frontend/src/features/projects/ui/AgileCell.vue @@ -21,14 +21,17 @@ function handleChange(event: any) {