Hanami backend/fi.aalto.cs.hanami.courses/CourseSettingsService

CourseSettingsService

Owns course discovery, validation, replacement, and cache invalidation.

Configuration replacement commits before related template, course, availability, and manual-grading caches are invalidated.

Types

UpstreamMetadata

data class UpstreamMetadata(val tags: List<ExternalCourseTag>, val ltiLoginUrl: String?)

Functions

configuredGraderByEmail

suspend fun configuredGraderByEmail(courseId: Long, email: String, token: String): ConfiguredGraderView

configuredGraderProfiles

suspend fun configuredGraderProfiles(courseId: Long, userIds: List<Long>, token: String): List<ConfiguredGraderView>

courseForManualGradingExercise

suspend fun courseForManualGradingExercise(exerciseId: Long): Long?

create

suspend fun create(configuration: CourseConfiguration): CourseEntry

createCourse

suspend fun createCourse(identity: Identity, token: String, body: CourseConfigurationCreateBody, courseConfigUrlSpecified: Boolean): CourseEntry

delete

suspend fun delete(courseId: Long, expectedRevision: Long): Boolean

discoverConfigurations

suspend fun discoverConfigurations(identity: Identity): List<CourseConfigurationDiscovery>

entries

suspend fun entries(): Collection<CourseEntry>

exportGradersCsv

suspend fun exportGradersCsv(request: AuthorizedCourseRequest): String

find

suspend fun find(courseId: Long): CourseEntry?

get

suspend fun get(courseId: Long): CourseEntry

ids

suspend fun ids(): Set<Long>

importGraders

suspend fun importGraders(request: AuthorizedCourseRequest, expectedRevision: Long, rows: List<List<String>>): CourseEntry

publicCourses

suspend fun publicCourses(): AllCoursesResponse

refreshFromUpstream

suspend fun refreshFromUpstream(request: AuthorizedCourseRequest, expectedRevision: Long): CourseEntry

refreshTemplates

suspend fun refreshTemplates(courseId: Long): TemplateCatalogStatus

replace

suspend fun replace(courseId: Long, expectedRevision: Long, configuration: CourseConfiguration): CourseEntry

replaceValidated

suspend fun replaceValidated(courseId: Long, token: String, expectedRevision: Long, configuration: CourseConfiguration): CourseEntry

requireGradersAreStaff

suspend fun requireGradersAreStaff(courseId: Long, token: String, graders: List<CourseGrader>)

templateStatus

suspend fun templateStatus(courseId: Long): TemplateCatalogStatus?

updateSettings

suspend fun updateSettings(request: AuthorizedCourseRequest, document: VersionedCourseConfiguration): CourseEntry

upstreamMetadata

suspend fun upstreamMetadata(courseId: Long, token: String): CourseSettingsService.UpstreamMetadata

validate

fun validate(configuration: CourseConfiguration): CourseConfiguration

visibleCourses

suspend fun visibleCourses(identity: Identity, token: String): CoursesResponse