cadence-ui/docs/exec-plans/2026-03-25-analytics-workspace-scene.md

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