Struct Challenge 

pub struct Challenge {

    pub id: Uuid,
    pub organization_id: Uuid,
    pub building_id: Option<Uuid>,
    pub challenge_type: ChallengeType,
    pub status: ChallengeStatus,
    pub title: String,
    pub description: String,
    pub icon: String,
    pub start_date: DateTime<Utc>,
    pub end_date: DateTime<Utc>,
    pub target_metric: String,
    pub target_value: i32,
    pub reward_points: i32,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Challenge entity - Time-bound goals to encourage community engagement

Represents a specific challenge or contest with a defined timeframe. Challenges motivate participation through gamification.

Belgian Context

• Encourages active copropriété community participation
• Promotes use of platform features (SEL, bookings, etc.)
• Builds community spirit through shared goals

Business Rules

• title must be 3-100 characters
• description must be 10-1000 characters
• start_date must be < end_date
• target_value must be > 0
• reward_points must be 0-10000

Fields

id: Uuid

organization_id: Uuid

building_id: Option<Uuid>

challenge_type: ChallengeType

status: ChallengeStatus

title: String

description: String

icon: String

start_date: DateTime<Utc>

end_date: DateTime<Utc>

target_metric: String

target_value: i32

reward_points: i32

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl Challenge

pub const MIN_TITLE_LENGTH: usize = 3usize

Minimum title length

pub const MAX_TITLE_LENGTH: usize = 100usize

Maximum title length

pub const MIN_DESCRIPTION_LENGTH: usize = 10usize

Minimum description length

pub const MAX_DESCRIPTION_LENGTH: usize = 1_000usize

Maximum description length

pub const MAX_REWARD_POINTS: i32 = 10_000i32

Maximum reward points

pub fn new( organization_id: Uuid, building_id: Option<Uuid>, challenge_type: ChallengeType, title: String, description: String, icon: String, start_date: DateTime<Utc>, end_date: DateTime<Utc>, target_metric: String, target_value: i32, reward_points: i32, ) -> Result<Self, String>

Create a new challenge

Validation

• title must be 3-100 characters
• description must be 10-1000 characters
• start_date must be < end_date
• start_date must be in the future
• target_value must be > 0
• reward_points must be 0-10000
• icon must not be empty

pub fn activate(&mut self) -> Result<(), String>

Activate the challenge (Draft → Active)

pub fn complete(&mut self) -> Result<(), String>

Complete the challenge (Active → Completed)

pub fn cancel(&mut self) -> Result<(), String>

Cancel the challenge

pub fn is_currently_active(&self) -> bool

Check if challenge is currently active (now >= start_date AND now < end_date AND status = Active)

pub fn has_ended(&self) -> bool

Check if challenge has ended (now >= end_date)

pub fn duration_days(&self) -> i64

Calculate duration in days

pub fn update( &mut self, title: Option<String>, description: Option<String>, icon: Option<String>, start_date: Option<DateTime<Utc>>, end_date: Option<DateTime<Utc>>, target_value: Option<i32>, reward_points: Option<i32>, ) -> Result<(), String>

Update challenge details (only allowed for Draft challenges)

pub fn update_title(&mut self, title: String) -> Result<(), String>

Update challenge title

pub fn update_description(&mut self, description: String) -> Result<(), String>

Update challenge description

pub fn update_icon(&mut self, icon: String) -> Result<(), String>

Update challenge icon

pub fn update_start_date( &mut self, start_date: DateTime<Utc>, ) -> Result<(), String>

Update challenge start date

pub fn update_end_date(&mut self, end_date: DateTime<Utc>) -> Result<(), String>

Update challenge end date

pub fn update_target_value(&mut self, target_value: i32) -> Result<(), String>

Update challenge target value

pub fn update_reward_points(&mut self, reward_points: i32) -> Result<(), String>

Update challenge reward points

Trait Implementations

impl Clone for Challenge

fn clone(&self) -> Challenge

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Challenge

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Challenge

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Challenge> for ChallengeResponseDto

fn from(challenge: Challenge) -> Self

Converts to this type from the input type.

impl Serialize for Challenge

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

where __S: Serializer,

Serialize this value into the given Serde serializer.