Update mengyastore

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

@@ -8,16 +8,28 @@ import (
 	"mengyastore-backend/internal/storage"
 )
 
-type maintenancePayload struct {
+type MaintenancePayload struct {
 	Maintenance bool   `json:"maintenance"`
 	Reason      string `json:"reason"`
 }
 
+// SetMaintenance 设置站点维护模式。
+// @Summary 设置维护模式
+// @Tags 管理端-站点
+// @Accept json
+// @Produce json
+// @Security AdminToken
+// @Param body body MaintenancePayload true "维护开关与原因"
+// @Success 200 {object} SwaggerMaintenanceWrap
+// @Failure 400 {object} SwaggerErrorBody
+// @Failure 401 {object} SwaggerErrorBody
+// @Failure 500 {object} SwaggerErrorBody
+// @Router /api/admin/site/maintenance [post]
 func (h *AdminHandler) SetMaintenance(c *gin.Context) {
 	if !h.requireAdmin(c) {
 		return
 	}
-	var payload maintenancePayload
+	var payload MaintenancePayload
 	if err := c.ShouldBindJSON(&payload); err != nil {
 		c.JSON(http.StatusBadRequest, gin.H{"error": "请求参数有误"})
 		return
@@ -34,6 +46,15 @@ func (h *AdminHandler) SetMaintenance(c *gin.Context) {
 	})
 }
 
+// GetSMTPConfig 获取 SMTP 配置（密码脱敏）。
+// @Summary 获取 SMTP 配置
+// @Tags 管理端-站点
+// @Produce json
+// @Security AdminToken
+// @Success 200 {object} SwaggerSMTPWrap
+// @Failure 401 {object} SwaggerErrorBody
+// @Failure 500 {object} SwaggerErrorBody
+// @Router /api/admin/site/smtp [get]
 func (h *AdminHandler) GetSMTPConfig(c *gin.Context) {
 	if !h.requireAdmin(c) {
 		return
@@ -51,6 +72,18 @@ func (h *AdminHandler) GetSMTPConfig(c *gin.Context) {
 	c.JSON(http.StatusOK, gin.H{"data": masked})
 }
 
+// SetSMTPConfig 保存 SMTP 配置。
+// @Summary 保存 SMTP 配置
+// @Tags 管理端-站点
+// @Accept json
+// @Produce json
+// @Security AdminToken
+// @Param body body storage.SMTPConfig true "SMTP 字段"
+// @Success 200 {object} SwaggerStringOKBody
+// @Failure 400 {object} SwaggerErrorBody
+// @Failure 401 {object} SwaggerErrorBody
+// @Failure 500 {object} SwaggerErrorBody
+// @Router /api/admin/site/smtp [post]
 func (h *AdminHandler) SetSMTPConfig(c *gin.Context) {
 	if !h.requireAdmin(c) {
 		return