Struct Model

pub struct Model {
    pub id: i64,
    pub username: String,
    pub email: String,
    pub password_hash: String,
    pub admin: bool,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub profile_picture_path: Option<String>,
}

Represents a user in the users table.

Fields

id: i64

Primary key ID (auto-incremented).

username: String

Unique student number.

email: String

User’s unique email address.

password_hash: String

Securely hashed password string.

admin: bool

Whether the user has admin privileges.

created_at: DateTime<Utc>

Timestamp when the user was created.

updated_at: DateTime<Utc>

Timestamp when the user was last updated.

profile_picture_path: Option<String>

Implementations

impl Model

pub async fn create( db: &DatabaseConnection, username: &str, email: &str, password: &str, admin: bool, ) -> Result<Model, DbErr>

Creates a new user with hashed password and returns the inserted model.

Arguments

• db - Database connection reference.
• username - Unique student number.
• email - Email address.
• password - Plaintext password to hash.
• admin - Whether the user is an admin.

pub async fn create_fake_user_with_no_hashed_password_do_not_use( db: &DatabaseConnection, username: &str, email: &str, password: &str, admin: bool, ) -> Result<Model, DbErr>

Creates a new user with no hashed password and returns the inserted model. NOTE: FOR SEEDING PURPOSES ONLY DO NOT USE

Arguments

• db - Database connection reference.
• username - Unique student number.
• email - Email address.
• password - Plaintext password to hash.
• admin - Whether the user is an admin.

pub async fn get_by_username( db: &DatabaseConnection, username: &str, ) -> Result<Option<Model>, DbErr>

Fetches a user by student number.

Arguments

• db - Database connection.
• username - The student number to look up.

Returns

An optional user model if found.

pub async fn verify_credentials( db: &DatabaseConnection, username: &str, password: &str, ) -> Result<Option<Model>, DbErr>

Verifies user credentials by checking password against stored hash.

Arguments

• db - Database connection.
• username - The student number of the user.
• password - The plaintext password to verify.

Returns

The user model if credentials are valid.

pub async fn get_module_roles( db: &DatabaseConnection, user_id: i64, ) -> Result<Vec<UserModuleRole>, DbErr>

Retrieves all module roles associated with the user.

Arguments

• db - Database connection.
• user_id - The user ID to query.

Returns

A list of module roles with related metadata.

pub async fn is_in_role( db: &DatabaseConnection, user_id: i64, module_id: i64, role: &str, ) -> Result<bool, DbErr>

Checks whether a user is assigned a specific role in a given module.

Arguments

• db - Database connection.
• user_id - User ID to check.
• module_id - Module ID to check against.
• role - Role name (e.g. “lecturer”, “tutor”, “student”).

Returns

true if the role exists, otherwise false.

pub fn hash_password(password: &str) -> String

Hashes a plaintext password using Argon2 with a generated salt.

Arguments

• password - The plaintext password.

Returns

A hashed password string.

pub fn verify_password(&self, password: &str) -> bool

Verifies a plaintext password against the stored hash

Trait Implementations

impl Clone for Model

fn clone(&self) -> Model

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Model

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

Formats the value using the given formatter.

impl From<Model> for ActiveModel

fn from(m: Model) -> Self

Converts to this type from the input type.

impl FromQueryResult for Model

fn from_query_result(row: &QueryResult, pre: &str) -> Result<Self, DbErr>

Instantiate a Model from a [QueryResult]

fn from_query_result_optional( res: &QueryResult, pre: &str, ) -> Result<Option<Self>, DbErr>

Transform the error from instantiating a Model from a [QueryResult] and converting it to an Option

fn from_query_result_nullable( res: &QueryResult, pre: &str, ) -> Result<Self, TryGetError>

Transform the error from instantiating a Model from a [QueryResult] and converting it to an Option

fn find_by_statement(stmt: Statement) -> SelectorRaw<SelectModel<Self>>

impl IntoActiveModel<ActiveModel> for Model

fn into_active_model(self) -> ActiveModel

Method to call to perform the conversion

impl ModelTrait for Model

type Entity = Entity

fn get(&self, c: <Self::Entity as EntityTrait>::Column) -> Value

Get the [Value] of a column from an Entity

fn set(&mut self, c: <Self::Entity as EntityTrait>::Column, v: Value)

Set the [Value] of a column in an Entity

fn find_related<R>(&self, _: R) -> Select<R>

where R: EntityTrait, Self::Entity: Related<R>,

Find related Models

fn find_linked<L>(&self, l: L) -> Select<<L as Linked>::ToEntity>

where L: Linked<FromEntity = Self::Entity>,

Find linked Models

fn delete<'a, 'async_trait, A, C>( self, db: &'a C, ) -> Pin<Box<dyn Future<Output = Result<DeleteResult, DbErr>> + Send + 'async_trait>>

where 'a: 'async_trait, Self: IntoActiveModel<A> + 'async_trait, C: ConnectionTrait + 'async_trait, A: ActiveModelTrait<Entity = Self::Entity> + ActiveModelBehavior + Send + 'a + 'async_trait,

Delete a model

impl PartialEq for Model

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for Model

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<ActiveModel> for Model

type Error = DbErr

The type returned in the event of a conversion error.

fn try_from(a: ActiveModel) -> Result<Self, DbErr>

Performs the conversion.

impl TryIntoModel<Model> for ActiveModel

fn try_into_model(self) -> Result<Model, DbErr>

Method to call to perform the conversion

impl StructuralPartialEq for Model