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

**Track ID**: `dashboard_refinement_v4_20260313`
**Status**: Planning
**Persona**: PO (UX/Vision), Dev (Stability), UI (Aesthetics)

## 1. Goal
Address critical functional errors (Zod), refine UI aesthetics (rounding, hover effects), complete missing features (Settings, real-time BI), and optimize navigation (Breadcrumbs, Sidebar) to achieve a high-fidelity, production-ready Admin Dashboard.

## 2. Functional Requirements
- **Zod Stability**: Resolve `CustomerDTOSchema` validation error by making the `address` field nullable/optional.
- **BI & Analytics**: 
  - Update `AnalyticsClient.tsx` to use more realistic/dynamic data where possible.
  - Implement a more functional Dashboard overview page with actual charts (Revenue, Orders) using Recharts.
- **Settings Page**: Create a fully functional `/dashboard/settings` page for system configuration.
- **Navigation Polish**:
  - Update `DashboardHeader` breadcrumbs to use a comprehensive `routeMap` and human-readable labels.
  - Rename and link "Bestandsführung" in Sidebar to "Lagerbestand" (Products Overview).
- **Redundancy Cleanup**: Remove duplicate "Add/Create" buttons from entity overview headers (Manufacturers, Suppliers, etc.) and consolidate them into the standardized `EntityOverviewHeader`.

## 3. Non-Functional Requirements
- **Visual Aesthetics (uncodixfy)**:
  - Reduce global border radius from 10px (`0.625rem`) to 8px (`0.5rem`) for a sharper, more professional look.
  - Remove aggressive `hover:scale-[1.02]` effects from all Cards and Buttons (keep only subtle transitions).
- **Code Quality**: Ensure zero `tsc` and `lint` errors.
- **Performance**: Maintain < 200ms response time for dashboard metrics.

## 4. Implementation Rules
- **No Ambiguity**: Implementers MUST provide line numbers and code snippets for all proposed changes.
- **Security**: RBAC checks MUST be verified for all sensitive actions and pages.

## 5. Acceptance Criteria
- [ ] `dashboard/customers/overview` loads without Zod errors.
- [ ] Dashboard Main page displays functional charts and real metrics.
- [ ] Global rounding is reduced and visually consistent.
- [ ] Breadcrumbs show "Katalog > Produkte" instead of "products > overview".
- [ ] `/dashboard/settings` exists and is functional.
- [ ] Duplicate buttons removed from all entity overviews.

## 6. Out of Scope
- Complete redesign of the database schema.
- Third-party API integrations (Stripe, etc.) unless already implemented.