# Track Plan: Comprehensive Dashboard Refinement & Functional Polish (v4)

**Track ID**: `dashboard_refinement_v4_20260313`
**Status**: In Progress

## Phase 1: Stability & Navigation [Skills: Fullstack-Development] [MCP: FileSystem]
- [x] Task: Fix `CustomerDTOSchema` Zod validation error. [Skills: Managing-Schemas] [MCP: FileSystem]
    - [x] [Scout] Verify `CustomerDTOSchema` in `lib/db/schemas/api.ts`.
    - [x] Update `address` field to `.nullable().optional()`.
    - [x] Verify fix by running `pnpm run typecheck`.
- [x] Task: Human-friendly Breadcrumbs & Sidebar. [Skills: Styling-UI-UX] [MCP: FileSystem]
    - [x] [Scout] Map all current dashboard routes.
    - [x] Update `routeMap` in `components/dashboard/DashboardHeader.tsx` with all missing routes (brands, shipments, etc.).
    - [x] Update `components/dashboard/layout/Sidebar.tsx` to rename "Bestandsführung" and link to products.

## Phase 2: Visual Polish (Radius & Effects) [Skills: Styling-UI-UX, Uncodixfy] [MCP: FileSystem]
- [x] Task: Global Border Radius Adjustment. [Skills: Styling-UI-UX] [MCP: FileSystem]
    - [x] Update `app/globals.css`: Change `--radius` from `0.625rem` to `0.5rem`.
- [x] Task: Hover Effect Standardization. [Skills: Styling-UI-UX] [MCP: FileSystem]
    - [x] [Scout] Find all components with `hover:scale-[1.02]`.
    - [x] Remove aggressive scale transforms from `components/ui/card.tsx`, `components/ui/button.tsx`, and `MetricPill`.
    - [x] Ensure subtle `transition-all duration-300` remains for hover states (shadow/border only).

## Phase 3: Dashboard & BI Functionality [Skills: Fullstack-Development, Styling-UI-UX] [MCP: FileSystem]
- [x] Task: Fully functional Dashboard Main Page. [Skills: Fullstack-Development] [MCP: FileSystem]
    - [x] [Scout] Check available metrics in `OrderRepository`.
    - [x] Update `app/(private)/dashboard/page.tsx` to include dynamic charts for Revenue Trend (Recharts).
    - [x] Replace placeholder "Quick Actions" with more useful metrics or links.
- [x] Task: Create `/dashboard/settings` Page. [Skills: Fullstack-Development] [MCP: FileSystem]
    - [x] Implement a standardized settings layout with tabs (Profile, System, Appearance).

## Phase 4: Overviews & RBAC Verification [Skills: Fullstack-Development, Securing-Applications] [MCP: FileSystem, Shell]
- [x] Task: Entity Overview Button Cleanup. [Skills: Styling-UI-UX] [MCP: FileSystem]
    - [x] Audit all `/overview/page.tsx` files.
    - [x] Consolidate buttons into the standardized `EntityOverviewHeader`.
- [x] Task: RBAC Verification. [Skills: Securing-Applications] [MCP: Shell]
    - [x] [Scout] Check middleware and server actions for `requireAdmin`.
    - [x] Verify that non-admin users cannot access sensitive dashboard paths.

## Phase 5: Quality Gates & Finalization [Skills: Authoring-Git-Commits] [MCP: Shell]
- [x] Task: Final Quality Audit. [Skills: Software-Architecture] [MCP: Shell]
    - [x] Run `pnpm run build` and `pnpm run lint`.
    - [x] Verify all reported UI issues are resolved.
- [x] Task: Commit & Sync Docs. [Skills: Authoring-Git-Commits] [MCP: Shell]
    - [x] Commit changes with `chore(conductor): Comprehensive Dashboard Refinement (v4)`.
    - [x] Synchronize `product.md` and `tech-stack.md`.

## Phase: Review Fixes
- [x] Task: Apply review suggestions 870f8f6