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
5 changes: 4 additions & 1 deletion CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ ESM-пакет, Node 22+. SDK — `@modelcontextprotocol/sdk` (`McpServer` + `St

**Env для e2e ставится в `setupFiles`, не в хелпере.** `AppModule` решает, поднимать ли Telegraf, на этапе **импорта модуля** (`const telegramImports = isTelegramEnabled()`). Любой `process.env.ENABLE_TELEGRAM = 'false'` внутри `createTestApp()` опаздывает: `import { AppModule }` в шапке спеки уже отработал, бот стартует и валит весь suite с `401: Bot Token is required`. Поэтому переменные живут в `alfy-bot/test/setup-e2e-env.ts`, подключённом через `setupFiles` в `test/jest-e2e.json`. Не переносить их обратно в хелпер.

**Триггеры SQLite и `synchronize`.** Часть правил CHECK-ом невыразима: SQLite запрещает подзапросы в CHECK, поэтому «родитель обязан быть эпиком» (`board_groups`) и «группа задачи — из её проекта» (`tasks`) сделаны триггерами с `RAISE(ABORT, ...)`. `synchronize` их не знает, а при изменении схемы SQLite-таблица пересобирается (temporary → copy → drop → rename). Триггер на `tasks` читает `board_groups`, и на rename SQLite его перепроверяет — живой триггер **роняет старт** (`no such table: main.board_groups`). Поэтому `DataSource` поднимается через `initializeWithSchemaSync` (`shared/database/create-data-source.ts`): БД открывается без `synchronize`, `dropBoardGroupTriggers` снимает триггеры, затем `synchronize()`; на `OnApplicationBootstrap` их заново ставит `board-group-constraints.service.ts`. Заводя новый триггер, добавь его имя в `BOARD_GROUP_TRIGGER_NAMES`. В тестах пересборку таблицы эмулируй так же, как TypeORM (`foreign_keys = OFF`, temporary → drop → rename): `ALTER TABLE x RENAME TO x_old` молча переписывает тела чужих триггеров на `x_old`, и тест проходит по неверной причине.
**Триггеры SQLite и `synchronize`.** Часть правил CHECK-ом невыразима: SQLite запрещает подзапросы в CHECK, поэтому «родитель обязан быть эпиком» (`board_groups`) и «группа задачи — из её проекта» (`tasks`) сделаны триггерами с `RAISE(ABORT, ...)`. `synchronize` их не знает, а при изменении схемы SQLite-таблица пересобирается (temporary → copy → drop → rename). Триггер на `tasks` читает `board_groups`, и на rename SQLite его перепроверяет — живой триггер **роняет старт** (`no such table: main.board_groups`). Поэтому `DataSource` поднимается через `initializeWithSchemaSync` (`shared/database/create-data-source.ts`): БД открывается без `synchronize`, `dropBoardGroupTriggers` снимает триггеры, затем `synchronize()`; на `OnApplicationBootstrap` их заново ставит `board-group-constraints.service.ts`. Триггеры структуры перечислены в `BOARD_GROUP_TRIGGER_NAMES`, история спринтов — в `SPRINT_HISTORY_TRIGGER_NAMES`; `dropBoardGroupTriggers` снимает оба набора перед синхронизацией. Новый триггер должен входить в один из снимаемых наборов. В тестах пересборку таблицы эмулируй так же, как TypeORM (`foreign_keys = OFF`, temporary → drop → rename): `ALTER TABLE x RENAME TO x_old` молча переписывает тела чужих триггеров на `x_old`, и тест проходит по неверной причине.

**Мокающие спеки не видят ограничений схемы.** `*.service.spec.ts` мокают репозитории, поэтому `NOT NULL`, CHECK и триггеры там не проверяются в принципе: сервис, забывший проставить `userId`, проходит все юнит-тесты и падает с 500 на живом API. Для сущностей с ограничениями нужен e2e на реальной схеме — образец `alfy-bot/test/board-groups.e2e-spec.ts`.

Expand Down Expand Up @@ -207,3 +207,6 @@ Add as new ## Bug Diagnosis section\n\n## Bug Diagnosis
- Before proposing a CSS/styling fix, reproduce the actual symptom and confirm root cause. State your hypothesis explicitly and ask user to confirm before editing.
- For recurring/scheduled-task logic, ensure next-instance dates are 'on-or-after today', not 'next-by-rule from last completion'.
- Always respond in the language the user is writing in (Russian if they write Russian).


**Workflow и планирование спринтов.** `workflowStatusId` истории независим от колонок и выполнения задач; совместимый `status=open/done` отражает категорию каталога проекта. `planning` возвращает серверный расчёт минут, неизвестные оценки и текущую дату в таймзоне пользователя. Предложение состава ничего не пишет, применение выполняется одной атомарной командой; undo проверяет исходные назначения и изменения. Снимки спринта сохраняются на старте и закрытии, триггеры фиксируют все пути изменений активного состава. Исторический отчёт нельзя пересчитывать из текущих задач. В UI фоновое обновление спринтов не должно размонтировать workspace и терять undoToken.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@
- **🧱 Чистая архитектура.** Бэкенд — Clean Architecture по модулям (порты в `domain/`, адаптеры в `infrastructure/`, оркестрация в сервисах). Фронтенд — Feature-Sliced Design. Границы слоёв реальны, а не декоративны.
- **🌍 Корректные таймзоны и локали.** Все операции с датами уважают IANA-таймзону пользователя; даты в БД хранятся в UTC и сдвигаются к wall-clock пользователя на границе домена. Календарь, локаль и первый день недели — из настроек пользователя.
- **🗓 Богатый UI задач.** Inbox, проекты со списками и board-колонками, повторяющиеся задачи, календарь с drag-create по сетке часов, Pomodoro-таймер, два независимых drag-and-drop-движка (кастомный на PointerEvents + vuedraggable). Agile-проекты включают эпики, истории, спринты и релизы; историю можно перенести в спринт целиком с задачами через меню или drag-and-drop. Стрелки ↑/↓ прямо на доске меняют порядок эпиков и историй внутри эпика; порядок сохраняется после перезагрузки. На доске отображаются группы текущего спринта. Историю или целый эпик можно вернуть в бэклог через меню или MCP `remove_group_from_sprint`: структура сохраняется, задачи других спринтов не меняются. Описание задачи поддерживает Markdown и кликабельные ссылки; исходный текст редактируется по кнопке «Редактировать» с явным сохранением или отменой. У каждой сохранённой задачи есть постоянная ссылка `/tasks/:taskId`: её можно скопировать из карточки или открыть в новой вкладке; после входа сохраняется переход к задаче.
- **Спринты и истории.** Настраиваемые статусы историй, блокеры и зависимости, бэклог с планированием по бюджету времени, предложения состава через MCP и сохранённые итоги спринтов. [Инструменты планирования](alfy-mcp/README.md#объяснимое-планирование).
- **🔔 Уведомления.** Web-push (VAPID) с подписками на устройство.

---
Expand Down
8 changes: 8 additions & 0 deletions alfy-bot-frontend/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,14 @@
- **PWA**: кастомный service worker (workbox), web-push-подписки, установка на устройство.
- **i18n локали дат**: единый реактивный источник `composables/useLocale.ts` (язык, таймзона, первый день недели — из настроек пользователя).

## Планирование спринтов

В Agile-проекте откройте **Бэклог → Планирование**: выберите спринт, задайте цель, бюджет и резерв, отметьте задачи или истории и перенесите их одной командой. Выбор истории переносит её незавершённые задачи; ранее выполненные сохраняют назначение. Последний перенос можно отменить, пока он не конфликтует с последующими изменениями. «Предложить план» показывает объяснимый черновик под бюджет; применению предшествует просмотр состава.

Режим **Истории** показывает отдельную доску статусов: проработка, готовность, работа, проверка и выполнение. Названия и порядок настраиваются в «Статусы историй». В карточке истории доступны блокер, зависимости, отложенная дата и архив. Завершение всех задач не закрывает историю автоматически.

На активной доске **Фокус** показывает ближайшие действия, блокеры и загрузку. При завершении спринта можно распределить остаток, записать итоги и улучшение. **Бэклог → Итоги** хранит исходный и итоговый состав; для старых спринтов отмечает неполную историю. Минуты — оценки объёма, а задачи без оценки показаны отдельно.

## Стек и UI

- Vue 3 `<script setup>` + TS, Vite, Tailwind v4, Pinia, vue-router.
Expand Down
35 changes: 35 additions & 0 deletions alfy-bot-frontend/src/features/projects/api/planning-api.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
import type { PlanningContext, PlanningProposal, SprintReport } from '../model/planning-types'
import type { StoryWorkflowStatus } from '../model/types'
import { api } from '@/api/client'

export function fetchStoryWorkflow(projectId: string) {
return api.get<{ statuses: StoryWorkflowStatus[] }>(`/projects/${projectId}/story-workflow`)
}

export function saveStoryWorkflow(projectId: string, statuses: StoryWorkflowStatus[]) {
return api.put<{ statuses: StoryWorkflowStatus[] }>(`/projects/${projectId}/story-workflow`, { statuses })
}

export function fetchPlanning(projectId: string, sprintId: string | null) {
return api.get<PlanningContext>(`/projects/${projectId}/planning`, { params: sprintId ? { sprintId } : {} })
}

export function proposePlan(projectId: string, payload: { sprintId: string, budgetMinutes: number, goal: string }) {
return api.post<PlanningProposal>(`/projects/${projectId}/planning/proposal`, payload)
}

export function movePlanningItems(projectId: string, payload: { taskIds: string[], storyIds: string[], sprintId: string | null }) {
return api.post<{ updated: number, undoToken: string }>(`/projects/${projectId}/planning/move`, payload)
}

export function undoPlanningMove(projectId: string, undoToken: string) {
return api.post<{ updated: number }>(`/projects/${projectId}/planning/undo`, { undoToken })
}

export function orderPlanningTasks(projectId: string, taskIds: string[], sprintId: string | null) {
return api.patch<{ updated: number }>(`/projects/${projectId}/planning/order`, { taskIds, sprintId })
}

export function fetchSprintReport(projectId: string, sprintId: string) {
return api.get<SprintReport>(`/projects/${projectId}/sprints/${sprintId}/report`)
}
56 changes: 56 additions & 0 deletions alfy-bot-frontend/src/features/projects/model/planning-types.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
import type { BoardGroup, Sprint } from './types'

export interface PlanningTask {
updatedAt?: string
id: string
title: string
completed: boolean
groupId: string | null
sprintId: string | null
order: number
estimateMinutes: number | null
priority?: string
blocked: boolean
}

export interface PlanningContext {
today?: string
sprintId: string | null
capacityMinutes: number | null
reserveMinutes: number
plannedMinutes: number
remainingMinutes: number | null
unestimatedCount: number
otherProjectsMinutes: number
otherProjectsUnestimatedCount?: number
historicalCapacityMinutes: number | null
historySampleCount: number
tasks: PlanningTask[]
stories: BoardGroup[]
carryoverCounts: Record<string, number>
}

export interface PlanningProposal {
taskIds: string[]
storyIds: string[]
totalMinutes: number
unestimatedIds: string[]
excluded: { id: string, reason: string }[]
reasons: { id: string, reason: string }[]
}

export interface PlanningSnapshot {
capturedAt: string
tasks: { id: string, title: string, completed: boolean, estimateMinutes: number | null, groupId: string | null }[]
stories: { id: string, title: string, status: string, workflowStatusId: string | null }[]
}

export interface SprintReport {
sprint: Sprint
historyComplete: boolean
initial: PlanningSnapshot | null
final: PlanningSnapshot | null
events: { id: string, sprintId: string, taskId: string | null, kind: string, occurredAt: string, title: string }[]
summary: { planned: number, added: number, removed: number, completed: number, carried: number }
retrospective: { goalOutcome: string | null, retrospective: string | null, improvement: string | null, carryoverReason: string | null }
}
6 changes: 3 additions & 3 deletions alfy-bot-frontend/src/features/projects/model/sprint-store.ts
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
import type { CreateSprintPayload, Sprint, StartSprintPayload, UpdateSprintPayload } from './types'
import type { CompleteSprintPayload, CreateSprintPayload, Sprint, StartSprintPayload, UpdateSprintPayload } from './types'
import { defineStore } from 'pinia'
import { ref } from 'vue'
import { useTaskStore } from '@/features/tasks/model/task-store'
Expand Down Expand Up @@ -195,7 +195,7 @@ export const useSprintStore = defineStore('sprints', () => {
* незавершённые задачи; после успеха API им локально выставляется
* `sprintId` (`'backlog'` → `null`), выполненные задачи остаются в спринте.
*/
const completeSprint = async (projectId: string, id: string, moveTo: 'backlog' | string) => {
const completeSprint = async (projectId: string, id: string, moveTo: 'backlog' | string, details?: Omit<CompleteSprintPayload, 'moveTo'>) => {
const previous = sprintsOf(projectId)
if (!previous.some(s => s.id === id))
return
Expand All @@ -204,7 +204,7 @@ export const useSprintStore = defineStore('sprints', () => {

let data: Sprint
try {
({ data } = await sprintsApi.completeSprint(projectId, id, { moveTo }))
({ data } = await sprintsApi.completeSprint(projectId, id, { moveTo, ...details }))
}
catch (err) {
lists.value[projectId] = previous
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
import type { StoryWorkflowStatus } from './types'
import { defineStore } from 'pinia'
import { ref } from 'vue'
import { fetchStoryWorkflow, saveStoryWorkflow } from '../api/planning-api'
import { apiErrorMessage } from '../lib/api-error'

export const useStoryWorkflowStore = defineStore('story-workflow', () => {
const catalogs = ref<Record<string, StoryWorkflowStatus[]>>({})
const errors = ref<Record<string, string>>({})
const pending = new Map<string, Promise<void>>()

function statusesOf(projectId: string) {
return catalogs.value[projectId] ?? []
}

async function fetch(projectId: string): Promise<void> {
if (pending.has(projectId))
return pending.get(projectId)
const request = (async () => {
try {
const { data } = await fetchStoryWorkflow(projectId)
catalogs.value[projectId] = data.statuses
delete errors.value[projectId]
}
catch (err) {
errors.value[projectId] = apiErrorMessage(err, 'Не удалось загрузить статусы историй')
}
finally { pending.delete(projectId) }
})()
pending.set(projectId, request)
return request
}

async function ensure(projectId: string) {
if (!(projectId in catalogs.value))
await fetch(projectId)
}

async function save(projectId: string, statuses: StoryWorkflowStatus[]) {
const { data } = await saveStoryWorkflow(projectId, statuses)
catalogs.value[projectId] = data.statuses
delete errors.value[projectId]
}

return { catalogs, errors, statusesOf, fetch, ensure, save }
})
Loading
Loading