34 lines
1.2 KiB
Go
34 lines
1.2 KiB
Go
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{}
|