Roster and Grade Exchange

Intent

Define exchange architecture for roster synchronization and grade publication across platform boundaries.

Scope

• Roster ingestion and reconciliation
• Membership lifecycle mapping
• Grade publication pipeline and retry policy

Roster Exchange Model

Roster sources may include:

• LTI NRPS (critical path)
• OneRoster connectors (mid-term)

Internal targets:

• Organization affiliation
• Offering membership
• Role grants where policy allows

Reconciliation Principles

• Imported roster records are never treated as identity truth by themselves
• Identity resolution must pass through identity_binding and person resolution policy
• Membership updates are temporal and auditable
• Source snapshots should be retained for traceability

Grade Exchange Model

Grade publication sources:

• Finalized assessment score events
• Qualification completion events where applicable

Grade publication stages:

1. Candidate event created
2. Validation and policy check
3. Outbound payload construction
4. Delivery attempt
5. Ack/failure recording
6. Retry or terminal failure workflow

Reliability Requirements

• Idempotency keys per target and grade event
• Observable retry strategy with capped backoff
• Dead-letter handling for persistent failures
• Manual remediation hooks with full audit trail

Data Model Touchpoints

• offering_membership state transitions
• assessment_score finalization
• activity_event and publication audit records

Open Decisions

1. How quickly roster diffs must converge in large organizations
2. Grade publication SLA targets for interactive vs batch courses
3. Manual override policy for externally rejected grades