presseportale/app/Support/FileDeletion.php
Kevin Adametz 2a2215b3c3 audit: Nacharbeit Umsetzungsaudit 25.09.2026 — Bildfreigabe, Beweisarchiv, KI-Atomarität, Berichte (Block 8, N01–N05, N07, N08, N10–N21, 5.1, 5.2)
Bilder (N01, N05, N07, N08): gemeinsamer Freigabezustand
PressReleaseImage::isPubliclyDeliverable() für Seiten, OG und Medienroute
(Bestand bleibt sichtbar, v2 nur mit Bestätigung, Admin-Upload bis zum
Kundenklick nicht öffentlich); eigene Ability confirmImageRights nur für den
Kontoinhaber, ohne Super-Admin-Kurzschluss, Identität und ausstehende
Bestätigung auch im Service; Status-Regel unter der PM-Sperre; Cache-Flush
nach dem Commit außerhalb der Dateibereinigung; Snapshot nach Bestätigung an
veröffentlichter PM; Bestätigungstexte an die gezeigte Kennung gebunden.

Beweisarchiv (N02, N10, N11, N12, N13, 5.1): Tombstone unter Zeilensperre mit
erneuter Hold-/Fristprüfung; Dateioperationen ausgewertet, Commands mit
FAILURE; record() über .tmp + move; Marker archive_pending_at mit
archive:retry-pending und archive:sweep-orphans; Anonymisierung entfernt Bilder
über den Remover mit Antragsbezug; Draft-Purge räumt Medien nie
veröffentlichter abgelehnter Einreichungen; App-Kopien fallen mit dem
Archiv-Tombstone; label_corrected nur für veröffentlichte Bilder;
archive_entries.legal_request_id; FileDeletion-Helfer; Systemstatus-Checks.

KI und Hintergrund (N03, N04, N14, N20, N21): Ergebnis-UPDATE und Audit in
einer Transaktion; erwarteter Hash bis in reject()/holdForManualReview();
Ablaufmail per beanspruchtem Marker in einer Transaktion; strikte
Schemaprüfung der Vision-Antwort; Fortschrittsmarke ungecacht.

Berichte und Canonical (N15–N19, 5.2): lückenlose Alterskohorten;
Feed-Identität mit Portal und Sprache; Sitemap-Rolle in der Kundenansicht;
Indexverteilung auf einer Grundgesamtheit; Kopien nach Wegfall der
Erstquelle neu bewertet; Kategorie-Admin leert Seiten-Caches; Dry-Run
zählt alle Tabellen.

Gesamtsuite: 2.122 Tests grün, einer übersprungen; Larastan und Pint sauber.
Zwei Migrationen (nullable Spalten, INSTANT). N09 offen.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-25 14:26:49 +00:00

68 lines
2.1 KiB
PHP

<?php
namespace App\Support;
use Illuminate\Contracts\Filesystem\Filesystem;
use Illuminate\Support\Facades\Log;
use RuntimeException;
/**
* Dateilöschung mit ausgewertetem Ergebnis (Umsetzungsaudit 25.09.2026,
* N10 und 5.1 e). Die Disks laufen mit `throw => false`; ein stilles
* `false` darf nirgends als Erfolg durchgehen, wo danach ein Tombstone
* gesetzt oder eine Zeile hart gelöscht wird.
*/
class FileDeletion
{
/**
* Löscht und bestätigt, dass die Datei danach nicht mehr existiert.
* Eine bereits fehlende Datei gilt als gelöscht.
*/
public static function delete(Filesystem $disk, string $path): bool
{
// Eine fehlende Datei meldet der lokale Treiber als gelöscht (true);
// ein stilles false (throw => false) heißt: Datei ist noch da.
return $disk->delete($path) && self::isGone($disk, $path);
}
private static function isGone(Filesystem $disk, string $path): bool
{
return ! $disk->exists($path);
}
/**
* Wie delete(), wirft aber bei Misserfolg — für Pfade, auf denen die
* Löschung Voraussetzung für den nächsten Schritt ist.
*/
public static function deleteOrThrow(Filesystem $disk, string $path, string $context): void
{
if (! self::delete($disk, $path)) {
throw new RuntimeException($context.': Datei konnte nicht gelöscht werden ('.$path.').');
}
}
/**
* Löscht mehrere Pfade, protokolliert Fehlschläge und liefert die
* verbliebenen Pfade — für Pfade, deren Verbleib nur Datenminimierung
* betrifft.
*
* @param list<string> $paths
* @return list<string>
*/
public static function deleteOrLog(Filesystem $disk, array $paths, string $context): array
{
$remaining = [];
foreach ($paths as $path) {
if (! self::delete($disk, $path)) {
$remaining[] = $path;
}
}
if ($remaining !== []) {
Log::error($context.': Datei(en) konnten nicht gelöscht werden.', ['paths' => $remaining]);
}
return $remaining;
}
}