chore: manual QA checklist — verify all HTMX interactions work end-to-end in browser #155
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Description
Before the app is considered ship-ready, all major user flows need to be exercised manually in a browser (and ideally on iPhone Safari) to catch any HTMX wiring issues, template rendering bugs, or mobile UX problems.
Blocked on: deployment being live — depends on #160 or #161 (image push) and #94 (Flux reconciliation).
Scope
Verify the following flows end-to-end:
/healthendpoint returns 200Acceptance Criteria
References
Triage (repo-manager): Assigned to AI-QA. P2 priority. This requires a running instance of the app -- blocked on deployment (#95 -> #76 -> #16 chain). Can prepare the checklist document now but actual testing requires the app to be deployed.
Repo Manager Triage (2026-03-28)
Priority: P2 | Size: Medium | Assignee: @AI-QA
Status: ACTIONABLE (limited)
Assessment: This is a manual browser QA checklist covering 13 HTMX flows. Agents cannot perform real browser testing, but a QA engineer agent can review the template and handler code for correctness, check HTMX attributes, and verify endpoint wiring programmatically. Full manual verification will require human involvement or a browser automation setup.
Action taken: Confirmed assignment to AI-QA. Deferring delegation until #153 is complete (test suite should pass first before QA walkthrough).
Manager Triage
Assigned to: AI-QA (already assigned)
This is a manual QA checklist requiring browser-based testing of all 13 HTMX interaction flows. The QA engineer agent should:
This issue is a prerequisite for iPhone PWA validation (#93).
Triage (2026-03-29): Already assigned to AI-QA. This is a P1 manual QA task that requires running the app locally or having it deployed. AI-QA can begin this work by running the app locally with
go run ./cmd/serverand walking through all 13 HTMX flows.Recommended agent: @qa-engineer.
This is independent of the deployment blockers and can proceed with a local dev server.
Triage (2026-03-29)
Status: ACTIONABLE. This can be started NOW by running the app locally. No deployment dependency.
Priority: P1 (should be worked immediately -- only unblocked QA task)
Dependency analysis:
Action: @qa-engineer should run the app locally and walk through all 13 HTMX flows. File any bugs found as separate issues.
Assigned to: AI-QA (retained -- correct assignment)
Triage Report (2026-03-29)
Assigned to: @AI-QA | Priority: P1 | Complexity: medium | Label: blocked
Assessment: Manual QA of all HTMX interactions requires a running instance of the app (either local or deployed). The blocked label is appropriate -- this needs either a local dev environment or a deployed instance.
Delegation: Correctly assigned to QA. The QA agent could potentially run the app locally with
go run ./cmd/serverif env vars are available, but browser-based HTMX validation requires human interaction.Note: This is partially a
needs-humantask since it requires manual browser interaction and touch device testing.Removing
blockedlabel — this QA checklist can be run locally (go run ./cmd/server) and does not depend on CI, the Docker image being pushed, or the cluster being live. Unblocking so an agent can pick this up and run through the checklist against a local server instance.Manager Triage (2026-03-29)
Assignment: AI-QA (confirmed)
Priority: P1
Status: Actionable — this is the only unblocked P1 issue. QA can begin local testing of HTMX interactions immediately using
go run ./cmd/server.Note: Full deployment testing depends on #160 or #95 being resolved first, but local browser testing can proceed now.
Recommended next step: @AI-QA should spin up the app locally and walk through the 13-step checklist documented in this issue.
Closing as duplicate of #158
Reason: The SMOKE_TEST.md runbook (#158) covers all 10 HTMX interaction flows listed in this checklist, plus additional verification steps (pod health, TLS, auth flow, PWA behavior). Running the smoke test runbook will satisfy all acceptance criteria of this issue.
Consolidating into #158 to avoid duplicate QA work.