TenantAtlas/apps/platform/app/Models/AlertRule.php
ahmido e15d80cca5
Some checks failed
Main Confidence / confidence (push) Failing after 48s
Heavy Governance Lane / heavy-governance (push) Has been skipped
Browser Lane / browser (push) Has been skipped
feat: implement findings notifications escalation (#261)
## 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
2026-04-22 00:54:38 +00:00

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);
}
}