ehoandClaude Opus 5
12f17d9d73
Two backlog trees are complete: `docs/project/backlog/` (75 files, every WP done) and `docs/project/refactor-backlog-setup/` (the arc before it). Move both under `docs/project/archive/` with `git mv`, so history stays intact through `git log --follow`. `SHOWCASE-ROADMAP.md` moves with them, because it points at the now-archived backlog README. Add `docs/project/archive/README.md`. It states that these trees are historical and names the two directories that are still live. Repoint every inbound reference named in RD-30's Files table: CLAUDE.md, the root README, both backend READMEs, `LetterHtml.cs`, `a11y.mdx`, the `document-feature` and `new-ssp` skills, and the readable-codebase PLAN, README, and RD-19 ticket. Fix two upward-relative links inside the moved WP files (WP-68, WP-69) that gained a directory level and would otherwise break. Repoint `.prettierignore`'s two agent-prompt exclusions to their new path, so prettier keeps leaving those files' exact wording alone. Mark RD-30 done and check off its acceptance criteria; flip its README row to done. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
84 lines
3.9 KiB
Markdown
84 lines
3.9 KiB
Markdown
# WP-61 — Bootstrap the behandelportal app
|
|
|
|
Status: done (behandelportal@6b0c6ce — separate sibling repo, not a commit in this one)
|
|
Phase: 11 — Behandelportal
|
|
|
|
## Why
|
|
|
|
ADR-0002 already designed the Behandelaar/backoffice as a separate sibling frontend app,
|
|
not a folder in this repo. Nothing exists yet — `/beheer/zaken` is confirmed to be only a
|
|
cross-owner list+delete, no treatment workflow. The `new-ssp` skill exists precisely to
|
|
bootstrap a new portal from this template; this slice is running that recipe for real,
|
|
with no business context yet — an empty, correctly-scaffolded shell.
|
|
|
|
## Read first
|
|
|
|
- `.claude/skills/new-ssp/SKILL.md`
|
|
- [ADR-0002 — user groups & bounded contexts](../reference/architecture/0002-user-groups-and-bounded-contexts.md)
|
|
- [ADR-0001 — BFF-lite decision DTOs](../reference/architecture/0001-bff-lite-decision-dtos.md)
|
|
|
|
## Decisions (pre-made, don't relitigate)
|
|
|
|
- Follow `new-ssp`'s own "keep vs. strip" checklist as-is: keep the `shared/ui` kernel,
|
|
tooling/CI gates, ADRs 0001-0003; strip the four citizen contexts and citizen branding.
|
|
- The new app talks to the same `BigRegister.Api` backend — no new backend service
|
|
(confirmed by ADR-0002: contexts integrate through the backend).
|
|
- Repo layout: **separate sibling repo** at `/home/eho/repos/behandelportal` (fresh clone —
|
|
`scripts/create-frontend.mjs`'s own header comment says to run it inside a fresh clone, not
|
|
against this repo's working tree).
|
|
|
|
## Resolution (kickoff deviation from the vanilla recipe)
|
|
|
|
`create-frontend.mjs` unconditionally renames the backend project regardless of
|
|
`--skip-backend` (that flag only gates the `gen:api` regen step) — which conflicts with
|
|
"no new backend service" above. Resolved by running the script as-is
|
|
(`--name Behandelportal --context behandeling --skip-backend`), then in the new repo:
|
|
deleting `backend/` entirely, vendoring its `swagger.json` into `api-contract/swagger.json`,
|
|
and pointing `gen:api` at `nswag run nswag.json` against that vendored doc instead of
|
|
regenerating from a live backend. Dev workflow is two terminals: `BigRegister.Api` runs from
|
|
_this_ repo on `:5000`, Behandelportal serves on `:4201` via its own unchanged
|
|
`proxy.conf.json`.
|
|
|
|
Also found and fixed by hand (real bugs in `create-frontend.mjs`, not specific to this WP):
|
|
`plop context`'s `.dependency-cruiser.js` insertion anchors on the `showcase`
|
|
`CONTEXT_ALLOWED` entry, which is already stripped by the time `plop context` runs in the
|
|
same invocation — so a freshly scaffolded context silently gets **no boundary-fence
|
|
entry**, and `dep:check` passes green with the architecture guarantee simply absent. Not
|
|
re-fixed in `create-frontend.mjs` itself this pass (out of scope here) — just compensated for by
|
|
hand in the new repo.
|
|
|
|
## Files
|
|
|
|
Whatever `new-ssp`'s recipe touches (new app root, `package.json`, shared/ui copy or
|
|
workspace reference, CI config) — enumerate at kickoff by following the skill.
|
|
|
|
## Steps
|
|
|
|
1. Run the `new-ssp` bootstrap per its own checklist.
|
|
2. Confirm the known un-genericizable rough edges it flags (`shared/ui/debug-state/`, the
|
|
`/dashboard` route) are handled per the skill's own guidance (delete / TODO stopgap)
|
|
rather than re-solved from scratch.
|
|
3. Land an empty landing/login page only — no `behandeling` context yet (that's WP-64+).
|
|
4. Get the new app's own CI green.
|
|
|
|
## Acceptance criteria
|
|
|
|
- [x] New app boots and its own `npm run ci` is green.
|
|
- [x] No citizen-facing business context (`registratie`, `herregistratie`, `brief`,
|
|
`showcase`) present.
|
|
- [x] Points at the same backend (`BigRegister.Api`) as this repo, no new backend stood
|
|
up.
|
|
|
|
## Verification
|
|
|
|
`npm run ci` in the new app; manual smoke — app loads to an empty shell page.
|
|
|
|
## Out of scope
|
|
|
|
Any `behandeling` screens (WP-64/65), identity (WP-62), status lifecycle (WP-63).
|
|
|
|
## Risks
|
|
|
|
`new-ssp`'s own docs already name its rough edges (`debug-state`, `/dashboard`) — budget
|
|
time for those rather than being surprised by them.
|