Unifi-Voucher-Tool/tools/screenshots.py
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

86 lines
4 KiB
Python
Executable file
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

#!/usr/bin/env python3
"""Erzeugt die Screenshots in docs/screenshots aus der laufenden Demo-Instanz.
Voraussetzung:
python3 tools/demo/build.py /tmp/uvt-demo
php -S 127.0.0.1:8123 -t /tmp/uvt-demo &
Aufruf:
python3 tools/screenshots.py [basis-url]
"""
import os
import shutil
import subprocess
import sys
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
OUT = os.path.join(ROOT, 'docs', 'screenshots')
SCALE = 2
# (Datei, Pfad, Breite, Hoehe) – Breite/Hoehe in CSS-Pixeln, Ausgabe in 2x
SHOTS = [
('login.png', 'login.php?anon=1', 1200, 850),
('login-branding.png', 'login.php?anon=1&brand=custom', 1200, 850),
('voucher-form.png', 'index.php', 1200, 880),
('voucher-result.png', 'index.php?demo=result', 1200, 900),
('bulk-vouchers.png', 'index.php?demo=bulk', 1200, 800),
('admin-dashboard.png', 'admin/index.php', 1200, 1400),
('admin-dashboard-dark.png', 'admin/index.php?theme=dark', 1200, 1400),
('vouchers.png', 'admin/vouchers.php', 1200, 1120),
('settings.png', 'admin/settings.php', 1200, 950),
('settings-login.png', 'admin/settings.php?tab=login', 1200, 1000),
('settings-branding.png', 'admin/settings.php?tab=branding', 1200, 900),
('api-keys.png', 'admin/api_keys.php?demo=new', 1200, 830),
('integrations.png', 'admin/integrations.php', 1200, 900),
('two-factor.png', 'admin/security.php', 1200, 900),
('updater.png', 'admin/update.php', 1200, 1420),
('updater-available.png', 'admin/update.php?demo=available', 1200, 1500),
('kiosk-display.png', 'kiosk.php?k=0f1e2d3c4b5a69788796a5b4c3d2e1f0', 1200, 900),
('kiosk-code.png', 'kiosk.php?k=a1b2c3d4e5f60718293a4b5c6d7e8f90&demo=code', 1200, 900),
('kiosk-branded.png', 'kiosk.php?k=a1b2c3d4e5f60718293a4b5c6d7e8f90', 1200, 900),
('kiosks-admin.png', 'admin/kiosks.php', 1200, 780),
('kiosks-form.png', 'admin/kiosks.php?demo=form', 1200, 1150),
('mobile-vouchers.png', 'admin/users.php', 430, 860),
# Die Wartungsseite zeigt ohne laufendes Update den unbestimmten Balken.
# Das mitgelieferte Bild wurde bei 65 % aufgenommen (Markierung in
# updater/storage/ gesetzt) - wer es neu erzeugt, bekommt die Ruhefassung.
('maintenance.png', 'updater/templates/maintenance.php', 1200, 700),
]
CANDIDATES = [
os.environ.get('CHROME_BIN', ''),
'/usr/bin/chromium', '/usr/bin/chromium-browser', '/usr/bin/google-chrome',
'/opt/pw-browsers/chromium', shutil.which('chromium') or '',
]
def find_browser() -> str:
for path in CANDIDATES:
if path and os.path.isfile(path) and os.access(path, os.X_OK):
return path
raise SystemExit('Kein Chromium gefunden – Pfad ueber CHROME_BIN setzen.')
def main() -> int:
base = (sys.argv[1] if len(sys.argv) > 1 else 'http://127.0.0.1:8123').rstrip('/')
browser = find_browser()
os.makedirs(OUT, exist_ok=True)
for name, path, width, height in SHOTS:
target = os.path.join(OUT, name)
subprocess.run([
browser, '--headless', '--no-sandbox', '--disable-gpu', '--hide-scrollbars',
'--force-color-profile=srgb', '--disable-lcd-text', '--font-render-hinting=none',
'--virtual-time-budget=4000', '--force-prefers-reduced-motion',
'--force-device-scale-factor=%d' % SCALE,
'--window-size=%d,%d' % (width, height),
'--screenshot=%s' % target,
'%s/%s' % (base, path),
], check=False, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL)
print('%-28s %s' % (name, 'ok' if os.path.exists(target) else 'FEHLER'))
return 0
if __name__ == '__main__':
raise SystemExit(main())