feat: Papierkorb, Abrufzaehler, WebP ohne Adressaenderung, ZIP hochladen

Vier Dinge, alle am laufenden Dienst gemessen.

PAPIERKORB. Loeschen war endgueltig -- bei einem Knopf "alle 3861 waehlen"
direkt neben "loeschen" ist das die falsche Haerte, und die Sicherung half nur
bis zum letzten naechtlichen Lauf. Die Datei wandert jetzt nach
/data/papierkorb, der Datensatz in eine eigene Tabelle, nach 30 Tagen raeumt
der Dienst stuendlich selbst auf. Der Ablagename traegt eine laufende Nummer:
unter demselben Pfad koennen nacheinander verschiedene Dateien gelegen haben,
und beide sollen zurueckholbar sein. Geprueft: loeschen -> oeffentlich 404,
Eintrag im Papierkorb, zurueckholen -> 200 samt neu gerechneter Vorschau.

ABRUFZAEHLER. media.abrufe und zuletzt_abgerufen. Gezaehlt wird im Speicher und
alle 30 Sekunden weggeschrieben -- ein UPDATE je Kachel waeren bei einer
Galerieseite 120 Schreibvorgaenge. Der 304 zaehlt mit (der Aufrufer WOLLTE die
Datei, er hatte sie nur schon), HEAD nicht. Was vor dem Einbau lag, steht als
"nie geholt" da, auch wenn es taeglich benutzt wurde -- die Karte im
Speicherbericht sagt das auch dazu, statt eine Zahl zu zeigen, die luegt.

WEBP OHNE ADRESSAENDERUNG. Der Pfad ist die Adresse: aus items/foo.png darf
nicht items/foo.webp werden. Die sparsame Fassung liegt deshalb DANEBEN und
wird unter DERSELBEN Adresse ausgeliefert, wenn der Aufrufer per Accept sagt,
dass er WebP versteht. Nachgemessen an einer Datei: 6448 Bytes fuer curl, 2758
fuer einen Browser. Ueber den ganzen Bestand: 3606 Fassungen, 199,3 MB ->
33,1 MB, gespart 166,2 MB. Bei 29 lohnt WebP nicht -- dort bleibt es beim
Original.

Zwei Dinge haengen daran, beide gegengeprueft: "Vary: Accept" (ohne die Zeile
legt ein Zwischenspeicher die WebP-Fassung fuer alle ab, auch fuer die, die sie
nicht lesen koennen) und getrennte ETags mit "-w" (sonst bekaeme jemand auf
seinen If-None-Match hin ein 304 fuer das falsche Bild). Gemessen: derselbe
ETag mit Accept -> 304, ohne Accept -> 200 mit dem PNG.

ZIP HOCHLADEN. Ein Archiv wird ausgepackt statt abgelegt, die Ordner darin
bleiben erhalten und haengen sich hinter den gewaehlten Zielordner. fflate und
nicht adm-zip: reines JavaScript, keine native Bibliothek -- dieses Projekt hat
schon einen halben Abend an einer ABI-Nummer verloren. Grenzen: 5000 Eintraege,
256 MB entpackt, geprueft VOR dem Entpacken (eine Zip-Bombe waere sonst schon
im Speicher). Zip-Slip gemessen: "../../../../etc/passwd" und
"..\..\windows\hosts" abgelehnt, die harmlose Datei im selben Archiv abgelegt.

UND EIN KNOPF, DER GELOGEN HAT. Der erste Nachruestlauf ueber alle Dateien
brauchte mehr als 90 Sekunden -- genau da gibt Nginx Proxy Manager auf. Der
Aufrufer sah einen 504, waehrend die Arbeit im Hintergrund weiterlief und
fertig wurde. Ein Knopf, der Erfolg als Fehler meldet, ist schlimmer als einer
ohne Rueckmeldung.

Beide Wartungsknoepfe laufen deshalb in Runden zu 300 Stueck: der Server meldet
"offen" und "fertig", die Oberflaeche ruft erneut auf und zeigt dabei "280
erzeugt, noch 129 offen ...". Gemessen: 7,8 s je Runde statt 90+ am Stueck. Der
Vorschau-Knopf hatte dieselbe Wand und wurde mitgezogen, obwohl er noch nicht
dagegengelaufen war.

Nebenbei: der Verwaisten-Sucher kennt jetzt auch /data/webp (gleiche Schleife,
Ordner im Ergebnis vorangestellt), Verschieben und Loeschen nehmen die sparsame
Fassung mit, und das Loeschen eines Ordners raeumt thumbs/ und webp/ hinterher.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

server/ui/src/api.ts

@@ -110,6 +110,9 @@ export type MediaItem = {
     created_at: number
     updated_at: number
     url: string
+    /** Wie oft die Datei oeffentlich geholt wurde. */
+    abrufe: number
+    zuletzt_abgerufen: number | null
 }
 
 export type MediaPage = {
@@ -127,6 +130,23 @@ export type Stats = {
     publicUrl: string
 }
 
+export type PapierkorbEintrag = {
+    id: number
+    path: string
+    size: number
+    sha256: string
+    mime: string
+    geloescht: number
+    von: string
+}
+
+export type PapierkorbSeite = {
+    items: PapierkorbEintrag[]
+    n: number
+    bytes: number
+    haltbarTage: number
+}
+
 export type Speicher = {
     nachArt: { art: string; files: number; bytes: number }[]
     groesste: MediaItem[]
@@ -134,6 +154,9 @@ export type Speicher = {
     doppelte: { sha256: string; n: number; bytes: number; pfade: string }[]
     verschwendet: number
     stufen: { tage: number; files: number; bytes: number }[]
+    /** Was seit dem Einbau des Zaehlers NIE geholt wurde. */
+    nieGeholt: { n: number; bytes: number }
+    beliebteste: MediaItem[]
 }
 
 export type TokenRow = {
@@ -206,7 +229,28 @@ export type Richtung = 'auf' | 'ab'
 export type Verwaiste = {
     dateiOhneDatensatz: { anzahl: number; beispiele: string[] }
     datensatzOhneDatei: { anzahl: number; beispiele: string[] }
-    vorschauOhneBild: { anzahl: number; beispiele: string[] }
+    /** Vorschauen UND sparsame Fassungen, deren Original es nicht mehr gibt.
+     *  Die Beispiele tragen den Ordner vorn — thumbs/… oder webp/…. */
+    abgeleitetOhneBild: { anzahl: number; beispiele: string[] }
+}
+
+/** Was EIN STAPEL „sparsame Fassungen nachziehen" zurueckmeldet.
+ *
+ *  `fertig` ist der Punkt: der Server rechnet hoechstens ein paar hundert
+ *  Stueck je Aufruf, weil der Proxy nach 90 Sekunden aufgibt. Solange `fertig`
+ *  falsch ist, steht in `offen`, wieviele noch fehlen. */
+export type WebpLauf = {
+    erzeugt: number
+    vorhanden: number
+    uebersprungen: number
+    lohntNicht: number
+    fehler: number
+    gesamt: number
+    offen: number
+    fertig: boolean
+    vorher: number
+    nachher: number
+    gespart: number
 }
 
 /** Was das Sicherungsskript nach jedem Lauf zurueckmeldet. */
@@ -296,6 +340,9 @@ export type ThumbLauf = {
     uebersprungen: number
     fehler: number
     gesamt: number
+    /** Wieviele noch fehlen. Siehe WebpLauf — derselbe Grund. */
+    offen: number
+    fertig: boolean
 }
 
 /** Die Adresse der Vorschau zu einem Pfad.
@@ -380,8 +427,18 @@ export const api = {
     uebersicht: () => get<Uebersicht>('/api/dash/uebersicht'),
     stand: () => get<Stand>('/api/dash/stand'),
     speicher: () => get<Speicher>('/api/dash/speicher'),
+    papierkorb: () => get<PapierkorbSeite>('/api/dash/papierkorb'),
+    papierkorbZurueck: (ids: number[]) =>
+        post<{
+            zurueck: number
+            fehlgeschlagen: number
+            ergebnisse: { path: string; ok: boolean; error?: string }[]
+        }>('/api/dash/papierkorb/zurueck', { ids }),
+    papierkorbLeeren: (ids?: number[]) =>
+        post<{ geleert: number }>('/api/dash/papierkorb/leeren', ids ? { ids } : {}),
     stats: () => get<Stats>('/api/dash/stats'),
     thumbsNachziehen: () => post<ThumbLauf>('/api/dash/maintenance/thumbs'),
+    webpNachziehen: () => post<WebpLauf>('/api/dash/maintenance/webp'),
     verwaiste: () => get<Verwaiste>('/api/dash/maintenance/orphans'),
     verwaisteBehandeln: (aktion: 'aufnehmen' | 'aufraeumen') =>
         post<{ aktion: string; aufgenommen?: number; datensaetze?: number; vorschauen?: number }>(