TenantAtlas/tests/Unit/Support/BackupQuality/BackupSetQualitySummaryTest.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

76 lines
2.6 KiB
PHP

<?php
declare(strict_types=1);
use App\Models\BackupItem;
use App\Models\BackupSet;
use App\Support\BackupQuality\BackupQualityResolver;
use Illuminate\Database\Eloquent\Collection as EloquentCollection;
it('renders a clear backup-set summary when no degradations are detected', function (): void {
$backupSet = new BackupSet([
'status' => 'completed',
'item_count' => 2,
]);
$backupSet->setRelation('items', new EloquentCollection([
new BackupItem([
'payload' => ['id' => 'one'],
'metadata' => [],
'assignments' => [],
]),
new BackupItem([
'payload' => ['id' => 'two'],
'metadata' => [],
'assignments' => [],
]),
]));
$summary = app(BackupQualityResolver::class)->summarizeBackupSet($backupSet);
expect($summary->degradedItemCount)->toBe(0)
->and($summary->compactSummary)->toBe('No degradations detected across 2 items')
->and($summary->summaryMessage)->toBe('No degradations were detected across 2 captured items.');
});
it('aggregates degraded backup-set counts from existing item metadata', function (): void {
$backupSet = new BackupSet([
'status' => 'completed',
'item_count' => 3,
]);
$backupSet->setRelation('items', new EloquentCollection([
new BackupItem([
'payload' => ['id' => 'healthy'],
'metadata' => [],
'assignments' => [],
]),
new BackupItem([
'payload' => [],
'metadata' => [
'source' => 'metadata_only',
'assignments_fetch_failed' => true,
],
'assignments' => [],
]),
new BackupItem([
'payload' => ['id' => 'warning'],
'metadata' => [
'has_orphaned_assignments' => true,
'integrity_warning' => 'Protected values are intentionally hidden.',
],
'assignments' => [],
]),
]));
$summary = app(BackupQualityResolver::class)->summarizeBackupSet($backupSet);
expect($summary->degradedItemCount)->toBe(2)
->and($summary->metadataOnlyCount)->toBe(1)
->and($summary->assignmentIssueCount)->toBe(1)
->and($summary->orphanedAssignmentCount)->toBe(1)
->and($summary->integrityWarningCount)->toBe(1)
->and($summary->compactSummary)->toBe('2 degraded items • 1 metadata-only • 1 assignment issue • 1 orphaned assignment • 1 integrity warning')
->and($summary->nextAction)->toBe('Open the backup set detail and inspect degraded items before continuing into restore.');
});