TenantAtlas/tests/Feature/TenantReview/TenantReviewLifecycleTest.php
ahmido 1f0cc5de56 feat: implement operator explanation layer (#191)
## Summary
- add the shared operator explanation layer with explanation families, trustworthiness semantics, count descriptors, and centralized badge mappings
- adopt explanation-first rendering across baseline compare, governance operation run detail, baseline snapshot presentation, tenant review detail, and review register rows
- extend reason translation, artifact-truth presentation, fallback ops UX messaging, and focused regression coverage for operator explanation semantics

## Testing
- vendor/bin/sail bin pint --dirty --format agent
- vendor/bin/sail artisan test --compact tests/Feature/Monitoring/OperationsTenantScopeTest.php tests/Feature/Operations/OperationRunBlockedExecutionPresentationTest.php
- vendor/bin/sail artisan test --compact

## Notes
- Livewire v4 compatible
- panel provider registration remains in bootstrap/providers.php
- no destructive Filament actions were added or changed in this PR
- no new global-search behavior was introduced in this slice

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #191
2026-03-24 11:24:33 +00:00

61 lines
2.7 KiB
PHP

<?php
declare(strict_types=1);
use App\Services\TenantReviews\TenantReviewLifecycleService;
use App\Services\TenantReviews\TenantReviewReadinessGate;
use App\Support\TenantReviewStatus;
use App\Support\Ui\GovernanceArtifactTruth\ArtifactTruthPresenter;
it('blocks publication when required review sections are missing from the anchored evidence basis', function (): void {
[$user, $tenant] = createUserWithTenant(role: 'owner');
$review = composeTenantReviewForTest($tenant, $user, seedTenantReviewEvidence(
tenant: $tenant,
permissionPayload: [
'required_count' => 11,
'granted_count' => 7,
],
operationRunCount: 0,
));
expect(app(TenantReviewReadinessGate::class)->canPublish($review))->toBeFalse()
->and($review->publishBlockers())->not->toBeEmpty();
$truth = app(ArtifactTruthPresenter::class)->forTenantReview($review);
expect($truth->artifactExistence)->toBe('created')
->and($truth->publicationReadiness)->toBe('blocked')
->and($truth->primaryLabel)->toBe('Publication blocked')
->and($truth->nextStepText())->toBe('Resolve the review blockers before publication');
expect(fn () => app(TenantReviewLifecycleService::class)->publish($review, $user))
->toThrow(\InvalidArgumentException::class);
});
it('publishes ready tenant reviews and archives them without mutating the published evidence history', function (): void {
[$user, $tenant] = createUserWithTenant(role: 'owner');
$review = composeTenantReviewForTest($tenant, $user);
$published = app(TenantReviewLifecycleService::class)->publish($review, $user);
$publishedAt = $published->published_at?->toIso8601String();
expect($published->status)->toBe(TenantReviewStatus::Published->value)
->and($published->published_by_user_id)->toBe((int) $user->getKey())
->and($publishedAt)->not->toBeNull();
$publishedTruth = app(ArtifactTruthPresenter::class)->forTenantReview($published);
$archived = app(TenantReviewLifecycleService::class)->archive($published, $user);
$archivedTruth = app(ArtifactTruthPresenter::class)->forTenantReview($archived);
expect($archived->status)->toBe(TenantReviewStatus::Archived->value)
->and($archived->archived_at)->not->toBeNull()
->and($archived->published_at?->toIso8601String())->toBe($publishedAt)
->and($publishedTruth->publicationReadiness)->toBe('publishable')
->and($publishedTruth->nextStepText())->toBe('No action needed')
->and($archivedTruth->artifactExistence)->toBe('historical_only')
->and($archivedTruth->publicationReadiness)->toBe('internal_only')
->and($archivedTruth->nextStepText())->toBe('No action needed');
});