TenantAtlas/app/Support/Badges/OperatorSemanticAxis.php
ahmido 3c3daae405 feat: normalize operator outcome taxonomy (#186)
## Summary
- introduce a shared operator outcome taxonomy with semantic axes, severity bands, and next-action policy
- apply the taxonomy to operations, evidence/review completeness, baseline semantics, and restore semantics
- harden badge rendering, tenant-safe filtering/search behavior, and operator-facing summary/notification wording
- add the spec kit artifacts, reference documentation, and regression coverage for diagnostic-vs-primary state handling

## Testing
- focused Pest coverage for taxonomy registry and badge guardrails
- operations presentation and notification tests
- evidence, baseline, restore, and tenant-scope regression tests

## Notes
- Livewire v4.0+ compliance is preserved in the existing Filament v5 stack
- panel provider registration remains unchanged in bootstrap/providers.php
- no new globally searchable resource was added; adopted resources remain tenant-safe and out of global search where required
- no new destructive action family was introduced; existing actions keep their current authorization and confirmation behavior
- no new frontend asset strategy was introduced; existing deploy flow with filament:assets remains unchanged

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #186
2026-03-22 12:13:34 +00:00

52 lines
2.3 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Badges;
enum OperatorSemanticAxis: string
{
case ExecutionLifecycle = 'execution_lifecycle';
case ExecutionOutcome = 'execution_outcome';
case ItemResult = 'item_result';
case DataCoverage = 'data_coverage';
case EvidenceDepth = 'evidence_depth';
case ProductSupportMaturity = 'product_support_maturity';
case DataFreshness = 'data_freshness';
case OperatorActionability = 'operator_actionability';
case PublicationReadiness = 'publication_readiness';
case GovernanceDeviation = 'governance_deviation';
public function label(): string
{
return match ($this) {
self::ExecutionLifecycle => 'Execution lifecycle',
self::ExecutionOutcome => 'Execution outcome',
self::ItemResult => 'Item result',
self::DataCoverage => 'Data coverage',
self::EvidenceDepth => 'Evidence depth',
self::ProductSupportMaturity => 'Product support maturity',
self::DataFreshness => 'Data freshness',
self::OperatorActionability => 'Operator actionability',
self::PublicationReadiness => 'Publication readiness',
self::GovernanceDeviation => 'Governance deviation',
};
}
public function definition(): string
{
return match ($this) {
self::ExecutionLifecycle => 'Where a run sits in its execution flow.',
self::ExecutionOutcome => 'What happened when execution finished or stopped.',
self::ItemResult => 'How one restore or preview item resolved.',
self::DataCoverage => 'Whether the expected data or sections are present.',
self::EvidenceDepth => 'How much structured evidence detail is available.',
self::ProductSupportMaturity => 'Whether the product can represent the source faithfully.',
self::DataFreshness => 'Whether the available data is still current enough to trust.',
self::OperatorActionability => 'Whether an operator needs to do anything next.',
self::PublicationReadiness => 'Whether the current record is ready for stakeholder delivery.',
self::GovernanceDeviation => 'Whether the record represents a real governance problem.',
};
}
}