docs(ui): record backlog board baseline

This commit is contained in:
Ashley Venn 2026-07-07 12:15:48 -07:00
parent 932a7409fc
commit edfde0a2d0

View file

@ -0,0 +1,34 @@
<!-- SPDX-FileCopyrightText: 2026 FocusFlow contributors -->
<!-- SPDX-License-Identifier: AGPL-3.0-only -->
# UI Plan 2 Implementation Notes
## Block 01 Baseline Map
1. Sidebar and app shell currently render through
`apps/focus_flow_flutter/lib/widgets/sidebar.dart`,
`apps/focus_flow_flutter/lib/widgets/app_shell.dart`, and the
`FocusFlowHome` parts under `apps/focus_flow_flutter/lib/app/home/`.
2. Navigation state is not implemented yet. `Sidebar` hard-codes Today as
active, and `FocusFlowHome` owns only Today controllers. UI Plan 2 should add
app-level section state in the home/composition layer before rendering the
Backlog board.
3. Backlog board data needs new public scheduler application read models. The
current `BacklogQueryResult` is list-shaped and returns raw `Task` values via
`BacklogItemReadModel`, which is not enough for board columns, summary,
detail drawer metadata, or suggested slot previews.
4. Existing commands include quick capture to backlog, schedule backlog item to
next available slot, move flexible tasks to backlog, remove task, and break
up task. Push-to-Someday and non-destructive backlog archive still need
command-level decisions before the drawer actions can be final.
5. UI Plan 1 components to reuse include `FocusFlowTokens`, the dark shell,
timeline reward icon, difficulty bars, selected overlay patterns, and the
top-bar icon/segmented-control styling conventions.
## Block 01 Validation
- `scripts/bootstrap_dev.sh`: passed.
- `dart analyze`: passed.
- `dart test`: passed.
- `flutter analyze` in `apps/focus_flow_flutter`: passed.
- `flutter test` in `apps/focus_flow_flutter`: passed.