Skip to content

feat(admin/media): Suche, serverseitiger Filter & Infinite-Scroll-Pagination#16

Open
mrwind-up-bird wants to merge 1 commit into
mainfrom
feat/admin-media-pagination
Open

feat(admin/media): Suche, serverseitiger Filter & Infinite-Scroll-Pagination#16
mrwind-up-bird wants to merge 1 commit into
mainfrom
feat/admin-media-pagination

Conversation

@mrwind-up-bird

Copy link
Copy Markdown
Contributor

Problem

/admin/media lud nur die neuesten 50 Medien und bot keinen Weg zu älteren Dateien. Der Bilder/Videos-Filter filterte nur diese 50, und es gab kein Suchfeld — dadurch waren ältere Medien praktisch unerreichbar.

Lösung

Alles serverseitig über die gesamte Bibliothek:

  • Suche (entprellt) nach Dateiname
  • Bilder/Videos-Filter serverseitig
  • Infinite Scroll (lädt beim Runterscrollen automatisch nach) + „Mehr laden"-Button als Fallback
  • Header zeigt die echte Gesamtzahl (N Dateien, (gefiltert))

Änderungen

  • GET /api/admin/media{ items, nextCursor, total } mit Cursor-Pagination (orderBy createdAt desc, id desc), serverseitiger Suche + Typ-Filter, geklemmtem limit, withRetry + try/catch, count nur auf der ersten Seite.
  • Neu: src/lib/media-query.ts — reine, unit-getestete Helfer (parseMediaQuery, buildMediaWhere, paginate), 12 Tests.
  • Medien-Seite: Cursor wird aus dem letzten geladenen Item abgeleitet (Löschen der Grenz-Zeile kann Pagination nicht mehr blockieren); Generations-Guard + synchrones reloadingRef verwerfen veraltete Cross-Filter-Appends; Observer an den <main>-Scrollcontainer gebunden; fehlgeschlagene Loads bieten explizites „Erneut laden".
  • MediaPickerDialog und die Slider-Bildsuche lesen die neue { items }-Form (die einzigen weiteren Konsumenten des Endpoints).

Reviews

Zwei unabhängige Code-Reviews (Fokus: Cursor-Korrektheit, Observer-Lifecycle, Races). Alle Critical/Important-Findings behoben und verifiziert.

Bekannte, bewusst zurückgestellte Kleinigkeiten (kein Datenverlust):

  • Optimistisches Upload/Delete kann durch einen gleichzeitigen Filter/Such-Reload kurz überschrieben werden (Item ist server-seitig persistiert, erscheint beim nächsten Fetch wieder).
  • MediaPickerDialog-Suche läuft weiterhin client-seitig über die erste Seite (Folge-Aufgabe, jetzt wo der API-Endpoint Suche kann).

Gates

  • tsc --noEmit sauber
  • 35/35 Tests grün (12 neu)
  • next build erfolgreich (56/56 Seiten)

🤖 Generated with Claude Code

…ation

The media library only ever returned the newest 50 items with no way to
reach older media; the Bilder/Videos filter only filtered those 50 and
there was no search box (though the API already accepted ?search=).

- GET /api/admin/media now returns { items, nextCursor, total } with
  cursor pagination (orderBy createdAt desc, id desc), server-side search
  + type filter, a clamped limit, withRetry + try/catch, and a count only
  on the first page.
- New pure, unit-tested helpers in lib/media-query.ts (parse/validate
  query, build where, paginate) — 12 tests.
- Media page: debounced search box, server-side Bilder/Videos filter,
  IntersectionObserver infinite scroll (scoped to the <main> scroll
  container) with a "Mehr laden" fallback, live total. Cursor is derived
  from the last loaded item so deleting the boundary row can't wedge
  paging; a generation guard + synchronous reloadingRef drop stale
  cross-filter appends; failed loads surface an explicit retry.
- MediaPickerDialog and the slider image search read the new { items }
  shape (the only other consumers of the endpoint).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant