Dashboard

Na tej stronie

Primary Containers
Dashboard Components
Related Widgets
Hooks & Services
State Management
i18n
Storybook Status
Zombie-Risk Notes
Next Actions
Dashboard Module Stats
Dashboard → Other Modules
My Day Panel
Powiązane dokumenty

Dashboard to główny widok po zalogowaniu. Orkiestruje dane z wizyt, zadań, kalendarza i analityki.

Primary Containers

Dashboard.tsx

Główny kontener - orkiestruje data hooks i DashboardScope:

Komponent	Rola
`StickyActionsBar`	Quick actions (add visit, search)
`MiniToolsPanelTabs`	Tabs dla mini tools
`DashboardMainView`	Główny panel z widgetami
`MyDayPanel`	”Today” summary

DashboardMainView.tsx

Stateless panel przyjmujący: visits, insight, loading flags, dateRange.

Komponent	Rola
`VistaInsightCard`	Daily insight
`PinnedNotesBoard`	Pinned notes
`TaskDashboardWidget`	Task list
`Card`	Generic containers

Dashboard Components

Komponent	Opis	Storybook
`MyDayPanel.tsx`	”Today” summary	missing
`MiniToolsDifferentialCard.tsx`	Mini tools card	missing
`StickyActionsBar.tsx`	Quick actions	missing
`MiniToolsPanelTabs.tsx`	Mini tools tabs	missing

Widget	Lokalizacja	Storybook
`TaskDashboardWidget`	`components/tasks/`	missing
`PinnedNotesBoard`	`features/notes/`	missing

Hooks & Services

Hook/Service	Source	Purpose
`useAppointmentsList`	`hooks/appointments/`	Appointments data
`useVisitsList`	`hooks/visits/`	Visits data
`useDailyInsight`	`hooks/`	JSONL asset loader
`useTasks`	`hooks/tasks/`	Tasks data
`analyticsService`	`services/`	Dashboard stats
`DashboardScopeContext`	`contexts/`	Time range, scope

State Management (2025-11)

DashboardStateProvider

Nowy provider w src/components/dashboard/state:

Dashboard + ToolsTray consume one hydrated state
Eliminuje redundantne get_dashboard_state calls
Usuwa window-level event wiring

Persistence

Feature	Via
Pinned items	`useDashboardState`
Histories	`useDashboardState`
Form state	`useDashboardState`
Scope changes	`save` helper (optimistic)

i18n

Namespace	File
`dashboard`	`src/i18n/locales/{pl,en}/dashboard.json`
`common`	`src/i18n/locales/{pl,en}/common.json`

Storybook Status

Story	Status
`Main/Dashboard`	Present (basic state)
`Main/Dashboard/MainView`	Added (Default, Loading, Empty, WithDateRange)
`StickyActionsBar`	Missing
`MiniToolsPanelTabs`	Missing
`MyDayPanel`	Missing
`TaskDashboardWidget`	Missing
`PinnedNotesBoard`	Missing

Zombie-Risk Notes

Next Actions

Add stories for StickyActionsBar and MiniToolsPanelTabs
Run depcruise for dashboard subtree
Use knip to list unused exports

Dashboard Module Stats

Metric	Value
Files	~12
LOC	~4,500
Key Hook	`useDashboardState`

Dashboard → Other Modules

graph LR
    subgraph Dashboard["Dashboard"]
        DashView[Dashboard.tsx]
        MyDay[MyDayPanel]
        TaskWidget[TaskDashboardWidget]
        PinnedNotes[PinnedNotesBoard]
    end

    subgraph Data["Data Sources"]
        WorkspaceData[useWorkspaceData<br/>visits, transcripts]
        AppointmentsData[useAppointmentsList]
        TasksData[useTasks]
        NotesData[NotesProvider]
    end

    subgraph Backend["Backend"]
        VisitsAPI[visitApi]
        TasksAPI[tasksService]
        AnalyticsAPI[analyticsService]
    end

    DashView --> WorkspaceData
    DashView --> AppointmentsData
    MyDay --> TasksData
    TaskWidget --> TasksData
    PinnedNotes --> NotesData

    WorkspaceData --> VisitsAPI
    TasksData --> TasksAPI
    DashView --> AnalyticsAPI

My Day Panel

My Day Panel pokazuje “dzisiejsze” podsumowanie:

Sekcja	Źródło danych
Appointments today	`useAppointmentsList`
Tasks due today	`useTasks` (filter: due_at = today)
Pinned notes	`NotesProvider`
Quick stats	`analyticsService.getDashboardStats`

Powiązane dokumenty

Tasks Overview - Task management
Calendar Overview - Appointments
Analytics - Dashboard analytics