presseportale/app/Services/Image/Precheck/ImagePrecheckReviewService.php
Kevin Adametz 8bb7049bdc images: KI-Vorab-Check für Titelbilder — Vision-Sichtung mit definiertem Ausgang je Befund, Admin-Queue, Protokoll und Archiv-Snapshot (Bildkennzeichnung Block K)
Decision-Update Abschnitt 12 (E15, S24): Sichtung auf offensichtliche
Probleme, keine Rechteprüfung, öffentlich weiterhin „automatisierte Prüfung".

- ImagePrecheckManager mit openai- und deterministic-Treiber (Muster der
  Text-Prüfstrecke), Bild auf 1024 px, Metadaten gestrippt, JPEG als Data-URI,
  Antwortschema 12.4; Fehler → Ausgang `error`, durchlassen mit Vermerk.
- Auswertung 12.3: reject (Stock-Wasserzeichen, Nacktheit/Gewalt, Dokument
  ab 0,85), queue (Screenshot, fremdes Logo, Kennzeichen ab 0,6 sowie
  Ablehnungskategorien 0,6–0,85), hint (Personen, „wirkt KI" nur bei „ohne
  KI", technischer Mangel). Stufe 1 wertet nur das Wasserzeichen; die KI setzt
  nie die Kennzeichnung (E9). Herabstufung per Config (12.8).
- Uploader: Check vor jedem Schreiben, Ablehnung speichert nichts und
  landet als ki_audits `image_precheck` an der PM; Hash-Bindung zwischen
  Vorprüfung im Formular und Speichern; Spalten precheck*, Snapshot
  `precheck_snapshot` im Bestätigungsprotokoll, Archiv-Payload erweitert.
- Queue: Bild zurückgehalten (withheld_at), Meldung läuft weiter; Admin
  entscheidet mit Vermerk (Freigabe/Ablehnung → ki_audits
  `image_precheck_review`); Ansicht „Bild-Sichtung" in der PM-Liste,
  Sichtungsblock auf der PM-Seite, Systemstatus-Zähler.
- Formular v2: Ablehnungsgrund unter dem Dateifeld, Hinweise nach der
  Dateiauswahl, „wird kurz gesichtet" an der Karte; API 422 mit Grund,
  Warnung `image_under_review`.
- Config images.precheck (IMAGE_PRECHECK aus, STAGE 1); 17 Tests.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-22 13:27:31 +00:00

74 lines
2.4 KiB
PHP

<?php
namespace App\Services\Image\Precheck;
use App\Enums\ArchiveEvent;
use App\Enums\ArchiveReasonCategory;
use App\Models\KiAudit;
use App\Models\PressReleaseImage;
use App\Models\User;
use App\Services\PressRelease\Images\PressReleaseImageRemover;
use App\Support\WebCaches;
use Illuminate\Support\Facades\DB;
/**
* Admin-Queue des Vorab-Checks (DU 12.3, 12.5): Ein Bild mit Ausgang
* `queue` ist zurückgehalten, bis ein Mensch entscheidet. Freigabe macht es
* sichtbar, Ablehnung entfernt es; beides mit Vermerk im KI-Protokoll und
* am Bild.
*/
class ImagePrecheckReviewService
{
public function __construct(private readonly PressReleaseImageRemover $remover) {}
public function approve(PressReleaseImage $image, User $admin, string $note): void
{
DB::transaction(function () use ($image, $admin, $note): void {
$image->forceFill([
'precheck_reviewed_at' => now(),
'precheck_reviewed_by' => $admin->getKey(),
'precheck_review_note' => $note,
'withheld_at' => null,
])->save();
$this->audit($image, 'approved', $note);
});
if ($image->pressRelease?->published_at !== null) {
WebCaches::forgetPublicPages();
}
}
public function reject(PressReleaseImage $image, User $admin, string $note): void
{
DB::transaction(function () use ($image, $admin, $note): void {
$image->forceFill([
'precheck_reviewed_at' => now(),
'precheck_reviewed_by' => $admin->getKey(),
'precheck_review_note' => $note,
])->save();
$this->audit($image, 'rejected', $note);
});
$this->remover->remove($image, $admin, ArchiveEvent::ImageRemoved, ArchiveReasonCategory::OwnDecision);
}
private function audit(PressReleaseImage $image, string $decision, string $note): void
{
KiAudit::query()->create([
'press_release_id' => $image->press_release_id,
'type' => KiAudit::TYPE_IMAGE_PRECHECK_REVIEW,
'provider' => 'admin',
'model' => null,
'result' => $decision,
'reason' => $note,
'raw_response' => [
'image_id' => $image->getKey(),
'reviewed_by' => $image->precheck_reviewed_by,
'precheck' => $image->precheck,
],
'created_at' => now(),
]);
}
}