docs(07-01): complete dashboard and navigation polish plan

- SUMMARY.md documents /packages route, dashboard live queries, 99 tests green
- STATE.md advanced to 7/7 phases complete (100%)
- ROADMAP.md marks Phase 7 and plan 07-01 complete

.planning/phases/07-dashboard-nav-polish/07-01-SUMMARY.md

@@ -0,0 +1,80 @@
+---
+phase: 07-dashboard-nav-polish
+plan: 01
+subsystem: web-ui
+tags: [dashboard, navigation, packages, integration]
+one_liner: "Wired dashboard to live DB queries and added /packages listing page closing two visible integration gaps"
+dependency_graph:
+  requires:
+    - "imptune/db/models.py (Printer, Client, Driver)"
+    - "imptune/templates/base.html (nav link /packages)"
+    - "Existing /printers/{id}/packages/intunewin and /ninja endpoints"
+  provides:
+    - "GET /packages route rendering printers with drivers"
+    - "Dashboard recent_printers and recent_packages live queries"
+    - "packages.html template"
+  affects:
+    - "imptune/api/pages.py (dashboard + new packages_page)"
+    - "imptune/templates/dashboard.html (clickable links, quick actions)"
+tech_stack:
+  added: []
+  patterns:
+    - "Deferred imports inside route bodies"
+    - "list(Model.select()...) wrapper over Peewee queries"
+    - "LEFT_OUTER joins on Client + Driver with switch(Printer)"
+key_files:
+  created:
+    - "imptune/templates/packages.html"
+    - ".planning/phases/07-dashboard-nav-polish/07-01-SUMMARY.md"
+  modified:
+    - "imptune/api/pages.py"
+    - "imptune/templates/dashboard.html"
+    - "tests/test_static.py"
+decisions:
+  - "packages_page follows printers_page join pattern (LEFT_OUTER Client + Driver, switch, list wrapper)"
+  - "Empty-state message shown when no driver-assigned printers exist; filter via Printer.driver.is_null(False)"
+  - "Dashboard list items are anchor tags linking to /printers/{id} detail"
+metrics:
+  duration_min: 1
+  tasks_completed: 2
+  files_touched: 4
+  tests_added: 3
+  tests_total: 99
+  completed_at: "2026-04-13"
+---
+
+# Phase 7 Plan 1: Dashboard and Packages Wire-Up Summary
+
+Closed two visible integration gaps: the /packages nav link previously returned 404 and the dashboard was rendering hard-coded empty lists despite real records in the database.
+
+## What Was Built
+
+- **New `/packages` route** in `imptune/api/pages.py` mirroring the `printers_page` join pattern; filters to printers where `driver IS NOT NULL` and renders the new `packages.html` template.
+- **`packages.html` template** extending `base.html`, showing a Pico grid table with printer name (linked to detail page), client, driver filename, and direct download links for `.intunewin` and NinjaRMM ZIP packages.
+- **Dashboard live queries**: `recent_printers = Printer.select().order_by(created_at desc).limit(5)` and `recent_packages` filtered to driver-assigned printers only.
+- **Dashboard UX polish**: list items are now anchors to `/printers/{id}`; quick-action buttons (New Printer / Upload Driver / Export Package) are wired to real routes with `aria-disabled` removed.
+- **Three integration tests** in `tests/test_static.py` proving /packages returns 200, dashboard shows real printer names, and the recent packages section includes only driver-assigned printers.
+
+## Verification
+
+- Full test suite: `python -m pytest tests/` → **99 passed, 0 failed**
+- TDD flow: RED commit (8cf47f5) → GREEN commit (91910ad)
+- All three new tests failed as expected before the implementation landed and pass after.
+
+## Deviations from Plan
+
+None — plan executed exactly as written.
+
+## Commits
+
+- `8cf47f5` test(07-01): add failing tests for /packages route and dashboard data
+- `91910ad` feat(07-01): wire dashboard data and add /packages listing page
+
+## Self-Check: PASSED
+
+- FOUND: imptune/templates/packages.html
+- FOUND: imptune/api/pages.py (packages_page route present)
+- FOUND: imptune/templates/dashboard.html (clickable links + wired quick actions)
+- FOUND: tests/test_static.py (3 new tests)
+- FOUND commit: 8cf47f5
+- FOUND commit: 91910ad