chore(init): 初始化解忧商行项目并完成 Phase 0 基座

backend/internal/modules/systemconfig/handler.go

@@ -0,0 +1,169 @@
+package systemconfig
+
+import (
+	"errors"
+	"net/http"
+
+	"hfb_sys/backend/internal/middleware"
+	"hfb_sys/backend/internal/sitecode"
+	"hfb_sys/backend/pkg/response"
+
+	"github.com/gin-gonic/gin"
+)
+
+type Handler struct {
+	service *Service
+}
+
+func NewHandler(service *Service) *Handler {
+	return &Handler{service: service}
+}
+
+func (h *Handler) List(c *gin.Context) {
+	items, err := h.service.List(c.Request.Context())
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, gin.H{"items": items})
+}
+
+func (h *Handler) PublishOptions(c *gin.Context) {
+	options, err := h.service.PublishOptions(c.Request.Context())
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, options)
+}
+
+func (h *Handler) SalePriceConfig(c *gin.Context) {
+	config, err := h.service.SalePriceConfig(c.Request.Context())
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, config)
+}
+
+func (h *Handler) OrderAgreements(c *gin.Context) {
+	agreements, err := h.service.OrderAgreements(c.Request.Context())
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, agreements)
+}
+
+func (h *Handler) ListingPublishAgreements(c *gin.Context) {
+	agreements, err := h.service.ListingPublishAgreements(c.Request.Context())
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, agreements)
+}
+
+func (h *Handler) PostRentalNotice(c *gin.Context) {
+	notice, err := h.service.PostRentalNotice(c.Request.Context())
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, notice)
+}
+
+func (h *Handler) HomeAnnouncements(c *gin.Context) {
+	announcements, err := h.service.HomeAnnouncements(c.Request.Context())
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, announcements)
+}
+
+func (h *Handler) HomeConfig(c *gin.Context) {
+	config, err := h.service.HomeConfig(c.Request.Context(), sitecode.FromRequest(c))
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, config)
+}
+
+func (h *Handler) Update(c *gin.Context) {
+	adminID, ok := currentAdminID(c)
+	if !ok {
+		response.Unauthorized(c, "缺少管理员上下文")
+		return
+	}
+	key := c.Param("key")
+	var req UpdateRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.BadRequest(c, "配置值不能为空")
+		return
+	}
+	item, err := h.service.Update(c.Request.Context(), adminID, key, req, auditMeta(c))
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, item)
+}
+
+func (h *Handler) BackupSchedule(c *gin.Context) {
+	schedule, err := h.service.BackupSchedule(c.Request.Context())
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, schedule)
+}
+
+func (h *Handler) UpdateBackupSchedule(c *gin.Context) {
+	adminID, ok := currentAdminID(c)
+	if !ok {
+		response.Unauthorized(c, "缺少管理员上下文")
+		return
+	}
+	var req BackupScheduleDTO
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.BadRequest(c, "备份定时配置格式无效")
+		return
+	}
+	schedule, err := h.service.UpdateBackupSchedule(c.Request.Context(), adminID, req, auditMeta(c))
+	if err != nil {
+		writeConfigError(c, err)
+		return
+	}
+	response.OK(c, schedule)
+}
+
+func auditMeta(c *gin.Context) AuditMeta {
+	return AuditMeta{
+		IP:        c.ClientIP(),
+		UserAgent: c.GetHeader("User-Agent"),
+		RequestID: middleware.GetRequestID(c),
+	}
+}
+
+func currentAdminID(c *gin.Context) (uint64, bool) {
+	value, ok := c.Get(middleware.ContextAdminID)
+	if !ok {
+		return 0, false
+	}
+	adminID, ok := value.(uint64)
+	return adminID, ok
+}
+
+func writeConfigError(c *gin.Context, err error) {
+	response.RecordError(c, err)
+	switch {
+	case errors.Is(err, ErrDependencyUnavailable):
+		response.ServiceUnavailable(c, "数据库未连接")
+	case errors.Is(err, ErrInvalidConfig):
+		response.BadRequest(c, "配置不符合规则")
+	default:
+		response.Error(c, http.StatusInternalServerError, "internal_error", "系统配置服务暂时不可用")
+	}
+}