Struct Achievement 

pub struct Achievement {

    pub id: Uuid,
    pub organization_id: Uuid,
    pub category: AchievementCategory,
    pub tier: AchievementTier,
    pub name: String,
    pub description: String,
    pub icon: String,
    pub points_value: i32,
    pub requirements: String,
    pub is_secret: bool,
    pub is_repeatable: bool,
    pub display_order: i32,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Achievement entity - Defines badges/achievements users can earn

Represents a specific accomplishment or milestone in the platform. Achievements encourage community participation and engagement.

Belgian Context

• Promotes active participation in copropriété management
• Encourages use of community features (SEL, notice board, bookings)
• Recognizes contributions to building community

Business Rules

• name must be 3-100 characters
• description must be 10-500 characters
• icon must be valid emoji or URL
• points_value must be 0-1000
• requirements stored as JSON for flexibility

Fields

id: Uuid

organization_id: Uuid

category: AchievementCategory

tier: AchievementTier

name: String

description: String

icon: String

points_value: i32

requirements: String

is_secret: bool

is_repeatable: bool

display_order: i32

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl Achievement

pub const MIN_NAME_LENGTH: usize = 3usize

Minimum name length

pub const MAX_NAME_LENGTH: usize = 100usize

Maximum name length

pub const MIN_DESCRIPTION_LENGTH: usize = 10usize

Minimum description length

pub const MAX_DESCRIPTION_LENGTH: usize = 500usize

Maximum description length

pub const MAX_POINTS_VALUE: i32 = 1_000i32

Maximum points value

pub fn new( organization_id: Uuid, category: AchievementCategory, tier: AchievementTier, name: String, description: String, icon: String, points_value: i32, requirements: String, is_secret: bool, is_repeatable: bool, display_order: i32, ) -> Result<Self, String>

Create a new achievement

Validation

• name must be 3-100 characters
• description must be 10-500 characters
• icon must not be empty
• points_value must be 0-1000
• requirements must not be empty

pub fn update( &mut self, name: Option<String>, description: Option<String>, icon: Option<String>, points_value: Option<i32>, requirements: Option<String>, is_secret: Option<bool>, is_repeatable: Option<bool>, display_order: Option<i32>, ) -> Result<(), String>

Update achievement details

pub fn default_points_for_tier(tier: &AchievementTier) -> i32

Calculate points for tier (helper for auto-calculation)

pub fn update_name(&mut self, name: String) -> Result<(), String>

Update achievement name

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

Update achievement description

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

Update achievement icon

pub fn update_points_value(&mut self, points_value: i32) -> Result<(), String>

Update achievement points value

pub fn update_requirements( &mut self, requirements: String, ) -> Result<(), String>

Update achievement requirements

Trait Implementations

impl Clone for Achievement

fn clone(&self) -> Achievement

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Achievement

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Achievement

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Achievement> for AchievementResponseDto

fn from(achievement: Achievement) -> Self

Converts to this type from the input type.

impl Serialize for Achievement

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

where __S: Serializer,

Serialize this value into the given Serde serializer.