<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Facades\Cache;

/**
 * Laufzeit-Einstellungen mit Admin-UI (Key-Value, JSON-Wert, gecacht).
 * Erster Nutzer: Schalter „KI-Prüfung Legacy-API" (10.07.2026).
 */
class AppSetting extends Model
{
    protected $primaryKey = 'key';

    protected $keyType = 'string';

    public $incrementing = false;

    protected $fillable = ['key', 'value'];

    /**
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return ['value' => 'json'];
    }

    public static function getValue(string $key, mixed $default = null): mixed
    {
        return Cache::rememberForever(
            "app-setting.{$key}",
            fn (): mixed => static::query()->find($key)?->value,
        ) ?? $default;
    }

    public static function getBool(string $key, bool $default = false): bool
    {
        return (bool) static::getValue($key, $default);
    }

    public static function setValue(string $key, mixed $value): void
    {
        static::query()->updateOrCreate(['key' => $key], ['value' => $value]);
        static::forgetCached($key);
    }

    /**
     * Verwirft den zwischengespeicherten Wert. Nötig überall dort, wo an
     * `app_settings` vorbei geschrieben wird — insbesondere in Migrationen,
     * die den Query Builder benutzen: `getValue()` cacht dauerhaft
     * (`rememberForever`), ein Direktschreiber bliebe sonst unsichtbar.
     */
    public static function forgetCached(string $key): void
    {
        Cache::forget("app-setting.{$key}");
    }
}