docs(journeydoc): bootstrap capture-driven user documentation

[rubenvdlinde]

Bootstraps the journeydoc pattern (ADR-030) for Procest — capture-driven user documentation where a Playwright spec drives each user journey and refreshes every screenshot on demand.

Scaffold landed

• docs/tutorials/_category_.json + docs/tutorials/{user,admin}/_category_.json — sidebar config for the two tracks
• 11 numbered story skeletons (using tutorial-page.md.template; GOAL / PREREQS / STEPS / VERIFICATION / COMMON_ISSUES / REFERENCE left as {{TODO}} for the human author or /journeydoc-add-story):
  • User track (8): 01-first-launch, 02-my-work, 03-view-case, 04-advance-case, 05-record-decision, 06-track-deadlines, 07-handle-objection, 08-inspection-checklist
  • Admin track (3): 01-configure-case-types, 02-automatic-actions, 03-admin-settings
• tests/e2e/docs-screenshots.spec.ts — capture spec with one test('UN <slug>', …) block per story (11 blocks), each a // TODO: see /journeydoc-add-story stub
• playwright.config.ts — added the docs-capture project; the chromium regression project now testIgnores **/docs-screenshots.spec.ts
• docs/docusaurus.config.js — markdown.hooks.onBrokenMarkdownImages: 'warn' so a fresh checkout that hasn't run the capture spec still builds
• .github/workflows/documentation.yml — also build on development (was documentation-only)

Brown-field migrations applied

• ✅ Moved docs/screenshots/ → docs/static/screenshots/ (8 PNGs) — Docusaurus only copies static/* into the build root, so the old location 404'd on deploy
• ✅ Rewrote 15 relative ../screenshots/... / screenshots/... image refs to root-absolute /screenshots/... (8 in docs/features/*.md, 7 in docs/README.md)
• ✅ Trimmed i18n.locales from ['en', 'nl'] to ['en'] — no translated markdown shipped under docs/i18n/nl/docusaurus-plugin-content-docs/current/ (only a stale current.json), which triggers SSR rendering errors on tutorial pages per ADR-030. The nl i18n/ JSON files are left in place for when a real translation backfill lands.
• ⏭️ Docs domain — already on procest.conduction.nl across all three places (docs/static/CNAME, docusaurus.config.js url:, documentation.yml cname:). No change needed.

Notes / follow-ups

• Story list cross-checked against openspec/specs/ (my-work, case-management, case-dashboard-view, status-transition-engine, advice/voorstel/roles-decisions, doorlooptijd-dashboard, bezwaar-lifecycle, inspection-checklists, case-types, automatic-actions, admin-settings all have specs).
• Did not run npm run build on the docs site — the worktree is a fresh checkout without docs/node_modules; node -c docusaurus.config.js + JSON validation pass.
• Next: fill the {{TODO}}s, run /journeydoc-instrument on capture-relevant Vue components for stable data-testids, then npx playwright test --project docs-capture to populate screenshots.

🤖 Generated with Claude Code

[github-actions]

Quality Report — ConductionNL/procest @ 22b4261

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	❌
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		❌
stylelint		❌
composer			✅	✅ 100/100
npm			✅	✅ 419/419
PHPUnit					⏭️
Newman					⏭️
Playwright					❌

Spec coverage: 7% (32 tests / 456 specs)

---

Quality workflow — 2026-05-12 13:49 UTC

Download the full PDF report from the workflow artifacts.