svc-essensplanung/Doku/adr/003-single-user-mit-token.md

003 – Single-User, keine Authentifizierung

Status: accepted

Kontext. Das Werkzeug wird im privaten Homelab von einer Person (bzw. Familie via LAN) genutzt. Ein Login-Flow wird zur Barriere, nicht zum Feature. Später soll Home-Assistant die API konsumieren, und dort ist es einfacher, einen Shared-Token zu haben statt ein OIDC-Realm zu betreiben.

Entscheidung. Im MVP kein Login. Die API ist hinter dem bestehenden Traefik-Routing essen.ljh31.de (ACME/TLS) erreichbar; wer die Domain kennt, kann aufrufen. Optional (Phase 2): Shared-API-Token per Header (X-Api-Token) für externe Clients wie HA.

Konsequenzen.

• • Einfachster möglicher Pfad, kein Auth-State, kein JWT.
• • HA-Integration ist trivial (einfacher Token statt OIDC).
• − Kein Benutzer-Abgrenzen, keine Rechte. Im aktuellen Kontext kein Risiko (LAN + eigene Domain).
• − Wenn es irgendwann öffentliches Hosting wird, ADR-003 ersetzen.