dachui/hfb_sys
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(admin): 客服手动录单支持平台与操作人，并可后台配置可选项

Browse Source 
- 录单列表新增「平台」「操作人」两列，录单表单与编辑弹窗新增同名字段下拉
- 新增 cs_manual_entry_options 表与 4 个接口（读取/新增/重命名/删除），页面右上角弹窗维护平台与操作人
- 迁移 000087：cs_manual_entries 增加 platform/operator 列与索引，注册 cs_manual_entry:option_manage 权限并授予 ops/super_admin
- 记录保存名称快照，删除选项不影响历史记录；同类型重名返回 409，跨类型同名允许
- 顶部关键词查询支持命中平台/操作人
- 新增单测：选项 CRUD 边界与录单平台/操作人读写
This commit is contained in:
yml2213
2026-10-13 16:22:57 +08:00
parent 9a52dbdb7b
commit f33dc97f6f
12 changed files with 1017 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files
backend/internal/model/cs_manual_entry.go
+19 -1
View File
@@ -4,10 +4,13 @@ import "time"
// CSManualEntry 客服手动录单记录。
// 客服在后台手动登记一个编号（如 202610120013），该编号与其登录账号绑定，
// 记录登记时间等，供后续查询与按客服统计今日录单量。
// 记录平台、操作人、登记时间等，供后续查询与按客服统计今日录单量。
// platform / operator 存名称快照：后台删掉选项也不影响历史记录展示。
type CSManualEntry struct {
ID uint64 `gorm:"primaryKey" json:"id"`
EntryNo string `gorm:"size:64;not null;uniqueIndex" json:"entry_no"`
Platform string `gorm:"size:64;not null;default:'';index" json:"platform"`
Operator string `gorm:"size:64;not null;default:'';index" json:"operator"`
AdminID uint64 `gorm:"not null;index" json:"admin_id"`
AdminName string `gorm:"size:64;not null;default:''" json:"admin_name"`
AdminUsername string `gorm:"size:64;not null;default:''" json:"admin_username"`
@@ -19,3 +22,18 @@ type CSManualEntry struct {
func (CSManualEntry) TableName() string {
return "cs_manual_entries"
}
// CSManualEntryOption 客服手动录单的可选项配置（平台 / 操作人）。
// 仅作为录单表单的下拉数据源，记录里保存的是名称快照。
type CSManualEntryOption struct {
ID uint64 `gorm:"primaryKey" json:"id"`
Type string `gorm:"size:16;not null;uniqueIndex:uk_cs_manual_entry_options_type_name,priority:1" json:"type"`
Name string `gorm:"size:64;not null;uniqueIndex:uk_cs_manual_entry_options_type_name,priority:2" json:"name"`
SortOrder int `gorm:"not null;default:0" json:"sort_order"`
CreatedAt time.Time `json:"created_at"`
UpdatedAt time.Time `json:"updated_at"`
}
func (CSManualEntryOption) TableName() string {
return "cs_manual_entry_options"
}
backend/internal/modules/csmanualentry/dto.go
+42 -4
View File
@@ -2,22 +2,34 @@ package csmanualentry
import "time"
// 录单选项类型。
const (
OptionTypePlatform = "platform" // 平台
OptionTypeOperator = "operator" // 操作人
)
// CreateRequest 客服手动录单请求。
type CreateRequest struct {
EntryNo string `json:"entry_no" binding:"required"`
Remark string `json:"remark"`
EntryNo string `json:"entry_no" binding:"required"`
Platform string `json:"platform"`
Operator string `json:"operator"`
Remark string `json:"remark"`
}
// UpdateRequest 管理员修正录单请求。
type UpdateRequest struct {
EntryNo string `json:"entry_no" binding:"required"`
Remark string `json:"remark"`
EntryNo string `json:"entry_no" binding:"required"`
Platform string `json:"platform"`
Operator string `json:"operator"`
Remark string `json:"remark"`
}
// EntryDTO 录单记录。
type EntryDTO struct {
ID uint64 `json:"id"`
EntryNo string `json:"entry_no"`
Platform string `json:"platform"`
Operator string `json:"operator"`
AdminID uint64 `json:"admin_id"`
AdminName string `json:"admin_name"`
AdminUsername string `json:"admin_username"`
@@ -56,3 +68,29 @@ type AgentDayStatsDTO struct {
type CreateResult struct {
Entry EntryDTO `json:"entry"`
}
// OptionDTO 录单可选项（平台 / 操作人）。
type OptionDTO struct {
ID uint64 `json:"id"`
Type string `json:"type"`
Name string `json:"name"`
SortOrder int `json:"sort_order"`
CreatedAt time.Time `json:"created_at"`
}
// OptionListDTO 平台与操作人选项集合，供录单表单下拉直接使用。
type OptionListDTO struct {
Platforms []OptionDTO `json:"platforms"`
Operators []OptionDTO `json:"operators"`
}
// CreateOptionRequest 新增平台 / 操作人选项。
type CreateOptionRequest struct {
Type string `json:"type" binding:"required"`
Name string `json:"name" binding:"required"`
}
// UpdateOptionRequest 重命名平台 / 操作人选项。
type UpdateOptionRequest struct {
Name string `json:"name" binding:"required"`
}
backend/internal/modules/csmanualentry/errors.go
+4
View File
@@ -8,4 +8,8 @@ var (
ErrEntryNoInvalid = errors.New("entry number is invalid")
ErrEntryNotFound = errors.New("manual entry not found")
ErrAdminNotFound = errors.New("admin not found")
ErrOptionTypeInvalid = errors.New("manual entry option type is invalid")
ErrOptionNameInvalid = errors.New("manual entry option name is invalid")
ErrOptionExists = errors.New("manual entry option already exists")
ErrOptionNotFound = errors.New("manual entry option not found")
)
backend/internal/modules/csmanualentry/handler.go
+83
View File
@@ -122,6 +122,81 @@ func (h *Handler) Delete(c *gin.Context) {
response.OK(c, gin.H{"deleted": true})
}
// ListOptions 返回平台与操作人选项，供录单表单下拉使用。
func (h *Handler) ListOptions(c *gin.Context) {
if _, ok := currentAdminID(c); !ok {
response.Unauthorized(c, "缺少管理员上下文")
return
}
result, err := h.service.ListOptions(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, "缺少管理员上下文")
return
}
var req CreateOptionRequest
if err := c.ShouldBindJSON(&req); err != nil {
response.BadRequest(c, "选项参数不正确")
return
}
option, err := h.service.CreateOption(c.Request.Context(), req)
if err != nil {
writeManualEntryError(c, err)
return
}
response.Created(c, option)
}
// UpdateOption 重命名平台 / 操作人选项。
func (h *Handler) UpdateOption(c *gin.Context) {
if _, ok := currentAdminID(c); !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 UpdateOptionRequest
if err := c.ShouldBindJSON(&req); err != nil {
response.BadRequest(c, "选项参数不正确")
return
}
option, err := h.service.UpdateOption(c.Request.Context(), id, req)
if err != nil {
writeManualEntryError(c, err)
return
}
response.OK(c, option)
}
// DeleteOption 删除平台 / 操作人选项。
func (h *Handler) DeleteOption(c *gin.Context) {
if _, ok := currentAdminID(c); !ok {
response.Unauthorized(c, "缺少管理员上下文")
return
}
id, err := strconv.ParseUint(c.Param("id"), 10, 64)
if err != nil || id == 0 {
response.BadRequest(c, "ID 不正确")
return
}
if err := h.service.DeleteOption(c.Request.Context(), id); err != nil {
writeManualEntryError(c, err)
return
}
response.OK(c, gin.H{"deleted": true})
}
func currentAdminID(c *gin.Context) (uint64, bool) {
value, ok := c.Get(middleware.ContextAdminID)
if !ok {
@@ -159,6 +234,14 @@ func writeManualEntryError(c *gin.Context, err error) {
response.NotFound(c, "录单记录不存在")
case errors.Is(err, ErrEntryNoExists):
response.Error(c, http.StatusConflict, "entry_no_exists", "该编号已被登记")
case errors.Is(err, ErrOptionTypeInvalid):
response.BadRequest(c, "选项类型不正确")
case errors.Is(err, ErrOptionNameInvalid):
response.BadRequest(c, "选项名称不正确")
case errors.Is(err, ErrOptionNotFound):
response.NotFound(c, "选项不存在")
case errors.Is(err, ErrOptionExists):
response.Error(c, http.StatusConflict, "option_exists", "该选项已存在")
default:
response.Error(c, http.StatusInternalServerError, "internal_error", "录单服务暂时不可用")
}
backend/internal/modules/csmanualentry/repository.go
+112 -5
View File
@@ -34,9 +34,11 @@ func (r *Repository) FindAdminSnapshot(ctx context.Context, adminID uint64) (nam
}
// Create 写入一条录单记录。
func (r *Repository) Create(ctx context.Context, adminID uint64, adminName, adminUsername, entryNo, remark string) (*EntryDTO, error) {
func (r *Repository) Create(ctx context.Context, adminID uint64, adminName, adminUsername, entryNo, platform, operator, remark string) (*EntryDTO, error) {
row := model.CSManualEntry{
EntryNo: entryNo,
Platform: platform,
Operator: operator,
AdminID: adminID,
AdminName: adminName,
AdminUsername: adminUsername,
@@ -65,12 +67,14 @@ func (r *Repository) FindByID(ctx context.Context, id uint64) (*EntryDTO, error)
return &dto, nil
}
// Update 修正录单的编号与备注。编号唯一冲突返回 ErrEntryNoExists。
func (r *Repository) Update(ctx context.Context, id uint64, entryNo, remark string) (*EntryDTO, error) {
// Update 修正录单的编号、平台、操作人与备注。编号唯一冲突返回 ErrEntryNoExists。
func (r *Repository) Update(ctx context.Context, id uint64, entryNo, platform, operator, remark string) (*EntryDTO, error) {
result := r.db.WithContext(ctx).Model(&model.CSManualEntry{}).
Where("id = ?", id).
Updates(map[string]any{
"entry_no": entryNo,
"platform": platform,
"operator": operator,
"remark": remark,
})
if result.Error != nil {
@@ -118,7 +122,10 @@ func (r *Repository) List(ctx context.Context, query ListQuery) (*PaginatedResul
}
if kw := strings.TrimSpace(query.Keyword); kw != "" {
like := "%" + kw + "%"
cond := r.db.Where("entry_no LIKE ? OR admin_name LIKE ? OR admin_username LIKE ?", like, like, like)
cond := r.db.Where(
"entry_no LIKE ? OR admin_name LIKE ? OR admin_username LIKE ? OR platform LIKE ? OR operator LIKE ?",
like, like, like, like, like,
)
db = db.Where(cond)
countDB = countDB.Where(cond)
}
@@ -192,11 +199,99 @@ func (r *Repository) TodayAgentStats(ctx context.Context, day time.Time) ([]Agen
return items, nil
}
// ListOptions 返回某类型（平台 / 操作人）的全部可选项。
func (r *Repository) ListOptions(ctx context.Context, optionType string) ([]OptionDTO, error) {
if !IsValidOptionType(optionType) {
return nil, ErrOptionTypeInvalid
}
rows := make([]model.CSManualEntryOption, 0)
if err := r.db.WithContext(ctx).
Where("type = ?", optionType).
Order("sort_order ASC, id ASC").
Find(&rows).Error; err != nil {
return nil, err
}
items := make([]OptionDTO, 0, len(rows))
for _, row := range rows {
items = append(items, toOptionDTO(row))
}
return items, nil
}
// ListAllOptions 返回平台与操作人两组可选项，供录单表单直接使用。
func (r *Repository) ListAllOptions(ctx context.Context) (*OptionListDTO, error) {
platforms, err := r.ListOptions(ctx, OptionTypePlatform)
if err != nil {
return nil, err
}
operators, err := r.ListOptions(ctx, OptionTypeOperator)
if err != nil {
return nil, err
}
return &OptionListDTO{Platforms: platforms, Operators: operators}, nil
}
// CreateOption 新增一个平台 / 操作人选项，重名返回 ErrOptionExists。
func (r *Repository) CreateOption(ctx context.Context, optionType, name string) (*OptionDTO, error) {
if !IsValidOptionType(optionType) {
return nil, ErrOptionTypeInvalid
}
row := model.CSManualEntryOption{Type: optionType, Name: name}
if err := r.db.WithContext(ctx).Create(&row).Error; err != nil {
if isDuplicateEntry(err) {
return nil, ErrOptionExists
}
return nil, err
}
dto := toOptionDTO(row)
return &dto, nil
}
// UpdateOption 重命名一个选项，重名返回 ErrOptionExists。
func (r *Repository) UpdateOption(ctx context.Context, id uint64, name string) (*OptionDTO, error) {
var row model.CSManualEntryOption
if err := r.db.WithContext(ctx).First(&row, id).Error; err != nil {
if errors.Is(err, gorm.ErrRecordNotFound) {
return nil, ErrOptionNotFound
}
return nil, err
}
result := r.db.WithContext(ctx).Model(&model.CSManualEntryOption{}).
Where("id = ?", id).
Update("name", name)
if result.Error != nil {
if isDuplicateEntry(result.Error) {
return nil, ErrOptionExists
}
return nil, result.Error
}
row.Name = name
dto := toOptionDTO(row)
return &dto, nil
}
// DeleteOption 删除一个选项（历史录单里的名称快照不受影响）。
func (r *Repository) DeleteOption(ctx context.Context, id uint64) error {
result := r.db.WithContext(ctx).Delete(&model.CSManualEntryOption{}, id)
if result.Error != nil {
return result.Error
}
if result.RowsAffected == 0 {
return ErrOptionNotFound
}
return nil
}
// IsValidOptionType 判断选项类型是否合法。
func IsValidOptionType(optionType string) bool {
return optionType == OptionTypePlatform || optionType == OptionTypeOperator
}
func parseDay(value string, loc *time.Location) (time.Time, error) {
return time.ParseInLocation("2006-01-02", value, loc)
}
// isDuplicateEntry 判断错误是否为 entry_no 唯一键冲突。
// isDuplicateEntry 判断错误是否为唯一键冲突。
func isDuplicateEntry(err error) bool {
if err == nil {
return false
@@ -211,6 +306,8 @@ func toDTO(row model.CSManualEntry) EntryDTO {
return EntryDTO{
ID: row.ID,
EntryNo: row.EntryNo,
Platform: row.Platform,
Operator: row.Operator,
AdminID: row.AdminID,
AdminName: row.AdminName,
AdminUsername: row.AdminUsername,
@@ -218,3 +315,13 @@ func toDTO(row model.CSManualEntry) EntryDTO {
CreatedAt: row.CreatedAt,
}
}
func toOptionDTO(row model.CSManualEntryOption) OptionDTO {
return OptionDTO{
ID: row.ID,
Type: row.Type,
Name: row.Name,
SortOrder: row.SortOrder,
CreatedAt: row.CreatedAt,
}
}
backend/internal/modules/csmanualentry/repository_test.go
+156
View File
@@ -0,0 +1,156 @@
package csmanualentry
import (
"errors"
"strings"
"testing"
"hfb_sys/backend/internal/database"
"hfb_sys/backend/internal/model"
"gorm.io/gorm"
)
func newManualEntryTestRepo(t *testing.T) (*Repository, *gorm.DB) {
t.Helper()
db := database.NewTestDB()
if err := database.AutoMigrateIfMissing(db,
&model.AdminUser{},
&model.CSManualEntry{},
&model.CSManualEntryOption{},
); err != nil {
t.Fatalf("迁移测试表失败: %v", err)
}
return NewRepository(db), db
}
func TestNormalizeOptionName(t *testing.T) {
tests := []struct {
name string
input string
want string
wantErr error
}{
{name: "trim", input: " 网易大神 ", want: "网易大神"},
{name: "empty allowed", input: " ", want: ""},
{name: "inner space kept", input: "网易 大神", want: "网易 大神"},
{name: "64 runes", input: strings.Repeat("游", 64), want: strings.Repeat("游", 64)},
{name: "65 runes", input: strings.Repeat("游", 65), wantErr: ErrOptionNameInvalid},
{name: "newline", input: "网易\n大神", wantErr: ErrOptionNameInvalid},
}
for _, tt := range tests {
t.Run(tt.name, func(t *testing.T) {
got, err := normalizeOptionName(tt.input)
if !errors.Is(err, tt.wantErr) {
t.Fatalf("normalizeOptionName(%q) error = %v, want %v", tt.input, err, tt.wantErr)
}
if tt.wantErr == nil && got != tt.want {
t.Fatalf("normalizeOptionName(%q) = %q, want %q", tt.input, got, tt.want)
}
})
}
}
func TestRepositoryOptionCRUDAndEntryPlatformOperator(t *testing.T) {
repo, db := newManualEntryTestRepo(t)
ctx := t.Context()
admin := model.AdminUser{Username: "cs001", Nickname: "客服小张", PasswordHash: "x"}
if err := db.Create(&admin).Error; err != nil {
t.Fatalf("创建管理员失败: %v", err)
}
// 1. 选项 CRUD
platform, err := repo.CreateOption(ctx, OptionTypePlatform, "网易大神")
if err != nil {
t.Fatalf("创建平台选项失败: %v", err)
}
// 同类型第二个平台，用于验证重命名撞名（唯一键是 type+name，跨类型不算冲突）
if _, err := repo.CreateOption(ctx, OptionTypePlatform, "交易猫"); err != nil {
t.Fatalf("创建第二个平台选项失败: %v", err)
}
operator, err := repo.CreateOption(ctx, OptionTypeOperator, "技术测试")
if err != nil {
t.Fatalf("创建操作人选项失败: %v", err)
}
if _, err := repo.CreateOption(ctx, OptionTypePlatform, "网易大神"); !errors.Is(err, ErrOptionExists) {
t.Fatalf("重复平台应返回 ErrOptionExists, got %v", err)
}
if _, err := repo.CreateOption(ctx, "unknown", "x"); !errors.Is(err, ErrOptionTypeInvalid) {
t.Fatalf("非法类型应返回 ErrOptionTypeInvalid, got %v", err)
}
// 与平台同名的操作人是允许的（不同 type）
if _, err := repo.CreateOption(ctx, OptionTypeOperator, "网易大神"); err != nil {
t.Fatalf("跨类型同名应允许: %v", err)
}
if _, err := repo.UpdateOption(ctx, platform.ID, "网易"); err != nil {
t.Fatalf("重命名选项失败: %v", err)
}
if _, err := repo.UpdateOption(ctx, platform.ID, "交易猫"); !errors.Is(err, ErrOptionExists) {
t.Fatalf("重命名撞同类型已有名应返回 ErrOptionExists, got %v", err)
}
if _, err := repo.UpdateOption(ctx, 999999, "任何"); !errors.Is(err, ErrOptionNotFound) {
t.Fatalf("重命名不存在选项应返回 ErrOptionNotFound, got %v", err)
}
options, err := repo.ListAllOptions(ctx)
if err != nil {
t.Fatalf("读取选项列表失败: %v", err)
}
if len(options.Platforms) != 2 || options.Platforms[0].Name != "网易" {
t.Fatalf("平台选项 = %+v, want 2 条且首条为网易", options.Platforms)
}
if len(options.Operators) != 2 {
t.Fatalf("操作人选项 = %+v, want 2 条", options.Operators)
}
// 2. 录单写入平台 / 操作人
entry, err := repo.Create(ctx, admin.ID, "客服小张", "cs001", "202610130001", "网易", "技术测试", "备注1")
if err != nil {
t.Fatalf("录单失败: %v", err)
}
if entry.Platform != "网易" || entry.Operator != "技术测试" {
t.Fatalf("录单平台/操作人 = %q/%q", entry.Platform, entry.Operator)
}
// 修正录单的平台与操作人
updated, err := repo.Update(ctx, entry.ID, "202610130001", "网易", "客服小李", "备注2")
if err != nil {
t.Fatalf("修正录单失败: %v", err)
}
if updated.Operator != "客服小李" || updated.Remark != "备注2" {
t.Fatalf("修正后 = %+v", updated)
}
// 3. 关键字命中平台 / 操作人
list, err := repo.List(ctx, ListQuery{Keyword: "客服小李", Page: 1, PageSize: 20})
if err != nil {
t.Fatalf("按操作人查询失败: %v", err)
}
if list.Total != 1 {
t.Fatalf("按操作人查询命中 %d 条, want 1", list.Total)
}
list, err = repo.List(ctx, ListQuery{Keyword: "网易", Page: 1, PageSize: 20})
if err != nil {
t.Fatalf("按平台查询失败: %v", err)
}
if list.Total != 1 {
t.Fatalf("按平台查询命中 %d 条, want 1", list.Total)
}
// 4. 删除选项不影响历史录单（记录里是名称快照）
if err := repo.DeleteOption(ctx, operator.ID); err != nil {
t.Fatalf("删除操作人选项失败: %v", err)
}
if err := repo.DeleteOption(ctx, operator.ID); !errors.Is(err, ErrOptionNotFound) {
t.Fatalf("重复删除应返回 ErrOptionNotFound, got %v", err)
}
after, err := repo.FindByID(ctx, entry.ID)
if err != nil {
t.Fatalf("删除选项后读取录单失败: %v", err)
}
if after.Operator != "客服小李" {
t.Fatalf("删除选项后历史录单操作人 = %q, want 客服小李", after.Operator)
}
}
backend/internal/modules/csmanualentry/service.go
+86 -3
View File
@@ -3,11 +3,15 @@ package csmanualentry
import (
"context"
"strings"
"unicode/utf8"
"hfb_sys/backend/internal/timeutil"
)
const maxEntryNoLength = 64
const (
maxEntryNoLength = 64
maxOptionNameLength = 64
)
type Service struct {
repo *Repository
@@ -26,6 +30,14 @@ func (s *Service) Create(ctx context.Context, adminID uint64, req CreateRequest)
if err != nil {
return nil, err
}
platform, err := normalizeOptionName(req.Platform)
if err != nil {
return nil, err
}
operator, err := normalizeOptionName(req.Operator)
if err != nil {
return nil, err
}
adminName, adminUsername, err := s.repo.FindAdminSnapshot(ctx, adminID)
if err != nil {
return nil, err
@@ -33,7 +45,7 @@ func (s *Service) Create(ctx context.Context, adminID uint64, req CreateRequest)
if adminName == "" {
adminName = adminUsername
}
entry, err := s.repo.Create(ctx, adminID, adminName, adminUsername, entryNo, strings.TrimSpace(req.Remark))
entry, err := s.repo.Create(ctx, adminID, adminName, adminUsername, entryNo, platform, operator, strings.TrimSpace(req.Remark))
if err != nil {
return nil, err
}
@@ -49,7 +61,15 @@ func (s *Service) Update(ctx context.Context, id uint64, req UpdateRequest) (*En
if err != nil {
return nil, err
}
return s.repo.Update(ctx, id, entryNo, strings.TrimSpace(req.Remark))
platform, err := normalizeOptionName(req.Platform)
if err != nil {
return nil, err
}
operator, err := normalizeOptionName(req.Operator)
if err != nil {
return nil, err
}
return s.repo.Update(ctx, id, entryNo, platform, operator, strings.TrimSpace(req.Remark))
}
// Delete 管理员删除录单记录。
@@ -76,6 +96,56 @@ func (s *Service) TodayAgentStats(ctx context.Context) ([]AgentDayStatsDTO, erro
return s.repo.TodayAgentStats(ctx, timeutil.ShanghaiNow())
}
// ListOptions 返回平台与操作人两组可选项。
func (s *Service) ListOptions(ctx context.Context) (*OptionListDTO, error) {
if s.repo == nil {
return nil, ErrDependencyUnavailable
}
return s.repo.ListAllOptions(ctx)
}
// CreateOption 新增平台 / 操作人选项。
func (s *Service) CreateOption(ctx context.Context, req CreateOptionRequest) (*OptionDTO, error) {
if s.repo == nil {
return nil, ErrDependencyUnavailable
}
optionType := strings.TrimSpace(req.Type)
if !IsValidOptionType(optionType) {
return nil, ErrOptionTypeInvalid
}
name, err := normalizeOptionName(req.Name)
if err != nil {
return nil, err
}
if name == "" {
return nil, ErrOptionNameInvalid
}
return s.repo.CreateOption(ctx, optionType, name)
}
// UpdateOption 重命名平台 / 操作人选项。
func (s *Service) UpdateOption(ctx context.Context, id uint64, req UpdateOptionRequest) (*OptionDTO, error) {
if s.repo == nil {
return nil, ErrDependencyUnavailable
}
name, err := normalizeOptionName(req.Name)
if err != nil {
return nil, err
}
if name == "" {
return nil, ErrOptionNameInvalid
}
return s.repo.UpdateOption(ctx, id, name)
}
// DeleteOption 删除平台 / 操作人选项。
func (s *Service) DeleteOption(ctx context.Context, id uint64) error {
if s.repo == nil {
return ErrDependencyUnavailable
}
return s.repo.DeleteOption(ctx, id)
}
// normalizeEntryNo 去除首尾空白并做基础校验。
func normalizeEntryNo(raw string) (string, error) {
value := strings.TrimSpace(raw)
@@ -90,3 +160,16 @@ func normalizeEntryNo(raw string) (string, error) {
}
return value, nil
}
// normalizeOptionName 规整平台 / 操作人名称：去首尾空白、按字符数限长。
// 允许为空（录单时平台与操作人选填），但内部不允许换行等控制字符。
func normalizeOptionName(raw string) (string, error) {
value := strings.TrimSpace(raw)
if utf8.RuneCountInString(value) > maxOptionNameLength {
return "", ErrOptionNameInvalid
}
if strings.ContainsAny(value, "\t\r\n") {
return "", ErrOptionNameInvalid
}
return value, nil
}
backend/internal/router/router.go
+4
View File
@@ -721,6 +721,10 @@ func New(cfg config.Config, deps Dependencies, logger *zap.Logger) *gin.Engine {
adminRoutes.POST("/files/upload", fileHandler.Upload)
adminRoutes.GET("/dashboard", requirePerm("dashboard:view"), adminDashboardHandler.Summary)
adminRoutes.GET("/manual-entries/today-stats", requirePerm("cs_manual_entry:view"), manualEntryHandler.TodayAgentStats)
adminRoutes.GET("/manual-entries/options", requirePerm("cs_manual_entry:view"), manualEntryHandler.ListOptions)
adminRoutes.POST("/manual-entries/options", requirePerm("cs_manual_entry:option_manage"), manualEntryHandler.CreateOption)
adminRoutes.PUT("/manual-entries/options/:id", requirePerm("cs_manual_entry:option_manage"), manualEntryHandler.UpdateOption)
adminRoutes.DELETE("/manual-entries/options/:id", requirePerm("cs_manual_entry:option_manage"), manualEntryHandler.DeleteOption)
adminRoutes.GET("/manual-entries", requirePerm("cs_manual_entry:view"), manualEntryHandler.List)
adminRoutes.POST("/manual-entries", requirePerm("cs_manual_entry:create"), manualEntryHandler.Create)
adminRoutes.PUT("/manual-entries/:id", requirePerm("cs_manual_entry:update"), manualEntryHandler.Update)