ahmido
53dc89e6ef
Implements Spec 075 (V1.5) on top of Spec 074. Highlights - Deterministic report fingerprint (sha256) + previous_report_id linkage - Viewer change indicator: "No changes" vs "Changed" when previous exists - Check acknowledgements (fail|warn|block) with capability-first auth, confirmation, and audit event - Verify-step UX polish (issues-first, primary CTA) Testing - Focused Pest coverage for fingerprint, previous resolver, change indicator, acknowledgements, badge semantics, DB-only viewer guard. Notes - Viewing remains DB-only (no external calls while rendering). Co-authored-by: Ahmed Darrazi <ahmeddarrazi@MacBookPro.fritz.box> Reviewed-on: #93
93 lines
2.5 KiB
PHP
93 lines
2.5 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Filament\Support;
|
|
|
|
use App\Models\OperationRun;
|
|
use App\Support\Verification\VerificationReportFingerprint;
|
|
use App\Support\Verification\VerificationReportSanitizer;
|
|
use App\Support\Verification\VerificationReportSchema;
|
|
|
|
final class VerificationReportViewer
|
|
{
|
|
/**
|
|
* @return array<string, mixed>|null
|
|
*/
|
|
public static function report(OperationRun $run): ?array
|
|
{
|
|
$context = is_array($run->context) ? $run->context : [];
|
|
$report = $context['verification_report'] ?? null;
|
|
|
|
if (! is_array($report)) {
|
|
return null;
|
|
}
|
|
|
|
$report = VerificationReportSanitizer::sanitizeReport($report);
|
|
|
|
if (! VerificationReportSchema::isValidReport($report)) {
|
|
return null;
|
|
}
|
|
|
|
return $report;
|
|
}
|
|
|
|
public static function previousReportId(array $report): ?int
|
|
{
|
|
$previousReportId = $report['previous_report_id'] ?? null;
|
|
|
|
if (is_int($previousReportId) && $previousReportId > 0) {
|
|
return $previousReportId;
|
|
}
|
|
|
|
if (is_string($previousReportId) && ctype_digit(trim($previousReportId))) {
|
|
return (int) trim($previousReportId);
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
public static function fingerprint(array $report): ?string
|
|
{
|
|
$fingerprint = $report['fingerprint'] ?? null;
|
|
|
|
if (is_string($fingerprint)) {
|
|
$fingerprint = strtolower(trim($fingerprint));
|
|
|
|
if (preg_match('/^[a-f0-9]{64}$/', $fingerprint)) {
|
|
return $fingerprint;
|
|
}
|
|
}
|
|
|
|
return VerificationReportFingerprint::forReport($report);
|
|
}
|
|
|
|
public static function previousRun(OperationRun $run, array $report): ?OperationRun
|
|
{
|
|
$previousReportId = self::previousReportId($report);
|
|
|
|
if ($previousReportId === null) {
|
|
return null;
|
|
}
|
|
|
|
$previous = OperationRun::query()
|
|
->whereKey($previousReportId)
|
|
->where('tenant_id', (int) $run->tenant_id)
|
|
->where('workspace_id', (int) $run->workspace_id)
|
|
->first();
|
|
|
|
return $previous instanceof OperationRun ? $previous : null;
|
|
}
|
|
|
|
public static function shouldRenderForRun(OperationRun $run): bool
|
|
{
|
|
$context = is_array($run->context) ? $run->context : [];
|
|
|
|
if (array_key_exists('verification_report', $context)) {
|
|
return true;
|
|
}
|
|
|
|
return in_array((string) $run->type, ['provider.connection.check'], true);
|
|
}
|
|
}
|