实现七月迭代公共技术基础

internal/model/dto/system_config_dto.go

@@ -0,0 +1,46 @@
+package dto
+
+import "time"
+
+// SystemConfigListRequest 是系统配置分页查询参数。
+type SystemConfigListRequest struct {
+	Module   string `json:"module" query:"module" validate:"omitempty,max=100" description:"模块筛选"`
+	Page     int    `json:"page" query:"page" validate:"omitempty,min=1" minimum:"1" description:"页码"`
+	PageSize int    `json:"page_size" query:"page_size" validate:"omitempty,min=1,max=100" minimum:"1" maximum:"100" description:"每页数量"`
+}
+
+// SystemConfigItem 是超级管理员可见的受控配置投影。
+type SystemConfigItem struct {
+	ConfigKey   string     `json:"config_key" description:"稳定配置 Key"`
+	Value       string     `json:"value" description:"配置值；敏感值按注册策略脱敏"`
+	ValueType   string     `json:"value_type" description:"值类型 (string:字符串, int:整数, bool:布尔, json:JSON)"`
+	Module      string     `json:"module" description:"所属模块"`
+	Description string     `json:"description" description:"中文说明"`
+	Readonly    bool       `json:"readonly" description:"是否只读"`
+	Sensitive   bool       `json:"sensitive" description:"是否敏感"`
+	Registered  bool       `json:"registered" description:"是否已在代码注册"`
+	Control     string     `json:"control" description:"前端控件提示"`
+	EnumValues  []string   `json:"enum_values,omitempty" description:"允许的枚举值"`
+	Min         *int64     `json:"min,omitempty" description:"整数最小值"`
+	Max         *int64     `json:"max,omitempty" description:"整数最大值"`
+	UpdatedAt   *time.Time `json:"updated_at,omitempty" description:"最近更新时间"`
+}
+
+// SystemConfigListResponse 是系统配置分页结果。
+type SystemConfigListResponse struct {
+	List     []SystemConfigItem `json:"list" description:"配置列表"`
+	Total    int64              `json:"total" description:"总数量"`
+	Page     int                `json:"page" description:"页码"`
+	PageSize int                `json:"page_size" description:"每页数量"`
+}
+
+// UpdateSystemConfigRequest 是单 Key 更新请求。
+type UpdateSystemConfigRequest struct {
+	Value string `json:"value" validate:"required" required:"true" description:"字符串化配置值"`
+}
+
+// UpdateSystemConfigParams 组合路径和请求体文档参数。
+type UpdateSystemConfigParams struct {
+	Key string `json:"key" path:"key" validate:"required" required:"true" description:"稳定配置 Key"`
+	UpdateSystemConfigRequest
+}