AlertService
in package
Alert Service.
Manages actionable alerts and insights.
Table of Contents
Constants
- TYPES = ['zero_result_spike' => 'Zero Result Spike', 'content_trending' => 'Content Trending', 'low_engagement' => 'Low Engagement', 'embargo_expiring' => 'Embargo Expiring', 'access_request_pending' => 'Access Request Pending', 'popia_critical' => 'POPIA Critical', 'quality_issue' => 'Quality Issue', 'batch_completed' => 'Batch Completed', 'batch_failed' => 'Batch Failed']
- Alert types.
Methods
- cleanupOldAlerts() : int
- Clean up old alerts.
- create() : int
- Create an alert.
- dismiss() : bool
- Dismiss alert.
- dismissByType() : int
- Dismiss all alerts of a type.
- generateSystemAlerts() : int
- Generate system alerts based on current state.
- getActiveAlerts() : array<string|int, mixed>
- Get active alerts.
- getAlertCounts() : array<string|int, mixed>
- Get alert counts by severity.
- markRead() : bool
- Mark alert as read.
Constants
TYPES
Alert types.
public
mixed
TYPES
= ['zero_result_spike' => 'Zero Result Spike', 'content_trending' => 'Content Trending', 'low_engagement' => 'Low Engagement', 'embargo_expiring' => 'Embargo Expiring', 'access_request_pending' => 'Access Request Pending', 'popia_critical' => 'POPIA Critical', 'quality_issue' => 'Quality Issue', 'batch_completed' => 'Batch Completed', 'batch_failed' => 'Batch Failed']
Methods
cleanupOldAlerts()
Clean up old alerts.
public
cleanupOldAlerts([int $days = 90 ]) : int
Parameters
- $days : int = 90
Return values
intcreate()
Create an alert.
public
create(array<string|int, mixed> $data) : int
Parameters
- $data : array<string|int, mixed>
Return values
intdismiss()
Dismiss alert.
public
dismiss(int $id[, int|null $userId = null ]) : bool
Parameters
- $id : int
- $userId : int|null = null
Return values
booldismissByType()
Dismiss all alerts of a type.
public
dismissByType(string $alertType[, int|null $institutionId = null ][, int|null $userId = null ]) : int
Parameters
- $alertType : string
- $institutionId : int|null = null
- $userId : int|null = null
Return values
intgenerateSystemAlerts()
Generate system alerts based on current state.
public
generateSystemAlerts([int|null $institutionId = null ]) : int
Parameters
- $institutionId : int|null = null
Return values
intgetActiveAlerts()
Get active alerts.
public
getActiveAlerts([int|null $institutionId = null ][, array<string|int, mixed> $params = [] ]) : array<string|int, mixed>
Parameters
- $institutionId : int|null = null
- $params : array<string|int, mixed> = []
Return values
array<string|int, mixed>getAlertCounts()
Get alert counts by severity.
public
getAlertCounts([int|null $institutionId = null ]) : array<string|int, mixed>
Parameters
- $institutionId : int|null = null
Return values
array<string|int, mixed>markRead()
Mark alert as read.
public
markRead(int $id) : bool
Parameters
- $id : int