TenantAtlas/apps/platform/app/Services/Evidence/Contracts/EvidenceSourceProvider.php
ahmido 75ebade345 feat: implement provider-neutral artifact source taxonomy (#343)
## 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
2026-05-08 23:47:31 +00:00

33 lines
860 B
PHP

<?php
declare(strict_types=1);
namespace App\Services\Evidence\Contracts;
use App\Models\ManagedEnvironment;
interface EvidenceSourceProvider
{
public function key(): string;
/**
* @return array{
* dimension_key: string,
* state: string,
* required: bool,
* source_kind: string,
* source_record_type: ?string,
* source_record_id: ?string,
* source_fingerprint: ?string,
* measured_at: ?\DateTimeInterface,
* freshness_at: ?\DateTimeInterface,
* summary_payload: array<string, mixed>,
* source_descriptor?: array<string, mixed>,
* provider_detail?: array<string, mixed>,
* fingerprint_payload: array<string, mixed>,
* sort_order: int
* }
*/
public function collect(ManagedEnvironment $tenant): array;
}