TenantAtlas/app/Models/AlertDelivery.php
ahmido d49d33ac27 feat(alerts): test message + last test status + deep links (#122)
Implements feature 100 (Alert Targets):

- US1: “Send test message” action (RBAC + confirmation + rate limit + audit + async job)
- US2: Derived “Last test” status badge (Never/Sent/Failed/Pending) on view + edit surfaces
- US3: “View last delivery” deep link + deliveries viewer filters (event_type, destination) incl. tenantless test deliveries

Tests:
- Full suite green (1348 passed, 7 skipped)
- Added focused feature tests for send test, last test resolver/badges, and deep-link filters

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #122
2026-02-18 23:12:38 +00:00

80 lines
2.0 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Models;
use App\Support\Concerns\DerivesWorkspaceIdFromTenantWhenPresent;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Prunable;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
class AlertDelivery extends Model
{
use DerivesWorkspaceIdFromTenantWhenPresent;
use HasFactory;
use Prunable;
public const string EVENT_TYPE_TEST = 'alerts.test';
public const string STATUS_QUEUED = 'queued';
public const string STATUS_DEFERRED = 'deferred';
public const string STATUS_SENT = 'sent';
public const string STATUS_FAILED = 'failed';
public const string STATUS_SUPPRESSED = 'suppressed';
public const string STATUS_CANCELED = 'canceled';
protected $guarded = [];
protected $casts = [
'send_after' => 'datetime',
'sent_at' => 'datetime',
'payload' => 'array',
];
public function workspace(): BelongsTo
{
return $this->belongsTo(Workspace::class);
}
public function tenant(): BelongsTo
{
return $this->belongsTo(Tenant::class);
}
public function rule(): BelongsTo
{
return $this->belongsTo(AlertRule::class, 'alert_rule_id');
}
public function destination(): BelongsTo
{
return $this->belongsTo(AlertDestination::class, 'alert_destination_id');
}
public function prunable(): Builder
{
$retentionDays = (int) config('tenantpilot.alerts.delivery_retention_days', 90);
$retentionDays = max(1, $retentionDays);
return static::query()->where('created_at', '<', now()->subDays($retentionDays));
}
public function isTerminal(): bool
{
return in_array($this->status, [
self::STATUS_SENT,
self::STATUS_FAILED,
self::STATUS_SUPPRESSED,
self::STATUS_CANCELED,
], true);
}
}