ferdi2go/OnlyFrames
1
0
Fork 0
Code Issues 4 Pull Requests Actions Packages Projects Releases Wiki Activity

[Perf] Thumbnail-Endpoint + pHash/EXIF-Cache #23

New Issue
Closed
opened 2026-05-27 12:21:05 +02:00 by ferdi2go · 1 comment
ferdi2go commented 2026-05-27 12:21:05 +02:00
Owner
Copy Link
Copy Source

Probleme

a) /preview liefert Original-JPEG als Thumbnail — index.html:1293, server.py:227-238
Review-Liste laedt bei 200 Fotos potenziell 200x3 MB = 600 MB.

b) Keine Cache-Header auf /preview, /exif. Browser re-fetcht bei jedem Reload.

c) Kein pHash/EXIF-Cache zwischen Runs. Re-Analyse rechnet alles neu.

Fix

  • a) Neuer Endpoint /thumb?path=...&w=200 mit Disk-Cache.
  • b) ETag aus mtime + Cache-Control: private, max-age=3600.
  • c) analyzer_cache.json mit {md5+mtime: {phash, exif, brightness, ...}}.
## Probleme **a) `/preview` liefert Original-JPEG als Thumbnail** — `index.html:1293`, `server.py:227-238` Review-Liste laedt bei 200 Fotos potenziell 200x3 MB = 600 MB. **b) Keine Cache-Header** auf `/preview`, `/exif`. Browser re-fetcht bei jedem Reload. **c) Kein pHash/EXIF-Cache** zwischen Runs. Re-Analyse rechnet alles neu. ## Fix - a) Neuer Endpoint `/thumb?path=...&w=200` mit Disk-Cache. - b) `ETag` aus mtime + `Cache-Control: private, max-age=3600`. - c) `analyzer_cache.json` mit `{md5+mtime: {phash, exif, brightness, ...}}`.
ferdi2go added the priority: mediummaintenance labels 2026-05-27 12:21:05 +02:00
ferdi2go commented 2026-05-27 13:16:19 +02:00
Author
Owner
Copy Link
Copy Source

Fix (a) und (b) umgesetzt:

(a) /thumb-Endpoint

  • Neuer Endpoint GET /thumb?path=...&w=200 (min 32, max 800)
  • Disk-Cache unter <tempdir>/of-thumbs/<md5(path|mtime|w)>.jpg
  • JPEG quality=80, optimize=true, LANCZOS-Resize
  • Frontend: makeThumb nutzt jetzt /thumb?w=240 (Lightbox-Klick laedt weiterhin /preview mit voller Aufloesung)

(b) Cache-Header

  • Helper _file_etag, _cache_response, _not_modified_if
  • /preview, /thumb, /exif setzen ETag (mtime-size + ggf. -wN) und Cache-Control: private, max-age=3600
  • 304 Not Modified wird zurueckgegeben wenn If-None-Match passt

Manueller Test mit 2000x1500 JPEG (47 KB):

  • /thumb?w=240 -> 556 B (99% Ersparnis)
    1. Request mit ETag -> HTTP 304
  • /preview mit ETag -> HTTP 304

(c) pHash/EXIF-Disk-Cache zwischen Runs als separates Issue #29 ausgegliedert.

Fix (a) und (b) umgesetzt: **(a) `/thumb`-Endpoint** - Neuer Endpoint `GET /thumb?path=...&w=200` (min 32, max 800) - Disk-Cache unter `<tempdir>/of-thumbs/<md5(path|mtime|w)>.jpg` - JPEG quality=80, optimize=true, LANCZOS-Resize - Frontend: `makeThumb` nutzt jetzt `/thumb?w=240` (Lightbox-Klick laedt weiterhin `/preview` mit voller Aufloesung) **(b) Cache-Header** - Helper `_file_etag`, `_cache_response`, `_not_modified_if` - `/preview`, `/thumb`, `/exif` setzen `ETag` (`mtime-size` + ggf. `-wN`) und `Cache-Control: private, max-age=3600` - 304 Not Modified wird zurueckgegeben wenn `If-None-Match` passt Manueller Test mit 2000x1500 JPEG (47 KB): - `/thumb?w=240` -> 556 B (99% Ersparnis) - 2. Request mit ETag -> HTTP 304 - `/preview` mit ETag -> HTTP 304 **(c) pHash/EXIF-Disk-Cache zwischen Runs** als separates Issue #29 ausgegliedert.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
bug
maintenance
priority: high
priority: low
priority: medium
security
ux
No labels maintenance priority: medium
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
ferdi2go
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ferdi2go/OnlyFrames#23