From 8dc43766749db12141317bccd6474f7cb27c69bb Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Thu, 5 Nov 2026 09:25:54 +0500 Subject: [PATCH 01/31] docs: plan full issue pages and collapsible stories --- docs/tasks/issue-pages.md | 77 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/tasks/issue-pages.md diff --git a/docs/tasks/issue-pages.md b/docs/tasks/issue-pages.md new file mode 100644 index 0000000..9459914 --- /dev/null +++ b/docs/tasks/issue-pages.md @@ -0,0 +1,77 @@ +# Страницы задач, историй и эпиков + +**Status:** executing +**Branch:** codex/issue-pages +**Worktree:** /Users/v/projects/Alfy/.worktrees/issue-pages +**Base:** adc9b59 +**Mode:** hands-off +**Goal:** Пользователь Alfy открывает задачу, историю или эпик по постоянной ссылке как полноценную рабочую страницу, переходит по иерархии и редактирует те же данные в быстром просмотре; истории на доске сворачиваются без потери контекста. Useless if: URL всё ещё показывает только модалку; страница и preview имеют разные формы; глубокая ссылка требует сначала открыть доску; длинные зависимости обрезаются; сворачивание скрывает статус или теряется при возвращении. + +## Context +- `/tasks/:taskId` уже существует, но TaskView открывает TaskDetailDialog; авторизация сохраняет redirect. +- Эпики/истории открываются через глобальный GroupDetailDialog без маршрутов. Его flex-колонки без min-width допускают переполнение, список всех зависимостей занимает всю боковую панель. +- AgileEpicBlock умеет сворачиваться, AgileStoryBlock — нет. Пользователь отдельно попросил сворачивание истории. +- Основной checkout содержит чужие незакоммиченные изменения; новая работа изолирована от origin/main. + +## Design +Сохранить быстрый просмотр по клику с доски и существующие события. Постоянная ссылка задачи теперь открывает встроенную страницу без overlay; добавить `/tasks/project/:projectId/group/:groupId` для эпика/истории. В preview — копирование ссылки и переход на страницу; ссылки внутри полноценной страницы ведут на страницы связанных сущностей, с обычным Ctrl/Cmd-click. Страница содержит breadcrumbs, широкую область заголовка/описания/дочерних элементов и правую панель свойств; на узком экране одна колонка. Формы общие для страницы и preview, persistence через существующие stores/API. Не вводить отдельную модель issue или новые идентификаторы. + +Быстрый просмотр остаётся диалогом, с ограниченной шириной, читаемыми переносами и доступным скроллом. Зависимости историй: выбранные видны, поиск по кандидатам, ограниченный прокручиваемый список вместо растягивания всей панели. Сохранить ручное применение условий. + +Сворачивание истории — отдельная стрелка с aria-expanded; название продолжает открывать preview. В свёрнутом виде видны название, статус, счётчик и действия. «Добавить задачу» раскрывает историю. Состояние по projectId/storyId хранится в браузере, переживает remount/возврат/перезагрузку; существующая единая сетка колонок и DnD сохраняются. + +Альтернативы: отдельные копии редакторов проще начать, но расходятся; превращение любого клика в переход ломает быстрый workflow доски. Выбраны общие редакторы и явные страницы при сохранении preview. +TDD: yes для маршрутов, загрузки/ошибок/гонок, редактирования и сворачивания; раскладка проверяется браузером. + +### Invariants +- IV1 — URL задачи совместим; группы scoped by project; cold start, reload, login redirect, back/forward работают; 404 и сетевые ошибки различимы. +- IV2 — Одна форма/логика редактирования на сущность для page и preview; не теряются checklist, Pomodoro, workflow, даты, релиз, зависимости, удаление с подтверждением. +- IV3 — Page не открывает overlay; preview закрывается в исходный контекст; переходы по breadcrumbs/дочерним ссылкам корректны, устаревшие async ответы не переключают сущность. +- IV4 — Нет горизонтального обрезания контента на 390px и desktop; длинные названия/зависимости переносимы, keyboard focus и scroll доступны. +- IV5 — Свёрнутая история сохраняет заголовок/статус/счётчик и состояние по своей идентичности; добавление раскрывает, сетка/порядок/DnD не меняют данные. + +## Plan + +### PH1 — Полноценная задача +- `alfy-bot-frontend/src/features/tasks/ui/TaskDetailDialog.vue:1-1120`: извлечь общую форму в TaskDetailContent.vue, сохранить диалоговую оболочку и внешние props/events. +- `src/views/TaskView.vue:1-135`: встроенная общая форма, загрузка по URL, ошибки/retry, удаление, переходы по иерархии без overlay; при необходимости точечное расширение use-task-detail-handlers.ts для page opener. +- `tests/views/TaskView.spec.ts`, `tests/features/tasks/ui/TaskDetailDialog.spec.ts`, новый TaskDetailContent.spec.ts: page vs preview, cold load/edit, ошибки/late responses, frozen tasks и checklist/Pomodoro compatibility. +- Commit: feat(tasks): open permanent task links as full pages. + +### PH2 — Эпики и истории +- `src/features/projects/ui/GroupDetailDialog.vue:1-470`: вынести общую GroupDetailContent.vue с явными projectId/groupId/presentation; wrapper сохраняет singleton preview и переключение task/group. +- Новый `src/views/GroupView.vue`: загрузить project-scoped данные через existing API/store, встроенный редактор, missing/error/retry, связанная навигация и подтверждаемое удаление; устранить гонки при смене route. +- `src/features/projects/ui/StoryPlanningFields.vue:1-74`: поиск/скролл зависимостей, min-width и переносы; сохранить payload и ручное применение. +- Existing GroupDetailDialog tests + новые GroupView/Content/StoryPlanningFields tests. +- Commit: feat(projects): add epic and story pages with shared quick preview. + +### PH3 — Маршруты, ссылки и сворачивание +- `src/router/index.ts:30-80`: group route name=project-group; route/login tests, существующий task route не менять. +- Новые `features/projects/lib/group-link.ts`, `ui/GroupLinkActions.vue`: canonical path и копирование/новая вкладка; использовать общий link actions presentation с существующим TaskLinkActions если это уменьшает дублирование. +- `ui/GroupActionsMenu.vue:90-110`: явный пункт страницы рядом с preview, реальные href. +- `ui/AgileStoryBlock.vue:40-145`, новый `model/board-collapse-store.ts`: сохранение collapsed state, доступная стрелка, скрытые клетки, автопоказ добавления; tests collapse/remount/identity/grid. +- README/CLAUDE/task: страницы и различие с preview, проверка всего потока browser + независимый review. +- Commit: feat(navigation): link group pages and preserve collapsed stories. + +### Interfaces +- IF1 — groupLinkPath(projectId:string, groupId:string): string|null — `/tasks/project/${projectId}/group/${groupId}` только persisted UUID; route name project-group, params projectId/groupId. Producer PH3, consumers PH1/PH2. +- IF2 — GroupLinkActions props `{projectId:string,groupId:string,type:'epic'|'story'}` — copy/new-tab actions using IF1; no mutations. Producer PH3, consumer PH2. +- IF3 — GroupView.vue — page route consumer, uses shared content, owns its task preview if needed; user clicks child title → canonical page. Producer PH2, consumer PH3 router. + +### Interface graph +- PH1 IF1 -> @ alfy-bot-frontend/src/features/tasks/ui/TaskDetailDialog.vue alfy-bot-frontend/src/features/tasks/ui/TaskDetailContent.vue alfy-bot-frontend/src/features/tasks/lib/use-task-detail-handlers.ts alfy-bot-frontend/src/views/TaskView.vue alfy-bot-frontend/tests/views/TaskView.spec.ts alfy-bot-frontend/tests/features/tasks/ui/TaskDetailDialog.spec.ts alfy-bot-frontend/tests/features/tasks/ui/TaskDetailContent.spec.ts +- PH2 IF1, IF2 -> IF3 @ alfy-bot-frontend/src/features/projects/ui/GroupDetailDialog.vue alfy-bot-frontend/src/features/projects/ui/GroupDetailContent.vue alfy-bot-frontend/src/features/projects/ui/StoryPlanningFields.vue alfy-bot-frontend/src/views/GroupView.vue alfy-bot-frontend/tests/views/GroupView.spec.ts alfy-bot-frontend/tests/features/projects/ui/GroupDetailDialog.spec.ts alfy-bot-frontend/tests/features/projects/ui/GroupDetailContent.spec.ts alfy-bot-frontend/tests/features/projects/ui/StoryPlanningFields.spec.ts +- PH3 IF3 -> IF1, IF2 @ remaining frontend navigation/link/collapse files docs/ README.md CLAUDE.md + +### Test strategy +Baseline focused TaskView/TaskDetail/GroupDetail and board suites; RED→GREEN core behavior; full frontend tests and build; local real API + browser desktop/mobile page/edit/reload/preview/dependency overflow/collapse, then independent review. + +### Risks / rollback +- RK1 — Extracting forms affects many callers: preserve wrapper contract, run existing suites, phase commits allow isolated revert. +- RK2 — Store fetch catches errors or ensure returns early: pages must observe complete loading and display actual errors, never stale context. + +## Conclusion +### Hands-off decisions +- make: новый worktree от adc9b59, ранее согласованный автоапрув продолжается; production публикация этой новой доработки отдельна от завершённого предыдущего деплоя. +- udesign: сохраняем существующий quick-preview клик; страницы доступны по постоянным ссылкам и явным действиям, общие редакторы предотвращают расхождение. +- uplan: план auto-approved, PH1/PH2 независимые implementers, PH3 и интеграция контроллером; scope включает последнее дополнение о сворачивании. From fda9085811cd4971192d7d1a24ed688e1b9df81e Mon Sep 17 00:00:00 2001 From: "i.seliverstov" Date: Thu, 5 Nov 2026 09:33:30 +0500 Subject: [PATCH 02/31] feat(tasks): render full task pages with shared preview editor --- .../tasks/lib/use-task-detail-handlers.ts | 5 +- .../features/tasks/ui/TaskDetailContent.vue | 1142 +++++++++++++++++ .../features/tasks/ui/TaskDetailDialog.vue | 1127 +--------------- alfy-bot-frontend/src/views/TaskView.vue | 53 +- .../tasks/ui/TaskDetailContent.spec.ts | 96 ++ .../tests/views/TaskView.spec.ts | 37 +- 6 files changed, 1331 insertions(+), 1129 deletions(-) create mode 100644 alfy-bot-frontend/src/features/tasks/ui/TaskDetailContent.vue create mode 100644 alfy-bot-frontend/tests/features/tasks/ui/TaskDetailContent.spec.ts diff --git a/alfy-bot-frontend/src/features/tasks/lib/use-task-detail-handlers.ts b/alfy-bot-frontend/src/features/tasks/lib/use-task-detail-handlers.ts index 11532f6..31d1269 100644 --- a/alfy-bot-frontend/src/features/tasks/lib/use-task-detail-handlers.ts +++ b/alfy-bot-frontend/src/features/tasks/lib/use-task-detail-handlers.ts @@ -20,7 +20,8 @@ type ConfirmFn = (opts: { cancelText?: string }) => Promise -export function useTaskDetailHandlers(store: TaskStore, confirm: ConfirmFn) { +/** Предоставляет редактирование задачи; onOpenTask заменяет открытие предпросмотра при внешней навигации. */ +export function useTaskDetailHandlers(store: TaskStore, confirm: ConfirmFn, onOpenTask?: (task: Task) => void) { const selectedTask = ref(null) const isDetailOpen = ref(false) const autofocusTitle = ref(false) @@ -41,7 +42,7 @@ export function useTaskDetailHandlers(store: TaskStore, confirm: ConfirmFn) { let unregisterTaskOpener: (() => void) | null = null onMounted(() => { - unregisterTaskOpener = registerTaskOpener(handleOpenTask) + unregisterTaskOpener = registerTaskOpener(onOpenTask ?? handleOpenTask) }) onBeforeUnmount(() => { diff --git a/alfy-bot-frontend/src/features/tasks/ui/TaskDetailContent.vue b/alfy-bot-frontend/src/features/tasks/ui/TaskDetailContent.vue new file mode 100644 index 0000000..13cd53b --- /dev/null +++ b/alfy-bot-frontend/src/features/tasks/ui/TaskDetailContent.vue @@ -0,0 +1,1142 @@ + + +