TenantAtlas/apps/platform/app/Support/Baselines/Compare/CompareSubjectProjection.php
ahmido ad16eee591 Spec 204: harden platform core vocabulary (#234)
## Summary
- add the Spec 204 platform vocabulary foundation, including canonical glossary terms, registry ownership descriptors, canonical operation type and alias resolution, and explicit reason ownership and platform reason-family metadata
- harden platform-facing compare, snapshot, evidence, monitoring, review, and reporting surfaces so they prefer governed-subject and canonical operation semantics while preserving intentional Intune-owned terminology
- extend Spec 204 unit, feature, Filament, and architecture coverage and add the full spec artifacts, checklist, and completed task ledger

## Verification
- ran the focused recent-change Sail verification pack for the new glossary and reason-semantics work
- ran the full Spec 204 quickstart verification pack under Sail
- ran `cd apps/platform && ./vendor/bin/sail bin pint --dirty --format agent`
- ran an integrated-browser smoke pass covering tenant dashboard, operations, operation detail, baseline compare, evidence, reviews, review packs, provider connections, inventory items, backup schedules, onboarding, and the system dashboard/operations/failures/run-detail surfaces

## Notes
- provider registration is unchanged and remains in `bootstrap/providers.php`
- no new destructive actions or asset-registration changes are introduced by this branch

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #234
2026-04-14 06:09:42 +00:00

52 lines
1.8 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\Baselines\Compare;
use InvalidArgumentException;
final class CompareSubjectProjection
{
/**
* @param array<string, string> $additionalLabels
* @param array<string, mixed>|null $subjectDescriptor
*/
public function __construct(
public readonly string $platformSubjectClass,
public readonly string $domainKey,
public readonly string $subjectTypeKey,
public readonly string $operatorLabel,
public readonly ?string $summaryKind = null,
public readonly array $additionalLabels = [],
public readonly ?array $subjectDescriptor = null,
) {
if (trim($this->platformSubjectClass) === '' || trim($this->domainKey) === '' || trim($this->subjectTypeKey) === '' || trim($this->operatorLabel) === '') {
throw new InvalidArgumentException('Compare subject projections require non-empty platform subject class, domain key, subject type key, and operator label values.');
}
}
/**
* @return array{
* platform_subject_class: string,
* domain_key: string,
* subject_type_key: string,
* operator_label: string,
* summary_kind: ?string,
* additional_labels: array<string, string>,
* subject_descriptor: ?array<string, mixed>
* }
*/
public function toArray(): array
{
return [
'platform_subject_class' => $this->platformSubjectClass,
'domain_key' => $this->domainKey,
'subject_type_key' => $this->subjectTypeKey,
'operator_label' => $this->operatorLabel,
'summary_kind' => $this->summaryKind,
'additional_labels' => $this->additionalLabels,
'subject_descriptor' => $this->subjectDescriptor,
];
}
}