Skip to content

[OpenSpec] 2026-09-29-integriq-adapter-uwlr-eduv #2370

Closed

Description

@github-actions

⚠️ OpenSpec-managed issue — this content is automatically synced
from the openspec/ 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 UwlrEduVProviderRegistry in Application.php; add a planned-claim entry to GatewayCatalogue
  • 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions