diff --git a/CLAUDE.md b/CLAUDE.md index 920be13..36532ed 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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`. @@ -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. diff --git a/README.md b/README.md index b260a0f..3ae2427 100644 --- a/README.md +++ b/README.md @@ -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) с подписками на устройство. --- diff --git a/alfy-bot-frontend/README.md b/alfy-bot-frontend/README.md index 996c51e..394f2cc 100644 --- a/alfy-bot-frontend/README.md +++ b/alfy-bot-frontend/README.md @@ -12,6 +12,14 @@ - **PWA**: кастомный service worker (workbox), web-push-подписки, установка на устройство. - **i18n локали дат**: единый реактивный источник `composables/useLocale.ts` (язык, таймзона, первый день недели — из настроек пользователя). +## Планирование спринтов + +В Agile-проекте откройте **Бэклог → Планирование**: выберите спринт, задайте цель, бюджет и резерв, отметьте задачи или истории и перенесите их одной командой. Выбор истории переносит её незавершённые задачи; ранее выполненные сохраняют назначение. Последний перенос можно отменить, пока он не конфликтует с последующими изменениями. «Предложить план» показывает объяснимый черновик под бюджет; применению предшествует просмотр состава. + +Режим **Истории** показывает отдельную доску статусов: проработка, готовность, работа, проверка и выполнение. Названия и порядок настраиваются в «Статусы историй». В карточке истории доступны блокер, зависимости, отложенная дата и архив. Завершение всех задач не закрывает историю автоматически. + +На активной доске **Фокус** показывает ближайшие действия, блокеры и загрузку. При завершении спринта можно распределить остаток, записать итоги и улучшение. **Бэклог → Итоги** хранит исходный и итоговый состав; для старых спринтов отмечает неполную историю. Минуты — оценки объёма, а задачи без оценки показаны отдельно. + ## Стек и UI - Vue 3 ` + + diff --git a/alfy-bot-frontend/src/features/projects/ui/SprintCapacityBar.vue b/alfy-bot-frontend/src/features/projects/ui/SprintCapacityBar.vue new file mode 100644 index 0000000..4ef7085 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/SprintCapacityBar.vue @@ -0,0 +1,37 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/SprintCompleteDialog.vue b/alfy-bot-frontend/src/features/projects/ui/SprintCompleteDialog.vue index e40994a..271d4e9 100644 --- a/alfy-bot-frontend/src/features/projects/ui/SprintCompleteDialog.vue +++ b/alfy-bot-frontend/src/features/projects/ui/SprintCompleteDialog.vue @@ -1,5 +1,5 @@ + + diff --git a/alfy-bot-frontend/src/features/projects/ui/SprintFormDialog.vue b/alfy-bot-frontend/src/features/projects/ui/SprintFormDialog.vue index 58fa5c5..02dbe20 100644 --- a/alfy-bot-frontend/src/features/projects/ui/SprintFormDialog.vue +++ b/alfy-bot-frontend/src/features/projects/ui/SprintFormDialog.vue @@ -1,5 +1,5 @@ + + diff --git a/alfy-bot-frontend/src/features/projects/ui/SprintReportPanel.vue b/alfy-bot-frontend/src/features/projects/ui/SprintReportPanel.vue new file mode 100644 index 0000000..26040c5 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/SprintReportPanel.vue @@ -0,0 +1,127 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/StoryBoardView.vue b/alfy-bot-frontend/src/features/projects/ui/StoryBoardView.vue new file mode 100644 index 0000000..db77978 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/StoryBoardView.vue @@ -0,0 +1,92 @@ + + + diff --git a/alfy-bot-frontend/src/features/projects/ui/StoryPlanningFields.vue b/alfy-bot-frontend/src/features/projects/ui/StoryPlanningFields.vue new file mode 100644 index 0000000..d83c021 --- /dev/null +++ b/alfy-bot-frontend/src/features/projects/ui/StoryPlanningFields.vue @@ -0,0 +1,74 @@ + + +