ahmido
28cfe38ba4
## Summary - turn the Monitoring audit log placeholder into a real workspace-scoped audit review surface - introduce a shared audit recorder, richer audit value objects, and additive audit log schema evolution - add audit outcome and actor badges, permission-aware related navigation, and durable audit retention coverage ## Included - canonical `/admin/audit-log` list and detail inspection UI - audit model helpers, taxonomy expansion, actor/target snapshots, and recorder/builder services - operation terminal audit writes and purge command retention changes - spec 134 design artifacts and focused Pest coverage for audit foundation behavior ## Validation - `vendor/bin/sail bin pint --dirty --format agent` - `vendor/bin/sail artisan test --compact tests/Unit/Audit tests/Unit/Badges/AuditBadgesTest.php tests/Feature/Filament/AuditLogPageTest.php tests/Feature/Filament/AuditLogDetailInspectionTest.php tests/Feature/Filament/AuditLogAuthorizationTest.php tests/Feature/Monitoring/AuditCoverageGovernanceTest.php tests/Feature/Monitoring/AuditCoverageOperationsTest.php tests/Feature/Console/TenantpilotPurgeNonPersistentDataTest.php` ## Notes - Livewire v4.0+ compliance is preserved within the existing Filament v5 application. - No provider registration changes were needed; panel provider registration remains in `bootstrap/providers.php`. - No new globally searchable resource was introduced. - The audit page remains read-only; no destructive actions were added. - No new asset pipeline changes were introduced; existing deploy-time `php artisan filament:assets` behavior remains unchanged. Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #163
55 lines
1.5 KiB
PHP
55 lines
1.5 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Services\Audit;
|
|
|
|
use App\Models\AuditLog;
|
|
use App\Models\Tenant;
|
|
use App\Models\Workspace;
|
|
use App\Support\Audit\AuditActionId;
|
|
use App\Support\Audit\AuditActorSnapshot;
|
|
use App\Support\Audit\AuditOutcome;
|
|
use App\Support\Audit\AuditTargetSnapshot;
|
|
use Carbon\CarbonInterface;
|
|
|
|
final class AuditRecorder
|
|
{
|
|
public function __construct(
|
|
private readonly AuditEventBuilder $builder,
|
|
) {}
|
|
|
|
/**
|
|
* @param array<string, mixed> $context
|
|
*/
|
|
public function record(
|
|
string|AuditActionId $action,
|
|
array $context = [],
|
|
?Workspace $workspace = null,
|
|
?Tenant $tenant = null,
|
|
?AuditActorSnapshot $actor = null,
|
|
?AuditTargetSnapshot $target = null,
|
|
string|AuditOutcome|null $outcome = null,
|
|
?CarbonInterface $recordedAt = null,
|
|
?string $summary = null,
|
|
?int $operationRunId = null,
|
|
): AuditLog {
|
|
$actionValue = $action instanceof AuditActionId ? $action->value : trim($action);
|
|
|
|
return AuditLog::query()->create(
|
|
$this->builder->buildRecordAttributes(
|
|
action: $actionValue,
|
|
context: $context,
|
|
workspace: $workspace,
|
|
tenant: $tenant,
|
|
actor: $actor,
|
|
target: $target,
|
|
outcome: $outcome,
|
|
recordedAt: $recordedAt,
|
|
summary: $summary,
|
|
operationRunId: $operationRunId,
|
|
),
|
|
);
|
|
}
|
|
}
|