Self-Updater und Lizenzprüfung

Umsetzung von docs/specs/self-updater.md für Laravel:
- Installierter Stand als SHA in storage/.version, Fortschritt in storage/.update-progress,
  selbstheilender Wartungsmodus in storage/.maintenance
- Update-Client je Kanal (stable/development), nur HTTPS, begrenzte Redirects,
  ZIP-Download per Stream mit PK- und SHA-256-Prüfung
- Entpacken mit zweistufigem ZIP-Slip-Schutz, Übernahme mit geschützten Pfaden
  (atomar je Datei, nie löschen), Migrationen, Cache- und OPcache-Reset
- Lizenzspeicher außerhalb der DB, Geräte-ID als Zufallszahl, rotierendes Gerätetoken
  wird bei jeder Antwort (auch Fehler und Downloads) sofort gespeichert
- Lizenzfehler mit verständlichen Meldungen – sie sperren nie das Portal
- Seite „Aktualisierung“ mit Kanal, Suche, Changelog-Vorschau, Fortschritt,
  Migrationen, Änderungsprotokoll, Lizenz und Datenschutzhinweis
- Wartungs-Middleware (503 + Retry-After) und Auto-Migration per Fingerabdruck
- Audit-Log für Updates, Kanalwechsel und Lizenzänderungen
- Version 0.2.0

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Friederich Loheide 2026-09-26 06:02:19 +00:00
parent a36752e09a
commit 43244d751a
41 changed files with 3184 additions and 3 deletions

View file

@ -0,0 +1,53 @@
<?php
namespace App\Support\Update;
/**
* „Nach Updates suchen“: fragt /check und bereitet das Ergebnis für die Anzeige auf.
* Zeigt bewusst keine Commit-Texte – nur ob es Neues gibt und was laut
* Änderungsprotokoll neu ist.
*/
class UpdateCheck
{
public function __construct(
private readonly Channels $channels,
private readonly InstalledVersion $version,
private readonly Changelog $changelog,
) {}
/**
* @return array<string, mixed>
*/
public function run(?string $channel = null): array
{
$current = $this->version->current();
$result = $this->channels->client($channel)->check($current);
$latest = $result['latest_sha'] ?? null;
// Frische Installation: Die erste Prüfung liefert den Stand zum Merken.
if ($current === null && is_string($latest) && InstalledVersion::isSha($latest)) {
$this->version->save($latest);
}
$preview = $result['changelog_preview'] ?? null;
$entries = is_array($preview['entries'] ?? null) ? $preview['entries'] : [];
return [
'has_update' => (bool) ($result['has_update'] ?? false),
'latest_sha' => is_string($latest) ? $latest : null,
'latest_short' => is_string($latest) ? substr($latest, 0, 7) : null,
'version' => $result['version'] ?? null,
'released_at' => $result['released_at'] ?? null,
'versions_behind' => (int) ($result['versions_behind'] ?? 0),
'channel_switch' => $result['channel_switch'] ?? null,
// Feld kann fehlen – dann gibt es nichts zu berichten (kein leerer Kasten).
'changelog' => array_map(fn (array $entry) => [
'version' => $entry['version'] ?? null,
'heading' => $entry['heading'] ?? null,
'html' => $this->changelog->toHtml((string) ($entry['text'] ?? '')),
], $entries),
'changelog_complete' => $preview === null ? true : (bool) ($preview['complete'] ?? true),
'changelog_url' => config('updater.changelog_url'),
];
}
}