Struct ConvocationUseCases 

pub struct ConvocationUseCases { /* private fields */ }

Implementations

impl ConvocationUseCases

pub fn new( convocation_repository: Arc<dyn ConvocationRepository>, recipient_repository: Arc<dyn ConvocationRecipientRepository>, owner_repository: Arc<dyn OwnerRepository>, building_repository: Arc<dyn BuildingRepository>, meeting_repository: Arc<dyn MeetingRepository>, ) -> Self

pub async fn create_convocation( &self, organization_id: Uuid, request: CreateConvocationRequest, created_by: Uuid, ) -> Result<ConvocationResponse, String>

Create a new convocation

pub async fn get_convocation( &self, id: Uuid, ) -> Result<ConvocationResponse, String>

Get convocation by ID

pub async fn get_convocation_by_meeting( &self, meeting_id: Uuid, ) -> Result<Option<ConvocationResponse>, String>

Get convocation by meeting ID

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

List convocations for a building

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

List convocations for an organization

pub async fn schedule_convocation( &self, id: Uuid, request: ScheduleConvocationRequest, ) -> Result<ConvocationResponse, String>

Schedule convocation to be sent at specific date

pub async fn send_convocation( &self, id: Uuid, request: SendConvocationRequest, ) -> Result<ConvocationResponse, String>

Send convocation to owners (generates PDF, creates recipients, sends emails) This would typically be called by a background job or email service

pub async fn mark_recipient_email_sent( &self, recipient_id: Uuid, ) -> Result<ConvocationRecipientResponse, String>

Mark recipient email as sent

pub async fn mark_recipient_email_opened( &self, recipient_id: Uuid, ) -> Result<ConvocationRecipientResponse, String>

Mark recipient email as opened (tracking pixel or link click)

pub async fn update_recipient_attendance( &self, recipient_id: Uuid, status: AttendanceStatus, ) -> Result<ConvocationRecipientResponse, String>

Update recipient attendance status

pub async fn set_recipient_proxy( &self, recipient_id: Uuid, proxy_owner_id: Uuid, ) -> Result<ConvocationRecipientResponse, String>

Set proxy delegation for recipient

pub async fn send_reminders( &self, convocation_id: Uuid, ) -> Result<Vec<ConvocationRecipientResponse>, String>

Send reminders to recipients who haven’t opened the convocation (J-3) This would typically be called by a background job

pub async fn get_tracking_summary( &self, convocation_id: Uuid, ) -> Result<RecipientTrackingSummaryResponse, String>

Get tracking summary for convocation

pub async fn list_convocation_recipients( &self, convocation_id: Uuid, ) -> Result<Vec<ConvocationRecipientResponse>, String>

Get all recipients for a convocation

pub async fn cancel_convocation( &self, id: Uuid, ) -> Result<ConvocationResponse, String>

Cancel convocation

pub async fn delete_convocation(&self, id: Uuid) -> Result<bool, String>

Delete convocation (and all recipients via CASCADE)

pub async fn process_scheduled_convocations( &self, ) -> Result<Vec<ConvocationResponse>, String>

Process scheduled convocations (called by background job) Returns list of convocations that were sent

pub async fn process_reminder_sending( &self, ) -> Result<Vec<ConvocationResponse>, String>

Process reminder sending (called by background job) Returns list of convocations that had reminders sent