Struct Notice 

pub struct Notice {

    pub id: Uuid,
    pub building_id: Uuid,
    pub author_id: Uuid,
    pub notice_type: NoticeType,
    pub category: NoticeCategory,
    pub title: String,
    pub content: String,
    pub status: NoticeStatus,
    pub is_pinned: bool,
    pub published_at: Option<DateTime<Utc>>,
    pub expires_at: Option<DateTime<Utc>>,
    pub archived_at: Option<DateTime<Utc>>,
    pub event_date: Option<DateTime<Utc>>,
    pub event_location: Option<String>,
    pub contact_info: Option<String>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
}

Community notice board entry

Represents an announcement, event, lost & found item, or classified ad posted on the building’s community board.

Business Rules

• Title must be 5-255 characters
• Content must be non-empty (max 10,000 characters)
• Draft notices cannot be pinned
• Only published notices are visible to building members
• Expired notices are automatically marked as Expired
• Events must have event_date and event_location
• Lost & Found and Classified Ads should have contact_info

Fields

id: Uuid

building_id: Uuid

author_id: Uuid

notice_type: NoticeType

category: NoticeCategory

title: String

content: String

status: NoticeStatus

is_pinned: bool

published_at: Option<DateTime<Utc>>

expires_at: Option<DateTime<Utc>>

archived_at: Option<DateTime<Utc>>

event_date: Option<DateTime<Utc>>

event_location: Option<String>

contact_info: Option<String>

created_at: DateTime<Utc>

updated_at: DateTime<Utc>

Implementations

impl Notice

pub fn new( building_id: Uuid, author_id: Uuid, notice_type: NoticeType, category: NoticeCategory, title: String, content: String, event_date: Option<DateTime<Utc>>, event_location: Option<String>, contact_info: Option<String>, ) -> Result<Self, String>

Create a new notice (Draft status)

Validation

• Title must be 5-255 characters
• Content must be non-empty (max 10,000 characters)
• Events must have event_date and event_location

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

Publish a draft notice

Transitions

Draft → Published

Business Rules

• Only Draft notices can be published
• Sets published_at timestamp

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

Archive a notice

Transitions

Published → Archived Expired → Archived

Business Rules

• Only Published or Expired notices can be archived
• Sets archived_at timestamp
• Unpins notice if pinned

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

Mark notice as expired

Transitions

Published → Expired

Business Rules

• Only Published notices can expire
• Unpins notice if pinned

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

Pin notice to top of board

Business Rules

• Only Published notices can be pinned
• Draft, Archived, Expired notices cannot be pinned

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

Unpin notice

pub fn is_expired(&self) -> bool

Check if notice is expired

Returns true if expires_at is set and is in the past

pub fn update_content( &mut self, title: Option<String>, content: Option<String>, category: Option<NoticeCategory>, event_date: Option<Option<DateTime<Utc>>>, event_location: Option<Option<String>>, contact_info: Option<Option<String>>, expires_at: Option<Option<DateTime<Utc>>>, ) -> Result<(), String>

Update notice content

Business Rules

• Only Draft notices can be updated
• Same validation as new()

pub fn set_expiration( &mut self, expires_at: Option<DateTime<Utc>>, ) -> Result<(), String>

Set expiration date

Business Rules

• Expiration date must be in the future
• Can be set for Draft or Published notices

Trait Implementations

impl Clone for Notice

fn clone(&self) -> Notice

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Notice

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Notice

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Notice

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

where __S: Serializer,

Serialize this value into the given Serde serializer.