TenantAtlas/app/Services/SystemConsole/SystemConsoleAuditLogger.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

58 lines
1.7 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Services\SystemConsole;
use App\Models\OperationRun;
use App\Models\PlatformUser;
use App\Models\Tenant;
use App\Services\Auth\BreakGlassSession;
use App\Services\Intune\AuditLogger;
use App\Support\Audit\AuditActorType;
final class SystemConsoleAuditLogger
{
public function __construct(
private readonly AuditLogger $auditLogger,
private readonly BreakGlassSession $breakGlassSession,
) {}
/**
* @param array<string, mixed> $metadata
*/
public function log(
PlatformUser $actor,
string $action,
string $status = 'success',
array $metadata = [],
?OperationRun $run = null,
): void {
$tenant = Tenant::query()->where('external_id', 'platform')->first();
if (! $tenant instanceof Tenant) {
return;
}
$metadata['break_glass_active'] = $this->breakGlassSession->isActive();
if ($run instanceof OperationRun) {
$metadata['operation_run_id'] = (int) $run->getKey();
}
$this->auditLogger->log(
tenant: $tenant,
action: trim($action),
context: ['metadata' => $metadata],
actorId: (int) $actor->getKey(),
actorEmail: $actor->email,
actorName: $actor->name,
status: trim($status),
resourceType: $run instanceof OperationRun ? 'operation_run' : null,
resourceId: $run instanceof OperationRun ? (string) $run->getKey() : null,
actorType: AuditActorType::Platform,
operationRunId: $run instanceof OperationRun ? (int) $run->getKey() : null,
);
}
}