TenantAtlas/tests/Unit/Support/BackupQuality/BackupQualityResolverTest.php
ahmido e840007127 feat: add backup quality truth surfaces (#211)
## Summary
- add a shared backup-quality resolver and summary model for backup sets, backup items, policy versions, and restore selection
- surface backup-quality truth across Filament backup-set, policy-version, and restore-wizard entry points
- add focused Pest coverage and the full Spec Kit artifact set for spec 176

## Testing
- focused backup-quality verification and integrated-browser smoke coverage were completed during implementation
- degraded browser smoke path was validated with temporary seeded records and then cleaned up again
- the workspace already has a prior `vendor/bin/sail artisan test --compact` run exiting non-zero; that full-suite failure was not reworked as part of this PR

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #211
2026-04-07 11:39:40 +00:00

88 lines
3.1 KiB
PHP

<?php
declare(strict_types=1);
use App\Models\BackupItem;
use App\Models\PolicyVersion;
use App\Support\BackupQuality\BackupQualityResolver;
use App\Support\RedactionIntegrity;
it('derives metadata-only and assignment degradations from backup item metadata', function (): void {
$summary = app(BackupQualityResolver::class)->forBackupItem(new BackupItem([
'payload' => [],
'assignments' => [],
'metadata' => [
'source' => 'metadata_only',
'assignments_fetch_failed' => true,
'has_orphaned_assignments' => true,
'integrity_warning' => 'Protected values are intentionally hidden.',
'assignment_capture_reason' => 'separate_role_assignments',
],
]));
expect($summary->snapshotMode)->toBe('metadata_only')
->and($summary->hasAssignmentIssues)->toBeTrue()
->and($summary->hasOrphanedAssignments)->toBeTrue()
->and($summary->hasIntegrityWarning())->toBeTrue()
->and($summary->degradationFamilies)->toBe([
'metadata_only',
'assignment_capture_issue',
'orphaned_assignments',
'integrity_warning',
])
->and($summary->qualityHighlights)->toContain(
'Metadata only',
'Assignment fetch failed',
'Orphaned assignments',
'Integrity warning',
);
});
it('uses unknown quality only when backup item metadata cannot justify a stronger claim', function (): void {
$resolver = app(BackupQualityResolver::class);
$unknownSummary = $resolver->forBackupItem(new BackupItem([
'payload' => [],
'assignments' => [],
'metadata' => [],
]));
$assignmentIssueSummary = $resolver->forBackupItem(new BackupItem([
'payload' => [],
'assignments' => [],
'metadata' => [
'assignments_fetch_failed' => true,
],
]));
expect($unknownSummary->degradationFamilies)->toBe(['unknown_quality'])
->and($unknownSummary->compactSummary)->toBe('Unknown quality')
->and($assignmentIssueSummary->degradationFamilies)->toBe(['assignment_capture_issue'])
->and($assignmentIssueSummary->qualityHighlights)->not->toContain('Unknown quality');
});
it('derives policy version integrity warnings from existing redaction context', function (): void {
$summary = app(BackupQualityResolver::class)->forPolicyVersion(new PolicyVersion([
'snapshot' => [
'id' => 'policy-1',
'displayName' => 'Policy One',
],
'metadata' => [
'assignments_fetch_failed' => true,
],
'secret_fingerprints' => [
'snapshot' => ['/clientSecret' => 'abc123'],
'assignments' => [],
'scope_tags' => [],
],
]));
expect($summary->snapshotMode)->toBe('full')
->and($summary->hasAssignmentIssues)->toBeTrue()
->and($summary->integrityWarning)->toBe(RedactionIntegrity::protectedValueNote())
->and($summary->degradationFamilies)->toBe([
'assignment_capture_issue',
'integrity_warning',
]);
});