ahmido
1f0cc5de56
## 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
62 lines
2.3 KiB
PHP
62 lines
2.3 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\Baselines;
|
|
|
|
use App\Support\Ui\OperatorExplanation\ExplanationFamily;
|
|
use App\Support\Ui\OperatorExplanation\TrustworthinessLevel;
|
|
|
|
enum BaselineCompareReasonCode: string
|
|
{
|
|
case NoSubjectsInScope = 'no_subjects_in_scope';
|
|
case CoverageUnproven = 'coverage_unproven';
|
|
case EvidenceCaptureIncomplete = 'evidence_capture_incomplete';
|
|
case RolloutDisabled = 'rollout_disabled';
|
|
case NoDriftDetected = 'no_drift_detected';
|
|
|
|
public function message(): string
|
|
{
|
|
return match ($this) {
|
|
self::NoSubjectsInScope => 'No subjects were in scope for this comparison.',
|
|
self::CoverageUnproven => 'Coverage proof was missing or incomplete, so some findings were suppressed for safety.',
|
|
self::EvidenceCaptureIncomplete => 'Evidence capture was incomplete, so some drift evaluation may have been suppressed.',
|
|
self::RolloutDisabled => 'Full-content baseline compare is currently disabled by rollout configuration.',
|
|
self::NoDriftDetected => 'No drift was detected for in-scope subjects.',
|
|
};
|
|
}
|
|
|
|
public function explanationFamily(): ExplanationFamily
|
|
{
|
|
return match ($this) {
|
|
self::NoDriftDetected => ExplanationFamily::NoIssuesDetected,
|
|
self::CoverageUnproven,
|
|
self::EvidenceCaptureIncomplete,
|
|
self::RolloutDisabled => ExplanationFamily::CompletedButLimited,
|
|
self::NoSubjectsInScope => ExplanationFamily::MissingInput,
|
|
};
|
|
}
|
|
|
|
public function trustworthinessLevel(): TrustworthinessLevel
|
|
{
|
|
return match ($this) {
|
|
self::NoDriftDetected => TrustworthinessLevel::Trustworthy,
|
|
self::CoverageUnproven,
|
|
self::EvidenceCaptureIncomplete => TrustworthinessLevel::LimitedConfidence,
|
|
self::RolloutDisabled,
|
|
self::NoSubjectsInScope => TrustworthinessLevel::Unusable,
|
|
};
|
|
}
|
|
|
|
public function absencePattern(): ?string
|
|
{
|
|
return match ($this) {
|
|
self::NoDriftDetected => 'true_no_result',
|
|
self::CoverageUnproven,
|
|
self::EvidenceCaptureIncomplete => 'suppressed_output',
|
|
self::RolloutDisabled => 'blocked_prerequisite',
|
|
self::NoSubjectsInScope => 'missing_input',
|
|
};
|
|
}
|
|
}
|