diff --git a/README.md b/README.md index 86ee818..f70f3ac 100644 --- a/README.md +++ b/README.md @@ -13,7 +13,7 @@ - **📱 Три поверхности, один бэкенд.** Telegram-бот (telegraf), Telegram WebApp и обычный SPA — всё работает поверх одного REST API. Веб собран как PWA (offline, web-push, установка на домашний экран). - **🧱 Чистая архитектура.** Бэкенд — Clean Architecture по модулям (порты в `domain/`, адаптеры в `infrastructure/`, оркестрация в сервисах). Фронтенд — Feature-Sliced Design. Границы слоёв реальны, а не декоративны. - **🌍 Корректные таймзоны и локали.** Все операции с датами уважают IANA-таймзону пользователя; даты в БД хранятся в UTC и сдвигаются к wall-clock пользователя на границе домена. Календарь, локаль и первый день недели — из настроек пользователя. -- **🗓 Богатый UI задач.** Inbox, проекты со списками и board-колонками, повторяющиеся задачи, календарь с drag-create по сетке часов, Pomodoro-таймер, два независимых drag-and-drop-движка (кастомный на PointerEvents + vuedraggable). Agile-проекты включают эпики, истории, спринты и релизы; историю можно перенести в спринт целиком с задачами через меню или drag-and-drop. Стрелки ↑/↓ прямо на доске меняют порядок эпиков и историй внутри эпика; порядок сохраняется после перезагрузки. +- **🗓 Богатый UI задач.** Inbox, проекты со списками и board-колонками, повторяющиеся задачи, календарь с drag-create по сетке часов, Pomodoro-таймер, два независимых drag-and-drop-движка (кастомный на PointerEvents + vuedraggable). Agile-проекты включают эпики, истории, спринты и релизы; историю можно перенести в спринт целиком с задачами через меню или drag-and-drop. Стрелки ↑/↓ прямо на доске меняют порядок эпиков и историй внутри эпика; порядок сохраняется после перезагрузки. На доске отображаются группы текущего спринта. Историю или целый эпик можно вернуть в бэклог через меню или MCP `remove_group_from_sprint`: структура сохраняется, задачи других спринтов не меняются. - **🔔 Уведомления.** Web-push (VAPID) с подписками на устройство. --- diff --git a/alfy-bot-frontend/src/features/projects/api/sprints-api.ts b/alfy-bot-frontend/src/features/projects/api/sprints-api.ts index fd4e7ab..b18a79c 100644 --- a/alfy-bot-frontend/src/features/projects/api/sprints-api.ts +++ b/alfy-bot-frontend/src/features/projects/api/sprints-api.ts @@ -30,3 +30,8 @@ export function startSprint(projectId: string, id: string, data: StartSprintPayl export function completeSprint(projectId: string, id: string, data: CompleteSprintPayload) { return api.post(`/projects/${projectId}/sprints/${id}/complete`, data) } + +/** Возвращает задачи и назначения группы из указанного спринта в бэклог; updated — число задач. */ +export function removeGroupFromSprint(projectId: string, sprintId: string, groupId: string) { + return api.post<{ updated: number }>(`/projects/${projectId}/sprints/${sprintId}/groups/${groupId}/backlog`) +} diff --git a/alfy-bot-frontend/src/features/projects/model/sprint-store.ts b/alfy-bot-frontend/src/features/projects/model/sprint-store.ts index f9f5ece..bf78af1 100644 --- a/alfy-bot-frontend/src/features/projects/model/sprint-store.ts +++ b/alfy-bot-frontend/src/features/projects/model/sprint-store.ts @@ -39,6 +39,13 @@ export const useSprintStore = defineStore('sprints', () => { return data.updated } + /** Возвращает группу из указанного спринта в бэклог и обновляет назначения; возвращает число задач. */ + async function removeGroupFromSprint(projectId: string, sprintId: string, groupId: string): Promise { + const { data } = await sprintsApi.removeGroupFromSprint(projectId, sprintId, groupId) + await refreshAssignments(projectId) + return data.updated + } + /** Все спринты проекта, включая завершённые, в порядке `order`. Для незагруженного проекта — `[]`. */ function sprintsOf(projectId: string): Sprint[] { return lists.value[projectId] ?? [] @@ -215,6 +222,7 @@ export const useSprintStore = defineStore('sprints', () => { } return { + removeGroupFromSprint, setStorySprint, lists, error, diff --git a/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue b/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue index 1a11730..0b67363 100644 --- a/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue +++ b/alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue @@ -7,6 +7,7 @@ import { storeToRefs } from 'pinia' import { computed, ref, watch } from 'vue' import { useTaskStore } from '@/features/tasks/model/task-store' import { buildAgileRows, groupTasksByColumn } from '../lib/agile-layout' +import { apiErrorMessage } from '../lib/api-error' import { useAgileDnd } from '../lib/use-agile-dnd' import { useGroupDeletion } from '../lib/use-group-deletion' import { useColumnStore } from '../model/column-store' @@ -42,6 +43,9 @@ const { onTaskChange } = useAgileDnd(taskStore) const { deleteGroupWithConfirm } = useGroupDeletion() const groupDetail = useGroupDetail() +const returningToBacklog = ref(false) +const backlogError = ref(null) +const creationNotice = ref(null) const addingEpic = ref(false) const reordering = ref(false) const reorderError = ref(null) @@ -59,6 +63,41 @@ const sprintBoardTasks = computed(() => { return tasks.value.filter(t => t.projectId === props.projectId && t.sprintId === sprintId) }) +const backlogGroupIds = computed(() => { + const sprintId = activeSprint.value?.id + if (!sprintId) + return [] + const ids = new Set(sprintBoardTasks.value.map(task => task.groupId)) + for (const epic of groupStore.groupsOf(props.projectId)) { + for (const story of epic.children) { + if (story.sprintId === sprintId) + ids.add(story.id) + if (ids.has(story.id)) + ids.add(epic.id) + } + } + return [...ids].filter((id): id is string => typeof id === 'string') +}) + +async function handleReturnToBacklog(group: BoardGroupNode) { + const sprintId = activeSprint.value?.id + if (!sprintId || returningToBacklog.value || !backlogGroupIds.value.includes(group.id)) + return + const projectId = props.projectId + returningToBacklog.value = true + backlogError.value = null + try { + await sprintStore.removeGroupFromSprint(projectId, sprintId, group.id) + } + catch (err) { + if (props.projectId === projectId && activeSprint.value?.id === sprintId) + backlogError.value = apiErrorMessage(err, 'Не удалось вернуть группу в бэклог') + } + finally { + returningToBacklog.value = false + } +} + const projectTasks = computed(() => sprintBoardTasks.value.filter(t => (props.showCompleted || !t.completed) @@ -68,7 +107,11 @@ const projectTasks = computed(() => const lanes = computed(() => sortedColumns.value) -const rows = computed(() => buildAgileRows(groupStore.groupsOf(props.projectId), projectTasks.value)) +const sprintGroups = computed(() => groupStore.groupsOf(props.projectId) + .filter(epic => backlogGroupIds.value.includes(epic.id)) + .map(epic => ({ ...epic, children: epic.children.filter(story => backlogGroupIds.value.includes(story.id)) }))) + +const rows = computed(() => buildAgileRows(sprintGroups.value, projectTasks.value)) const epicRows = computed(() => rows.value.filter((row): row is AgileEpicRow => row.kind === 'epic'), @@ -95,12 +138,15 @@ async function handleMoveGroup(group: BoardGroupNode, direction: -1 | 1) { const siblings = [...(group.parentId ? tree.find(epic => epic.id === group.parentId)?.children ?? [] : tree)] .sort((a, b) => a.order - b.order) const index = siblings.findIndex(sibling => sibling.id === group.id) - const targetIndex = index + direction - if (index < 0 || targetIndex < 0 || targetIndex >= siblings.length) + const visibleSiblings = siblings.filter(sibling => backlogGroupIds.value.includes(sibling.id)) + const visibleIndex = visibleSiblings.findIndex(sibling => sibling.id === group.id) + const target = visibleSiblings[visibleIndex + direction] + if (index < 0 || visibleIndex < 0 || !target) return + const targetIndex = siblings.findIndex(sibling => sibling.id === target.id) const orderedIds = siblings.map(sibling => sibling.id) - const targetId = orderedIds[targetIndex]! + const targetId = target.id orderedIds[targetIndex] = group.id orderedIds[index] = targetId reordering.value = true @@ -134,12 +180,41 @@ async function handleSetGroupColor(id: string, color: string | null) { } async function handleCreateStory(epicId: string, title: string) { - await groupStore.createGroup(props.projectId, { title, parentId: epicId }) + const sprintId = activeSprint.value?.id + if (!sprintId) + return + const projectId = props.projectId + backlogError.value = null + let created = false + try { + const story = await groupStore.createGroup(projectId, { title, parentId: epicId }) + created = true + await sprintStore.setStorySprint(projectId, story.id, sprintId) + } + catch (err) { + if (props.projectId === projectId) { + const reason = apiErrorMessage(err, 'Попробуйте ещё раз') + backlogError.value = created ? `История создана. ${reason}. Проверьте её назначение в бэклоге.` : `Не удалось создать историю: ${reason}` + } + } } async function handleCreateEpic(title: string) { addingEpic.value = false - await groupStore.createGroup(props.projectId, { title }) + const projectId = props.projectId + backlogError.value = null + creationNotice.value = null + try { + const epic = await groupStore.createGroup(projectId, { title }) + if (props.projectId === projectId) { + creationNotice.value = 'Эпик создан в бэклоге. Добавьте его задачи или истории в спринт, чтобы он появился на доске.' + groupDetail.open(projectId, epic.id) + } + } + catch (err) { + if (props.projectId === projectId) + backlogError.value = apiErrorMessage(err, 'Не удалось создать эпик') + } } async function handleCreateTask(groupId: string, title: string) { @@ -167,6 +242,8 @@ function handleTaskChange(event: any, columnId: string, groupId: string | null, watch(() => props.projectId, (id) => { reorderError.value = null + backlogError.value = null + creationNotice.value = null if (id) { columnStore.fetchColumns(id) groupStore.fetchGroups(id) @@ -179,6 +256,12 @@ watch(() => props.projectId, (id) => {
+

+ {{ creationNotice }} +

+ @@ -209,6 +292,9 @@ watch(() => props.projectId, (id) => { :can-move-up="index > 0" :can-move-down="index < epicRows.length - 1" :reordering="reordering" + :backlog-group-ids="backlogGroupIds" + :returning-to-backlog="returningToBacklog" + @return-to-backlog="handleReturnToBacklog" @move-group="handleMoveGroup" @toggle-task="$emit('toggleTask', $event)" @open-task="$emit('openTask', $event)" diff --git a/alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue b/alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue index debe04a..0bc0cf2 100644 --- a/alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue +++ b/alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue @@ -20,9 +20,12 @@ const props = defineProps<{ canMoveUp?: boolean canMoveDown?: boolean reordering?: boolean + backlogGroupIds?: string[] + returningToBacklog?: boolean }>() const emit = defineEmits<{ + returnToBacklog: [group: BoardGroupNode] moveGroup: [group: BoardGroupNode, direction: -1 | 1] toggleTask: [id: string] openTask: [task: Task] @@ -132,6 +135,9 @@ function handleCreateStory(title: string) { () const emit = defineEmits<{ + returnToBacklog: [group: BoardGroupNode] moveGroup: [group: BoardGroupNode, direction: -1 | 1] toggleTask: [id: string] openTask: [task: Task] @@ -90,6 +93,9 @@ function handleCreateTask(title: string) { () const emit = defineEmits<{ + returnToBacklog: [] open: [] rename: [] setColor: [color: string | null] @@ -136,6 +139,14 @@ function onCloseAutoFocus(event: Event) { {{ toggleDoneLabel }} + + + Вернуть в бэклог + ({ api: { post: vi.fn() } })) + +it('возврат группы отправляет один POST с исходным спринтом без тела', async () => { + vi.mocked(api.post).mockResolvedValueOnce({ data: { updated: 4 } }) + const response = await removeGroupFromSprint('project', 'sprint', 'group') + expect(api.post).toHaveBeenCalledExactlyOnceWith('/projects/project/sprints/sprint/groups/group/backlog') + expect(response.data.updated).toBe(4) +}) diff --git a/alfy-bot-frontend/tests/features/projects/model/sprint-store.spec.ts b/alfy-bot-frontend/tests/features/projects/model/sprint-store.spec.ts index 1b19807..1c8f14f 100644 --- a/alfy-bot-frontend/tests/features/projects/model/sprint-store.spec.ts +++ b/alfy-bot-frontend/tests/features/projects/model/sprint-store.spec.ts @@ -15,6 +15,7 @@ vi.mock('@/features/projects/api/sprints-api', () => ({ deleteSprint: vi.fn(), startSprint: vi.fn(), completeSprint: vi.fn(), + removeGroupFromSprint: vi.fn(), })) vi.mock('@/features/projects/api/groups-api', () => ({ setGroupSprint: vi.fn(), fetchGroups: vi.fn() })) @@ -85,6 +86,31 @@ describe('useSprintStore', () => { expect(store.error).toContain('Сеть недоступна') }) + it('возвращает группу из выбранного спринта и перечитывает назначения', async () => { + vi.mocked(sprintsApi.removeGroupFromSprint).mockResolvedValueOnce({ data: { updated: 3 } } as any) + await expect(useSprintStore().removeGroupFromSprint('proj-a', 's1', 'epic')).resolves.toBe(3) + expect(sprintsApi.removeGroupFromSprint).toHaveBeenCalledWith('proj-a', 's1', 'epic') + expect(useTaskStore().fetchTasks).toHaveBeenCalledOnce() + expect(useGroupStore().fetchGroups).toHaveBeenCalledWith('proj-a') + }) + + it('не меняет назначения и не перечитывает данные при отказе возврата', async () => { + useTaskStore().tasks = [makeTask({ sprintId: 's1' })] + vi.mocked(sprintsApi.removeGroupFromSprint).mockRejectedValueOnce(new Error('Спринт закрыт')) + await expect(useSprintStore().removeGroupFromSprint('proj-a', 's1', 'epic')).rejects.toThrow('Спринт закрыт') + expect(useTaskStore().tasks[0]!.sprintId).toBe('s1') + expect(useTaskStore().fetchTasks).not.toHaveBeenCalled() + expect(useGroupStore().fetchGroups).not.toHaveBeenCalled() + }) + + it('различает сохранённый возврат и ошибку обновления данных', async () => { + vi.mocked(sprintsApi.removeGroupFromSprint).mockResolvedValueOnce({ data: { updated: 1 } } as any) + vi.mocked(useTaskStore().fetchTasks).mockImplementationOnce(async () => { + useTaskStore().error = 'Сеть недоступна' + }) + await expect(useSprintStore().removeGroupFromSprint('proj-a', 's1', 'story')).rejects.toThrow('Изменения сохранены, но не удалось обновить данные: Сеть недоступна') + }) + it('загрузка проекта B не меняет sprintsOf(A)', async () => { const store = useSprintStore() await load(store, 'proj-a', [makeSprint({ id: 'a1' })]) diff --git a/alfy-bot-frontend/tests/features/projects/ui/AgileBoardView.spec.ts b/alfy-bot-frontend/tests/features/projects/ui/AgileBoardView.spec.ts index b86ccce..553c620 100644 --- a/alfy-bot-frontend/tests/features/projects/ui/AgileBoardView.spec.ts +++ b/alfy-bot-frontend/tests/features/projects/ui/AgileBoardView.spec.ts @@ -14,6 +14,7 @@ import { useGroupDetail } from '@/features/projects/model/use-group-detail' import AgileBoardView from '@/features/projects/ui/AgileBoardView.vue' import AgileEpicBlock from '@/features/projects/ui/AgileEpicBlock.vue' import AgileStoryBlock from '@/features/projects/ui/AgileStoryBlock.vue' +import GroupActionsMenu from '@/features/projects/ui/GroupActionsMenu.vue' import { useTaskStore } from '@/features/tasks/model/task-store' vi.mock('@/features/projects/api/columns-api', () => ({ @@ -130,6 +131,112 @@ describe('agileBoardView', () => { }) } + it('возврат истории передаёт активный спринт и блокирует повтор до ответа', async () => { + const story = makeEpic({ id: 'story-1', type: 'story', parentId: 'epic-1', sprintId: 'sprint-1' }) + const wrapper = setup([makeColumn()], [makeEpic({ children: [story] })], []) + await flushPromises() + let resolve!: (value: number) => void + const remove = vi.spyOn(useSprintStore(), 'removeGroupFromSprint').mockImplementation(() => new Promise((done) => { + resolve = done + })) + const menu = wrapper.findAllComponents(GroupActionsMenu).find(item => item.props('group').id === story.id)! + expect(menu.props('canReturnToBacklog')).toBe(true) + menu.vm.$emit('returnToBacklog') + menu.vm.$emit('returnToBacklog') + await wrapper.vm.$nextTick() + expect(remove).toHaveBeenCalledExactlyOnceWith('proj-1', 'sprint-1', 'story-1') + expect(menu.props('returningToBacklog')).toBe(true) + expect(useGroupStore().groupsOf('proj-1')[0]!.children[0]!.sprintId).toBe('sprint-1') + resolve(0) + await flushPromises() + expect(menu.props('returningToBacklog')).toBe(false) + wrapper.unmount() + }) + + it('эпик доступен для возврата по скрытой выполненной задаче дочерней истории', async () => { + const story = makeEpic({ id: 'story-1', type: 'story', parentId: 'epic-1' }) + const wrapper = setup([makeColumn()], [makeEpic({ children: [story] })], [makeTask({ groupId: story.id, completed: true })]) + await wrapper.setProps({ showCompleted: false }) + await flushPromises() + const remove = vi.spyOn(useSprintStore(), 'removeGroupFromSprint').mockResolvedValue(1) + const menu = wrapper.findComponent(GroupActionsMenu) + expect(menu.props('canReturnToBacklog')).toBe(true) + menu.vm.$emit('returnToBacklog') + await flushPromises() + expect(remove).toHaveBeenCalledWith('proj-1', 'sprint-1', 'epic-1') + wrapper.unmount() + }) + + it.each([ + { response: { data: { message: 'Спринт закрыт' } } }, + new Error('Изменения сохранены, но не удалось обновить данные: Сеть недоступна'), + ])('показывает точную ошибку возврата без удаления структуры', async (error) => { + const wrapper = setup([makeColumn()], [makeEpic()], [makeTask({ groupId: 'epic-1' })]) + await flushPromises() + vi.spyOn(useSprintStore(), 'removeGroupFromSprint').mockRejectedValue(error) + wrapper.findComponent(GroupActionsMenu).vm.$emit('returnToBacklog') + await flushPromises() + expect(wrapper.get('[role="alert"]').text()).toBe(error instanceof Error ? error.message : error.response.data.message) + expect(wrapper.findComponent(AgileEpicBlock).exists()).toBe(true) + wrapper.unmount() + }) + + it('не предлагает возврат групп без назначений в активном спринте', async () => { + const story = makeEpic({ id: 'story-1', type: 'story', parentId: 'epic-1', sprintId: 'other' }) + const wrapper = setup([makeColumn()], [makeEpic({ children: [story] })], [makeTask({ groupId: story.id, sprintId: 'other' })]) + await flushPromises() + expect(wrapper.findAllComponents(GroupActionsMenu).every(menu => !menu.props('canReturnToBacklog'))).toBe(true) + useSprintStore().lists['proj-1'] = [] + await wrapper.vm.$nextTick() + expect(wrapper.findAllComponents(GroupActionsMenu).every(menu => !menu.props('canReturnToBacklog'))).toBe(true) + wrapper.unmount() + }) + + it('показывает только группы спринта и сохраняет назначенные пустые истории', async () => { + const assigned = makeEpic({ id: 'assigned', type: 'story', parentId: 'epic-1', sprintId: 'sprint-1' }) + const byTask = makeEpic({ id: 'by-task', type: 'story', parentId: 'epic-1', sprintId: 'other' }) + const backlog = makeEpic({ id: 'backlog', type: 'story', parentId: 'epic-1', sprintId: null }) + const wrapper = setup([makeColumn()], [makeEpic({ children: [assigned, byTask, backlog] }), makeEpic({ id: 'empty' }), makeEpic({ id: 'direct' })], [makeTask({ groupId: 'by-task', completed: true }), makeTask({ id: 'direct-task', groupId: 'direct' })]) + await wrapper.setProps({ showCompleted: false }) + await flushPromises() + expect(wrapper.findAllComponents(AgileEpicBlock).map(c => c.props('epic').id)).toEqual(['epic-1', 'direct']) + expect(wrapper.findAllComponents(AgileStoryBlock).map(c => c.props('story').id)).toEqual(['assigned', 'by-task']) + wrapper.unmount() + }) + + it('после успешного возврата история и пустой эпик исчезают из доски, но остаются в дереве', async () => { + const story = makeEpic({ id: 'story-1', type: 'story', parentId: 'epic-1', sprintId: 'sprint-1' }) + const wrapper = setup([makeColumn()], [makeEpic({ children: [story] })], []) + await flushPromises() + vi.spyOn(useSprintStore(), 'removeGroupFromSprint').mockImplementationOnce(async () => { + useGroupStore().trees['proj-1'] = [makeEpic({ children: [{ ...story, sprintId: null }] })] + return 0 + }) + wrapper.findAllComponents(GroupActionsMenu)[1]!.vm.$emit('returnToBacklog') + await flushPromises() + expect(wrapper.findAllComponents(AgileEpicBlock)).toHaveLength(0) + expect(useGroupStore().groupsOf('proj-1')[0]!.children).toHaveLength(1) + wrapper.unmount() + }) + + it.each([false, true])('создание истории назначает её в активный спринт, ошибка назначения видна (%s)', async (fail) => { + const wrapper = setup([makeColumn()], [makeEpic()], [makeTask({ groupId: 'epic-1' })]) + await flushPromises() + const story = makeEpic({ id: 'new-story', type: 'story', parentId: 'epic-1' }) + vi.mocked(groupsApi.createGroup).mockResolvedValueOnce({ data: story } as any) + const assign = vi.spyOn(useSprintStore(), 'setStorySprint') + if (fail) + assign.mockRejectedValueOnce(new Error('Спринт закрыт')) + else + assign.mockResolvedValueOnce(0) + wrapper.findComponent(AgileEpicBlock).vm.$emit('createStory', 'epic-1', 'История') + await flushPromises() + expect(assign).toHaveBeenCalledWith('proj-1', 'new-story', 'sprint-1') + if (fail) + expect(wrapper.get('[role="alert"]').text()).toContain('История создана. Спринт закрыт') + wrapper.unmount() + }) + it('не показывает на доске задачу истории/эпика с columnId === null — у ячейки доски всегда есть колонка', async () => { const story = makeEpic({ id: 'story-1', type: 'story', parentId: 'epic-1' }) const epic = makeEpic({ id: 'epic-1', children: [story] }) @@ -315,6 +422,7 @@ describe('agileBoardView — управление на доске', () => { title: `История ${n}-${m}`, type: 'story', parentId: `epic-${n}`, + sprintId: 'sprint-1', order: m - 1, })), })) @@ -339,6 +447,19 @@ describe('agileBoardView — управление на доске', () => { expect(wrapper.findAll('.sticky.top-0')).toHaveLength(1) }) + it('стрелка переставляет видимых соседей через скрытые группы, сохраняя полный порядок', async () => { + const groups = orderedGroups() + groups[1]!.children.forEach(story => story.sprintId = null) + vi.mocked(groupsApi.reorderGroups).mockResolvedValue({} as any) + const wrapper = setup([makeColumn()], groups, []) + await flushPromises() + await wrapper.get('button[aria-label="Переместить эпик Эпик 1 ниже"]').trigger('click') + await flushPromises() + expect(groupsApi.reorderGroups).toHaveBeenCalledWith('proj-1', ['epic-3', 'epic-2', 'epic-1', 'epic-4']) + expect(wrapper.findAllComponents(AgileEpicBlock).map(c => c.props('epic').id)).toEqual(['epic-3', 'epic-1', 'epic-4']) + wrapper.unmount() + }) + it('стрелки историй меняют порядок только внутри их эпика', async () => { vi.mocked(groupsApi.reorderGroups).mockResolvedValue({} as any) const wrapper = setup([makeColumn()], orderedGroups(), []) @@ -399,6 +520,10 @@ describe('agileBoardView — управление на доске', () => { await wrapper.vm.$nextTick() expect(groupsApi.createGroup).toHaveBeenCalledWith('proj-1', { title: 'Новый эпик' }) + await flushPromises() + expect(useGroupDetail().current.value).toEqual({ projectId: 'proj-1', groupId: 'epic-new' }) + expect(wrapper.get('[role="status"]').text()).toContain('Эпик создан в бэклоге') + expect(wrapper.findComponent(AgileEpicBlock).exists()).toBe(false) }) it('«+» у эпика создаёт задачу с groupId эпика и первой колонкой доски', async () => { @@ -409,7 +534,7 @@ describe('agileBoardView — управление на доске', () => { const wrapper = setup( [makeColumn({ id: 'col-1' }), makeColumn({ id: 'col-2', order: 1 })], [epic], - [], + [makeTask({ groupId: epic.id })], ) await vi.dynamicImportSettled() await wrapper.vm.$nextTick() @@ -431,7 +556,7 @@ describe('agileBoardView — управление на доске', () => { it('esc в поле создания задачи эпика не создаёт задачу', async () => { const epic = makeEpic({ id: 'epic-1' }) - const wrapper = setup([makeColumn()], [epic], []) + const wrapper = setup([makeColumn()], [epic], [makeTask({ groupId: epic.id })]) await vi.dynamicImportSettled() await wrapper.vm.$nextTick() @@ -446,7 +571,7 @@ describe('agileBoardView — управление на доске', () => { it('клик по названию эпика открывает карточку группы через useGroupDetail', async () => { const epic = makeEpic({ id: 'epic-1' }) - const wrapper = setup([makeColumn()], [epic], []) + const wrapper = setup([makeColumn()], [epic], [makeTask({ groupId: epic.id })]) await vi.dynamicImportSettled() await wrapper.vm.$nextTick() diff --git a/alfy-bot-frontend/tests/features/projects/ui/GroupActionsMenu.spec.ts b/alfy-bot-frontend/tests/features/projects/ui/GroupActionsMenu.spec.ts index 7e06f26..46eedea 100644 --- a/alfy-bot-frontend/tests/features/projects/ui/GroupActionsMenu.spec.ts +++ b/alfy-bot-frontend/tests/features/projects/ui/GroupActionsMenu.spec.ts @@ -51,9 +51,9 @@ function makeGroup(overrides: Partial = {}): BoardGroup { } } -async function openMenu(group: BoardGroup) { +async function openMenu(group: BoardGroup, options = {}) { const wrapper = mount(GroupActionsMenu, { - props: { group }, + props: { group, ...options }, attachTo: document.body, }) await wrapper.find('button').trigger('click') @@ -77,6 +77,34 @@ describe('groupActionsMenu', () => { vi.restoreAllMocks() }) + it('без контекста спринта не предлагает возврат в бэклог', async () => { + const wrapper = await openMenu(makeGroup()) + expect(itemLabels()).not.toContain('Вернуть в бэклог') + wrapper.unmount() + }) + + it.each(['epic', 'story'] as const)('возвращает %s в бэклог из меню доски', async (type) => { + const wrapper = await openMenu(makeGroup({ type }), { canReturnToBacklog: true }) + const item = Array.from(document.querySelectorAll('[data-slot="dropdown-menu-item"]')) + .find(el => el.textContent?.trim() === 'Вернуть в бэклог') as HTMLElement + expect(item).toBeTruthy() + item.click() + await flushPromises() + expect(wrapper.emitted('returnToBacklog')).toHaveLength(1) + wrapper.unmount() + }) + + it('блокирует повторный возврат пока запрос выполняется', async () => { + const wrapper = await openMenu(makeGroup(), { canReturnToBacklog: true, returningToBacklog: true }) + const item = Array.from(document.querySelectorAll('[data-slot="dropdown-menu-item"]')) + .find(el => el.textContent?.trim() === 'Вернуть в бэклог') as HTMLElement + expect(item?.hasAttribute('data-disabled')).toBe(true) + item.click() + await flushPromises() + expect(wrapper.emitted('returnToBacklog')).toBeUndefined() + wrapper.unmount() + }) + it('у истории нет пунктов «Цвет» и «Добавить историю»', async () => { const wrapper = await openMenu(makeGroup({ id: 'story-1', type: 'story', parentId: 'epic-1' })) diff --git a/alfy-bot/src/modules/project/domain/sprint-repository.port.ts b/alfy-bot/src/modules/project/domain/sprint-repository.port.ts index 73bdd42..4940a0a 100644 --- a/alfy-bot/src/modules/project/domain/sprint-repository.port.ts +++ b/alfy-bot/src/modules/project/domain/sprint-repository.port.ts @@ -39,4 +39,11 @@ export abstract class SprintRepositoryPort { groupId: string, sprintId: string | null, ): Promise; + /** Атомарно возвращает эпик с дочерними историями либо историю из заданного спринта в бэклог; проверяет доступ и возвращает число перенесённых задач. При ошибке изменения откатываются. */ + abstract removeGroupFromSprint( + userId: number, + projectId: string, + sprintId: string, + groupId: string, + ): Promise; } diff --git a/alfy-bot/src/modules/project/infrastructure/typeorm-sprint.repository.ts b/alfy-bot/src/modules/project/infrastructure/typeorm-sprint.repository.ts index 820adeb..ad50a77 100644 --- a/alfy-bot/src/modules/project/infrastructure/typeorm-sprint.repository.ts +++ b/alfy-bot/src/modules/project/infrastructure/typeorm-sprint.repository.ts @@ -1,8 +1,13 @@ -import { BadRequestException, Injectable } from '@nestjs/common'; +import { + BadRequestException, + Injectable, + NotFoundException, +} from '@nestjs/common'; import { InjectDataSource, InjectRepository } from '@nestjs/typeorm'; -import { DataSource, Repository } from 'typeorm'; +import { DataSource, In, Repository } from 'typeorm'; import { BoardGroup, + Project, ProjectColumn, Sprint, Task, @@ -141,4 +146,71 @@ export class TypeOrmSprintRepository extends SprintRepositoryPort { return result.affected ?? 0; }); } + async removeGroupFromSprint( + userId: number, + projectId: string, + sprintId: string, + groupId: string, + ): Promise { + return this.dataSource.transaction(async (manager) => { + const project = await manager.findOneBy(Project, { + id: projectId, + userId, + }); + if (!project) + throw new NotFoundException(`Project #${projectId} not found`); + if (project.type !== 'agile') { + throw new BadRequestException( + 'Sprint planning requires an Agile project', + ); + } + const sprint = await manager.findOneBy(Sprint, { + id: sprintId, + projectId, + userId, + }); + if (!sprint) throw new NotFoundException(`Sprint #${sprintId} not found`); + if (sprint.status === 'closed') { + throw new BadRequestException('Closed sprint cannot be changed'); + } + const group = await manager.findOneBy(BoardGroup, { + id: groupId, + projectId, + userId, + }); + if (!group) throw new NotFoundException(`Group #${groupId} not found`); + const children = + group.type === 'epic' + ? await manager.findBy(BoardGroup, { + parentId: groupId, + projectId, + userId, + type: 'story', + }) + : []; + const groupIds = [groupId, ...children.map((child) => child.id)]; + await manager.update( + BoardGroup, + { + id: In(groupIds), + projectId, + userId, + sprintId, + type: 'story', + }, + { sprintId: null }, + ); + const result = await manager.update( + Task, + { + groupId: In(groupIds), + projectId, + userId, + sprintId, + }, + { sprintId: null }, + ); + return result.affected ?? 0; + }); + } } diff --git a/alfy-bot/src/modules/project/sprint.controller.ts b/alfy-bot/src/modules/project/sprint.controller.ts index abe00c3..7249a44 100644 --- a/alfy-bot/src/modules/project/sprint.controller.ts +++ b/alfy-bot/src/modules/project/sprint.controller.ts @@ -92,4 +92,21 @@ export class SprintController { ) { return this.sprintService.complete(req.user.sub, projectId, id, dto); } + @Post(':id/groups/:groupId/backlog') + @ApiOperation({ + summary: 'Вернуть эпик или историю из выбранного спринта в бэклог', + }) + async removeGroupFromSprint( + @Request() req: AuthRequest, + @Param('projectId') projectId: string, + @Param('id') id: string, + @Param('groupId') groupId: string, + ) { + return this.sprintService.removeGroupFromSprint( + req.user.sub, + projectId, + id, + groupId, + ); + } } diff --git a/alfy-bot/src/modules/project/sprint.service.spec.ts b/alfy-bot/src/modules/project/sprint.service.spec.ts index 8ad9a50..1001a04 100644 --- a/alfy-bot/src/modules/project/sprint.service.spec.ts +++ b/alfy-bot/src/modules/project/sprint.service.spec.ts @@ -61,6 +61,7 @@ describe('SprintService', () => { delete: jest.fn().mockResolvedValue(true), closeAndMoveUnfinished: jest.fn().mockResolvedValue(undefined), setGroupSprint: jest.fn().mockResolvedValue(0), + removeGroupFromSprint: jest.fn().mockResolvedValue(3), }; projRepo = { @@ -406,4 +407,59 @@ describe('SprintService', () => { ); }); }); + describe('removeGroupFromSprint', () => { + beforeEach(() => { + projRepo.findById.mockResolvedValue(makeProject({ type: 'agile' })); + sprintRepo.findById.mockResolvedValue(makeSprint()); + groupRepo.findById.mockResolvedValue({ id: 'group-1', type: 'epic' }); + }); + + it.each(['epic', 'story'])( + 'возвращает %s из выбранного спринта', + async (type) => { + groupRepo.findById.mockResolvedValue({ id: 'group-1', type }); + await expect( + service.removeGroupFromSprint(1, 'proj-1', 'sprint-1', 'group-1'), + ).resolves.toEqual({ updated: 3 }); + expect(sprintRepo.removeGroupFromSprint).toHaveBeenCalledWith( + 1, + 'proj-1', + 'sprint-1', + 'group-1', + ); + }, + ); + + it('не пишет при недоступном проекте', async () => { + projRepo.findById.mockResolvedValue(null); + await expect( + service.removeGroupFromSprint(1, 'proj-1', 'sprint-1', 'group-1'), + ).rejects.toThrow(NotFoundException); + expect(sprintRepo.removeGroupFromSprint).not.toHaveBeenCalled(); + }); + + it('не пишет при простом проекте', async () => { + projRepo.findById.mockResolvedValue(makeProject({ type: 'simple' })); + await expect( + service.removeGroupFromSprint(1, 'proj-1', 'sprint-1', 'group-1'), + ).rejects.toThrow(BadRequestException); + expect(sprintRepo.removeGroupFromSprint).not.toHaveBeenCalled(); + }); + + it('не пишет при закрытом спринте', async () => { + sprintRepo.findById.mockResolvedValue(makeSprint({ status: 'closed' })); + await expect( + service.removeGroupFromSprint(1, 'proj-1', 'sprint-1', 'group-1'), + ).rejects.toThrow(BadRequestException); + expect(sprintRepo.removeGroupFromSprint).not.toHaveBeenCalled(); + }); + + it('не пишет при чужой или отсутствующей группе', async () => { + groupRepo.findById.mockResolvedValue(null); + await expect( + service.removeGroupFromSprint(1, 'proj-1', 'sprint-1', 'group-1'), + ).rejects.toThrow(NotFoundException); + expect(sprintRepo.removeGroupFromSprint).not.toHaveBeenCalled(); + }); + }); }); diff --git a/alfy-bot/src/modules/project/sprint.service.ts b/alfy-bot/src/modules/project/sprint.service.ts index 1d348e1..a785a84 100644 --- a/alfy-bot/src/modules/project/sprint.service.ts +++ b/alfy-bot/src/modules/project/sprint.service.ts @@ -218,4 +218,32 @@ export class SprintService { ); return { updated }; } + + /** Возвращает группу и её задачи только из указанного незакрытого спринта в бэклог; сохраняет структуру и возвращает число перенесённых задач. */ + async removeGroupFromSprint( + userId: number, + projectId: string, + sprintId: string, + groupId: string, + ): Promise<{ updated: number }> { + const project = await this.validateProjectAccess(userId, projectId); + if (project.type !== 'agile') { + throw new BadRequestException( + 'Sprint planning requires an Agile project', + ); + } + const sprint = await this.getSprint(sprintId, projectId); + if (sprint.status === 'closed') { + throw new BadRequestException('Closed sprint cannot be changed'); + } + const group = await this.groupRepo.findById(groupId, projectId); + if (!group) throw new NotFoundException(`Group #${groupId} not found`); + const updated = await this.sprintRepo.removeGroupFromSprint( + userId, + projectId, + sprintId, + groupId, + ); + return { updated }; + } } diff --git a/alfy-bot/test/group-sprint-backlog.e2e-spec.ts b/alfy-bot/test/group-sprint-backlog.e2e-spec.ts new file mode 100644 index 0000000..c8930c9 --- /dev/null +++ b/alfy-bot/test/group-sprint-backlog.e2e-spec.ts @@ -0,0 +1,274 @@ +import request from 'supertest'; +import { Server } from 'node:http'; +import { INestApplication } from '@nestjs/common'; +import { DataSource } from 'typeorm'; +import { createTestApp } from './helpers/test-app'; +import { + BoardGroup, + ProjectColumn, + Release, + Sprint, + Task, + User, +} from '../src/shared/entities'; +import { ApiTokenService } from '../src/modules/auth/application/api-token.service'; + +describe('Group sprint backlog (e2e)', () => { + let app: INestApplication; + let server: Server; + let db: DataSource; + let token: string; + let userId: number; + + beforeAll(async () => { + const context = await createTestApp(); + app = context.app; + server = app.getHttpServer() as Server; + userId = context.userId; + db = app.get(DataSource); + token = (await app.get(ApiTokenService).generate(userId, 'group-backlog')) + .plaintext; + }); + + afterAll(async () => { + await app.close(); + }); + + const auth = () => ({ Authorization: `Bearer ${token}` }); + const url = (projectId: string, sprintId: string, groupId: string) => + `/api/projects/${projectId}/sprints/${sprintId}/groups/${groupId}/backlog`; + + async function fixture(type: 'agile' | 'simple' = 'agile') { + const project = await request(server) + .post('/api/projects') + .set(auth()) + .send({ title: 'Backlog test', viewMode: 'board', type }) + .expect(201); + const projectId = (project.body as { id: string }).id; + const groups = db.getRepository(BoardGroup); + const epic = await groups.save({ + projectId, + userId, + type: 'epic', + title: 'Epic', + }); + const sibling = await groups.save({ + projectId, + userId, + type: 'epic', + title: 'Other', + }); + const sprints = db.getRepository(Sprint); + const source = await sprints.save({ + projectId, + userId, + name: 'Source', + status: 'active', + }); + const planned = await sprints.save({ + projectId, + userId, + name: 'Planned', + status: 'planned', + }); + const closed = await sprints.save({ + projectId, + userId, + name: 'Closed', + status: 'closed', + }); + const story = await groups.save({ + projectId, + userId, + type: 'story', + parentId: epic.id, + title: 'Story', + sprintId: source.id, + }); + const otherStory = await groups.save({ + projectId, + userId, + type: 'story', + parentId: epic.id, + title: 'Other story', + sprintId: planned.id, + }); + const empty = await groups.save({ + projectId, + userId, + type: 'story', + parentId: epic.id, + title: 'Empty', + sprintId: source.id, + }); + const column = await db + .getRepository(ProjectColumn) + .save({ projectId, title: 'Todo', order: 10 }); + const release = await db + .getRepository(Release) + .save({ projectId, userId, name: 'Release' }); + await groups.update(story.id, { releaseId: release.id, status: 'done' }); + const tasks = await db.getRepository(Task).save( + [ + { title: 'Direct', groupId: epic.id, sprintId: source.id }, + { + title: 'Done story', + groupId: story.id, + sprintId: source.id, + completed: true, + }, + { + title: 'Other assignment', + groupId: otherStory.id, + sprintId: source.id, + }, + { title: 'Planned', groupId: story.id, sprintId: planned.id }, + { title: 'Closed', groupId: story.id, sprintId: closed.id }, + { title: 'Backlog', groupId: story.id, sprintId: null }, + { title: 'Sibling', groupId: sibling.id, sprintId: source.id }, + ].map((task) => ({ + ...task, + projectId, + userId, + columnId: column.id, + releaseId: release.id, + })), + ); + return { + projectId, + source, + planned, + closed, + epic, + story, + otherStory, + empty, + tasks: await Promise.all( + tasks.map((task) => + db.getRepository(Task).findOneByOrFail({ id: task.id }), + ), + ), + }; + } + + it('возвращает эпик и пустые истории, сохраняя остальные поля и другие спринты; повтор идемпотентен', async () => { + const f = await fixture(); + const beforeGroups = await db + .getRepository(BoardGroup) + .findBy({ projectId: f.projectId }); + const response = await request(server) + .post(url(f.projectId, f.source.id, f.epic.id)) + .set(auth()) + .expect(201); + expect(response.body).toEqual({ updated: 3 }); + for (let i = 0; i < f.tasks.length; i++) { + const task = await db + .getRepository(Task) + .findOneByOrFail({ id: f.tasks[i].id }); + expect(task).toEqual({ + ...f.tasks[i], + sprintId: i < 3 ? null : f.tasks[i].sprintId, + updatedAt: expect.any(Date) as Date, + }); + } + for (const group of beforeGroups) { + const after = await db + .getRepository(BoardGroup) + .findOneByOrFail({ id: group.id }); + expect(after).toEqual({ + ...group, + sprintId: group.sprintId === f.source.id ? null : group.sprintId, + updatedAt: expect.any(Date) as Date, + }); + } + await request(server) + .post(url(f.projectId, f.source.id, f.epic.id)) + .set(auth()) + .expect(201, { updated: 0 }); + }); + + it('возвращает только выбранную историю из planned-спринта и сохраняет назначение другого спринта', async () => { + const f = await fixture(); + await request(server) + .post(url(f.projectId, f.planned.id, f.story.id)) + .set(auth()) + .expect(201, { updated: 1 }); + expect( + (await db.getRepository(BoardGroup).findOneByOrFail({ id: f.story.id })) + .sprintId, + ).toBe(f.source.id); + expect( + (await db.getRepository(Task).findOneByOrFail({ id: f.tasks[1].id })) + .sprintId, + ).toBe(f.source.id); + expect( + (await db.getRepository(Task).findOneByOrFail({ id: f.tasks[3].id })) + .sprintId, + ).toBeNull(); + }); + + it('отклоняет закрытый спринт, чужие группы/спринты, простой проект и неавторизованный запрос', async () => { + const f = await fixture(); + const other = await fixture(); + const simple = await fixture('simple'); + const foreignUser = await db + .getRepository(User) + .save({ telegramId: 991122, username: 'foreign-backlog' }); + const foreignToken = ( + await app.get(ApiTokenService).generate(foreignUser.id, 'foreign') + ).plaintext; + await request(server) + .post(url(f.projectId, f.source.id, f.epic.id)) + .set({ Authorization: `Bearer ${foreignToken}` }) + .expect(404); + + await request(server) + .post(url(f.projectId, f.closed.id, f.epic.id)) + .set(auth()) + .expect(400); + await request(server) + .post(url(f.projectId, f.source.id, other.epic.id)) + .set(auth()) + .expect(404); + await request(server) + .post(url(f.projectId, other.source.id, f.epic.id)) + .set(auth()) + .expect(404); + await request(server) + .post(url(simple.projectId, simple.source.id, simple.epic.id)) + .set(auth()) + .expect(400); + await request(server) + .post(url(f.projectId, f.source.id, f.epic.id)) + .expect(401); + expect( + await db.getRepository(Task).findBy({ projectId: f.projectId }), + ).toEqual(expect.arrayContaining(f.tasks)); + }); + + it('ошибка записи задачи откатывает перенос всех групп и задач', async () => { + const f = await fixture(); + await db.query( + `CREATE TRIGGER fail_backlog BEFORE UPDATE OF sprintId ON tasks WHEN OLD.id = '${f.tasks[1].id}' AND NEW.sprintId IS NULL BEGIN SELECT RAISE(ABORT, 'forced rollback'); END`, + ); + try { + await request(server) + .post(url(f.projectId, f.source.id, f.epic.id)) + .set(auth()) + .expect(500); + expect( + await db.getRepository(Task).findBy({ projectId: f.projectId }), + ).toEqual(expect.arrayContaining(f.tasks)); + expect( + (await db.getRepository(BoardGroup).findOneByOrFail({ id: f.story.id })) + .sprintId, + ).toBe(f.source.id); + expect( + (await db.getRepository(BoardGroup).findOneByOrFail({ id: f.empty.id })) + .sprintId, + ).toBe(f.source.id); + } finally { + await db.query('DROP TRIGGER fail_backlog'); + } + }); +}); diff --git a/alfy-mcp/README.md b/alfy-mcp/README.md index c0a719e..d06ccdc 100644 --- a/alfy-mcp/README.md +++ b/alfy-mcp/README.md @@ -133,6 +133,7 @@ read -rs ALFY_MCP_TOKEN - `complete_sprint` — `id` и обязательный `moveTo`: `backlog` либо UUID запланированного спринта. Незавершённые задачи и открытые истории переносятся; выполненные задачи остаются в закрытом спринте. - `delete_sprint` — `id` и `confirm: true`. Задачи и истории сохраняются, назначение удалённого спринта очищается. - `list_project_groups` — дерево эпиков и историй с UUID и назначениями спринтов/релизов. +- `remove_group_from_sprint` — `projectId`, `sprintId` исходного незакрытого спринта и `groupId` эпика/истории. Возвращает в бэклог только записи указанного спринта: у истории её задачи и назначение, у эпика также прямые задачи и дочерние истории. Выполненные задачи тоже переносятся с сохранением статуса. Другие спринты, иерархия, релизы и колонки не меняются. Атомарно, повторный вызов безопасен; ответ `{ updated: number }` — количество перенесённых задач. - `move_story_to_sprint` — `storyId` и обязательный `sprintId`: UUID незакрытого спринта этого проекта либо `null` для бэклога. Перенос истории и её задач атомарен; задачи закрытых спринтов сохраняются. Ответ `{ updated: number }` содержит число перенесённых задач, включая скрытые выполненные. Пустую историю тоже можно перенести. Например, после `list_project_groups` перенести выбранную историю и её задачи можно вызовом `move_story_to_sprint({ projectId, storyId, sprintId })`. Отдельную задачу переносят через `update_task({ id, sprintId })`. diff --git a/alfy-mcp/src/tools/sprints.ts b/alfy-mcp/src/tools/sprints.ts index 885520b..8c53b87 100644 --- a/alfy-mcp/src/tools/sprints.ts +++ b/alfy-mcp/src/tools/sprints.ts @@ -66,6 +66,16 @@ export function registerSprintTools(server: McpServer, client: AlfyRestClient): annotations: { readOnlyHint: true }, }, async ({ projectId }) => toText(await client.get(`/projects/${projectId}/groups`))); + server.registerTool('remove_group_from_sprint', { + description: 'Вернуть историю или эпик целиком из выбранного незакрытого спринта в бэклог. У эпика учитываются прямые задачи и дочерние истории с задачами. Меняется только sprintId записей выбранного спринта, включая выполненные задачи. Группы, родительские связи, статусы, колонки и релизы сохраняются; другие спринты не затрагиваются. Атомарно; повторный вызов безопасен. Возвращает updated — число перенесённых задач.', + inputSchema: { + projectId, + sprintId: z.string().uuid().describe('UUID исходного незакрытого спринта этого проекта'), + groupId: z.string().uuid().describe('UUID эпика или истории этого проекта из list_project_groups'), + }, + annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: true }, + }, async ({ projectId, sprintId, groupId }) => toText(await client.post(`/projects/${projectId}/sprints/${sprintId}/groups/${groupId}/backlog`))); + server.registerTool('move_story_to_sprint', { description: 'Атомарно перенести историю и все её задачи вне закрытых спринтов в незакрытый спринт этого проекта. sprintId=null переносит в бэклог. Пустые истории поддерживаются; задачи закрытых спринтов сохраняются. Возвращает число перенесённых задач updated.', inputSchema: { diff --git a/alfy-mcp/tests/tools/sprints.spec.ts b/alfy-mcp/tests/tools/sprints.spec.ts index 87c82f1..6888d79 100644 --- a/alfy-mcp/tests/tools/sprints.spec.ts +++ b/alfy-mcp/tests/tools/sprints.spec.ts @@ -27,6 +27,32 @@ describe('sprint tools through MCP', () => { await Promise.all([client.close(), server.close()]); }); + it('returns a group from only the selected sprint to backlog', async () => { + rest.post.mockResolvedValue({ updated: 3 }); + const result = await client.callTool({ name: 'remove_group_from_sprint', arguments: { projectId: PROJECT, sprintId: SPRINT, groupId: STORY } }); + expect(result.isError).not.toBe(true); + expect(rest.post).toHaveBeenCalledTimes(1); + expect(rest.post).toHaveBeenCalledWith(`/projects/${PROJECT}/sprints/${SPRINT}/groups/${STORY}/backlog`); + expect(result.content).toEqual([{ type: 'text', text: '{"updated":3}' }]); + }); + + it.each([ + { projectId: PROJECT, groupId: STORY }, + { projectId: PROJECT, sprintId: null, groupId: STORY }, + { projectId: PROJECT, sprintId: SPRINT, groupId: 'bad' }, + ])('rejects incomplete removal scope %j', async (args) => { + const result = await client.callTool({ name: 'remove_group_from_sprint', arguments: args }); + expect(result.isError).toBe(true); + expect(rest.post).not.toHaveBeenCalled(); + }); + + it('returns closed sprint error instead of a successful removal', async () => { + rest.post.mockRejectedValue(new RestError(400, 'Closed sprint cannot be changed')); + const result = await client.callTool({ name: 'remove_group_from_sprint', arguments: { projectId: PROJECT, sprintId: SPRINT, groupId: STORY } }); + expect(result.isError).toBe(true); + expect(JSON.stringify(result.content)).toContain('Closed sprint'); + }); + it('registers planning and lifecycle tools in the server', async () => { const { tools } = await client.listTools(); expect(tools.map(t => t.name)).toEqual(expect.arrayContaining([ diff --git a/docs/tasks/group-sprint-backlog.md b/docs/tasks/group-sprint-backlog.md new file mode 100644 index 0000000..783ccae --- /dev/null +++ b/docs/tasks/group-sprint-backlog.md @@ -0,0 +1,60 @@ +# Возврат эпика или истории из спринта в бэклог + +**Status:** done +**Branch:** codex/group-sprint-backlog +**Worktree:** /Users/v/projects/Alfy/.worktrees/group-sprint-backlog +**Mode:** interactive +**Goal:** Пользователь на доске и агент через MCP возвращают историю или весь эпик с вложенными историями и задачами из выбранного спринта в бэклог, сохраняя проект и данные других спринтов. Useless if: структура удалена; задачи других спринтов изменены; UI сообщает успех при ошибке. + +## Context +- Пользователь подтвердил возврат в бэклог, а не статус отмены. +- Старый setGroupSprint умеет переносить только историю и все её задачи вне закрытых спринтов; для удаления из одного конкретного спринта не подходит. +- На доске меню групп не содержит возврат в бэклог; эпик не имеет sprintId. + +## Design +Новая атомарная команда с явным исходным спринтом. Для истории — её задачи и назначение истории, для эпика — прямые задачи и дочерние истории с задачами. Меняются только записи с исходным sprintId. Закрытый спринт недоступен; пустая группа допустима. Все задачи выбранной группы из спринта, включая выполненные, возвращаются в бэклог. Названия, статусы, родительские связи, релизы и колонки сохраняются. TDD: yes. + +### Invariants +- IV1 — Изоляция по пользователю, проекту и исходному спринту; закрытые спринты неизменны. +- IV2 — Операция атомарна и идемпотентна, возвращает updated — число перенесённых задач. +- IV3 — Сами группы и задачи не удаляются; другие спринты и связи неизменны. + +## Plan +### PH1 — REST +- alfy-bot/src/modules/project/sprint.controller.ts, sprint.service.ts, domain/sprint-repository.port.ts, infrastructure/typeorm-sprint.repository.ts: removeGroupFromSprint(userId,projectId,sprintId,groupId), POST /projects/:projectId/sprints/:sprintId/groups/:groupId/backlog. +- Unit + SQLite HTTP e2e: история/эпик, прямые задачи, чужой проект/закрытый спринт, другой спринт и релиз не затронуты, повторный вызов, rollback. +- Commit: feat(sprints): return groups from a selected sprint to backlog +### PH2 — Клиент и MCP +- Меню группы на доске вызывает команду для активного спринта; pending, ошибки, обновление задач и групп. +- MCP remove_group_from_sprint(projectId,sprintId,groupId): один POST, описание границ, SDK тесты и документация. +- По подтверждению пользователя доска показывает только группы активного спринта: историю по назначению или задачам; эпик по прямым задачам или видимой истории. Фильтры задач не скрывают принадлежность группы. После возврата пустая структура исчезает с доски, но сохраняется в бэклоге. +- Новая история с доски назначается активному спринту; отказ назначения сообщает, что история уже создана. Новый пустой эпик создаётся в бэклоге, открывается его карточка и показывается пояснение о назначении задач/историй. +- Стрелки меняют порядок видимых соседей, сохраняя скрытые группы в полном orderedIds. +- Commit: feat(board): return sprint groups to backlog + +### Interfaces +- IF1 — POST /projects/:projectId/sprints/:sprintId/groups/:groupId/backlog → {updated:number}; тело не требуется. + +### Validation +Реальный API/SQLite и MCP smoke, клиентские тесты и браузер, независимое ревью. + +### Interface graph +- PH1 -> IF1 @ alfy-bot/src/modules/project/ alfy-bot/test/ +- PH2 IF1 -> @ alfy-bot-frontend/src/features/projects/ alfy-bot-frontend/tests/features/projects/ alfy-mcp/ + +## Verify +- Backend: 36 unit и 11 HTTP/SQLite e2e; build и scoped lint пройдены. Принудительная ошибка SQLite подтверждает полный rollback. +- Frontend: 60 тестов, type-check, build и scoped lint пройдены. Проверены исчезновение групп, назначенные пустые истории, создание и ошибка назначения, порядок видимых соседей. +- MCP: 197 тестов, build и lint пройдены; реальный SDK → REST smoke подтвердил story updated=1, epic updated=2, повтор updated=0, сохранение других спринтов и отказ закрытого спринта. +- Браузер с локальным API: возврат истории убрал только её из доски; возврат эпика убрал остальные группы; перезагрузка сохранила результат. Бэклог содержит 3 возвращённые задачи, следующий спринт сохранил свою задачу, обе истории остались в структуре проекта. +- Скриншот: /Users/v/.codex/visualizations/2026/10/09/01a120ab-bf2f-7d90-a51f-5fca7d78316d/group-sprint-backlog.png. + +## Conclusion +Возврат групп в бэклог работает через доску и MCP; после возврата группы исчезают с доски текущего спринта, данные сохраняются. Реализация: b7387d0; независимое ревью не выявило critical/important замечаний. + +Invariants: +- IV1 — HTTP e2e и реальный MCP smoke подтвердили изоляцию пользователя, проекта и спринта, отказ закрытого спринта. +- IV2 — SQLite rollback-тест и повторные MCP вызовы с updated=0 подтвердили атомарность и идемпотентность. +- IV3 — HTTP e2e, MCP smoke и браузер подтвердили сохранение структуры и данных других спринтов. + +Plan adherence: по уточнению пользователя добавлена фильтрация групп текущего спринта; адаптированы создание групп и перестановка видимых соседей. MCP выделен в отдельный коммит.