Repository navigation
Description
⚠️ OpenSpec-managed issue — this content is automatically synced
from theopenspec/directory. Manual edits will be overwritten on next sync.
Artifacts
Summary
Give learniq's data-exchange layer live wire adapters for the four
connection families the round-1 comparison found with zero or near-zero
implementation: UWLR (pupil/group/teacher export to Kennisnet-registered
publishers and test suppliers), Edu-V (three separately qualified data
services — Onderwijsdeelnemers, Onderwijsgroepen, Onderwijsmedewerkers),
Basispoort (PO pupil/group/staff sync + method/publisher SSO hand-off) and
Entree content SSO hand-off (the VO equivalent, distinct from Entree's own
login-federation use in entree-surfconext-sso-contract). A sibling
learniq change, uwlr-eduv-basispoort-contract, adds the DataMappingProfile
seeds and job-type declarations for all four targets; this change is the
wire adapter only, per D3's abstract-integration split, mirroring
integriq-adapter-rod/-verzuimloket/-oso's provider-seam shape.
Out of scope, explicitly: UWLR's own "results back" import direction
(Cito/IEP/Boom/Dia test results) is a separate change,
integriq-adapter-lvs-imports, depending on a different sibling contract
(lvs-import-contract) that reuses the LvsResult schema. This change
ships UWLR/Edu-V/Basispoort/Entree-content export and sync only.
Specs
Tasks
- Implement (uwlr-eduv binding reuses the shared Digikoppeling transport; refuses closed without a resolvable certificateRef)
- Test (unknown provider id fails naming itself; fail-closed path)
- Implement (pupil/group/teacher subtypes, eckId required, literal-leak guard)
- Test (each subtype; missing eckId raises before any XML)
- Implement (onderwijsdeelnemers/onderwijsgroepen/onderwijsmedewerkers, each naming its own targetSchema)
- Test (three distinct targetSchema values; unknown data service rejected)
- Implement (PO pupil/group/staff export + ssoAudience hand-off)
- Test (complete payload; missing ssoAudience raises)
- Implement (VO content SSO hand-off, structurally distinct from entree-surfconext-sso-contract)
- Test (complete payload; missing schoolBrin raises)
- Implement (kenmerk required before any dispatch)
- Test (accepted, rejected, missing-kenmerk paths)
- Implement (send/sync/receiveReturn/retryFailed orchestration across all four targets)
- Test (per-target persistence; event dispatch on retour)
- Implement (
uwlr/eduV/basispoort/entreeContent: NoAdminRequired;retour: PublicPage + HMAC verification before any processing) - Test (200/400/503 on each send endpoint; 401 on unsigned retour)
- Implement (hourly TimedJob, retries only status=failed rows across all targets, per-message isolation)
- Test (invokes retryFailed(); no-ops cleanly; contains a sweep-level exception)
- Implement a catalogue card (id
uwlr-eduv, category government) with the log/uwlr-eduv config schema - DI-register
UwlrEduVProviderRegistryinApplication.php; add aplanned-claim entry toGatewayCatalogue - Card label/description carry no em-dashes and no Title Case (writing skill applied); icon MUST already be registered in
src/icons.js(verified before commit)
Design
See design.md for technical design details.
Synced from openspec/changes/archive/2026-09-29-integriq-adapter-uwlr-eduv by OpenSpec workflow
App: integriq
Activity