feat(api): Core-API mit Authentifizierung, CRUD und Monatsreport

- Anmeldung über Argon2id und JWT in httpOnly-Cookies, Refresh mit echter
  Rotation über die neue Tabelle refresh_token
- AuthProvider-Protokoll als Vorbereitung für OIDC, Administrator-Anlage beim
  Erststart mit erzwungenem Passwortwechsel
- CRUD für Konten, Kategorien (zweistufiger Baum), Firmen, Recurrences,
  Preisversionen, Buchungen, Budgets, Vorlagen und Sparziele
- Fälligkeiten mit Overlay-Logik: abrufen, bestätigen, auslassen, zurücksetzen
- Kontosalden zum Stichtag, Monatsübersicht mit Plan-Ist-Vergleich
- SECRET_KEY jetzt mindestens 32 Zeichen; Platzhalter in Produktion abgelehnt
- 61 neue Integrationstests, insgesamt 148 grün

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014e7t8UpmoVNMtWivY5LiSH
This commit is contained in:
moneyfy
2026-09-09 13:40:37 +02:00
co-authored by Claude Opus 5
parent 70d73cf8d3
commit b586d27b77
46 changed files with 4866 additions and 21 deletions
+55
View File
@@ -0,0 +1,55 @@
"""Gemeinsame Bausteine aller API-Schemata."""
from datetime import date
from decimal import Decimal
from typing import Annotated
from pydantic import BaseModel, ConfigDict, Field
# Geldbeträge werden als Decimal geführt und im JSON als String ausgeliefert,
# damit auf dem Weg zum Frontend keine Genauigkeit verloren geht.
Money = Annotated[Decimal, Field(max_digits=12, decimal_places=2)]
PositiveMoney = Annotated[Decimal, Field(gt=0, max_digits=12, decimal_places=2)]
NonNegativeMoney = Annotated[Decimal, Field(ge=0, max_digits=12, decimal_places=2)]
HexColor = Annotated[str, Field(pattern=r"^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$")]
class ApiModel(BaseModel):
"""Basisklasse für Ausgabeschemata; liest Werte direkt von ORM-Objekten."""
model_config = ConfigDict(from_attributes=True)
class InputModel(BaseModel):
"""Basisklasse für Eingabeschemata; unbekannte Felder werden abgewiesen."""
model_config = ConfigDict(extra="forbid", str_strip_whitespace=True)
class Page[T](ApiModel):
"""Einfache Seitenausgabe mit Gesamtzahl."""
items: list[T]
total: int = Field(description="Gesamtzahl der Treffer ohne Berücksichtigung der Seite.")
limit: int
offset: int
class DateRange(InputModel):
"""Ein von/bis-Zeitraum, beide Grenzen einschließlich."""
date_from: date
date_to: date
class ErrorResponse(BaseModel):
"""Einheitliches Fehlerformat aller Endpunkte."""
detail: str = Field(description="Für Menschen lesbare Beschreibung des Fehlers.")
code: str = Field(description="Stabiler Fehlercode zur Auswertung im Frontend.")
class MessageResponse(BaseModel):
"""Antwort für Aktionen ohne eigene Nutzlast."""
detail: str