TenantAtlas/app/Support/Baselines/TenantGovernanceAggregateResolver.php
ahmido 807d574d31 feat: add tenant governance aggregate contract and action surface follow-ups (#199)
## Summary
- amend the operator UI constitution and related SpecKit templates for the new UI/UX governance rules
- add Spec 168 artifacts plus the tenant governance aggregate implementation used by the tenant dashboard, banner, and baseline compare landing surfaces
- normalize Filament action surfaces around clickable-row inspection, grouped secondary actions, and explicit action-surface declarations across enrolled resources and pages
- fix post-suite regressions in membership cache priming, finding workflow state refresh, tenant review derived-state invalidation, and tenant-bound backup-set related navigation

## Commit Series
- `docs: amend operator UI constitution`
- `spec: add tenant governance aggregate contract`
- `feat: add tenant governance aggregate contract`
- `refactor: normalize filament action surfaces`
- `fix: resolve post-suite state regressions`

## Testing
- `vendor/bin/sail artisan test --compact`
- Result: `3176 passed, 8 skipped (17384 assertions)`

## Notes
- Livewire v4 / Filament v5 stack remains unchanged
- no provider registration changes; `bootstrap/providers.php` remains the relevant location
- no new global-search resources or asset-registration changes in this branch

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #199
2026-03-29 21:14:17 +00:00

72 lines
2.3 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Baselines;
use App\Models\Tenant;
use App\Support\Ui\DerivedState\DerivedStateFamily;
use App\Support\Ui\DerivedState\DerivedStateKey;
use App\Support\Ui\DerivedState\RequestScopedDerivedStateStore;
final class TenantGovernanceAggregateResolver
{
public const string VARIANT_TENANT_GOVERNANCE_SUMMARY = 'tenant_governance_summary';
public function __construct(
private readonly RequestScopedDerivedStateStore $derivedStateStore,
) {}
public function forTenant(?Tenant $tenant, bool $fresh = false): ?TenantGovernanceAggregate
{
if (! $tenant instanceof Tenant) {
return null;
}
return $this->resolveAggregate(
tenant: $tenant,
resolver: fn (): TenantGovernanceAggregate => BaselineCompareStats::forTenant($tenant)
->toTenantGovernanceAggregate($tenant),
fresh: $fresh,
);
}
public function fromStats(?Tenant $tenant, BaselineCompareStats $stats, bool $fresh = false): ?TenantGovernanceAggregate
{
if (! $tenant instanceof Tenant) {
return null;
}
return $this->resolveAggregate(
tenant: $tenant,
resolver: fn (): TenantGovernanceAggregate => $stats->toTenantGovernanceAggregate($tenant),
fresh: $fresh,
);
}
private function resolveAggregate(Tenant $tenant, callable $resolver, bool $fresh = false): TenantGovernanceAggregate
{
$key = DerivedStateKey::fromModel(
DerivedStateFamily::TenantGovernanceAggregate,
$tenant,
self::VARIANT_TENANT_GOVERNANCE_SUMMARY,
);
$value = $fresh
? $this->derivedStateStore->resolveFresh(
$key,
$resolver,
DerivedStateFamily::TenantGovernanceAggregate->defaultFreshnessPolicy(),
DerivedStateFamily::TenantGovernanceAggregate->allowsNegativeResultCache(),
)
: $this->derivedStateStore->resolve(
$key,
$resolver,
DerivedStateFamily::TenantGovernanceAggregate->defaultFreshnessPolicy(),
DerivedStateFamily::TenantGovernanceAggregate->allowsNegativeResultCache(),
);
return $value;
}
}