55 lines
2.4 KiB
Markdown
55 lines
2.4 KiB
Markdown
# Analytics Workspace Scene
|
|
|
|
- Status: `completed`
|
|
- Owner: `codex`
|
|
- Date: `2026-03-25`
|
|
|
|
## Goal
|
|
|
|
Add a new Storybook `Scenes` entry that mirrors the supplied logistics analytics reference page
|
|
while staying inside Cadence UI's active tonal Material-inspired design language and leaning on the
|
|
current shared component set first.
|
|
|
|
## Scope
|
|
|
|
- In scope:
|
|
- add a new `Scenes/Analytics Workspace` story under `apps/docs/src`
|
|
- match the reference page's main information architecture: sidebar, top workspace toolbar,
|
|
analytics header, KPI cards, two upper chart panels, and one wide lower trend panel
|
|
- reuse existing shared components for shell, navigation, cards, charts, inputs, badges, and
|
|
segmented controls whenever possible
|
|
- keep the scene responsive across mobile and desktop Storybook widths
|
|
- Out of scope:
|
|
- pixel-matching the supplied screenshot's white-label brand
|
|
- replacing the active Cadence tonal system with a new one-off skin
|
|
- changing shared component APIs unless a clear gap blocks the composition
|
|
|
|
## Constraints
|
|
|
|
- Follow `DESIGN.md` over the raw screenshot when style details conflict.
|
|
- Do not disturb unrelated in-progress workspace changes.
|
|
- Keep any missing visual glue local to the scene unless it is clearly reusable.
|
|
|
|
## Affected Surfaces
|
|
|
|
- `apps/docs/src`
|
|
- `docs/exec-plans`
|
|
|
|
## Plan
|
|
|
|
1. Add an execution plan for the new analytics workspace scene.
|
|
2. Compose the new scene from the current shell, nav, toolbar, stat, metric, and chart components.
|
|
3. Fill any remaining screenshot-specific presentation gaps with lightweight scene-local helpers.
|
|
4. Run the narrowest useful docs validation for the changed surface.
|
|
|
|
## Validation
|
|
|
|
- `pnpm harness:validate:changed`
|
|
|
|
## Status Log
|
|
|
|
- `2026-03-25 20:14` started plan for a new analytics workspace scene based on the provided logistics dashboard reference
|
|
- `2026-03-25 20:31` added `Scenes/Analytics Workspace` with a sidebar shell, workspace toolbar, KPI cards, two upper chart panels, and a wide lower automation trend panel
|
|
- `2026-03-25 20:36` verified `apps/docs/src/analytics-workspace.stories.tsx` with `pnpm exec eslint apps/docs/src/analytics-workspace.stories.tsx` and `pnpm --filter @ai-ui/docs typecheck`
|
|
- `2026-03-25 20:37` noted `pnpm harness:validate:changed` is currently blocked by unrelated pre-existing lint errors in `packages/ui/src/components/gauge.tsx` and `packages/ui/src/components/progress.test.tsx`
|