docs: open the build log
This commit is contained in:
parent
d2380b621a
commit
000b435b9a
1 changed files with 35 additions and 0 deletions
35
docs/logboek.md
Normal file
35
docs/logboek.md
Normal file
|
|
@ -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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue