package v1

import "github.com/gogf/gf/v2/frame/g"

// ============================================================================
// 管理端系统配置契约（迭代-2026-09-29）
//
// 走 settings 表（约定 S9：配置一律走 settings 表，不写 config.yaml）；本模块
// 只开放白名单键，当前是 site.base_url（图片等静态资源的对外拼接前缀）。
// ============================================================================

// AdminSettingItem 配置项
type AdminSettingItem struct {
	Key    string `json:"key"`
	Value  string `json:"value"`
	Remark string `json:"remark"`
}

// AdminSettingGetReq 读取白名单配置项
type AdminSettingGetReq struct {
	g.Meta `path:"/admin/setting/get" method:"get" tags:"admin" summary:"系统配置读取"`
}
type AdminSettingGetRes struct {
	Items []AdminSettingItem `json:"items"`
}

// AdminSettingSaveReq 保存一项配置（key 必须在白名单内）
type AdminSettingSaveReq struct {
	g.Meta `path:"/admin/setting/save" method:"post" tags:"admin" summary:"系统配置保存"`
	Key    string `v:"required" json:"key"`
	Value  string `v:"length:0,255#配置值最多 255 字" json:"value"`
}
type AdminSettingSaveRes struct{}