# Einstellungen: Speicherung (DB + Cache)

Letzte Aktualisierung: 2026-03-06

## Kurzfassung

- **Source of truth ist immer die Tabelle `settings` in der Datenbank.**
- `config/settings.php` ist nur ein **Teil-Cache** für wenige, sehr häufig gelesene UI-Basiswerte.
- Nicht alle Settings müssen oder sollen im Datei-Cache stehen.

## Warum es beides gibt

Die Kombination ist bewusst so gebaut:

1. **DB als Wahrheit**
   - Alle Settings werden persistiert in `settings`.
   - Validierung und Schreiblogik laufen über `SettingService`.

2. **Datei-Cache für Hot-Path-Reads**
   - `config/settings.php` wird durch `SettingCacheService` geschrieben.
   - Verwendet wird er über `appSetting(...)` nur für globale Basiswerte wie:
     - `app_title`
     - `app_locale`
     - `app_theme`
     - `app_theme_user`
     - `app_registration`
     - `app_primary_color`

## Was **nicht** im Cache der Datei liegen muss

Sicherheits- oder Integrationswerte werden direkt aus DB gelesen, z. B.:

- SMTP (`smtp_host`, `smtp_port`, `smtp_user`, `smtp_from`, ...)
- Microsoft SSO Shared App Settings
- API-spezifische Policies
- User-Lifecycle-Policies (`user_inactivity_deactivate_days`, `user_inactivity_delete_days`)
- Scheduler-/Job-Konfiguration (`scheduled_jobs`, `scheduled_job_runs`)

Daher ist es korrekt, wenn diese Werte in `settings` (DB) vorhanden sind, aber nicht in `config/settings.php`.

## Laufzeitfluss

1. Admin speichert Settings in `admin/settings`.
2. `SettingGateway` (aus `SettingServicesFactory`) delegiert auf `SettingService`, der in DB schreibt.
3. `SettingCacheService` aktualisiert den Datei-Cache nur für den definierten Teilbereich.
4. UI-Helfer `appSetting(...)` liest danach aus Datei-Cache.

## Wenn DB und Datei scheinbar nicht zusammenpassen

Das ist oft erwartbar, solange es um nicht-gecachte Keys geht.

Prüfregel:

- Geht es um `appSetting(...)`-Keys? Dann Datei-Cache relevant.
- Geht es um SMTP/SSO/API-Details? Dann DB ist massgeblich.

## Betriebs-Hinweis

Direkte DB-Änderungen an gecachten `appSetting(...)`-Keys werden erst wirksam, wenn der Datei-Cache aktualisiert wurde
(z. B. durch erneutes Speichern in den Settings).
