course-service 0.2.0

Course Service — a course-administration microservice modelled on schema.org/Course; interoperates with the course-matcher crate
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

//! schema.org/EducationalOccupationalCredential.

use serde::{Deserialize, Serialize};
use utoipa::ToSchema;

/// A credential a course can award — schema.org/EducationalOccupationalCredential.
///
/// Attached to a [`Course`](crate::models::course::Course) via
/// `educational_credential_awarded` / `occupational_credential_awarded`.
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
pub struct EducationalCredential {
    /// Credential title (e.g. "Certificate of Completion").
    pub name: String,
    /// Coarse credential class.
    #[serde(default)]
    pub category: Option<CredentialCategory>,
    /// e.g. ISCED level.
    #[serde(default)]
    pub educational_level: Option<String>,
    /// Issuing competent authority (free text or org URL).
    #[serde(default)]
    pub recognized_by: Option<String>,
    /// Credential URL / Open Badge / Verifiable Credential ID.
    #[serde(default)]
    pub url: Option<String>,
}

/// Coarse classification of an [`EducationalCredential`]. `Custom`
/// keeps the surface extensible without forking the enum.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize, ToSchema)]
pub enum CredentialCategory {
    /// A certificate.
    Certificate,
    /// A diploma.
    Diploma,
    /// An academic degree.
    Degree,
    /// A digital badge (e.g. Open Badge).
    Badge,
    /// A microcredential / nanodegree.
    Microcredential,
    /// A professional license.
    License,
    /// Any category not covered above, carried verbatim.
    Custom(String),
}