Add settings table

Author: KillerX

backend/cmd/server/main.go

@@ -162,13 +162,23 @@ func main() {
 	leaderboardService := services.NewLeaderboardService(db.Queries, cacheInstance.Cache, dataLoaders)
 	slog.Info("LeaderboardService initialized with caching and loaders")
 
+	// Initialize SettingsService
+	settingsService, err := services.NewSettingsService(ctx, db.Queries, lgr)
+	if err != nil {
+		slog.Error("Failed to initialize SettingsService", "error", err)
+		os.Exit(1)
+	}
+	defer settingsService.Stop()
+	slog.Info("SettingsService initialized with background refresh")
+
 	// Initialize GraphQL resolver
 	apiResolver := &api.Resolver{
 		DB:                 db,
 		Loaders:            dataLoaders,
 		Cache:              cacheInstance,
 		RoleService:        roleService,
 		LeaderboardService: leaderboardService,
+		Settings:           settingsService,
 	}
 
 	apiHandler := handler.New(api.NewExecutableSchema(api.Config{

backend/internal/database/migrations/00047_create_settings_table.sql

@@ -0,0 +1,58 @@
+-- +goose Up
+-- +goose StatementBegin
+
+-- Settings table stores runtime configuration as key-value pairs
+CREATE TABLE settings (
+    key TEXT PRIMARY KEY,
+    value_text TEXT,
+    value_int BIGINT,
+    value_bool BOOLEAN,
+    value_float DOUBLE PRECISION,
+    value_json JSONB,
+    value_type TEXT NOT NULL CHECK (value_type IN ('text', 'int', 'bool', 'float', 'json')),
+    description TEXT,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+COMMENT ON TABLE settings IS 'Runtime configuration key-value store';
+COMMENT ON COLUMN settings.key IS 'Unique setting identifier (e.g., current_project_id, log_level)';
+COMMENT ON COLUMN settings.value_type IS 'Indicates which value column to use: text, int, bool, float, or json';
+COMMENT ON COLUMN settings.description IS 'Human-readable description of the setting';
+
+-- Auto-update updated_at timestamp
+CREATE TRIGGER settings_updated_at
+    BEFORE UPDATE ON settings
+    FOR EACH ROW
+    EXECUTE FUNCTION update_updated_at_column();
+
+-- Insert default settings
+INSERT INTO settings (key, value_text, value_type, description) VALUES
+    ('current_project_id', 'PR01K9VZ8684DP9R4W3ZEV526E5X', 'text', 'Default project ID for unauthenticated queries');
+
+INSERT INTO settings (key, value_text, value_type, description) VALUES
+    ('log_level', 'info', 'text', 'Logging verbosity: debug, info, warn, error');
+
+INSERT INTO settings (key, value_bool, value_type, description) VALUES
+    ('db_log_queries', false, 'bool', 'Toggle query logging for debugging');
+
+INSERT INTO settings (key, value_bool, value_type, description) VALUES
+    ('otel_enabled', true, 'bool', 'Toggle OpenTelemetry tracing on/off');
+
+INSERT INTO settings (key, value_float, value_type, description) VALUES
+    ('otel_sampling_ratio', 0.1, 'float', 'OpenTelemetry sampling rate (0.0-1.0)');
+
+INSERT INTO settings (key, value_bool, value_type, description) VALUES
+    ('ssf_debug_mode', false, 'bool', 'SSF API debug logging');
+
+-- Index for faster lookups by type (likely unnecessary given small table size, but follows best practices)
+CREATE INDEX idx_settings_value_type ON settings(value_type);
+
+-- +goose StatementEnd
+
+-- +goose Down
+-- +goose StatementBegin
+
+DROP TABLE IF EXISTS settings CASCADE;
+
+-- +goose StatementEnd

backend/internal/database/queries/projects.sql

@@ -265,3 +265,6 @@ RETURNING id, name, description, rules, start_date, end_date, logo_url,
     color_dark_text_default, color_dark_text_muted, color_dark_text_hint,
     color_dark_shadow_default, color_dark_shadow_blank, color_dark_border_default,
     rounding, archived;
+
+-- name: ProjectExists :one
+SELECT EXISTS(SELECT 1 FROM projects WHERE id = @projectid::text);

backend/internal/database/queries/settings.sql

@@ -0,0 +1,87 @@
+-- name: GetSettingByKey :one
+SELECT key, value_text, value_int, value_bool, value_float, value_json, value_type, description, created_at, updated_at
+FROM settings
+WHERE key = @key::text;
+
+-- name: GetSettingText :one
+SELECT value_text
+FROM settings
+WHERE key = @key::text
+  AND value_type = 'text';
+
+-- name: GetSettingInt :one
+SELECT value_int
+FROM settings
+WHERE key = @key::text
+  AND value_type = 'int';
+
+-- name: GetSettingBool :one
+SELECT value_bool
+FROM settings
+WHERE key = @key::text
+  AND value_type = 'bool';
+
+-- name: GetSettingFloat :one
+SELECT value_float
+FROM settings
+WHERE key = @key::text
+  AND value_type = 'float';
+
+-- name: GetSettingJSON :one
+SELECT value_json
+FROM settings
+WHERE key = @key::text
+  AND value_type = 'json';
+
+-- name: GetAllSettings :many
+SELECT key, value_text, value_int, value_bool, value_float, value_json, value_type, description, created_at, updated_at
+FROM settings
+ORDER BY key;
+
+-- name: SetSettingText :exec
+INSERT INTO settings (key, value_text, value_type, description)
+VALUES (@key::text, @value_text::text, 'text', @description::text)
+ON CONFLICT (key) DO UPDATE
+    SET value_text = EXCLUDED.value_text,
+        value_type = 'text',
+        description = COALESCE(EXCLUDED.description, settings.description),
+        updated_at = NOW();
+
+-- name: SetSettingInt :exec
+INSERT INTO settings (key, value_int, value_type, description)
+VALUES (@key::text, @value_int::bigint, 'int', @description::text)
+ON CONFLICT (key) DO UPDATE
+    SET value_int = EXCLUDED.value_int,
+        value_type = 'int',
+        description = COALESCE(EXCLUDED.description, settings.description),
+        updated_at = NOW();
+
+-- name: SetSettingBool :exec
+INSERT INTO settings (key, value_bool, value_type, description)
+VALUES (@key::text, @value_bool::boolean, 'bool', @description::text)
+ON CONFLICT (key) DO UPDATE
+    SET value_bool = EXCLUDED.value_bool,
+        value_type = 'bool',
+        description = COALESCE(EXCLUDED.description, settings.description),
+        updated_at = NOW();
+
+-- name: SetSettingFloat :exec
+INSERT INTO settings (key, value_float, value_type, description)
+VALUES (@key::text, @value_float::double precision, 'float', @description::text)
+ON CONFLICT (key) DO UPDATE
+    SET value_float = EXCLUDED.value_float,
+        value_type = 'float',
+        description = COALESCE(EXCLUDED.description, settings.description),
+        updated_at = NOW();
+
+-- name: SetSettingJSON :exec
+INSERT INTO settings (key, value_json, value_type, description)
+VALUES (@key::text, @value_json::jsonb, 'json', @description::text)
+ON CONFLICT (key) DO UPDATE
+    SET value_json = EXCLUDED.value_json,
+        value_type = 'json',
+        description = COALESCE(EXCLUDED.description, settings.description),
+        updated_at = NOW();
+
+-- name: DeleteSetting :exec
+DELETE FROM settings WHERE key = @key::text;