From 000b435b9a9a26aef720a530357f3d298e5fdd1b Mon Sep 17 00:00:00 2001 From: Justin Visser Date: Mon, 10 Aug 2026 10:24:54 +0200 Subject: [PATCH] docs: open the build log --- docs/logboek.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 docs/logboek.md diff --git a/docs/logboek.md b/docs/logboek.md new file mode 100644 index 0000000..25a5166 --- /dev/null +++ b/docs/logboek.md @@ -0,0 +1,35 @@ +# Logboek + +Bijgehouden tijdens de bouw. Per blok: wat ik deed, waarom, wat ik heb laten +vallen. + +## Opzet (avond dag 1) + +Wat ik deed: + +- Afspraken vastgelegd in AGENTS.md (architectuur, naamgeving, wanneer + commentaar, wat de linters afdwingen). +- Backend-skelet: Python 3.13 + FastAPI via uv, mappenstructuur volgens + ports-and-adapters (domain / ports / adapters / pipeline / api), config + met alleen de app-mode (demo of live), health-endpoint met een smoke test. +- Frontend-skelet: Vue 3 + TypeScript via Vite, met eslint, prettier en + vue-tsc. +- docker-compose die 1 image bouwt: frontend-build en API samen op dezelfde + poort. De poort ligt vast omdat de geregistreerde Spotify redirect-URI + moet kloppen. +- CI op elke push: ruff, mypy, pytest voor de backend; typecheck, lint en + build voor de frontend. Groen vanaf de eerste commit. +- Repo op eigen Forgejo met een mirror naar GitHub. + +Waarom: + +- Structuur eerst, dan blijft elke volgende stap klein en controleerbaar. +- `docker compose up` is het opleverbare, dus dat werkt vanaf het begin van development. +- Alles Engels behalve dit logboek; ik volg de taal van de opdracht. + +Wat ik heb laten vallen of uitgesteld: + +- Domainmodellen, protocollen, prompts, pipeline-instellingen en het + frontend-typecontract bewust nog niet neergezet. Die ontstaan in de stap + waar ze horen. Ik probeer op die manier bewust vroeg drift en dode code te voorkomen. +- Geen apart beslisdocument. De motivering staat in de README en hier.