Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) с подписками на устройство.

---
Expand Down
5 changes: 5 additions & 0 deletions alfy-bot-frontend/src/features/projects/api/sprints-api.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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<Sprint>(`/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`)
}
8 changes: 8 additions & 0 deletions alfy-bot-frontend/src/features/projects/model/sprint-store.ts
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,13 @@ export const useSprintStore = defineStore('sprints', () => {
return data.updated
}

/** Возвращает группу из указанного спринта в бэклог и обновляет назначения; возвращает число задач. */
async function removeGroupFromSprint(projectId: string, sprintId: string, groupId: string): Promise<number> {
const { data } = await sprintsApi.removeGroupFromSprint(projectId, sprintId, groupId)
await refreshAssignments(projectId)
return data.updated
}

/** Все спринты проекта, включая завершённые, в порядке `order`. Для незагруженного проекта — `[]`. */
function sprintsOf(projectId: string): Sprint[] {
return lists.value[projectId] ?? []
Expand Down Expand Up @@ -215,6 +222,7 @@ export const useSprintStore = defineStore('sprints', () => {
}

return {
removeGroupFromSprint,
setStorySprint,
lists,
error,
Expand Down
98 changes: 92 additions & 6 deletions alfy-bot-frontend/src/features/projects/ui/AgileBoardView.vue
Original file line number Diff line number Diff line change
Expand Up @@ -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'
Expand Down Expand Up @@ -42,6 +43,9 @@ const { onTaskChange } = useAgileDnd(taskStore)
const { deleteGroupWithConfirm } = useGroupDeletion()
const groupDetail = useGroupDetail()

const returningToBacklog = ref(false)
const backlogError = ref<string | null>(null)
const creationNotice = ref<string | null>(null)
const addingEpic = ref(false)
const reordering = ref(false)
const reorderError = ref<string | null>(null)
Expand All @@ -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)
Expand All @@ -68,7 +107,11 @@ const projectTasks = computed(() =>

const lanes = computed<ProjectColumn[]>(() => 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'),
Expand All @@ -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
Expand Down Expand Up @@ -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) {
Expand Down Expand Up @@ -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)
Expand All @@ -179,6 +256,12 @@ watch(() => props.projectId, (id) => {
<div class="animate-spin rounded-full h-8 w-8 border-b-2 border-primary mx-auto" />
</div>
<div v-else class="overflow-x-auto pb-4 h-full">
<p v-if="creationNotice" role="status" class="sticky left-0 mb-3 text-sm text-muted-foreground">
{{ creationNotice }}
</p>
<p v-if="backlogError" role="alert" class="sticky left-0 mb-3 text-sm text-destructive">
{{ backlogError }}
</p>
<p v-if="reorderError" role="alert" class="sticky left-0 mb-3 text-sm text-destructive">
{{ reorderError }}
</p>
Expand Down Expand Up @@ -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)"
Expand Down
9 changes: 9 additions & 0 deletions alfy-bot-frontend/src/features/projects/ui/AgileEpicBlock.vue
Original file line number Diff line number Diff line change
Expand Up @@ -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]
Expand Down Expand Up @@ -132,6 +135,9 @@ function handleCreateStory(title: string) {
</Button>
<GroupActionsMenu
:group="epic"
:can-return-to-backlog="backlogGroupIds?.includes(epic.id)"
:returning-to-backlog="returningToBacklog"
@return-to-backlog="$emit('returnToBacklog', epic)"
@open="$emit('openGroup', epic.id)"
@rename="renaming = true"
@set-color="(color) => $emit('setGroupColor', epic.id, color)"
Expand All @@ -152,6 +158,9 @@ function handleCreateStory(title: string) {
:can-move-up="index > 0"
:can-move-down="index < stories.length - 1"
:reordering="reordering"
:backlog-group-ids="backlogGroupIds"
:returning-to-backlog="returningToBacklog"
@return-to-backlog="$emit('returnToBacklog', $event)"
@move-group="(group, direction) => $emit('moveGroup', group, direction)"
@toggle-task="$emit('toggleTask', $event)"
@open-task="$emit('openTask', $event)"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,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]
Expand Down Expand Up @@ -90,6 +93,9 @@ function handleCreateTask(title: string) {
</Button>
<GroupActionsMenu
:group="story"
:can-return-to-backlog="backlogGroupIds?.includes(story.id)"
:returning-to-backlog="returningToBacklog"
@return-to-backlog="$emit('returnToBacklog', story)"
@open="$emit('openGroup', story.id)"
@rename="renaming = true"
@set-color="(color) => $emit('setGroupColor', story.id, color)"
Expand Down
11 changes: 11 additions & 0 deletions alfy-bot-frontend/src/features/projects/ui/GroupActionsMenu.vue
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,12 @@ import { useReleaseStore } from '../model/release-store'
*/
const props = defineProps<{
group: BoardGroup
canReturnToBacklog?: boolean
returningToBacklog?: boolean
}>()

const emit = defineEmits<{
returnToBacklog: []
open: []
rename: []
setColor: [color: string | null]
Expand Down Expand Up @@ -136,6 +139,14 @@ function onCloseAutoFocus(event: Event) {
<CircleCheck v-else :size="14" class="mr-2" />
{{ toggleDoneLabel }}
</DropdownMenuItem>
<DropdownMenuItem
v-if="canReturnToBacklog"
:disabled="returningToBacklog"
@click="!returningToBacklog && $emit('returnToBacklog')"
>
<RotateCcw :size="14" class="mr-2" />
Вернуть в бэклог
</DropdownMenuItem>
<DropdownMenuSeparator />
<DropdownMenuItem
class="text-destructive focus:text-destructive focus:bg-destructive/10"
Expand Down
12 changes: 12 additions & 0 deletions alfy-bot-frontend/tests/features/projects/api/sprints-api.spec.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
import { expect, it, vi } from 'vitest'
import { api } from '@/api/client'
import { removeGroupFromSprint } from '@/features/projects/api/sprints-api'

vi.mock('@/api/client', () => ({ 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)
})
Original file line number Diff line number Diff line change
Expand Up @@ -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() }))

Expand Down Expand Up @@ -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' })])
Expand Down
Loading
Loading