docs: propagate Round 12 (full user-journey e2e) across all project docs

[bejranonda]

Records Round 12 (the full user-journey e2e spec, PRs #76–#78) everywhere the project documents its testing posture, approach, and known issues — following the established round-documentation conventions.

Changes (11 files, +166/−18)

• README / README-TH — e2e count 93 → 97 (6 spec files), four-lens → five-lens testing posture, Round 12 line in the audit-history summary, quality-gate table.
• CHANGELOG — full Round 12 entry: phase table, findings surfaced while building the spec (intermittent register error-boundary crash, silent sub-500-byte file rejection, duplicate-label button trap, benign console-noise classes), side-effect budget, final test posture.
• RELEASE_NOTES — Round 12 section at top (unreleased).
• CONTRIBUTING — journey-spec testing section with run command, per-run cost, and the four extension rules.
• docs/GUIDELINE — new "The full user-journey lens": approach (terminal-state assertions, runtime fixtures above client floors, type=submit over text selectors, documented-pattern console filtering) and method (phase independence, crash sentinels, side-effect budgets, when to run). Coverage table corrected to 171 unit / 97 e2e.
• docs/ITERATION_PROCESS — §3 notes the spec automates manual checks 1/3/4/5; §9 five-lens table with the Round 12 integration-seam lesson.
• docs/KNOWLEDGE_BASE — user-journey.spec.ts row in the Playwright table + Round 12 section with the seven design decisions for extending the spec.
• docs/KNOWN_ISSUES — new §2a (intermittent client error boundary on register response — sentinel-pinned) and §5 (known-benign console-error noise, documented so new specs reuse the shared filter).
• docs/claude.md + docs/gemini.md — AI-guide sections pointing at the spec, its traps, and the GUIDELINE recipe.

Docs-only change — no code touched.

https://claude.ai/code/session_01BWLU1nKZpxToH5hMeBDusG

---

Generated by Claude Code

Summary by CodeRabbit

• Documentation
  • Updated project guides, contributing guidelines, and changelog to reflect a new comprehensive end-to-end testing suite validating complete user journeys—including file scanning, user authentication, and application routing. Added testing best practices, updated test coverage metrics, and documented known edge cases for developer reference.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b021e630-a82c-4f93-bedb-5af3467dd6ed

📥 Commits

Reviewing files that changed from the base of the PR and between ff2299a and edf75cc.

📒 Files selected for processing (11)

• CHANGELOG.md
• CONTRIBUTING.md
• README-TH.md
• README.md
• RELEASE_NOTES.md
• docs/GUIDELINE.md
• docs/ITERATION_PROCESS.md
• docs/KNOWLEDGE_BASE.md
• docs/KNOWN_ISSUES.md
• docs/claude.md
• docs/gemini.md

---

📝 Walkthrough

Walkthrough

This PR documents Round 12 of the UX-audit initiative, introducing a new full user-journey e2e Playwright test spec as the fifth independent testing lens. The PR updates changelog, release notes, testing guidelines, process documentation, known issues, and model-specific guidance to consistently announce and specify the four-phase end-to-end test covering landing/locale, scan/upload, auth round-trip, and route coverage with terminal-state assertions.

Changes

Round 12 Full User-Journey E2E Testing Documentation

Layer / File(s)	Summary
Changelog and Release Documentation CHANGELOG.md, RELEASE_NOTES.md	Establishes Round 12 milestone with details on the new full user-journey e2e spec structure, four-phase test coverage (locale, scan, auth, routing), identified issues (register crash, silent file rejection, login label duplication), de-flaking approach, side-effect budget, and updated test posture metrics for frontend/backend unit and e2e.
Core Testing Specification and Design docs/GUIDELINE.md, docs/KNOWLEDGE_BASE.md	Introduces comprehensive technical specification for the full-user-journey lens including terminal-state assertion rules, fixture generation constraints, form-field selection guidance, console-error filtering strategy, crash-sentinel methodology for intermittent register bug, explicit side-effect budgeting, and Playwright execution commands.
Process and Contribution Integration docs/ITERATION_PROCESS.md, CONTRIBUTING.md	Updates release/merge verification procedures to emphasize running user-journey.spec.ts first, extends testing-posture framework from four independent lenses (Rounds 7–11) to five lenses (Rounds 7–12), and provides contribution rules with links to full lens documentation.
Known Issues and Benign Patterns docs/KNOWN_ISSUES.md	Documents intermittent client error boundary crash during double-register submission (Phase 3 of e2e) and three classes of expected benign console.error patterns in production (Next.js RSC prefetch, scan logger timeout, cold-start 404s) that are filtered by the e2e benign-error helper.
Public-Facing README Updates and Internationalization README.md, README-TH.md	Updates main README.md to document Round 12 features, expands e2e test count from 93 cases (5 specs) to 97 cases (6 specs), reframes testing posture from four-lens to five-lens model, and updates Thai translation to reflect five lenses and extended rounds (Rounds 7→12).
Model-Specific Development Guidance docs/claude.md, docs/gemini.md	Adds specialized guidance documenting the user-journey spec workflow, test phases (landing, scan, auth, routing), expected runtime (~17s warm), and pre-encoded failure traps (sub-500-byte file drops, login label duplication, console-noise filtering, register crash sentinel) to guide scan/auth/routing changes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~4 minutes

Possibly related PRs

• bejranonda/Nutri-Vision-AI#75: Extends the testing-posture documentation framework from the previous Round 8–11 lens model to Round 12's new full user-journey e2e lens across shared documentation files (README, CONTRIBUTING, ITERATION_PROCESS, GUIDELINE).

Poem

🐰 Round Twelve hops along the UX trail,
Five lenses now see without fail—
Journey tests from launch to land,
Terminal states, all carefully planned,
Console whispers soothed with benign-error bail! 🍀

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch claude/code-review-refactor-212i2

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}