Module logic 

Per-item world-state resolution: pure functions over the working set, with now passed in.

The caller resolves faults ahead of this, so per item the order is first matching fault, then here.

Enums

ImportResolution

What resolving one import item comes to before anything is written.

IncomingGrade 🔒

The Finnish grade string Suotar ranks by: 1–5, “Hyv.” or a fail.

Constants

NO_ACCEPTORS_VIOLATION 🔒

Suotar’s approver violation, as its translation table words it.

RECENTLY_ACCEPTED_HOURS 🔒

How far back Suotar checks its own accepted sends, which the importer’s copy of Sisu may not show yet.

Functions

acceptor_lookup_fails

Whether the batch’s acceptor lookup would fail for any of these submissions’ course units.

attainment_summary 🔒

attainments_for 🔒

beats 🔒

Higher grade wins; with equal grades more credits win; with those equal too a later date wins, by more than a day on the 0–5 scale. A fail never beats a pass.

clamp_into_study_right 🔒

A date on or before the start moves to the start, one on or after the end to the day before it, and nothing may precede a grant date that falls inside the validity.

course_not_allowed_reason 🔒

credits_of 🔒

enrolment_dto 🔒

enrolments_for 🔒

existing_attainment 🔒

import_outcome

Read back from the submission, the way Suotar answers after its send.

is_identical 🔒

is_passed 🔒

is_pending 🔒

An accepted send stays pending for good: Sisu took it, so notRegistered would invite a second.

list_by_course_item

Only realisations whose activity period ends after two months ago are listed; one with no end date never is.

numeric_grade 🔒

A pass/fail attainment has no numeric correspondence, which Suotar compares as zero.

recently_accepted 🔒

A send Sisu accepted within RECENTLY_ACCEPTED_HOURS of the same completion. Not matched on the date, which Suotar’s cron runs vary for one completion.

record_submission

resolve_enrolments_item

resolve_import_item

Suotar’s checks in its own order, first failure wins.

resolve_person_item

retry_after 🔒

validate_course_code_item

verify_item

write_and_send

Writes the submission and sends it: refused by Sisu when the world holds violations for it, accepted otherwise.