From 789fc944e827d9fda20f188dcc9e1e062a55a164 Mon Sep 17 00:00:00 2001 From: Justin Visser Date: Sun, 9 Aug 2026 21:00:20 +0200 Subject: [PATCH] docs: open the build log --- docs/logboek.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 docs/logboek.md diff --git a/docs/logboek.md b/docs/logboek.md new file mode 100644 index 0000000..66e7c2b --- /dev/null +++ b/docs/logboek.md @@ -0,0 +1,25 @@ +# 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.py` ↔ `lib/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.