TenantAtlas/app/Services/Audit/AuditRecorder.php
2026-03-11 10:35:32 +01:00

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