discovery-by-llm/docs/logboek.md
Justin Visser 789fc944e8
Some checks are pending
ci / backend (push) Waiting to run
ci / frontend (push) Waiting to run
docs: open the build log
2026-08-09 21:00:20 +02:00

1.2 KiB

Logboek

Chronologisch bijgehouden tijdens de bouw. Elk blokje: wat ik deed, waarom, wat ik heb laten vallen.

Opzet (avond dag 1)

Wat ik deed: repository neergezet: backend-skelet (Python 3.13, FastAPI, uv) met de ports-and-adapters-indeling zichtbaar in de mappenstructuur, frontend-skelet (Vue 3 + TypeScript + Vite) met het getypeerde stream-eventcontract als eerste echte bestand, docker-compose met één image en één poort, alle pipeline-instellingen in één getypeerde config, promptsjablonen als bestanden, de scenario's als gedeelde data (eval + demofixtures + UI-chips uit één bron), en CI die lint, typecheck en tests draait. Alles groen bij de eerste push.

Waarom: de structuur is hier de helft van het verhaal — door de seam (domain / ports / adapters) en de config-als-data-aanpak nu vast te leggen blijft elke volgende stap klein en toetsbaar, en kan de frontend straks parallel aan de backend groeien tegen een bevroren contract (api/schemas.pylib/types.ts).

Wat ik heb laten vallen: een apart beslisdocument — de motivering leeft in de README en hier, twee plekken is genoeg. Verder nog niets: dit was opzet, de keuzes komen bij de pipeline.