## 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
40 lines
1.5 KiB
PHP
40 lines
1.5 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
use App\Models\Tenant;
|
|
use App\Support\OpsUx\OperationUxPresenter;
|
|
use App\Support\Ui\GovernanceArtifactTruth\ArtifactTruthPresenter;
|
|
use Illuminate\Foundation\Testing\RefreshDatabase;
|
|
use Tests\Feature\Concerns\BuildsGovernanceArtifactTruthFixtures;
|
|
|
|
uses(RefreshDatabase::class, BuildsGovernanceArtifactTruthFixtures::class);
|
|
|
|
it('reuses governance operator explanations for run failure detail and next-step guidance', function (): void {
|
|
$tenant = Tenant::factory()->create();
|
|
[$user, $tenant] = createUserWithTenant(tenant: $tenant, role: 'owner');
|
|
|
|
$run = $this->makeArtifactTruthRun(
|
|
tenant: $tenant,
|
|
type: 'tenant.review.compose',
|
|
context: [
|
|
'tenant_id' => (int) $tenant->getKey(),
|
|
'workspace_id' => (int) $tenant->workspace_id,
|
|
'reason_code' => 'review_missing_sections',
|
|
],
|
|
attributes: [
|
|
'outcome' => 'blocked',
|
|
'failure_summary' => [
|
|
['reason_code' => 'review_missing_sections', 'message' => 'The review basis is incomplete.'],
|
|
],
|
|
],
|
|
);
|
|
|
|
$truth = app(ArtifactTruthPresenter::class)->forOperationRun($run);
|
|
$explanation = $truth->operatorExplanation;
|
|
|
|
expect($explanation)->not->toBeNull()
|
|
->and(OperationUxPresenter::surfaceFailureDetail($run))->toBe($explanation?->dominantCauseExplanation)
|
|
->and(OperationUxPresenter::surfaceGuidance($run))->toContain((string) $explanation?->nextActionText);
|
|
});
|