docs: log the streaming api
This commit is contained in:
parent
41aa93c3c7
commit
1a0712144e
1 changed files with 20 additions and 0 deletions
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue