docs(requirements): add 005 to 008 for hub receipts, score overlays, resources view and home dashboard
005 shows readers and acks under every radio row instead of receipt rows. 006 renames the score labels to Tokens and Velocity, journals every score block, backfills it deterministically and draws each metric as a burndown overlay. 007 merges the hardware load into one chart, adds an accumulated tokens chart, a combined overlay mode and the unsigned /api/view store. 008 adds a Home tab with stars on every panel and item and a 12-column grid. All decisions operator-confirmed 2026-11-13. 🎯 Fix: 95 % 💥 Break: 1 % 💸 Cost: 100 % ⏱️ Time: 100 % 🛡️ Security: 100 % 🏆 Score: 94 🚦 Gate: ✅ 90/5, cost and time <= 100, security 100 % Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
3418738993
commit
7ed142032b
5 files changed
+382
No files matched your search
@@ -0,0 +1,93 @@
|
||||
# 008 - Home Dashboard
|
||||
|
||||
## User Story
|
||||
|
||||
As the operator, I want to star any panel or item of the hub and arrange the
|
||||
starred ones on a Home tab, so that I get my own overview of what matters to
|
||||
me.
|
||||
|
||||
## Decisions (operator-confirmed 2026-11-13; do not re-litigate)
|
||||
|
||||
1. **Home tab**: a new first tab left of Stream (route `#home`); it becomes
|
||||
the start tab once at least one pin exists, otherwise Stream stays the
|
||||
start; an explicit hash wins.
|
||||
2. **Star everywhere**: a star button on every panel (each chart, the
|
||||
stream, the radio log, kanban, gantt, burndown, task list, RASCI,
|
||||
ancestry, 3D, the agents list) and on every single item (message, task,
|
||||
artifact, agent card); pressing it again unpins. Rejected: panels only;
|
||||
panels and agent cards only.
|
||||
3. **Panel registry**: every pinnable panel and item kind registers an id, a
|
||||
title and a render function that takes the tile size; Home renders tiles
|
||||
through it, live with the same data as the source view. Rejected: Home as
|
||||
saved route views (views are not built for small cells and share page
|
||||
state).
|
||||
4. **Grid**: a classic 12-column CSS grid; a tile resizes from 1 to 12
|
||||
columns wide and 1 to 12 rows high by a handle and reorders by drag and by
|
||||
the arrow keys while focused; no layout library. Rejected: gridstack.js (a
|
||||
new dependency for what CSS grid does).
|
||||
5. **Gone items**: a tile whose item no longer exists shows "gone" with an
|
||||
unpin button; it is never removed silently.
|
||||
6. **Persistence**: pins, sizes and order live in the unsigned view store of
|
||||
007, capped at 64 pins.
|
||||
7. **Order**: the registry, stars and grid may start at once against the
|
||||
view store contract of 007; persistence and e2e after 007 is on master.
|
||||
|
||||
## Approach
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
subgraph P["🧭 0 · Preparation"]
|
||||
P1["📋 Write requirement"] --> P2{"✅ Operator approves?"}
|
||||
P2 -- "✏️ corrections" --> P1
|
||||
end
|
||||
P2 -- "🤖 yes" --> A1
|
||||
subgraph A["⭐ A · Registry and stars"]
|
||||
A1["🧩 Panel registry, star on every panel and item"] --> A2{"🧪 Unit and integration green?"}
|
||||
A2 -- "🔴 no: fix" --> A1
|
||||
end
|
||||
A2 -- "🟢 yes, 007 on master" --> B1
|
||||
subgraph B["🏠 B · Home grid"]
|
||||
B1["🔲 12-column grid, resize, drag, keyboard, gone tiles, start tab"] --> B2{"🧪 E2E green?"}
|
||||
B2 -- "🔴 no: fix" --> B1
|
||||
B2 -- "🟢 yes" --> BF{"💬 Operator feedback on screenshots?"}
|
||||
BF -- "✏️ changes" --> B1
|
||||
end
|
||||
BF -- "👍 fits" --> D1["🏁 Review, commit with operator OK, hand-over"]
|
||||
```
|
||||
|
||||
## Acceptance Criteria
|
||||
|
||||
### Stars
|
||||
|
||||
- [ ] The e2e count of registered panels and items without a star is 0
|
||||
across all tabs.
|
||||
- [ ] Starring adds a tile on Home and unstarring removes it; the same
|
||||
layout shows in a second browser.
|
||||
- [ ] A 65th pin is refused with a visible message.
|
||||
|
||||
### Grid
|
||||
|
||||
- [ ] A tile spans w of 12 columns; the handle changes w from 1 to 12 and h
|
||||
from 1 to 12.
|
||||
- [ ] Drag and keyboard reorder work and persist.
|
||||
- [ ] At 390 px width every tile spans all 12 columns.
|
||||
|
||||
### Tiles
|
||||
|
||||
- [ ] A pinned chart updates on the next poll like its source view.
|
||||
- [ ] A pinned task deleted from the register shows "gone" and an unpin
|
||||
button.
|
||||
|
||||
### Start tab
|
||||
|
||||
- [ ] With no pins the hub opens on Stream, with one or more on Home; an
|
||||
explicit hash wins.
|
||||
|
||||
### Tests
|
||||
|
||||
- [ ] Unit: registry lookup, layout validation, reorder math.
|
||||
- [ ] Integration: `/api/view` accepts the pins schema and refuses an
|
||||
oversize or malformed one.
|
||||
- [ ] E2E: Chromium and Firefox at 1920, 1366 and 390: star and unstar,
|
||||
resize, reorder by drag and keyboard, the gone tile, the start tab;
|
||||
screenshots for the checkpoint.
|
||||
Reference in new issue
Block a user