From 1a0712144e3f8bec53ea2940069d2433ff68e685 Mon Sep 17 00:00:00 2001 From: Justin Visser Date: Mon, 10 Aug 2026 13:46:56 +0200 Subject: [PATCH] docs: log the streaming api --- docs/logboek.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/logboek.md b/docs/logboek.md index 5814a02..fe62ce6 100644 --- a/docs/logboek.md +++ b/docs/logboek.md @@ -110,3 +110,23 @@ Wat ik heb laten vallen of uitgesteld: geverifieerde pool. Sneller en consistent, maar een refinement haalt geen nieuwe nummers op. Dit is een bewuste afweging, mocht er tijd over zijn is dit 1 van de uitbreidingen die ik op zou kunnen pakken. + +### Streaming API + +Wat ik deed: + +- De pipeline als streamend endpoint: POST /api/recommendations levert + NDJSON events (metadata / track / warning / error / done); een + client-disconnect stopt de stream en de grounding. +- Playlist-endpoint dat schrijft met een vaste naam-prefix, zodat + aangemaakte playlists later in bulk op te ruimen zijn. +- Request-timing middleware met per-request counters (Spotify calls, cache + hits, LLM tokens) in gestructureerde logs. +- Seed session voor gehost draaien: in live mode installeert een refresh + token bij startup een sessie, zodat een publieke instantie werkt zonder + interactieve login. + +Waarom: + +- Streamen maakt de wachttijd eerlijk: de eerste kaart telt, niet de + laatste. Een afgebroken request mag geen werk laten doorlopen.