Enum headless_lms_models::user_exercise_states::ReviewingStage

pub enum ReviewingStage {
    NotStarted,
    PeerReview,
    SelfReview,
    WaitingForPeerReviews,
    WaitingForManualGrading,
    ReviewedAndLocked,
}

Tells what stage of reviewing the user is currently in. Used for for peer review, self review, and manual review. If an exercise does not involve reviewing, the value of this stage will always be NotStarted.

Variants

NotStarted

In this stage the user submits answers to the exercise. If the exercise allows it, the user can answer the exercise multiple times. If the exercise is not in this stage, the user cannot answer the exercise. Most exercises will never leave this stage because other stages are reseverved for situations when we cannot give the user points just based on the automatic gradings.

PeerReview

In this stage the student is instructed to give peer reviews to other students.

SelfReview

In this stage the student is instructed to review their own answer.

WaitingForPeerReviews

In this stage the student has completed the neccessary peer and self reviews but is waiting for other students to peer review their answer before we can give points for this exercise.

WaitingForManualGrading

In this stage the student has completed everything they need to do, but before we can give points for this exercise, we need a manual grading from the teacher.

Reasons for ending up in this stage may be one of these:

1. The exercise is configured to require all answers to be reviewed by the teacher.
2. The answer has received poor reviews from the peers, and the exercise has been configured so that the teacher has to double-check whether it is justified to not give full points to the student.

ReviewedAndLocked

In this stage the the reviews have been completed and the points have been awarded to the student. However, since the answer had to go though the review process, the student may no longer answer the exercise since because

1. It is likely that we revealed the model solution to the student during the review process.
2. In case of peer review, a new answer would have to be reviewed by other students again, and that would be unreasonable extra work for others.

If the teacher for some reasoon feels bad for the student and wants to give them a new chance, the answers for this exercise should be reset, the reason should be recorded somewhere in the database, and the value of this column should be set to NotStarted. Deleting the whole user_exercise_state may also be wise. However, if we end up doing this for a teacher, we should make sure that the teacher realizes that they should not give an unfair advantage to anyone.

Trait Implementations

impl Clone for ReviewingStage

fn clone(&self) -> ReviewingStage

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ReviewingStage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'r> Decode<'r, Postgres> for ReviewingStage

fn decode( value: PgValueRef<'r> ) -> Result<Self, Box<dyn Error + Send + Sync + 'static>>

Decode a new value of this type using a raw value from the database.

impl<'de> Deserialize<'de> for ReviewingStage

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'q, DB: Database> Encode<'q, DB> for ReviewingStage

where &'q str: Encode<'q, DB>,

fn encode_by_ref( &self, buf: &mut <DB as HasArguments<'q>>::ArgumentBuffer ) -> IsNull

Writes the value of self into buf without moving self.

fn size_hint(&self) -> usize

fn encode(self, buf: &mut <DB as HasArguments<'q>>::ArgumentBuffer) -> IsNull

where Self: Sized,

Writes the value of self into buf in the expected format for the database.

fn produces(&self) -> Option<<DB as Database>::TypeInfo>

impl PartialEq for ReviewingStage

fn eq(&self, other: &ReviewingStage) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ReviewingStage

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Type<Postgres> for ReviewingStage

fn type_info() -> PgTypeInfo

Returns the canonical SQL type for this Rust type.

fn compatible(ty: &<DB as Database>::TypeInfo) -> bool

Determines if this Rust type is compatible with the given SQL type.

impl Copy for ReviewingStage

impl Eq for ReviewingStage

impl StructuralEq for ReviewingStage

impl StructuralPartialEq for ReviewingStage