Settings Overview

enum SettingKey: string
{
    // Application settings
    case APP_NAME = 'app.name';
    case APP_SUPPORT_EMAIL = 'app.support_email';

    // Internationalization
    case I18N_LOCALE = 'i18n.locale';
    case I18N_FALLBACK_LOCALE = 'i18n.fallback_locale';

    // Time
    case TIME_TIMEZONE = 'time.timezone';

    // Money
    case MONEY_CURRENCY = 'money.currency';
    case MONEY_FALLBACK_CURRENCY = 'money.fallback_currency';

    // Company Information
    case BILLING_COMPANY_NAME = 'billing.company.name';
    case BILLING_COMPANY_ADDRESS = 'billing.company.address';
    case BILLING_COMPANY_ADDRESS_LINE2 = 'billing.company.address_line2';
    case BILLING_COMPANY_CITY = 'billing.company.city';
    case BILLING_COMPANY_STATE = 'billing.company.state';
    case BILLING_COMPANY_POSTAL_CODE = 'billing.company.postal_code';
    case BILLING_COMPANY_COUNTRY = 'billing.company.country';
    case BILLING_COMPANY_VAT_NUMBER = 'billing.company.vat_number';

    // Branding
    case APP_LOGO = 'app.logo';
    case APP_EMAIL_LOGO = 'app.email_logo';

    // Email
    case MAIL_FROM_ADDRESS = 'mail.from.address';
    case MAIL_FROM_NAME = 'mail.from.name';
    case MAIL_REPLY_TO_ADDRESS = 'mail.reply_to.address';
    case MAIL_REPLY_TO_NAME = 'mail.reply_to.name';
    case APP_SUPPORT_NAME = 'app.support_name';

    // Notifications
    case NOTIFICATIONS_EMAIL_ENABLED = 'notifications.email_enabled';
    case NOTIFICATIONS_DESKTOP_ENABLED = 'notifications.desktop_enabled';
}

public function resolve(SettingKey $key, ?Tenant $tenant = null, ?User $user = null): array
{
    $definition = $key->definition();

    // 1. Try user scope (highest priority)
    if ($user !== null && $key->allowedAtScope(SettingScope::User)) {
        $value = $this->userSettings->get($user->id, $key);
        if ($value !== null) {
            return ['value' => $value, 'source' => 'user'];
        }
    }

    // 2. Try tenant scope
    if ($tenant !== null && $key->allowedAtScope(SettingScope::Tenant)) {
        $value = $this->tenantSettings->get($tenant->id, $key);
        if ($value !== null) {
            return ['value' => $value, 'source' => 'tenant'];
        }
    }

    // 3. Try application scope
    if ($key->allowedAtScope(SettingScope::Application)) {
        $value = $this->appSettings->get($key);
        if ($value !== null) {
            return ['value' => $value, 'source' => 'application'];
        }
    }

    // 4. Fall back to registry default
    return ['value' => $definition->default, 'source' => 'default'];
}

final readonly class SettingDefinition
{
    public function __construct(
        public array $scopes,               // Allowed scopes (e.g., [Application, Tenant, User])
        public string $type,                // Storage type: string, bool, int, enum, email, timezone, currency
        public mixed $default,              // Default value when not set in database
        public ?array $allowedValues = null, // For enum types: list of valid values
        public ?string $validation = null,  // Additional Laravel validation rules
        public bool $sensitive = false,     // If true, excluded from public API responses
    ) {}
}

self::I18N_LOCALE => new SettingDefinition(
    scopes: [SettingScope::Application, SettingScope::Tenant, SettingScope::User],
    type: 'enum',
    default: config('app.locale', 'en'),
    allowedValues: ['en', 'fr', 'es', 'it'],
),