feat(site): the Zuiddrecht example resident: Sanne de Vries, her cases and a sign-in without a broker

[rubenvdlinde]

What

The Zuiddrecht example site (#1206, #1208) had nobody to sign in as, so the area behind "Mijn Zuiddrecht" was never seen. This adds the example resident of the design, Sanne de Vries, with her cases, and a way to sign in as her on a demo or test instance without a DigiD broker and without the test sign-in.

occ portaliq:example-resident:install zuiddrecht
occ portaliq:example-resident:remove zuiddrecht

• Declaration lib/Settings/sites/residents/zuiddrecht.json: the resident (Nextcloud account id sanne.devries, audience citizen), the way in (mode nextcloud with the card "Voorbeeldinwoner"), and ten dossiq objects: five cases on dossiq's shipped case types (a Woo request in treatment with the design's five steps, a building permit waiting for a drawing, a report about a loose paving stone, two finished cases), one open question and four messages. Dates are counted from the day of the install; a case type is found by its identifier, a status by its name, and a message quotes the number the register gave its case. Every stored key was held against dossiq's own register file (0 unknown keys, 0 enum or required misses) and read back live.
• Install makes the Nextcloud account (password shown once, or OC_PASS with --password-from-env), the portal account, adds the sign-in mode to the portal (its card only when the portal has none), writes the objects in order, reads everything back and exits 2 when anything is dropped, missing or not kept. It never takes over an account it did not make (--user picks another id), and a second run writes nothing.
• Remove deletes from the install's own record: messages, question, portal account, Nextcloud account, the mode when the install added it. OpenRegister refuses to delete a case (archival schema), and dossiq refuses a purge while a term runs, so the cases are named, stay recorded, and a new install under the same id uses them again.
• The demo door is the nextcloud sign-in mode, which already existed: a session is minted only for a Nextcloud account with an active portal account under the same id (checked live: admin through the same link gets 403 no_portal_account). The test sign-in stays closed (404 checked live); the docs now say what it is, that debug mode opens it, and why it stays off.

Docs: docs/Installation/example-site-zuiddrecht.md gained "The example resident", "Who can sign in this way", "Why not the test sign-in" and "Remove the resident". OpenSpec change example-resident-zuiddrecht.

What the resident sees (live on a test instance, dossiq 0.4.43)

Sign-in page with the third card; the overview with "Welkom, Sanne", the question "Stuur de bouwtekening van uw dakkapel", three case cards with step bars, the newest messages; "Mijn zaken" with Lopend (3) and Afgerond (2); the case page with the five Woo steps, the detail card and the message button; Berichten with two unread. Screenshots in the coordinator's hand-back (~/memcap-work/zuiddrecht/mijn/shots/pr1-*.png).

Verified

• composer check:strict (COMPOSER_PROCESS_TIMEOUT=0, own TMPDIR): lint, phpcs, psalm, phpstan green; phpmd green on this diff after the refactor commit (the earlier run named 7 complexity findings in the new files, all split); PHPUnit exit 1 with 46 errors, all inherited: the same 46 tests (PageHistoryTest, RenameDutchColumnsTest, NoticeWriteGuardListenerTest and others) fail identically on clean development, list identical to the previous lane's development baseline (diff empty), and none of their files is in this diff.
• New PHPUnit: 17 tests, 160 assertions, green (installer, remover, values, catalogue, commands).
• npm run lint exit 0 (0 errors, 108 inherited warnings), npm run format exit 0, node --test tests/example-resident.spec.mjs 5/5, every check:specs member green except two inherited bundle-size checks (check:traffic-client, check:site-edit-mode) that measure a development build on the tree they ran in. There is no test:l10n script in this repo.
• hydra gates (ConductionNL/.github main, HYDRA_GATE_BASE_REF=origin/development): all 86 applicable gates passed and ran.
• Live on :8097: install (exit 0, 5/1/4 created and found), second install (exit 0, all already there), remove (exit 2, cases named), install again (exit 0, 5 cases kept, 1 question and 4 messages created), sign-in as the resident, every page above.

Not in this PR

Documents on a case (need a file on the case object plus an informatieobject and its join), the design's exact case numbers (the register numbers cases), a parkeervergunning case (dossiq ships none; the waiting case is an omgevingsvergunning). The case page shows "Wat er is gebeurd" and "Documenten" twice (dossiq's page declares timeline and documents blocks and the citizenCase screen repeats them) and one untranslated line ("This case is not open for changes from the portal"): both are inherited and listed for the coordinator.

🤖 Generated with Claude Code

[github-actions]

Quality Report — ConductionNL/portaliq @ c0859ce

Check	PHP	Vue	Security	License	Tests
lint	✅
phpcs	✅
phpmd	✅
psalm	✅
phpstan	✅
phpmetrics	✅
eslint		✅
stylelint		✅
build		✅
check-specs		✅
check-manifest		✅
format		✅
check-l10n-js		✅
check-schema-l10n		✅
check-reuse		✅
composer			✅	✅ 108/108
npm			✅	✅ 984/984
app:check-code	⏭️
info.xml	✅
REUSE	✅
lockfile sync		✅
PHPUnit					✅
Newman					✅
Playwright					⏭️ deferred: E2E runs locally and on the promotion path only. This pull request targets development, so the suite is asked once per promotion into beta and main rather than once per push per open pull request. Run it locally with npx playwright test, or from the Actions tab on a branch with no open pull request into development.
Hydra gates					✅

---

Quality workflow — 2026-10-06 05:56 UTC

Download the full PDF report from the workflow artifacts.