Files
hfb_sys/backend/internal/modules/csmanualentry/handler.go
T
yml2213 cca40940d5 feat(admin): 新增客服手动录单功能与仪表盘今日录单统计
- 做了什么:
  - 新增客服手动录单数据库迁移 000084 及对应模型,支持编号唯一校验、客服快照绑定与 CRUD 操作;
  - 后端提供 csmanualentry 业务模块及相关 API,并在仪表盘摘要中聚合今日各客服录单数量;
  - 前端增加客服手动录单视图页面、路由与侧边栏导航,支持录单二次确认与细粒度权限控制;
  - 管理后台仪表盘增加今日客服手动录单卡片展示。
- 为什么:
  - 满足客服在后台手动登记外部业务编号需求,并便于运营按客服统计今日录单业绩和追溯对账。
- 验证方式:
  - 执行后端全量测试 go test ./... 与静态检查 go vet ./... 全部通过;
  - 执行前端代码门禁 npm run check 与 vite build 全部通过;
  - 执行 goose down/up 迁移回滚与应用测试通过,角色权限分配正确;
  - 本地 dev 联调 POST /api/admin/manual-entries 录单成功返回 201。
2026-10-12 14:52:24 +08:00

166 lines
4.0 KiB
Go

package csmanualentry
import (
"errors"
"net/http"
"strconv"
"strings"
"hfb_sys/backend/internal/middleware"
"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) Create(c *gin.Context) {
adminID, ok := currentAdminID(c)
if !ok {
response.Unauthorized(c, "缺少管理员上下文")
return
}
var req CreateRequest
if err := c.ShouldBindJSON(&req); err != nil {
response.BadRequest(c, "录单参数不正确")
return
}
result, err := h.service.Create(c.Request.Context(), adminID, req)
if err != nil {
writeManualEntryError(c, err)
return
}
response.Created(c, result)
}
func (h *Handler) List(c *gin.Context) {
if _, ok := currentAdminID(c); !ok {
response.Unauthorized(c, "缺少管理员上下文")
return
}
page, pageSize := parsePagination(c)
query := ListQuery{
EntryNo: strings.TrimSpace(c.Query("entry_no")),
Keyword: strings.TrimSpace(c.Query("keyword")),
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)
if err != nil {
response.BadRequest(c, "客服 ID 不正确")
return
}
query.AdminID = adminID
}
result, err := h.service.List(c.Request.Context(), query)
if err != nil {
writeManualEntryError(c, err)
return
}
response.OK(c, result)
}
func (h *Handler) TodayAgentStats(c *gin.Context) {
if _, ok := currentAdminID(c); !ok {
response.Unauthorized(c, "缺少管理员上下文")
return
}
items, err := h.service.TodayAgentStats(c.Request.Context())
if err != nil {
writeManualEntryError(c, err)
return
}
response.OK(c, items)
}
func (h *Handler) Update(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 UpdateRequest
if err := c.ShouldBindJSON(&req); err != nil {
response.BadRequest(c, "录单参数不正确")
return
}
entry, err := h.service.Update(c.Request.Context(), id, req)
if err != nil {
writeManualEntryError(c, err)
return
}
response.OK(c, entry)
}
func (h *Handler) Delete(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.Delete(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 {
return 0, false
}
adminID, ok := value.(uint64)
return adminID, ok
}
func parsePagination(c *gin.Context) (int, int) {
page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
pageSize, _ := strconv.Atoi(c.DefaultQuery("page_size", "20"))
if page < 1 {
page = 1
}
if pageSize < 1 {
pageSize = 20
}
if pageSize > 100 {
pageSize = 100
}
return page, pageSize
}
func writeManualEntryError(c *gin.Context, err error) {
response.RecordError(c, err)
switch {
case errors.Is(err, ErrDependencyUnavailable):
response.ServiceUnavailable(c, "数据库未连接")
case errors.Is(err, ErrAdminNotFound):
response.Unauthorized(c, "客服账号不存在")
case errors.Is(err, ErrEntryNoInvalid):
response.BadRequest(c, "编号格式不正确")
case errors.Is(err, ErrEntryNotFound):
response.NotFound(c, "录单记录不存在")
case errors.Is(err, ErrEntryNoExists):
response.Error(c, http.StatusConflict, "entry_no_exists", "该编号已被登记")
default:
response.Error(c, http.StatusInternalServerError, "internal_error", "录单服务暂时不可用")
}
}