Files
kandev/docs/plans/azure-devops-integration/task-16-board-ui.md
T
2026-08-24 11:09:03 +00:00

102 lines
4.3 KiB
Markdown

---
id: "16-board-ui"
title: "Editable desktop and mobile board"
status: done
wave: 9
depends_on: ["14-board-discovery", "15-board-mutations"]
plan: "plan.md"
spec: "../../specs/integrations/requirements/azure-devops-integration.md"
---
# Task 16: Editable Desktop And Mobile Board
## Acceptance
- `/azure-devops` opens in Board mode, initializes project → team → board using
the spec defaults, resets invalid dependent selections, and renders column
counts/limits plus core card fields from one shared board view model.
- Fine-pointer desktop uses an internally scrolling multi-column board with
optimistic drag/move and rollback; wider card editing exposes title,
assignee, tags, split done state, and the Azure link.
- Phone composition shows one focused column with previous/next controls and a
bottom-drawer hierarchy navigator. A full-height, safe-area-aware editor
provides the same fields and an explicit move control without document
horizontal overflow or a touch-drag requirement.
## Verification
- `rtk pnpm --filter @kandev/web test -- --run lib/api/domains/azure-devops-api.test.ts hooks/domains/azure-devops/use-azure-devops-board.test.tsx components/azure-devops/azure-devops-board-model.test.ts` from `apps`.
- `rtk pnpm --filter @kandev/web typecheck` from `apps`.
- `rtk pnpm --filter @kandev/web lint` from `apps`.
## Files Likely Touched
- `apps/web/lib/types/azure-devops.ts`
- `apps/web/lib/api/domains/azure-devops-api.ts`
- `apps/web/lib/api/domains/azure-devops-api.test.ts`
- `apps/web/hooks/domains/azure-devops/use-azure-devops-board.ts`
- `apps/web/hooks/domains/azure-devops/use-azure-devops-board.test.tsx`
- `apps/web/app/azure-devops/azure-devops-page-client.tsx`
- `apps/web/components/azure-devops/azure-devops-board.tsx`
- `apps/web/components/azure-devops/azure-devops-board-model.ts`
- `apps/web/components/azure-devops/azure-devops-board-model.test.ts`
- `apps/web/components/azure-devops/azure-devops-board-navigator.tsx`
- `apps/web/components/azure-devops/azure-devops-board-card.tsx`
- `apps/web/components/azure-devops/azure-devops-board-item-editor.tsx`
## Dependencies
Tasks 14-15.
## Parallelism
Sequential. The page, hooks, components, and API types share the same view
model and mutation state.
## Inputs
- Spec sections: What (Board mode), API Surface, Failure Modes, Scenarios.
- Required workflows: `.agents/skills/tdd/SKILL.md`,
`.agents/skills/mobile-parity/SKILL.md`, and
`.agents/skills/e2e/SKILL.md`.
- Mobile exemplar:
`apps/web/components/kanban/mobile-column-tabs.tsx` for focused-column
previous/next navigation and the hierarchy drawer.
- Desktop exemplars:
`apps/web/components/kanban/adaptive-desktop-kanban.tsx` for contained
horizontal scrolling and
`apps/web/components/kanban/swimlane-kanban-content.tsx` for optimistic DnD
rollback.
## Mobile Design Contract
- Desktop outcome: view every Azure column, drag cards between columns, and
edit core fields without leaving `/azure-devops`.
- Mobile entry point and hierarchy: Board mode opens one focused column; the
center navigator shows project/team/board/column context, while previous and
next controls move one column at a time.
- Presentation: an inset bottom drawer owns temporary hierarchy selection; a
full-height editor owns dense card editing. The board column is the only
vertical scroll owner, and the editor uses `100dvh`, internal scrolling, and
bottom safe-area clearance.
- Shared logic: project/team/board selection, grouping, edits, move state,
conflict refresh, and errors stay in shared hooks/view-model code. Only
composition and the desktop drag affordance differ by viewport/pointer.
- Touch targets are at least 44px, every required action is visible or in an
explicit menu/drawer, and mobile selection never overwrites a persisted
desktop preference.
## Risks
- `azure-devops-page-client.tsx` is already near the frontend file-size limit;
keep board state/composition in extracted modules rather than growing the
page.
- A drag result is provisional until Azure returns the updated revision.
Rollback must not overwrite a newer successful refresh or edit.
## Output Contract
Report responsive compositions, shared-state boundaries, files changed,
RED/GREEN commands, targeted checks, visual verification status, blockers and
risks, then set this task and its plan checkbox to done.