Arkitekturbeslut

Detta dokument innehåller viktiga tekniska beslut och varför de fattades.

ADR-001: main motsvarar produktion

Beslut: main är den branch som produktion bygger från.

Motivering: Det ger en enkel och tydlig modell där produktionskoden alltid kan identifieras i Git.

ADR-002: develop motsvarar test

Beslut: develop används för testmiljön.

Motivering: Nya funktioner kan verifieras utan att påverka produktion.

ADR-003: Git Worktree används

Beslut: prod/app och test/app är separata worktrees.

Motivering: Test och produktion kan ligga på olika brancher samtidigt utan manuell kopiering.

ADR-004: Data ligger utanför Git

Beslut: Datakataloger versioneras inte.

Motivering: Data är miljöspecifik, kan innehålla personuppgifter och ska inte blandas med källkod.

ADR-005: Docker används som körmiljö

Beslut: Applikationen körs i Docker med Gunicorn.

Motivering: Docker ger repeterbar körmiljö och gör test/prod mer lika.

ADR-006: Dokumentationen ligger i appen

Beslut: Dokumentation exponeras i applikationen under /docs.

Motivering: Systemet blir självdokumenterande och dokumentationen följer releaserna.

ADR-007: Releasepaket används som leveransformat

Beslut: Nya ändringar levereras som zip-baserade releasepaket.

Motivering: Det minskar manuell klipp-och-klistra och gör installation mer repeterbar.