Test Plan - Roosloot.com

Version: 0.7
Date: April 13, 2026

1. Objective

Define how site verification is executed under a lightweight V-model:

• Installation Qualification (IQ): correct deployment/package integrity
• Operational Qualification (OQ): functional behavior under normal use

2. Test Levels

• IQ: files, paths, references, deployability
• OQ: navigation, i18n, docs pages, accessibility, performance

3. Entry Criteria

• Latest changes committed locally
• URS.md, FS.md, and DS.md updated for scope changes

4. Exit Criteria

• All IQ checks pass
• All critical OQ checks pass
• No unresolved High-priority defects

5. Tooling (Preferred Automated)

• Link checker (internal links)
• Playwright (smoke + functional flows)
• Axe/Pa11y (accessibility scan)
• Lighthouse CI (optional deep reporting)

6. Artifacts

• IQ.md (installation qualification protocol/report)
• OQ.md (operational qualification protocol/report)
• Optional CI logs for automated runs

7. Automation Baseline (Implemented)

• Runner: Playwright
• Command: npm run test:e2e
• Config: playwright.config.js
• Tests:
  • tests/e2e/iq.spec.js (IQ automation)
  • tests/e2e/smoke.spec.js (OQ smoke automation)
  • tests/e2e/a11y.spec.js (OQ accessibility baseline via Axe)
  • tests/e2e/perf.spec.js (OQ performance smoke baseline)

8. Change Addendum (2026-02-25)

• For major visual tuning changes on site/visuals-ascii-star-runner.html, include manual checks for:
  • parallax layer motion consistency (no visible layer/texture desync)
  • mountain groove stability across control ranges (especially hill height and groove controls)
  • UFO terrain-follow behavior and craft clipping
  • acceptable frame rate when ASCII mountains are enabled
• Automated coverage remains unchanged unless the visual gains deterministic DOM-testable hooks.

9. Change Addendum (2026-02-25, Game Prototype Branch)

• Add manual prototype test focus for site/swapbound/game.html:
  • split-control mapping correctness (both players required)
  • checkpoint respawn behavior
  • block/switch/bridge puzzle flow
  • control remap trigger clarity
  • room-jump test tool correctness
  • procedural audio behavior (mute, event SFX, background loop)
• Automated Playwright coverage is not yet extended for the prototype page while mechanics/layout remain in active iteration.

10. Change Addendum (2026-03-08, Docs and Visual Routing)

• Add smoke verification for site/visuals.html:
  • confirm the Voxel card is visible
  • confirm the preview image loads
  • confirm the detail-page link resolves
• Add smoke verification for project-level docs hubs:
  • open site/docs/index.html
  • open site/docs/swapbound.html
  • open site/voxel-cutaway-world/docs/index.html
  • confirm each hub links to reachable HTML docs
• Re-run npm run docs:render after markdown documentation updates before smoke verification.

11. Change Addendum (2026-04-13, Gravity Toy Docs)

• Add smoke verification for the new Gravity Toy visual docs set:
  • open site/docs/index.html
  • confirm Gravity Toy Docs appears under Visual docs
  • open site/visuals-gravity/docs/index.html
  • confirm URS, FS, and DS links are present and reachable
  • open site/visuals-gravity/docs/urs.html
  • open site/visuals-gravity/docs/fs.html
  • open site/visuals-gravity/docs/ds.html
• When site/visuals-gravity/docs/*.md changes:
  • re-run npm run docs:render
  • verify the rendered HTML mirrors are regenerated under site/visuals-gravity/docs/