#6 - S-05 · BIG Domain Service skeleton with the Registration aggregate - register-referentie

eho commented

2026-06-03 09:52:57 +00:00

Owner

Outcome: A .NET service exposing a single endpoint POST /registrations. The Registration aggregate has a state machine with at minimum INGEDIEND. The service orchestrates: start a Flowable process → external task callback executes the ACL OpenZaak → zaak URL stored on the aggregate.

Acceptance:

BDD scenario: "Given a zorgprofessional submits a registration, when the domain service receives it, then a Flowable process is started and a zaak is opened in OpenZaak."
Integration test exercises the full path (no real frontend yet).
The Workflow Client is the only code that calls Flowable.

Touches: services/domain/, services/acl/ (consumed), tests, ADR for external-task job-worker pattern.

Out of scope: any other use case, documents, decisions.

Definition of Done

A linked Gitea issue exists (this one).
Failing test written and committed first.
Implementation makes the test pass.
Refactor commit follows if structure improved.
Conventional Commit messages referencing this issue (refs #NN).
All Gitea Actions CI jobs green: lint, unit, integration, mutation (ratchet), e2e, container build + push, compose-up smoke test.
docker compose up from a fresh clone reaches green health checks within 3 minutes.
Docs touched if behaviour, contracts, or operations changed.
ADR added in docs/architecture/ if a non-obvious decision was made.
Demo note appended to docs/demo-script.md if the slice is user-visible.
This issue closed by the merging PR (closes #NN).

**Outcome:** A .NET service exposing a single endpoint `POST /registrations`. The Registration aggregate has a state machine with at minimum `INGEDIEND`. The service orchestrates: start a Flowable process → external task callback executes the ACL `OpenZaak` → zaak URL stored on the aggregate. **Acceptance:** - BDD scenario: "Given a zorgprofessional submits a registration, when the domain service receives it, then a Flowable process is started and a zaak is opened in OpenZaak." - Integration test exercises the full path (no real frontend yet). - The Workflow Client is the only code that calls Flowable. **Touches:** `services/domain/`, `services/acl/` (consumed), tests, ADR for external-task job-worker pattern. **Out of scope:** any other use case, documents, decisions. ## Definition of Done - [ ] A linked Gitea issue exists (this one). - [ ] Failing test written and committed first. - [ ] Implementation makes the test pass. - [ ] Refactor commit follows if structure improved. - [ ] Conventional Commit messages referencing this issue (`refs #NN`). - [ ] All Gitea Actions CI jobs green: lint, unit, integration, mutation (ratchet), e2e, container build + push, compose-up smoke test. - [ ] `docker compose up` from a fresh clone reaches green health checks within 3 minutes. - [ ] Docs touched if behaviour, contracts, or operations changed. - [ ] ADR added in `docs/architecture/` if a non-obvious decision was made. - [ ] Demo note appended to `docs/demo-script.md` if the slice is user-visible. - [ ] This issue closed by the merging PR (`closes #NN`).