新增其他线下出款记账

backend/internal/modules/adminfinance/handler.go

@@ -7,6 +7,8 @@ import (
 	"strings"
 	"time"
 
+	"hfb_sys/backend/internal/auditlog"
+	"hfb_sys/backend/internal/middleware"
 	"hfb_sys/backend/internal/timeutil"
 	"hfb_sys/backend/pkg/response"
 
@@ -60,6 +62,49 @@ func (h *Handler) Disbursements(c *gin.Context) {
 	response.OK(c, result)
 }
 
+func (h *Handler) CreateManualDisbursement(c *gin.Context) {
+	adminID, ok := financeAdminID(c)
+	if !ok {
+		response.Unauthorized(c, "缺少管理员上下文")
+		return
+	}
+	var req CreateManualDisbursementRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.BadRequest(c, "线下出款信息不正确")
+		return
+	}
+	item, err := h.service.CreateManualDisbursement(c.Request.Context(), req, adminID, financeAuditMeta(c))
+	if err != nil {
+		writeFinanceError(c, err)
+		return
+	}
+	response.Created(c, item)
+}
+
+func (h *Handler) VoidManualDisbursement(c *gin.Context) {
+	adminID, ok := financeAdminID(c)
+	if !ok {
+		response.Unauthorized(c, "缺少管理员上下文")
+		return
+	}
+	id, err := strconv.ParseUint(c.Param("id"), 10, 64)
+	if err != nil || id == 0 {
+		response.BadRequest(c, "线下出款记录 ID 不正确")
+		return
+	}
+	var req VoidManualDisbursementRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		response.BadRequest(c, "请填写作废原因")
+		return
+	}
+	item, err := h.service.VoidManualDisbursement(c.Request.Context(), id, req.Reason, adminID, financeAuditMeta(c))
+	if err != nil {
+		writeFinanceError(c, err)
+		return
+	}
+	response.OK(c, item)
+}
+
 func parseDashboardQuery(c *gin.Context) (DashboardQuery, bool) {
 	start, end, ok := parseDateRange(c, 6)
 	if !ok {
@@ -124,11 +169,11 @@ func parseDisbursementQuery(c *gin.Context) (DisbursementQuery, bool) {
 		StartDate:  start,
 		EndDate:    end,
 	}
-	if query.SourceType != "" && query.SourceType != "platform_managed" && query.SourceType != "withdrawal" {
+	if query.SourceType != "" && query.SourceType != "platform_managed" && query.SourceType != "withdrawal" && query.SourceType != "manual_offline" {
 		response.BadRequest(c, "出款类型不正确")
 		return query, false
 	}
-	if query.Status != "" && query.Status != "review_pending" && query.Status != "payment_pending" && query.Status != "paid" && query.Status != "rejected" && query.Status != "cancelled" {
+	if query.Status != "" && query.Status != "review_pending" && query.Status != "payment_pending" && query.Status != "paid" && query.Status != "rejected" && query.Status != "cancelled" && query.Status != "voided" {
 		response.BadRequest(c, "出款状态不正确")
 		return query, false
 	}
@@ -186,7 +231,30 @@ func writeFinanceError(c *gin.Context, err error) {
 	switch {
 	case errors.Is(err, ErrDependencyUnavailable):
 		response.ServiceUnavailable(c, "数据库未连接")
+	case errors.Is(err, ErrInvalidManualDisbursement):
+		response.BadRequest(c, "线下出款信息不正确")
+	case errors.Is(err, ErrManualDisbursementNotFound):
+		response.NotFound(c, "线下出款记录不存在")
+	case errors.Is(err, ErrManualDisbursementNotPaid):
+		response.BadRequest(c, "该线下出款记录已作废")
 	default:
 		response.Error(c, http.StatusInternalServerError, "finance_error", "财务数据暂时不可用")
 	}
 }
+
+func financeAdminID(c *gin.Context) (uint64, bool) {
+	value, ok := c.Get(middleware.ContextAdminID)
+	if !ok {
+		return 0, false
+	}
+	adminID, ok := value.(uint64)
+	return adminID, ok
+}
+
+func financeAuditMeta(c *gin.Context) auditlog.Meta {
+	return auditlog.Meta{
+		IP:        c.ClientIP(),
+		UserAgent: c.GetHeader("User-Agent"),
+		RequestID: middleware.GetRequestID(c),
+	}
+}