Breid de OciServe-contractpoort uit voor Managed Intake #2262

New issue

Closed

opened 2026-10-04 12:11:35 +00:00 by brenno · 0 comments

brenno commented

2026-10-04 12:11:35 +00:00

Owner

Aanleiding

OciDeck bewaart al een gepinde kopie van OciServe OpenAPI in test/fixtures/ociserve_openapi.yaml en controleert drift via test/ociserve_api_drift_test.dart en lib/services/ociserve/ociserve_gateway.dart. Managed Intake voegt normale OIDC/tenant-routes én publieke doelgebonden respondentroutes toe.

Upstream contract: brenno/OciServe#629

Werk

Vernieuw de gepinde specificatie pas vanaf de OciServe-main-commit met definitief contract en capabilitycatalogus.
Pin broncommit, hash en catalogusversie volgens de bestaande conventie.
Breid gateway/modellen uit zonder serverpayloads of secrets in diagnoselogging.
Controleer voor iedere gebruikte intake-route methode, pad, security scheme, request-/responsevelden en fouttypen.
Houd organisator- en respondentauth strikt gescheiden.
Lees onbekende status-, revisie-, policy- of probleemwaarden fail-closed.
Leg bytegrenzen, timeouts, idempotency en ETag/If-Match vast in client en tests.

INTAKE_PROTOCOL.md en INTAKE_SERVER_REQUIREMENTS.md van het oude ontwerp zijn geen contractbron. Neem geen oude /v1-routes, invite-tokens, Ed25519 requests of ciphertext-receipts over.

Acceptatiecriteria

Fixture verwijst naar één verifieerbare OciServe-main-commit en exacte spec-hash.
Capabilitycatalogusversie en gebruikte capabilities komen exact overeen.
Alle intakecalls worden door drift-tests afgedekt.
Organisatorcalls vereisen OIDC/tenantcontext; respondentcalls nooit.
OTP, locator en bearer grants verschijnen niet in URL-query, logs of fouten.
Onbekende enums/toestanden blokkeren wijzigen en geven een veilige update-melding.
Contracttests dekken RFC 9457, 401/403/404/409/412/413/429 en retry-informatie.
Grootte, hash, revisie en formulierversie worden vóór verwerking gecontroleerd.
Bestaande OciServefunctionaliteit en lokale formulierroute blijven groen.

Afhankelijkheden

Geblokkeerd door #2259 en merge van OciServe #629. Dit issue landt vóór #2260.

## Aanleiding OciDeck bewaart al een gepinde kopie van OciServe OpenAPI in `test/fixtures/ociserve_openapi.yaml` en controleert drift via `test/ociserve_api_drift_test.dart` en `lib/services/ociserve/ociserve_gateway.dart`. Managed Intake voegt normale OIDC/tenant-routes én publieke doelgebonden respondentroutes toe. Upstream contract: https://pawprint.vigilis.online/brenno/OciServe/issues/629 ## Werk - Vernieuw de gepinde specificatie pas vanaf de OciServe-`main`-commit met definitief contract en capabilitycatalogus. - Pin broncommit, hash en catalogusversie volgens de bestaande conventie. - Breid gateway/modellen uit zonder serverpayloads of secrets in diagnoselogging. - Controleer voor iedere gebruikte intake-route methode, pad, security scheme, request-/responsevelden en fouttypen. - Houd organisator- en respondentauth strikt gescheiden. - Lees onbekende status-, revisie-, policy- of probleemwaarden fail-closed. - Leg bytegrenzen, timeouts, idempotency en ETag/If-Match vast in client en tests. `INTAKE_PROTOCOL.md` en `INTAKE_SERVER_REQUIREMENTS.md` van het oude ontwerp zijn geen contractbron. Neem geen oude `/v1`-routes, invite-tokens, Ed25519 requests of ciphertext-receipts over. ## Acceptatiecriteria - [ ] Fixture verwijst naar één verifieerbare OciServe-main-commit en exacte spec-hash. - [ ] Capabilitycatalogusversie en gebruikte capabilities komen exact overeen. - [ ] Alle intakecalls worden door drift-tests afgedekt. - [ ] Organisatorcalls vereisen OIDC/tenantcontext; respondentcalls nooit. - [ ] OTP, locator en bearer grants verschijnen niet in URL-query, logs of fouten. - [ ] Onbekende enums/toestanden blokkeren wijzigen en geven een veilige update-melding. - [ ] Contracttests dekken RFC 9457, 401/403/404/409/412/413/429 en retry-informatie. - [ ] Grootte, hash, revisie en formulierversie worden vóór verwerking gecontroleerd. - [ ] Bestaande OciServefunctionaliteit en lokale formulierroute blijven groen. ## Afhankelijkheden Geblokkeerd door #2259 en merge van OciServe #629. Dit issue landt vóór #2260.

brenno added the

enhancement

security

labels

2026-10-04 12:11:35 +00:00

brenno referenced this issue

2026-10-04 12:14:19 +00:00

Herontwerp formulierintake als optionele OciServe Managed Intake #2259

brenno referenced this issue

2026-10-04 16:03:58 +00:00

docs(intake): Managed Intake als richting — FORM_INTAKE revisie 4 (#2259) #2266

brenno added the