gitmedia/thats-me
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Client-Logging, getrennte Rate-Limits und Ladezustand für Bilder

Browse source 
Auf dem Testserver lief die App beim Scrollen langer Timelines in ein 429:
nach jeder Scroll-Pause ging sofort ein PUT /settings raus, und jedes
sichtbare Vorschaubild zählte auf dasselbe Limit von 300/min. Danach
blieben Bilder leer und "Einstellungen konnten nicht gespeichert werden"
erschien.

Backend: Medien-Reads bekommen einen eigenen Limiter (media, 1200/min),
POST /client-logs nimmt Warnungen und Fehler der App an (client-logs,
30/min) und schreibt sie in den täglichen Kanal `client`; Exceptions
tragen user_id, path und method im Kontext.

Frontend: Einstellungen gehen frühestens 1,5 s nach der letzten Änderung
und nur bei geändertem Inhalt zum Server, 429/Netzfehler werden still mit
Backoff wiederholt, nur eine Ablehnung wird gemeldet. Bilder laufen durch
ein Gate (6 parallel, Retry-After, 3 Versuche) und fallen auf einen
Platzhalter statt auf einen kaputten Pfad zurück. Neuer clientLog-Service
mit IndexedDB-Puffer, Dedupe und Batch-Versand, globaler Fehlerfang im
Boot, Protokoll im Entwickler-Tab. Drei pulsierende Punkte statt weißer
Fläche in Timeline-Punkt, Key Image und Medienkacheln.

Dokumentation in documentation/logging.md.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
Kevin Adametz 2026-09-25 09:31:35 +00:00
parent 522deffa1a
commit ab23c9f4ef
28 changed files with 1689 additions and 78 deletions
Download patch file Download diff file Expand all files Collapse all files

18
backend/routes/api.php
View file

@ -1,6 +1,7 @@
<?php
use App\Http\Controllers\Api\AuthController;
use App\Http\Controllers\Api\ClientLogController;
use App\Http\Controllers\Api\EventController;
use App\Http\Controllers\Api\EventMediaController;
use App\Http\Controllers\Api\SettingsController;
@ -15,11 +16,9 @@ Route::middleware(['auth:api', 'throttle:api'])->group(function () {
Route::post('/logout', [AuthController::class, 'logout']);
Route::get('/settings', [SettingsController::class, 'show']);
Route::put('/settings', [SettingsController::class, 'update']);
Route::get('/settings/media/background', [SettingsMediaController::class, 'show']);
Route::post('/settings/media/background', [SettingsMediaController::class, 'store'])
->middleware('throttle:uploads');
Route::delete('/settings/media/background', [SettingsMediaController::class, 'destroy']);
Route::get('/event-media/{media}/{variant}', [EventMediaController::class, 'show']);
Route::get('/events/{clientId}/media', [EventMediaController::class, 'index']);
Route::post('/events/{clientId}/media', [EventMediaController::class, 'store'])
->middleware('throttle:uploads');
@ -31,3 +30,18 @@ Route::middleware(['auth:api', 'throttle:api'])->group(function () {
]);
Route::post('/events/sync', [EventController::class, 'sync']);
});
// Browser-side warnings and errors, batched by the app. Own budget so a
// client that is failing loudly cannot lock itself out of the real API.
Route::middleware(['auth:api', 'throttle:client-logs'])->group(function () {
Route::post('/client-logs', [ClientLogController::class, 'store']);
});
// Image reads get their own budget: a long timeline fetches one thumbnail per
// visible event, and that must never eat into the limit for the actual API
// writes (which is what showed up as "Einstellungen konnten nicht gespeichert
// werden" while scrolling).
Route::middleware(['auth:api', 'throttle:media'])->group(function () {
Route::get('/settings/media/background', [SettingsMediaController::class, 'show']);
Route::get('/event-media/{media}/{variant}', [EventMediaController::class, 'show']);
});