presseportale/app/Models/PressReleaseRedactionSnapshot.php
Kevin Adametz e783adc54e technik: Statische Analyse wieder aussagekräftig machen
phpstan lief mit 390 Meldungen außerhalb der Baseline, der größte Teil davon
Falschmeldungen. Ursache: Larastan löste keinen einzigen Cast auf, weil alle
Models ihre Casts über die casts()-METHODE deklarieren (Laravel-11-Stil).
Laravel führt die erst zur Laufzeit mit $casts zusammen, Larastan instanziiert
Models aber ohne Konstruktor — $pressRelease->status galt deshalb als string
und jeder Enum-Vergleich als "immer falsch". Dafür gibt es den Schalter
parseModelCastsMethod, dessen Larastan-Default false ist.

Zweite Sammelursache waren fehlende Generics an den Relations-Methoden: Ohne
sie landete phpstan auf Illuminate\Database\Eloquent\Model und meldete jede
Modell-Eigenschaft und jeden eigenen Scope als unbekannt. Alle 102
Relationen tragen jetzt ihr @return <Related, $this>; das verbessert
nebenbei die Vervollständigung in der IDE.

Zusammen fällt die Zahl von 390 auf 169. Die neu erzeugte Baseline umfasst 166
Einträge, überwiegend Closure-Parameter, die als blankes Builder typisiert
sind, sowie zwei nachgeprüfte Falschmeldungs-Gruppen: die Concerns unter
app/Livewire werden ausschließlich aus Volt-Komponenten eingebunden, die
phpstan nicht analysiert, und Cashier typisiert findBillable() gegen den TRAIT
Billable, was phpstan nicht mit User vereinbaren kann — die Laufzeitprüfung
dort ist richtig und bleibt.

Was die Analyse an echten toten Zweigen zutage gefördert hat, ist mit
entfernt: eine doppelte Null-Prüfung im Nachweis-PDF, Prüfungen gegen
NOT-NULL-Spalten in der Rechnungsstellung und im Vorschau-Controller, eine
immer wahre Bedingung im Logo-Pfad und in RetireAgencyCompanyType, ein
überflüssiges ?? [] auf einer Symfony-Methode, die immer ein Array liefert,
sowie der unerreichbare null-Arm in publicPortalLinks(). MigrateLegacyMedia
deklariert seine Medientypen jetzt als Literal-Union, womit das match ohne
default nachweislich vollständig ist statt nur faktisch.

Damit das nicht wieder abdriftet — die Baseline stand seit Mai unverändert —
läuft die Analyse ab jetzt als eigener Schritt in der Test-Pipeline.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-01 11:07:51 +00:00

79 lines
2.3 KiB
PHP

<?php
namespace App\Models;
use Database\Factories\PressReleaseRedactionSnapshotFactory;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* Verschlüsselter Vorher-Snapshot einer Meldeverfahren-Mutation
* (Anonymisierung/Depublizierung). Existiert nur für die Reversibilität
* innerhalb der Löschfrist — Alt-Werte leben nie im Klartext in Logs
* oder Payloads weiter. Wird nach purge_after durch snapshots:purge
* gelöscht (config legal.snapshot_retention_days).
*/
class PressReleaseRedactionSnapshot extends Model
{
/** @use HasFactory<PressReleaseRedactionSnapshotFactory> */
use HasFactory;
public const UPDATED_AT = null;
protected $fillable = [
'legal_request_id',
'press_release_id',
'encrypted_before',
'purge_after',
];
protected function casts(): array
{
return [
'encrypted_before' => 'encrypted:array',
'purge_after' => 'date',
];
}
/**
* Snapshot mit Löschfrist ab heute (config legal.snapshot_retention_days).
*
* @param array<string, mixed> $before
*/
public static function capture(PressRelease $pressRelease, array $before, ?LegalRequest $legalRequest = null): self
{
return self::query()->create([
'legal_request_id' => $legalRequest?->getKey(),
'press_release_id' => $pressRelease->getKey(),
'encrypted_before' => $before,
'purge_after' => now()->addDays((int) config('legal.snapshot_retention_days'))->toDateString(),
]);
}
/**
* @return BelongsTo<LegalRequest, $this>
*/
public function legalRequest(): BelongsTo
{
return $this->belongsTo(LegalRequest::class);
}
/**
* @return BelongsTo<PressRelease, $this>
*/
public function pressRelease(): BelongsTo
{
return $this->belongsTo(PressRelease::class);
}
/**
* @param Builder<PressReleaseRedactionSnapshot> $query
* @return Builder<PressReleaseRedactionSnapshot>
*/
public function scopeDueForPurge(Builder $query): Builder
{
return $query->whereDate('purge_after', '<', now()->toDateString());
}
}