feat(docs): add analytics and pattern showcase stories

2026-03-25 19:59:42 +08:00
parent a5d75f42e9
commit f049736c8a
21 changed files with 5765 additions and 1204 deletions
@@ -0,0 +1,54 @@
+# 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`