docs: add dashboard unification plan v2 - panel widths and bloat ordering

Updates:
- Widen tuple read/fetched panels to full width (w=24) in Dashboard 10
- Move "Estimated bloat stats" section right after "Size stats" everywhere
- Rationale: see size and bloat together for better analysis

Author: claude

PLAN_dashboard_unification_v2.md

@@ -0,0 +1,197 @@
+# Dashboard Unification Plan - Update v2
+
+This document outlines additional improvements to dashboard layouts and section ordering.
+
+---
+
+## 1. Panel Width Changes
+
+### Issue
+In Dashboard 10 (Aggregated Index Analysis), the "Tuples read" and "Tuples fetched" panels are displayed side-by-side (w=12 each), making them narrow and hard to read with multiple index entries.
+
+### Current Layout
+```
+| Top indexes by tuples read (w=12) | Top indexes by tuples fetched (w=12) |
+```
+
+### Proposed Layout
+```
+| Top indexes by tuples read (w=24)                                        |
+| Top indexes by tuples fetched (w=24)                                     |
+```
+
+### Changes Required
+
+#### Dashboard 10 (Index Health)
+| Panel | Current gridPos | Proposed gridPos |
+|-------|-----------------|------------------|
+| Top $top_n indexes by tuples read | `"w": 12, "x": 0, "y": 15` | `"w": 24, "x": 0, "y": 15` |
+| Top $top_n indexes by tuples fetched | `"w": 12, "x": 12, "y": 15` | `"w": 24, "x": 0, "y": 25` |
+
+Note: Y position of subsequent panels will need to shift down by 10 (height of the added row).
+
+---
+
+## 2. Bloat Section Reordering
+
+### Rationale
+Moving "Estimated bloat stats" immediately after "Size stats" simplifies analysis:
+- Users can see size metrics and immediately correlate with bloat
+- When bloat is reduced, the size drop is visible in adjacent sections
+- More logical flow: Size → Bloat → Activity → IO
+
+### Current Section Order (all dashboards)
+
+#### Dashboard 8 (Table Stats)
+1. Detailed table view
+2. Size stats
+3. Tuple stats
+4. IO stats
+5. **Estimated bloat stats** ← at end
+
+#### Dashboard 9 (Single Table Analysis)
+1. Size stats
+2. **Estimated bloat stats** ← already correct!
+3. Activity stats
+4. IO stats
+
+#### Dashboard 10 (Index Health)
+1. Detailed index view
+2. Size stats
+3. Index usage stats
+4. IO stats
+5. **Estimated bloat stats** ← at end
+
+#### Dashboard 11 (Single Index Analysis)
+1. Size stats
+2. Index usage stats
+3. IO stats
+4. **Estimated bloat stats** ← at end
+
+### Proposed Section Order
+
+#### Dashboard 8 (Table Stats)
+1. Detailed table view
+2. Size stats
+3. **Estimated bloat stats** ← moved up
+4. Activity stats (was "Tuple stats")
+5. IO stats
+
+#### Dashboard 9 (Single Table Analysis)
+*No change needed - already in correct order*
+
+#### Dashboard 10 (Index Health)
+1. Detailed index view
+2. Size stats
+3. **Estimated bloat stats** ← moved up
+4. Activity stats (was "Index usage stats")
+5. IO stats
+
+#### Dashboard 11 (Single Index Analysis)
+1. Size stats
+2. **Estimated bloat stats** ← moved up
+3. Activity stats (was "Index usage stats")
+4. IO stats
+
+---
+
+## 3. Implementation Details
+
+### Dashboard 10 (Index Health) - Full Changes
+
+#### Step 1: Widen tuple panels
+```json
+// Panel "Top $top_n indexes by tuples read" (id: 27)
+// Change:
+"gridPos": { "h": 10, "w": 12, "x": 0, "y": 15 }
+// To:
+"gridPos": { "h": 10, "w": 24, "x": 0, "y": 15 }
+
+// Panel "Top $top_n indexes by tuples fetched" (id: 28)
+// Change:
+"gridPos": { "h": 10, "w": 12, "x": 12, "y": 15 }
+// To:
+"gridPos": { "h": 10, "w": 24, "x": 0, "y": 25 }
+```
+
+#### Step 2: Move bloat section after size stats
+Reorder panels so "Estimated bloat stats" row and its child panels come immediately after "Size stats" section.
+
+**New Y-position mapping:**
+| Section | Current Y | New Y |
+|---------|-----------|-------|
+| Detailed index view (row) | 0 | 0 |
+| Size stats (row) | 4 | 4 |
+| Size panel | 5 | 5 |
+| **Bloat stats (row)** | 36 → | 15 |
+| Bloat % panel | 37 → | 16 |
+| Bloat size panel | 47 → | 26 |
+| Index usage stats (row) | 15 → | 36 |
+| Tuples read panel | 16 → | 37 |
+| Tuples fetched panel | 16 → | 47 |
+| IO stats (row) | 25 → | 57 |
+| Block reads panel | 26 → | 58 |
+| Block hits panel | 26 → | 58 |
+
+### Dashboard 8 (Table Stats) - Bloat Reorder
+
+Move "Estimated bloat stats" section from position 5 to position 3:
+
+**Current order of row panels:**
+1. "Detailed table view" (y=0)
+2. "Size stats" (y=1)
+3. "Tuple stats" (y=33)
+4. "IO stats" (y=53)
+5. "Estimated bloat stats" (y=95)
+
+**Proposed order:**
+1. "Detailed table view" (y=0)
+2. "Size stats" (y=1)
+3. "Estimated bloat stats" (move up)
+4. "Activity stats" (rename from "Tuple stats")
+5. "IO stats"
+
+### Dashboard 11 (Single Index Analysis) - Bloat Reorder
+
+Move "Estimated bloat stats" section from position 4 to position 2:
+
+**Current order:**
+1. Size stats
+2. Index usage stats
+3. IO stats
+4. Estimated bloat stats
+
+**Proposed:**
+1. Size stats
+2. Estimated bloat stats (move up)
+3. Activity stats (rename)
+4. IO stats
+
+---
+
+## 4. Summary of All Changes
+
+| Dashboard | Change Type | Description |
+|-----------|-------------|-------------|
+| Dashboard 8 | Reorder | Move bloat after size |
+| Dashboard 8 | Rename | "Tuple stats" → "Activity stats" |
+| Dashboard 9 | None | Already correct order |
+| Dashboard 10 | Width | Widen tuple panels to w=24 |
+| Dashboard 10 | Reorder | Move bloat after size |
+| Dashboard 10 | Rename | "Index usage stats" → "Activity stats" |
+| Dashboard 11 | Reorder | Move bloat after size |
+| Dashboard 11 | Rename | "Index usage stats" → "Activity stats" |
+
+---
+
+## 5. Implementation Priority
+
+1. **Dashboard 10** - Widen tuple panels (immediate visual improvement)
+2. **Dashboard 10** - Move bloat section
+3. **Dashboard 8** - Move bloat section
+4. **Dashboard 11** - Move bloat section
+5. **All affected** - Rename rows to "Activity stats"
+
+---
+
+*Document updated for dashboard width and bloat ordering improvements.*