Unifi-Voucher-Tool/tools
Friederich Loheide 25b8c51362
Some checks failed
CI / PHP Lint-1 (push) Successful in 43s
CI / PHP Lint (push) Successful in 45s
CI / PHP Lint (pull_request) Successful in 38s
CI / Unit Tests & Static Analysis (push) Failing after 43s
CI / PHP Lint-1 (pull_request) Successful in 40s
CI / Unit Tests & Static Analysis (pull_request) Failing after 41s
Selbst-Updater neu gebaut, Diagnoseseiten abgesichert
Aktualisierung per Klick im Administrationsbereich, ohne Zugang zum
Server. Der bisherige Updater lud ein ZIP und entpackte es ungeprüft über
die Produktion; das ist vollständig ersetzt.

Neu in updater/:

- Version: Release-Version als Konstante, installierter Commit-SHA in
  storage/.version (Datei, nicht Datenbank - der Updater muss den Stand
  auch bei hängender Datenbank lesen können)
- Progress: Fortschrittsdatei mit eigenem Fehlerzustand (pct = -1) und
  Verfallszeit, damit ein abgestürzter Lauf den nächsten nicht blockiert
- Maintenance: Wartungsmarkierung mit Ablauf, die sich beim Prüfen selbst
  aufräumt
- ProxyClient: nur HTTPS, Zertifikatsprüfung an, begrenzte
  Weiterleitungen, 503 mirror_pending/not_released als Bitte um Geduld
- Updater: Prüfsumme gegen X-Content-Sha256, zweistufiger ZIP-Slip-Schutz,
  geschützte Pfade, atomares Schreiben je Datei, nie löschen
- AutoMigrate: zieht Migrationen beim ersten Seitenaufruf nach, nur bei
  geändertem Fingerabdruck und mit Sperre gegen Parallellauf
- guard.php: Wartungs-Wächter für die Einstiegsseiten, JSON für die
  Schnittstellen; ausgenommen bleiben Update-Seite, Anmeldung und
  Health-Check
- Changelog: zerlegt CHANGELOG.md und rendert Markdown ohne unsichere Links

Oberfläche: Seite "Aktualisierung" mit Stand, Kanal, Suche, Fortschritt,
Migrationsliste und Versionsgeschichte. Der Datenschutzhinweis steht
dauerhaft neben der Schaltfläche, nicht in einem Dialog.

Fehlt changelog_preview in der Antwort, bleibt es bei "neue Fassung
verfügbar" - kein leerer Kasten, kein erfundener Ersatztext. Commit-Texte
werden nirgends angezeigt.

Außerdem (Punkt 2 der Liste):

- cron_test.php entfernt: ohne jede Anmeldung erreichbar, meldete
  Datenbankfehler samt Meldung und die Spalten der vouchers-Tabelle
- test.php verweigert ohne config.php die Auskunft; bisher lief die
  Diagnose auf einer frisch entpackten Installation ohne Anmeldung

PHPStan prüft jetzt den gesamten updater/-Ordner. 18 neue Tests
(93 Tests, 243 Assertions), Ablauf gegen den echten Update-Dienst
durchgespielt.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-25 19:49:59 +00:00
..
demo Selbst-Updater neu gebaut, Diagnoseseiten abgesichert 2026-09-25 19:49:59 +00:00
runner Einrichtung für einen Forgejo-Actions-Runner beilegen 2026-09-23 15:06:19 +00:00
.htaccess Sicherheits-Header, Werkzeuge und Dokumentation 2026-09-23 06:49:14 +00:00
README.md Einrichtung für einen Forgejo-Actions-Runner beilegen 2026-09-23 15:06:19 +00:00
screenshots.py Selbst-Updater neu gebaut, Diagnoseseiten abgesichert 2026-09-25 19:49:59 +00:00

Werkzeuge

Demo-Instanz (tools/demo/build.py)

Baut aus dem Projekt eine lauffähige Kopie ohne Datenbank: Database und Auth werden durch Stubs mit festen Beispieldaten ersetzt (tools/demo/overlay/). Das Original bleibt unverändert.

python3 tools/demo/build.py /tmp/uvt-demo
php -S 127.0.0.1:8123 -t /tmp/uvt-demo

Nützlich für:

  • Screenshots für die Dokumentation – immer mit denselben Daten
  • Smoke-Test – jede Seite einmal rendern, ohne MySQL aufzusetzen

Demo-spezifische Zustände werden über Query-Parameter erreicht:

Parameter Wirkung
?demo=result / ?demo=bulk Voucher-Ergebnis bzw. Bulk-Liste auf index.php
?demo=new frisch erzeugter Schlüssel auf admin/api_keys.php
?anon=1 nicht angemeldet (für die Login-Seite)
?theme=dark erzwingt den Dark Mode
?brand=custom / ?brand=nopanel Beispiel-Branding der Login-Seite

Screenshots (tools/screenshots.py)

Rendert die Bilder aus docs/screenshots/ neu. Voraussetzung ist ein headless Chromium; der Pfad kommt aus $CHROME_BIN oder wird in den üblichen Verzeichnissen gesucht.

python3 tools/demo/build.py /tmp/uvt-demo
php -S 127.0.0.1:8123 -t /tmp/uvt-demo &
CHROME_BIN=/usr/bin/chromium python3 tools/screenshots.py

Actions-Runner (tools/runner/)

Compose-Datei und Anleitung, um einen Forgejo-Actions-Runner einzurichten. Ohne Runner bleiben ci.yml und release.yml in der Warteschlange stehen. Details: tools/runner/README.md.

Die Skripte sind Hilfsmittel für die Entwicklung – im Betrieb werden sie nicht benötigt und sind per .htaccess nicht über HTTP erreichbar.