Struct ChallengeUseCases 

pub struct ChallengeUseCases { /* private fields */ }

Use cases for challenge operations

Orchestrates business logic for challenge CRUD, activation/completion, and progress tracking.

Implementations

impl ChallengeUseCases

pub fn new( challenge_repo: Arc<dyn ChallengeRepository>, progress_repo: Arc<dyn ChallengeProgressRepository>, ) -> Self

pub async fn create_challenge( &self, dto: CreateChallengeDto, ) -> Result<ChallengeResponseDto, String>

Create a new challenge (Draft status)

Authorization

• Only organization admins can create challenges

pub async fn get_challenge( &self, challenge_id: Uuid, ) -> Result<ChallengeResponseDto, String>

Get challenge by ID

pub async fn list_challenges( &self, organization_id: Uuid, ) -> Result<Vec<ChallengeResponseDto>, String>

List all challenges for an organization

pub async fn list_challenges_by_status( &self, organization_id: Uuid, status: ChallengeStatus, ) -> Result<Vec<ChallengeResponseDto>, String>

List challenges by status

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

List challenges for a building

pub async fn list_active_challenges( &self, organization_id: Uuid, ) -> Result<Vec<ChallengeResponseDto>, String>

List active challenges (Active status + date range)

pub async fn update_challenge( &self, challenge_id: Uuid, dto: UpdateChallengeDto, ) -> Result<ChallengeResponseDto, String>

Update challenge (Draft only)

Authorization

• Only organization admins can update challenges
• Can only update Draft challenges

pub async fn activate_challenge( &self, challenge_id: Uuid, ) -> Result<ChallengeResponseDto, String>

Activate challenge (Draft → Active)

Authorization

• Only organization admins can activate challenges

pub async fn complete_challenge( &self, challenge_id: Uuid, ) -> Result<ChallengeResponseDto, String>

Complete challenge (Active → Completed)

Authorization

• Only organization admins can complete challenges

pub async fn cancel_challenge( &self, challenge_id: Uuid, ) -> Result<ChallengeResponseDto, String>

Cancel challenge (Draft/Active → Cancelled)

Authorization

• Only organization admins can cancel challenges

pub async fn delete_challenge(&self, challenge_id: Uuid) -> Result<(), String>

Delete challenge (admin only)

pub async fn get_challenge_progress( &self, user_id: Uuid, challenge_id: Uuid, ) -> Result<ChallengeProgressResponseDto, String>

Get user progress for a challenge

pub async fn list_challenge_progress( &self, challenge_id: Uuid, ) -> Result<Vec<ChallengeProgressResponseDto>, String>

List all progress for a challenge

pub async fn list_user_active_progress( &self, user_id: Uuid, ) -> Result<Vec<ChallengeProgressResponseDto>, String>

List active challenges for a user with progress

pub async fn increment_progress( &self, user_id: Uuid, challenge_id: Uuid, increment: i32, ) -> Result<ChallengeProgressResponseDto, String>

Increment user progress for a challenge

Creates progress if doesn’t exist, increments if exists. Automatically completes challenge if target reached.