docs(03-02): complete printer detail page plan summary

- 03-02-SUMMARY.md: printer detail page with driver info and regenerate placeholder - STATE.md: advance position, record metrics and decisions - ROADMAP.md: phase 03 marked complete (2/2 plans done) - REQUIREMENTS.md: PRNT-10 marked complete
2026-04-10 13:05:55 +02:00
parent cad664c0f6
commit 7c0ae66d39
4 changed files with 125 additions and 10 deletions
@@ -0,0 +1,112 @@
+---
+phase: 03-printer-configuration
+plan: 02
+subsystem: ui
+tags: [fastapi, jinja2, htmx, peewee, sqlite]
+
+# Dependency graph
+requires:
+  - phase: 03-01
+    provides: Printer and Client CRUD endpoints, DB models, printer_list partial template
+
+provides:
+  - GET /printers/{id} detail route with LEFT OUTER JOINs on Client and Driver
+  - printer_detail.html full-page template showing all config fields and driver info
+  - Disabled "Regenerate Package" button (Phase 4 placeholder)
+  - Clickable printer name links in printer_list.html navigating to detail page
+
+affects:
+  - 04-script-generation (regenerate button placeholder ready to wire up)
+
+# Tech tracking
+tech-stack:
+  added: []
+  patterns:
+    - "TDD RED/GREEN cycle: failing tests committed first, then implementation"
+    - "LEFT OUTER JOIN chain with .switch(Printer) for multi-FK queries in Peewee"
+    - "Null-safe driver_desc parse: check printer.driver_id before json.loads"
+
+key-files:
+  created:
+    - imptune/templates/printer_detail.html
+  modified:
+    - imptune/api/pages.py
+    - imptune/templates/partials/printer_list.html
+    - tests/test_printer_crud.py
+
+key-decisions:
+  - "Detail page is a full-page template (not partial) — simpler than partial injection into printers.html"
+  - "Route lives in pages.py (not printers.py) because it returns a full HTML page, not an HTMX fragment"
+
+patterns-established:
+  - "Full-page detail routes in pages.py; HTMX fragment routes in api/printers.py"
+  - "Disabled placeholder buttons for Phase N+1 features with descriptive title attribute"
+
+requirements-completed:
+  - PRNT-10
+
+# Metrics
+duration: 2min
+completed: 2026-04-10
+---
+
+# Phase 3 Plan 02: Printer Detail Page Summary
+
+**GET /printers/{id} detail page with pre-populated config fields, associated driver info via FK, and disabled Regenerate Package button placeholder for Phase 4**
+
+## Performance
+
+- **Duration:** ~2 min
+- **Started:** 2026-04-10T12:03:29Z
+- **Completed:** 2026-04-10T12:05:56Z
+- **Tasks:** 2
+- **Files modified:** 4
+
+## Accomplishments
+
+- Printer detail route with Peewee multi-FK LEFT OUTER JOIN queries returning 200 or 404
+- Full-page Jinja2 template showing all 8 config fields, driver package name, driver names list, and architecture
+- Graceful "No driver assigned" display when driver FK is null
+- Printer names in list view are now clickable navigation links to their detail pages
+- 3 new integration tests; full suite at 61 passing
+
+## Task Commits
+
+1. **Task 1: Write failing tests for printer detail page** - `6e7892e` (test)
+2. **Task 2: Implement printer detail route, template, and list nav links** - `cad664c` (feat)
+
+**Plan metadata:** (committed next)
+
+## Files Created/Modified
+
+- `imptune/api/pages.py` - Added GET /printers/{printer_id} route with LEFT OUTER JOIN on Client and Driver
+- `imptune/templates/printer_detail.html` - Full-page detail template with config, driver info, and regenerate placeholder
+- `imptune/templates/partials/printer_list.html` - Printer name column wrapped in anchor tag linking to detail page
+- `tests/test_printer_crud.py` - Added 3 tests: detail with driver, 404 not found, detail without driver
+
+## Decisions Made
+
+- Detail page uses a full-page template (not a partial) to avoid coupling it to the printers list layout
+- Route placed in `pages.py` since it returns a full HTML page, keeping HTMX fragment routes in `api/printers.py`
+
+## Deviations from Plan
+
+None - plan executed exactly as written.
+
+## Issues Encountered
+
+None.
+
+## User Setup Required
+
+None - no external service configuration required.
+
+## Next Phase Readiness
+
+- PRNT-10 satisfied: saved configs are retrievable with driver association intact
+- "Regenerate Package" button is present and disabled, ready for Phase 4 to wire up
+- No blockers for Phase 4 script generation work
+
+---
+*Phase: 03-printer-configuration*
+*Completed: 2026-04-10*