Struct NoticeUseCases 

pub struct NoticeUseCases { /* private fields */ }

Implementations

impl NoticeUseCases

pub fn new( notice_repo: Arc<dyn NoticeRepository>, owner_repo: Arc<dyn OwnerRepository>, ) -> Self

pub async fn create_notice( &self, author_id: Uuid, dto: CreateNoticeDto, ) -> Result<NoticeResponseDto, String>

Create a new notice (Draft status)

Authorization

• Author must be a member of the building (validated by owner_repo)

pub async fn get_notice( &self, notice_id: Uuid, ) -> Result<NoticeResponseDto, String>

Get notice by ID with author name enrichment

pub async fn list_building_notices( &self, building_id: Uuid, ) -> Result<Vec<NoticeSummaryDto>, String>

List all notices for a building (all statuses)

Returns

• Notices sorted by pinned (DESC), created_at (DESC)

pub async fn list_published_notices( &self, building_id: Uuid, ) -> Result<Vec<NoticeSummaryDto>, String>

List published notices for a building (visible to members)

Returns

• Only Published notices, sorted by pinned (DESC), published_at (DESC)

pub async fn list_pinned_notices( &self, building_id: Uuid, ) -> Result<Vec<NoticeSummaryDto>, String>

List pinned notices for a building (important announcements)

pub async fn list_notices_by_type( &self, building_id: Uuid, notice_type: NoticeType, ) -> Result<Vec<NoticeSummaryDto>, String>

List notices by type (Announcement, Event, LostAndFound, ClassifiedAd)

pub async fn list_notices_by_category( &self, building_id: Uuid, category: NoticeCategory, ) -> Result<Vec<NoticeSummaryDto>, String>

List notices by category (General, Maintenance, Social, etc.)

pub async fn list_notices_by_status( &self, building_id: Uuid, status: NoticeStatus, ) -> Result<Vec<NoticeSummaryDto>, String>

List notices by status (Draft, Published, Archived, Expired)

pub async fn list_author_notices( &self, author_id: Uuid, ) -> Result<Vec<NoticeSummaryDto>, String>

List all notices created by an author

pub async fn update_notice( &self, notice_id: Uuid, actor_id: Uuid, dto: UpdateNoticeDto, ) -> Result<NoticeResponseDto, String>

Update a notice (Draft only)

Authorization

• Only author can update their notice
• Only Draft notices can be updated

pub async fn publish_notice( &self, notice_id: Uuid, actor_id: Uuid, ) -> Result<NoticeResponseDto, String>

Publish a notice (Draft → Published)

Authorization

• Only author can publish their notice

pub async fn archive_notice( &self, notice_id: Uuid, actor_id: Uuid, actor_role: &str, ) -> Result<NoticeResponseDto, String>

Archive a notice (Published/Expired → Archived)

Authorization

• Only author or building admin can archive

pub async fn pin_notice( &self, notice_id: Uuid, actor_role: &str, ) -> Result<NoticeResponseDto, String>

Pin a notice to top of board (Published only)

Authorization

• Only building admin (admin, superadmin, or syndic) can pin notices

pub async fn unpin_notice( &self, notice_id: Uuid, actor_role: &str, ) -> Result<NoticeResponseDto, String>

Unpin a notice

Authorization

• Only building admin (admin, superadmin, or syndic) can unpin notices

pub async fn set_expiration( &self, notice_id: Uuid, actor_id: Uuid, dto: SetExpirationDto, ) -> Result<NoticeResponseDto, String>

Set expiration date for a notice

Authorization

• Only author can set expiration

pub async fn delete_notice( &self, notice_id: Uuid, actor_id: Uuid, ) -> Result<(), String>

Delete a notice

Authorization

• Only author can delete their notice
• Cannot delete Published/Archived notices (must archive first)

pub async fn auto_expire_notices( &self, building_id: Uuid, ) -> Result<Vec<Uuid>, String>

Automatically expire notices that have passed their expiration date

Background Job

• Should be called periodically (e.g., daily cron job)
• Finds all Published notices with expires_at in the past
• Transitions them to Expired status

pub async fn get_statistics( &self, building_id: Uuid, ) -> Result<NoticeStatistics, String>

Get notice statistics for a building