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
79 lines
2.2 KiB
PHP
79 lines
2.2 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\Audit;
|
|
|
|
use App\Models\PlatformUser;
|
|
use App\Models\User;
|
|
|
|
final readonly class AuditActorSnapshot
|
|
{
|
|
public function __construct(
|
|
public AuditActorType $type,
|
|
public int|string|null $id = null,
|
|
public ?string $label = null,
|
|
public ?string $email = null,
|
|
) {}
|
|
|
|
public static function human(User $user): self
|
|
{
|
|
return new self(
|
|
type: AuditActorType::Human,
|
|
id: (int) $user->getKey(),
|
|
label: filled($user->name) ? (string) $user->name : (filled($user->email) ? (string) $user->email : null),
|
|
email: filled($user->email) ? (string) $user->email : null,
|
|
);
|
|
}
|
|
|
|
public static function platform(PlatformUser $user): self
|
|
{
|
|
return new self(
|
|
type: AuditActorType::Platform,
|
|
id: (int) $user->getKey(),
|
|
label: filled($user->name) ? (string) $user->name : (filled($user->email) ? (string) $user->email : null),
|
|
email: filled($user->email) ? (string) $user->email : null,
|
|
);
|
|
}
|
|
|
|
public static function fromLegacy(
|
|
AuditActorType $type,
|
|
?int $id = null,
|
|
?string $email = null,
|
|
?string $label = null,
|
|
): self {
|
|
return new self(
|
|
type: $type,
|
|
id: $id,
|
|
label: filled($label) ? trim((string) $label) : (filled($email) ? trim((string) $email) : null),
|
|
email: filled($email) ? trim((string) $email) : null,
|
|
);
|
|
}
|
|
|
|
public function labelOrFallback(): string
|
|
{
|
|
if (filled($this->label)) {
|
|
return (string) $this->label;
|
|
}
|
|
|
|
if (filled($this->email)) {
|
|
return (string) $this->email;
|
|
}
|
|
|
|
return $this->type->label();
|
|
}
|
|
|
|
/**
|
|
* @return array{actor_type: string, actor_id: int|string|null, actor_label: string, actor_email: ?string}
|
|
*/
|
|
public function toArray(): array
|
|
{
|
|
return [
|
|
'actor_type' => $this->type->value,
|
|
'actor_id' => $this->id,
|
|
'actor_label' => $this->labelOrFallback(),
|
|
'actor_email' => $this->email,
|
|
];
|
|
}
|
|
}
|