docs: master tracking issue — overall implementation phases

[strausmann]

Tracking

This issue tracks all phases. Update checkboxes as work lands.

• Phase 0 — Hardware tests (PT-P750W ✅, QL-820NWBc — see test(hardware): QL-820NWBc smoke test (TCP/9100 + SNMP + first print) #12)
• Phase 1 — Repo skeleton (this initial commit covers most of it; project layout under app/ to be added with Phase 2)
• Phase 2 — Plugin foundation + PT-Series plugin (feat(printer-models): Brother PT-Series plugin (PT-E550W/PT-P710BT/PT-P750W) #10) + QL-Series plugin (feat(printer-models): Brother QL-Series plugin (QL-800/QL-810W/QL-820NWB) #11) + StatusBlockParser + TapeRegistry + StatusProbe + PrintQueue (feat(queue): print queue with pause/resume/cancel/retry/priority #13) — delivered via feat(printer-models): Brother PT-Series TapeRegistry with TZe and heat-shrink specs #47–feat(printer-models): PrintQueue worker with pause/resume/cancel/retry #50
• Phase 3 — App lookup clients (Snipe-IT/Grocy/Spoolman) — delivered via feat(integrations): LabelData schema + Snipe-IT lookup client #51, feat(integrations): Grocy + Spoolman lookup clients with shared NotFoundError base #52, feat(integrations): AppLookupService aggregator — Phase 3 complete #53
• Phase 3.5 — Integration-Plugin-Architecture: IntegrationPlugin Protocol + IntegrationRegistry + entry_points discovery; refactored existing clients to plugins — delivered via feat(integrations): plugin architecture for lookup clients (Phase 3.5) #55
• Phase 4 — LabelRenderer ✅ (feat(label-renderer): Template schema + Pillow/qrcode renderer for 1-bit label bitmaps #54) + Default templates + TemplateLoader — delivered via feat(templates): default templates + TemplateLoader (Phase 4) #56 (12 templates on 12/18/24mm + generic QR-only; atomic loader with reload; TemplateSchema.app: str \| None + schema_version field)
• Phase 5 — SQLModel persistence (feat: SQLModel persistence layer #19)
• Phase 6 — REST + SSE API (feat(api): REST endpoints + OpenAPI #18 + feat(api): SSE endpoint + EventBus for live updates without page reload #14)
• Phase 7 — HTMX UI + EventBus + PWA (feat(api): SSE endpoint + EventBus for live updates without page reload #14, feat(pwa): manifest + service worker + offline shell #15) + Notifications (feat(pwa): browser notifications for job/status events (Web Notifications API + Web Push) #5) — includes template editor
• Phase 8 — Container build + sample compose (already in examples/)
• Phase 9 — App-side webhook configuration (Spoolman/Grocy)
• Phase 10 — Documentation (see new docs issue)
• Phase 12 (optional) — Prometheus snmp_exporter (see new prometheus issue)

Architecture decisions

• Frontend stack — decided in feat: clarify frontend architecture (Go server vs Python+HTMX vs static) #1 (closed)
• Notifications — see feat(pwa): browser notifications for job/status events (Web Notifications API + Web Push) #5
• Plugin pattern for integrations — Protocol + Registry + entry_points (PR feat(integrations): plugin architecture for lookup clients (Phase 3.5) #55)
• Template schema versioning — schema_version: 1 field for forward-compat (PR feat(templates): default templates + TemplateLoader (Phase 4) #56)

References

• Brother PT raster spec extract: docs/research/2026-05-10-brother-pt-raster-extract.md
• QL raster spec extract: added in repo
• Spec/plan in maintainer's private repo (homelab-pangolin-client) — not mirrored here

Status (2026-05-15)

Released: v0.3.0 (with #54). PR #55 merged (Phase 3.5 — plugin architecture). PR #56 merged (Phase 4 — default templates + loader). 12 seed templates ship by default; new integrations + templates can be added via entry_points without core repo changes.

Next: Phase 5 SQLModel persistence (#19) for custom templates created via the future editor.