TenantAtlas/app/Services/Evidence/EvidenceSnapshotResolver.php
ahmido a74ab12f04 feat: implement evidence domain foundation (#183)
## Summary
- add the Evidence Snapshot domain with immutable tenant-scoped snapshots, per-dimension items, queued generation, audit actions, badge mappings, and Filament list/detail surfaces
- add the workspace evidence overview, capability and policy wiring, Livewire update-path hardening, and review-pack integration through explicit evidence snapshot resolution
- add spec 153 artifacts, migrations, factories, and focused Pest coverage for evidence, review-pack reuse, authorization, action-surface regressions, and audit behavior

## Testing
- `vendor/bin/sail artisan test --compact --stop-on-failure`
- `CI=1 vendor/bin/sail artisan test --compact`
- `vendor/bin/sail bin pint --dirty --format agent`

## Notes
- branch: `153-evidence-domain-foundation`
- commit: `b7dfa279`
- spec: `specs/153-evidence-domain-foundation/`

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #183
2026-03-19 13:32:52 +00:00

63 lines
2.0 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Services\Evidence;
use App\Models\EvidenceSnapshot;
use App\Support\Evidence\EvidenceCompletenessState;
final class EvidenceSnapshotResolver
{
public function resolve(EvidenceResolutionRequest $request): EvidenceResolutionResult
{
$query = EvidenceSnapshot::query()
->with('items')
->where('workspace_id', $request->workspaceId)
->where('tenant_id', $request->tenantId)
->where('status', 'active')
->where(function ($query): void {
$query->whereNull('expires_at')->orWhere('expires_at', '>', now());
})
->latest('generated_at');
if ($request->snapshotId !== null) {
$query->whereKey($request->snapshotId);
}
$snapshot = $query->first();
if (! $snapshot instanceof EvidenceSnapshot) {
return EvidenceResolutionResult::missingSnapshot(['No active snapshot found.']);
}
$requiredDimensions = $request->requiredDimensions;
$items = $snapshot->items->keyBy('dimension_key');
$reasons = [];
foreach ($requiredDimensions as $dimension) {
$item = $items->get($dimension);
if ($item === null) {
$reasons[] = sprintf('Missing dimension: %s', $dimension);
continue;
}
if ((string) $item->state === EvidenceCompletenessState::Missing->value) {
$reasons[] = sprintf('Missing dimension: %s', $dimension);
}
if (! $request->allowStale && (string) $item->state === EvidenceCompletenessState::Stale->value) {
$reasons[] = sprintf('Stale dimension: %s', $dimension);
}
}
if ($reasons !== []) {
return EvidenceResolutionResult::snapshotIneligible($snapshot, $reasons);
}
return EvidenceResolutionResult::resolved($snapshot, $requiredDimensions === [] ? $items->keys()->all() : $requiredDimensions);
}
}