presseportale/app/Services/PressRelease/Classification/Contracts/ClassificationDriver.php

<?php

namespace App\Services\PressRelease\Classification\Contracts;

use App\Models\PressRelease;
use App\Services\PressRelease\Classification\ClassificationResult;

/**
 * Vertrag für austauschbare Klassifikations-Treiber (OpenAI, Anthropic,
 * Gemini, deterministischer Fallback). Auswahl über config/scoring.php.
 */
interface ClassificationDriver
{
    /**
     * Klassifiziert eine Pressemitteilung (green/yellow/red).
     *
     * Wirft bei API-Fehlern/Timeouts eine Exception; der aufrufende Job
     * weicht dann auf den deterministischen Fallback aus.
     */
    public function classify(PressRelease $pressRelease): ClassificationResult;
}