## Summary Implements Spec 284 for provider-neutral artifact source taxonomy. - add shared artifact source descriptor, resolver, taxonomy, and provider-detail support - update findings, evidence snapshots, stored reports, inventory items, and tenant review surfaces to disclose descriptor-first artifact summaries - add bounded Pest unit, feature, guard, and browser coverage for the taxonomy slice - include the completed Spec 284 package artifacts under `specs/284-provider-neutral-artifact-source-taxonomy/` ## Notes - branch: `284-provider-neutral-artifact-source-taxonomy` - commit: `bf8d59e0` - this PR was created as part of the requested commit/push/PR flow against `platform-dev` Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #343
69 lines
1.8 KiB
PHP
69 lines
1.8 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Models;
|
|
|
|
use App\Support\Concerns\DerivesWorkspaceIdFromTenant;
|
|
use App\Support\Artifacts\ArtifactSourceDescriptor;
|
|
use App\Support\Artifacts\ArtifactSourceResolver;
|
|
use Illuminate\Database\Eloquent\Factories\HasFactory;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
|
|
class EvidenceSnapshotItem extends Model
|
|
{
|
|
use DerivesWorkspaceIdFromTenant;
|
|
use HasFactory;
|
|
|
|
protected $guarded = [];
|
|
|
|
/**
|
|
* @return array<string, string>
|
|
*/
|
|
protected function casts(): array
|
|
{
|
|
return [
|
|
'required' => 'boolean',
|
|
'measured_at' => 'datetime',
|
|
'freshness_at' => 'datetime',
|
|
'summary_payload' => 'array',
|
|
'sort_order' => 'integer',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @return BelongsTo<EvidenceSnapshot, $this>
|
|
*/
|
|
public function snapshot(): BelongsTo
|
|
{
|
|
return $this->belongsTo(EvidenceSnapshot::class, 'evidence_snapshot_id');
|
|
}
|
|
|
|
/**
|
|
* @return BelongsTo<ManagedEnvironment, $this>
|
|
*/
|
|
public function tenant(): BelongsTo
|
|
{
|
|
return $this->belongsTo(ManagedEnvironment::class, 'managed_environment_id');
|
|
}
|
|
|
|
/**
|
|
* @return list<array<string, mixed>>
|
|
*/
|
|
public function canonicalControlReferences(): array
|
|
{
|
|
$payload = is_array($this->summary_payload) ? $this->summary_payload : [];
|
|
$references = $payload['canonical_controls'] ?? [];
|
|
|
|
return is_array($references)
|
|
? array_values(array_filter($references, static fn (mixed $reference): bool => is_array($reference)))
|
|
: [];
|
|
}
|
|
|
|
public function artifactSourceDescriptor(): ArtifactSourceDescriptor
|
|
{
|
|
return app(ArtifactSourceResolver::class)->forEvidenceSnapshotItem($this);
|
|
}
|
|
}
|