feat(finance): 增加线下结算实际操作人

This commit is contained in:
yml
2026-11-15 17:14:23 +08:00
parent 79b8bc3ac1
commit b1a898ad92
35 changed files with 543 additions and 129 deletions
+13 -10
View File
@@ -6,6 +6,8 @@ import "time"
const (
OptionTypePlatform = "platform" // 平台
OptionTypeOperator = "operator" // 操作人
// OptionTypeDisbursementOperator 线下结算实际操作人;独立于录单操作人。
OptionTypeDisbursementOperator = "disbursement_operator"
)
// 录单组别。
@@ -68,12 +70,12 @@ type PaginatedResult struct {
// AgentDayStatsDTO 某客服某日录单统计(按组分列)。
type AgentDayStatsDTO struct {
Date string `json:"date"` // YYYY-MM-DD(北京时间)
Date string `json:"date"` // YYYY-MM-DD(北京时间)
AdminID uint64 `json:"admin_id"`
AdminName string `json:"admin_name"`
Count int64 `json:"count"` // 总录单量
CollectCount int64 `json:"collect_count"` // 收号录单量
SellCount int64 `json:"sell_count"` // 出号录单量
Count int64 `json:"count"` // 总录单量
CollectCount int64 `json:"collect_count"` // 收号录单量
SellCount int64 `json:"sell_count"` // 出号录单量
}
// CreateResult 录单结果。
@@ -81,7 +83,7 @@ type CreateResult struct {
Entry EntryDTO `json:"entry"`
}
// OptionDTO 录单可选项(平台 / 操作人)。
// OptionDTO 可选项(平台 / 操作人 / 出款实际操作人)。
type OptionDTO struct {
ID uint64 `json:"id"`
Type string `json:"type"`
@@ -91,20 +93,21 @@ type OptionDTO struct {
CreatedAt time.Time `json:"created_at"`
}
// OptionListDTO 平台与操作人选项集合,供录单表单下拉直接使用。
// OptionListDTO 平台、操作人与出款实际操作人选项集合。
type OptionListDTO struct {
Platforms []OptionDTO `json:"platforms"`
Operators []OptionDTO `json:"operators"`
Platforms []OptionDTO `json:"platforms"`
Operators []OptionDTO `json:"operators"`
DisbursementOperators []OptionDTO `json:"disbursement_operators"`
}
// CreateOptionRequest 新增平台 / 操作人选项。
// CreateOptionRequest 新增平台 / 操作人 / 出款实际操作人选项。
type CreateOptionRequest struct {
Type string `json:"type" binding:"required"`
Name string `json:"name" binding:"required"`
GroupTag string `json:"group_tag"` // 仅操作人类型可用,collect/sell/空
}
// UpdateOptionRequest 重命名平台 / 操作人选项(可同时更新组别标记)。
// UpdateOptionRequest 重命名选项(录单操作人可同时更新组别标记)。
type UpdateOptionRequest struct {
Name string `json:"name" binding:"required"`
GroupTag string `json:"group_tag"` // 仅操作人类型可用,collect/sell/空
@@ -49,10 +49,10 @@ func (h *Handler) List(c *gin.Context) {
EntryNo: strings.TrimSpace(c.Query("entry_no")),
EntryGroup: strings.TrimSpace(c.Query("entry_group")),
Keyword: strings.TrimSpace(c.Query("keyword")),
StartDate: strings.TrimSpace(c.Query("start_date")),
EndDate: strings.TrimSpace(c.Query("end_date")),
Page: page,
PageSize: pageSize,
StartDate: strings.TrimSpace(c.Query("start_date")),
EndDate: strings.TrimSpace(c.Query("end_date")),
Page: page,
PageSize: pageSize,
}
if raw := c.Query("admin_id"); raw != "" {
adminID, err := strconv.ParseUint(raw, 10, 64)
@@ -123,7 +123,7 @@ func (h *Handler) Delete(c *gin.Context) {
response.OK(c, gin.H{"deleted": true})
}
// ListOptions 返回平台与操作人选项,供录单表单下拉使用。
// ListOptions 返回平台、操作人与出款实际操作人选项。
func (h *Handler) ListOptions(c *gin.Context) {
if _, ok := currentAdminID(c); !ok {
response.Unauthorized(c, "缺少管理员上下文")
@@ -137,7 +137,21 @@ func (h *Handler) ListOptions(c *gin.Context) {
response.OK(c, result)
}
// CreateOption 新增平台 / 操作人选项。
// ListDisbursementOperators 返回线下结算实际操作人可选项。
func (h *Handler) ListDisbursementOperators(c *gin.Context) {
if _, ok := currentAdminID(c); !ok {
response.Unauthorized(c, "缺少管理员上下文")
return
}
result, err := h.service.ListDisbursementOperators(c.Request.Context())
if err != nil {
writeManualEntryError(c, err)
return
}
response.OK(c, result)
}
// CreateOption 新增平台 / 操作人 / 出款实际操作人选项。
func (h *Handler) CreateOption(c *gin.Context) {
if _, ok := currentAdminID(c); !ok {
response.Unauthorized(c, "缺少管理员上下文")
@@ -156,7 +170,7 @@ func (h *Handler) CreateOption(c *gin.Context) {
response.Created(c, option)
}
// UpdateOption 重命名平台 / 操作人选项。
// UpdateOption 重命名选项。
func (h *Handler) UpdateOption(c *gin.Context) {
if _, ok := currentAdminID(c); !ok {
response.Unauthorized(c, "缺少管理员上下文")
@@ -238,7 +238,7 @@ func (r *Repository) ListOptions(ctx context.Context, optionType string) ([]Opti
return items, nil
}
// ListAllOptions 返回平台与操作人两组可选项,供录单表单直接使用。
// ListAllOptions 返回平台、操作人与出款实际操作人三组可选项。
func (r *Repository) ListAllOptions(ctx context.Context) (*OptionListDTO, error) {
platforms, err := r.ListOptions(ctx, OptionTypePlatform)
if err != nil {
@@ -248,10 +248,18 @@ func (r *Repository) ListAllOptions(ctx context.Context) (*OptionListDTO, error)
if err != nil {
return nil, err
}
return &OptionListDTO{Platforms: platforms, Operators: operators}, nil
disbursementOperators, err := r.ListOptions(ctx, OptionTypeDisbursementOperator)
if err != nil {
return nil, err
}
return &OptionListDTO{
Platforms: platforms,
Operators: operators,
DisbursementOperators: disbursementOperators,
}, nil
}
// CreateOption 新增一个平台 / 操作人选项,重名返回 ErrOptionExists。
// CreateOption 新增一个可选项,重名返回 ErrOptionExists。
// 操作人选项可通过 groupTag 标记所属组别(collect/sell,空表示未分组)。
func (r *Repository) CreateOption(ctx context.Context, optionType, name, groupTag string) (*OptionDTO, error) {
if !IsValidOptionType(optionType) {
@@ -309,7 +317,9 @@ func (r *Repository) DeleteOption(ctx context.Context, id uint64) error {
// IsValidOptionType 判断选项类型是否合法。
func IsValidOptionType(optionType string) bool {
return optionType == OptionTypePlatform || optionType == OptionTypeOperator
return optionType == OptionTypePlatform ||
optionType == OptionTypeOperator ||
optionType == OptionTypeDisbursementOperator
}
func parseDay(value string, loc *time.Location) (time.Time, error) {
@@ -74,6 +74,10 @@ func TestRepositoryOptionCRUDAndEntryPlatformOperator(t *testing.T) {
if err != nil {
t.Fatalf("创建操作人选项失败: %v", err)
}
disbursementOperator, err := repo.CreateOption(ctx, OptionTypeDisbursementOperator, "出款小王", "")
if err != nil {
t.Fatalf("创建出款实际操作人选项失败: %v", err)
}
if _, err := repo.CreateOption(ctx, OptionTypePlatform, "网易大神", ""); !errors.Is(err, ErrOptionExists) {
t.Fatalf("重复平台应返回 ErrOptionExists, got %v", err)
}
@@ -105,6 +109,9 @@ func TestRepositoryOptionCRUDAndEntryPlatformOperator(t *testing.T) {
if len(options.Operators) != 2 {
t.Fatalf("操作人选项 = %+v, want 2 条", options.Operators)
}
if len(options.DisbursementOperators) != 1 || options.DisbursementOperators[0].ID != disbursementOperator.ID {
t.Fatalf("出款实际操作人选项 = %+v, want 1 条", options.DisbursementOperators)
}
// 2. 录单写入平台 / 操作人
entry, err := repo.Create(ctx, admin.ID, "客服小张", "cs001", "202610130001", EntryGroupCollect, "网易", "技术测试", "备注1")
@@ -104,7 +104,7 @@ func (s *Service) TodayAgentStats(ctx context.Context) ([]AgentDayStatsDTO, erro
return s.repo.TodayAgentStats(ctx, timeutil.ShanghaiNow())
}
// ListOptions 返回平台与操作人两组可选项。
// ListOptions 返回平台、操作人与出款实际操作人三组可选项。
func (s *Service) ListOptions(ctx context.Context) (*OptionListDTO, error) {
if s.repo == nil {
return nil, ErrDependencyUnavailable
@@ -112,7 +112,15 @@ func (s *Service) ListOptions(ctx context.Context) (*OptionListDTO, error) {
return s.repo.ListAllOptions(ctx)
}
// CreateOption 新增平台 / 操作人选项。
// ListDisbursementOperators 返回线下结算实际操作人可选项。
func (s *Service) ListDisbursementOperators(ctx context.Context) ([]OptionDTO, error) {
if s.repo == nil {
return nil, ErrDependencyUnavailable
}
return s.repo.ListOptions(ctx, OptionTypeDisbursementOperator)
}
// CreateOption 新增平台 / 操作人 / 出款实际操作人选项。
func (s *Service) CreateOption(ctx context.Context, req CreateOptionRequest) (*OptionDTO, error) {
if s.repo == nil {
return nil, ErrDependencyUnavailable
@@ -135,7 +143,7 @@ func (s *Service) CreateOption(ctx context.Context, req CreateOptionRequest) (*O
return s.repo.CreateOption(ctx, optionType, name, groupTag)
}
// UpdateOption 重命名平台 / 操作人选项。
// UpdateOption 重命名选项。
func (s *Service) UpdateOption(ctx context.Context, id uint64, req UpdateOptionRequest) (*OptionDTO, error) {
if s.repo == nil {
return nil, ErrDependencyUnavailable