# Changelog

Alle nennenswerten Änderungen an diesem Projekt werden hier dokumentiert.

Das Format orientiert sich an [Keep a Changelog](https://keepachangelog.com/de/1.1.0/),
die Versionierung folgt [Semantic Versioning](https://semver.org/lang/de/).

## [Unreleased]

### Hinzugefügt

- Projektgerüst mit getrennten Bereichen für Backend, Frontend, Dokumentation und CI.
- FastAPI-Backend mit Konfiguration über `pydantic-settings` und einheitlichem
  Fehlerformat (`{"detail": ..., "code": ...}`).
- Vollständiges Datenmodell als SQLAlchemy-2.0-Modelle: Konten, Kategorien, Firmen,
  Logo-Assets, Recurrences, Preishistorie, Occurrences, Buchungen, Budgets samt
  Vorlagen, Sparziele, Rücklagen, Benachrichtigungsregeln und -protokoll, Benutzer.
- Alembic-Setup gegen die Async-Engine samt Erstmigration des kompletten Schemas;
  der Downgrade entfernt auch die nativen Enum-Typen, sodass Auf- und Abwärtsmigration
  beliebig oft wiederholbar sind.
- Idempotenter Seed für den deutschen Standard-Kategoriebaum (35 Kategorien) und
  die Standard-Benachrichtigungsregeln.
- Endpunkte `GET /api/health` und `GET /api/version`.
- Testinfrastruktur mit pytest, httpx und transaktionsisolierten Fixtures.
- `.env.example`, `docker-compose.override.yml.example` und Makefile für die
  lokale Entwicklung.
- Recurrence-Engine (`app/services/recurrence.py`) mit vollständiger
  RFC-5545-Expansion: `expand` liefert nominale und tatsächliche Zahltage,
  `expand_by_due_date` filtert nach dem Zahltag für Kalender und Monatsberichte.
- Wochenend- und Feiertagsverschiebung über den NRW-Kalender; das nominale Datum
  bleibt stabiler Schlüssel zur Zuordnung materialisierter Fälligkeiten.
- Auflösung der Preishistorie je Fälligkeitsdatum, Overlays aus `occurrence`,
  Kappung der Serie durch `until`, Kündigung und Ratenzahl.
- `installments_remaining` (Restraten und Restschuld), `contract_term` und
  `notice_deadline` (Mindestlaufzeit, automatische Verlängerung, Kündigungsfrist)
  sowie `annual_burden` und `monthly_reserve` für die Rücklagenbildung.
- `validate_rrule` und `next_dates` als Grundlage für Eingabeprüfung und Vorschau.
- Authentifizierung mit Argon2id, JWT in httpOnly-Cookies (Access 30 min, Refresh
  14 Tage) und echter Token-Rotation über die Tabelle `refresh_token`; ein erneut
  eingelöstes Refresh-Token beendet alle Sitzungen.
- `AuthProvider`-Protokoll mit lokalem Provider als Vorbereitung für OIDC.
- Anlage des Administrators beim Erststart mit erzwungenem Passwortwechsel; bis
  dahin sind alle Fachrouten gesperrt.
- CRUD für Konten, Kategorien, Firmen, wiederkehrende Posten, Preisversionen,
  Buchungen, Budgets, Budgetvorlagen und Sparziele.
- Fälligkeiten-API mit Overlay-Logik: abrufen, bestätigen (auch mit abweichendem
  Betrag oder Datum), auslassen und zurücksetzen.
- Kontosalden zum Stichtag aus Eröffnungssaldo, Buchungen und bestätigten
  Fälligkeiten, inklusive abweichender Konten je Fälligkeit.
- Monatsübersicht mit Plan-Ist-Vergleich, Aufteilung in fixe und variable Kosten,
  Rücklagen und Vergleich zum Vormonat.
- Vollständig annotiertes OpenAPI-Dokument unter `/api/docs`.

- Logo-Service mit fünfstufiger Provider-Kette: lokal gevendorte simple-icons
  (3.459 Marken, rund 2 MB), logo.dev und Brandfetch bei gesetztem Schlüssel,
  Favicon-Fallback und generierter Buchstaben-Avatar als Garantie.
- Logo-Cache im Dateisystem, benannt nach dem SHA-256 des Inhalts; Auslieferung
  ausschließlich über `GET /api/logos/{id}` mit `immutable`-Cache-Header und
  ETag-Unterstützung.
- Ermittlung der Markenfarbe: bei SVG aus den `fill`-Attributen, bei
  Rastergrafiken per k-Means über 64×64 Pixel; dazu eine im HSL-Raum aufgehellte
  Variante, die gegen den dunklen Hintergrund mindestens 4,5:1 Kontrast erreicht.
- Auswahldialog-Endpunkte: Kandidatensuche mit Vorauswahl, Übernahme eines
  Kandidaten, Upload (SVG/PNG/JPEG bis 1 MB) und Zurücksetzen.
- Die Logosuche läuft nach dem Anlegen einer Firma im Hintergrund; der Aufruf
  antwortet sofort.
- `make vendor-icons` erzeugt den simple-icons-Index neu.

### Geändert

- `SECRET_KEY` muss mindestens 32 Zeichen lang sein (Vorgabe von HS256); in
  Produktion wird der Platzhalterwert beim Start abgelehnt.
- Der Bildtyp eines Uploads wird ausschließlich am Inhalt bestimmt; die vom
  Aufrufer gemeldete Kopfzeile wird nicht mehr als Nachweis akzeptiert.