TenantAtlas/apps/platform/app/Services/Baselines/SnapshotRendering/RenderedSnapshotGroup.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

76 lines
2.5 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Services\Baselines\SnapshotRendering;
final readonly class RenderedSnapshotGroup
{
/**
* @param array<int, RenderedSnapshotItem> $items
* @param array<string, mixed> $technicalPayload
* @param array<string, mixed> $subjectDescriptor
*/
public function __construct(
public string $policyType,
public string $label,
public int $itemCount,
public FidelityState $fidelity,
public GapSummary $gapSummary,
public bool $initiallyCollapsed,
public array $items,
public ?string $renderingError = null,
public ?string $coverageHint = null,
public ?string $capturedAt = null,
public array $technicalPayload = [],
public array $subjectDescriptor = [],
) {}
/**
* @return array{
* policyType: string,
* label: string,
* itemCount: int,
* fidelity: string,
* gapSummary: array{count: int, has_gaps: bool, messages: list<string>, badge_state: string},
* initiallyCollapsed: bool,
* items: list<array{
* label: string,
* typeLabel: string,
* identityHint: string,
* referenceStatus: string,
* fidelity: string,
* gapSummary: array{count: int, has_gaps: bool, messages: list<string>, badge_state: string},
* observedAt: ?string,
* sourceReference: ?string,
* structuredAttributes: list<array{label: string, value: string, priority: string}>
* }>,
* renderingError: ?string,
* coverageHint: ?string,
* capturedAt: ?string,
* technicalPayload: array<string, mixed>,
* subjectDescriptor: array<string, mixed>
* }
*/
public function toArray(): array
{
return [
'policyType' => $this->policyType,
'label' => $this->label,
'itemCount' => $this->itemCount,
'fidelity' => $this->fidelity->value,
'gapSummary' => $this->gapSummary->toArray(),
'initiallyCollapsed' => $this->initiallyCollapsed,
'items' => array_map(
static fn (RenderedSnapshotItem $item): array => $item->toArray(),
$this->items,
),
'renderingError' => $this->renderingError,
'coverageHint' => $this->coverageHint,
'capturedAt' => $this->capturedAt,
'technicalPayload' => $this->technicalPayload,
'subjectDescriptor' => $this->subjectDescriptor,
];
}
}