## Summary - implement Spec 224 findings notifications and escalation v1 on top of the existing alerts and Filament database notification infrastructure - add finding assignment, reopen, due soon, and overdue event handling with direct recipient routing, dedupe, and optional external alert fan-out - extend alert rule and alert delivery surfaces plus add the Spec 224 planning bundle and candidate-list promotion cleanup ## Validation - `cd apps/platform && ./vendor/bin/sail bin pint --dirty --format agent` - `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Feature/Findings/FindingsNotificationEventTest.php tests/Feature/Findings/FindingsNotificationRoutingTest.php` - `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Feature/Alerts/FindingsAlertRuleIntegrationTest.php tests/Feature/Alerts/SlaDueAlertTest.php tests/Feature/Notifications/FindingNotificationLinkTest.php` ## Filament / Platform Notes - Livewire v4.0+ compliance is preserved - provider registration remains unchanged in `apps/platform/bootstrap/providers.php` - no globally searchable resource behavior changed in this feature - no new destructive action was introduced - asset strategy is unchanged and the existing `cd apps/platform && php artisan filament:assets` deploy step remains sufficient ## Manual Smoke Note - integrated-browser smoke testing confirmed the new alert rule event options, notification drawer entries, alert delivery history row, and tenant finding detail route on the active Sail host - local notification deep links currently resolve from `APP_URL`, so a local `localhost` vs `127.0.0.1:8081` host mismatch can break the browser session if the app is opened on a different host/port combination Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #261
82 lines
2.4 KiB
PHP
82 lines
2.4 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Models;
|
|
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
|
|
use Illuminate\Database\Eloquent\Relations\HasMany;
|
|
|
|
class AlertRule extends Model
|
|
{
|
|
use HasFactory;
|
|
|
|
public const string EVENT_HIGH_DRIFT = 'high_drift';
|
|
|
|
public const string EVENT_COMPARE_FAILED = 'compare_failed';
|
|
|
|
public const string EVENT_BASELINE_HIGH_DRIFT = 'baseline_high_drift';
|
|
|
|
public const string EVENT_BASELINE_COMPARE_FAILED = 'baseline_compare_failed';
|
|
|
|
public const string EVENT_SLA_DUE = 'sla_due';
|
|
|
|
public const string EVENT_PERMISSION_MISSING = 'permission_missing';
|
|
|
|
public const string EVENT_ENTRA_ADMIN_ROLES_HIGH = 'entra.admin_roles.high';
|
|
|
|
public const string EVENT_FINDINGS_ASSIGNED = 'findings.assigned';
|
|
|
|
public const string EVENT_FINDINGS_REOPENED = 'findings.reopened';
|
|
|
|
public const string EVENT_FINDINGS_DUE_SOON = 'findings.due_soon';
|
|
|
|
public const string EVENT_FINDINGS_OVERDUE = 'findings.overdue';
|
|
|
|
public const string TENANT_SCOPE_ALL = 'all';
|
|
|
|
public const string TENANT_SCOPE_ALLOWLIST = 'allowlist';
|
|
|
|
protected $guarded = [];
|
|
|
|
protected $casts = [
|
|
'is_enabled' => 'boolean',
|
|
'tenant_allowlist' => 'array',
|
|
'cooldown_seconds' => 'integer',
|
|
'quiet_hours_enabled' => 'boolean',
|
|
];
|
|
|
|
public function workspace(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Workspace::class);
|
|
}
|
|
|
|
public function destinations(): BelongsToMany
|
|
{
|
|
return $this->belongsToMany(AlertDestination::class, 'alert_rule_destinations')
|
|
->using(AlertRuleDestination::class)
|
|
->withPivot(['id', 'workspace_id'])
|
|
->withTimestamps();
|
|
}
|
|
|
|
public function deliveries(): HasMany
|
|
{
|
|
return $this->hasMany(AlertDelivery::class);
|
|
}
|
|
|
|
public function appliesToTenant(int $tenantId): bool
|
|
{
|
|
if ($this->tenant_scope_mode !== self::TENANT_SCOPE_ALLOWLIST) {
|
|
return true;
|
|
}
|
|
|
|
$allowlist = is_array($this->tenant_allowlist) ? $this->tenant_allowlist : [];
|
|
$allowlist = array_values(array_unique(array_map(static fn (mixed $value): int => (int) $value, $allowlist)));
|
|
|
|
return in_array($tenantId, $allowlist, true);
|
|
}
|
|
}
|