chore: sync local updates

mengyastore-backend-go/internal/handlers/admin_site.go

@@ -14,12 +14,13 @@ type MaintenancePayload struct {
 }
 
 // SetMaintenance 设置站点维护模式。
-// @Summary 设置维护模式
+// @Summary 设置全站维护模式
+// @Description 打开维护后前台可展示原因文案；需管理令牌。请求体含 `maintenance` 布尔与可选 `reason`。
 // @Tags 管理端-站点
 // @Accept json
 // @Produce json
 // @Security AdminToken
-// @Param body body MaintenancePayload true "维护开关与原因"
+// @Param body body MaintenancePayload true "maintenance 与 reason"
 // @Success 200 {object} SwaggerMaintenanceWrap
 // @Failure 400 {object} SwaggerErrorBody
 // @Failure 401 {object} SwaggerErrorBody
@@ -47,7 +48,8 @@ func (h *AdminHandler) SetMaintenance(c *gin.Context) {
 }
 
 // GetSMTPConfig 获取 SMTP 配置（密码脱敏）。
-// @Summary 获取 SMTP 配置
+// @Summary 获取发信 SMTP 配置（脱敏）
+// @Description 返回当前站点发件配置；密码字段以占位符脱敏显示，不会返回明文。
 // @Tags 管理端-站点
 // @Produce json
 // @Security AdminToken
@@ -73,12 +75,13 @@ func (h *AdminHandler) GetSMTPConfig(c *gin.Context) {
 }
 
 // SetSMTPConfig 保存 SMTP 配置。
-// @Summary 保存 SMTP 配置
+// @Summary 保存发信 SMTP 配置
+// @Description 写入 SMTP 主机、端口、账号等；若密码仍为脱敏占位符则保留库中已有密码（实现细节见服务逻辑）。
 // @Tags 管理端-站点
 // @Accept json
 // @Produce json
 // @Security AdminToken
-// @Param body body storage.SMTPConfig true "SMTP 字段"
+// @Param body body storage.SMTPConfig true "SMTP 连接与发件人信息"
 // @Success 200 {object} SwaggerStringOKBody
 // @Failure 400 {object} SwaggerErrorBody
 // @Failure 401 {object} SwaggerErrorBody