presseportale/app/Services/PressRelease/Classification/ClassificationResult.php

<?php

namespace App\Services\PressRelease\Classification;

use App\Enums\PressReleaseClassification;

/**
 * Ergebnis einer KI-Klassifikation (Red Flag, Konzept §15.1).
 *
 * Provider-neutral: jeder Treiber liefert dasselbe Schema zurück, damit der
 * Job das Ergebnis einheitlich persistieren und auditieren kann.
 */
final class ClassificationResult
{
    /**
     * @param  list<string>  $reasons  Begründungen der KI (kann leer sein)
     * @param  array<string, mixed>  $rawResponse  Roh-Antwort für das Audit-Log
     */
    public function __construct(
        public readonly PressReleaseClassification $classification,
        public readonly array $reasons,
        public readonly string $provider,
        public readonly ?string $model,
        public readonly array $rawResponse,
    ) {}

    public function reasonText(): ?string
    {
        return $this->reasons === [] ? null : implode('; ', $this->reasons);
    }
}