新增其他线下出款记账

backend/internal/modules/adminfinance/service.go

@@ -3,9 +3,19 @@ package adminfinance
 import (
 	"context"
 	"errors"
+	"net/url"
+	"strings"
+	"unicode/utf8"
+
+	"hfb_sys/backend/internal/auditlog"
 )
 
-var ErrDependencyUnavailable = errors.New("dependency unavailable")
+var (
+	ErrDependencyUnavailable      = errors.New("dependency unavailable")
+	ErrInvalidManualDisbursement  = errors.New("invalid manual disbursement")
+	ErrManualDisbursementNotFound = errors.New("manual disbursement not found")
+	ErrManualDisbursementNotPaid  = errors.New("manual disbursement is not paid")
+)
 
 type Service struct {
 	repo *Repository
@@ -53,3 +63,66 @@ func (s *Service) Disbursements(ctx context.Context, query DisbursementQuery) (*
 	}
 	return s.repo.Disbursements(ctx, query)
 }
+
+func (s *Service) CreateManualDisbursement(
+	ctx context.Context,
+	req CreateManualDisbursementRequest,
+	adminID uint64,
+	meta auditlog.Meta,
+) (*ManualDisbursementDTO, error) {
+	if s.repo == nil {
+		return nil, ErrDependencyUnavailable
+	}
+	req.Category = strings.TrimSpace(req.Category)
+	req.PayeeName = strings.TrimSpace(req.PayeeName)
+	req.Remark = strings.TrimSpace(req.Remark)
+	req.VoucherURL = strings.TrimSpace(req.VoucherURL)
+	if !validManualDisbursementCategory(req.Category) ||
+		utf8.RuneCountInString(req.PayeeName) < 1 || utf8.RuneCountInString(req.PayeeName) > 100 ||
+		req.AmountCent <= 0 || req.PaidAt.IsZero() ||
+		utf8.RuneCountInString(req.Remark) < 1 || utf8.RuneCountInString(req.Remark) > 500 ||
+		!validManualVoucherURL(req.VoucherURL) {
+		return nil, ErrInvalidManualDisbursement
+	}
+	return s.repo.CreateManualDisbursement(ctx, req, adminID, meta)
+}
+
+func (s *Service) VoidManualDisbursement(
+	ctx context.Context,
+	id uint64,
+	reason string,
+	adminID uint64,
+	meta auditlog.Meta,
+) (*ManualDisbursementDTO, error) {
+	if s.repo == nil {
+		return nil, ErrDependencyUnavailable
+	}
+	reason = strings.TrimSpace(reason)
+	if id == 0 || utf8.RuneCountInString(reason) < 1 || utf8.RuneCountInString(reason) > 255 {
+		return nil, ErrInvalidManualDisbursement
+	}
+	return s.repo.VoidManualDisbursement(ctx, id, reason, adminID, meta)
+}
+
+func validManualDisbursementCategory(category string) bool {
+	switch category {
+	case "user_compensation", "seller_supplement", "operating_expense", "channel_fee", "other":
+		return true
+	default:
+		return false
+	}
+}
+
+func validManualVoucherURL(raw string) bool {
+	if raw == "" {
+		return true
+	}
+	if len(raw) > 500 {
+		return false
+	}
+	parsed, err := url.Parse(raw)
+	if err != nil || parsed.IsAbs() || parsed.Path != "/api/files/object" {
+		return false
+	}
+	return strings.HasPrefix(parsed.Query().Get("key"), "manual-disbursement/")
+}