# Phase 3: Dashboard Day Cockpit

## Objective

Deliver the operational day dashboard for a selected place/date with planning visualization and KPI pack.

---

## Tasks

### 3.1 Daily planning view

- Build a day schedule timeline widget.
- Support date navigation for future days.
- Group/filter by session type and/or department where relevant.

### 3.2 Operational summary blocks

- Bookings today.
- Upcoming sessions in next hours.
- Check-ins/access count.
- Sales snapshot.

### 3.3 KPI pack implementation

Implement these 6 KPIs:
1. Planned Sessions Today
2. Occupancy Rate by Time Block
3. Coach Utilization
4. Attendance Gap
5. Pending Customer Actions
6. Commercial Pulse (Today)

### 3.4 Charting and drilldowns

- Occupancy heat map / histogram by hour.
- Payment method split chart.
- Coach utilization drilldown list.

---

## File Impact (Expected)

- `app/Filament/V2/Pages/*Dashboard*`
- `app/Filament/V2/Widgets/*`
- `app/Actions/AdminV2/Dashboard/*`
- `app/Data/AdminV2/Dashboard/*`

---

## Acceptance Criteria

- Dashboard data is accurate for selected place/date.
- KPI values are coherent with source entities (bookings/orders/access logs).
- UX remains readable under high-density days.

---

## Tests

- Data aggregation tests per KPI.
- Date/place context tests.
- Widget rendering/permissions tests.