TenantAtlas/app/Support/Audit/AuditTargetSnapshot.php
ahmido 28cfe38ba4 feat: lay audit log foundation (#163)
## 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
2026-03-11 09:39:37 +00:00

50 lines
1.1 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Audit;
final readonly class AuditTargetSnapshot
{
public function __construct(
public ?string $type = null,
public int|string|null $id = null,
public ?string $label = null,
) {}
public function labelOrFallback(): ?string
{
if (filled($this->label)) {
return (string) $this->label;
}
if (! filled($this->type) && ! filled($this->id)) {
return null;
}
$type = is_string($this->type) && trim($this->type) !== ''
? trim(str_replace(['_', '.'], ' ', $this->type))
: 'Record';
$type = ucfirst($type);
if (filled($this->id)) {
return sprintf('%s #%s', $type, (string) $this->id);
}
return $type;
}
/**
* @return array{target_type: ?string, target_id: int|string|null, target_label: ?string}
*/
public function toArray(): array
{
return [
'target_type' => $this->type,
'target_id' => $this->id,
'target_label' => $this->labelOrFallback(),
];
}
}