yml2213
412d219cca
- 数据库新增 099_order_claim_status.sql 迁移，扩展 claim_status、claim_status_reason 等字段 - 后端新增 /claims/h5/:orderNo、UID提交、分销提交接口，保留原有 token 接口双轨兼容 - 增加兑换有效性强拦截：暂停/关闭/退款/取消订单精准阻断并返回友好提示 - 后台新增 POST /admin/orders/:orderId/claim-status 接口与审计日志记录 - 前端管理后台（订单列表、详情页）支持 H5 兑换状态展示、一键复制链接及暂停/关闭/启用弹窗 - 前端领取页面适配 /h5/:orderNo 路由及暂停/关闭等状态的异常展示 - 验证方式：运行前后端类型检查、全量单元测试（后端 674、前端 132）及全量构建编译均通过
107 lines
2.7 KiB
TypeScript
107 lines
2.7 KiB
TypeScript
import { Router } from 'express'
|
|
|
|
import { createRateLimitMiddleware, getParamRateLimitKey } from '../middleware/rate-limit.js'
|
|
import {
|
|
getH5ClaimDetailByOrderNo,
|
|
getKuaishouCloudClaimDetail,
|
|
submitAffiliateDashClaim,
|
|
submitClaimUid,
|
|
submitH5AffiliateDashClaimByOrderNo,
|
|
submitH5ClaimUidByOrderNo,
|
|
} from '../services/claim/kuaishou-cloud-claim-service.js'
|
|
import { buildNotFoundPayload, createRouteHandler } from '../utils/http.js'
|
|
|
|
const router = Router()
|
|
const claimReadRateLimit = createRateLimitMiddleware({
|
|
scope: 'claim:read',
|
|
windowMs: 60_000,
|
|
max: 120,
|
|
key: getParamRateLimitKey('token'),
|
|
})
|
|
const claimWriteRateLimit = createRateLimitMiddleware({
|
|
scope: 'claim:write',
|
|
windowMs: 60_000,
|
|
max: 30,
|
|
key: getParamRateLimitKey('token'),
|
|
})
|
|
|
|
const h5ReadRateLimit = createRateLimitMiddleware({
|
|
scope: 'claim:h5:read',
|
|
windowMs: 60_000,
|
|
max: 120,
|
|
key: getParamRateLimitKey('orderNo'),
|
|
})
|
|
const h5WriteRateLimit = createRateLimitMiddleware({
|
|
scope: 'claim:h5:write',
|
|
windowMs: 60_000,
|
|
max: 30,
|
|
key: getParamRateLimitKey('orderNo'),
|
|
})
|
|
|
|
router.get(
|
|
'/h5/:orderNo',
|
|
h5ReadRateLimit,
|
|
createRouteHandler((req) => getH5ClaimDetailByOrderNo(req.params.orderNo), {
|
|
errorMessage: '查询订单领取详情失败',
|
|
scope: '[claims/h5/:orderNo]',
|
|
}),
|
|
)
|
|
|
|
router.post(
|
|
'/h5/:orderNo/uid',
|
|
h5WriteRateLimit,
|
|
createRouteHandler((req) => submitH5ClaimUidByOrderNo(req.params.orderNo, req.body || {}), {
|
|
successMessage: 'UID 已提交',
|
|
errorMessage: '提交 UID 失败',
|
|
scope: '[claims/h5/:orderNo/uid]',
|
|
}),
|
|
)
|
|
|
|
router.post(
|
|
'/h5/:orderNo/affiliate-dash/submit',
|
|
h5WriteRateLimit,
|
|
createRouteHandler(
|
|
(req) => submitH5AffiliateDashClaimByOrderNo(req.params.orderNo, req.body || {}),
|
|
{
|
|
successMessage: '发货已提交',
|
|
errorMessage: '提交发货失败',
|
|
scope: '[claims/h5/:orderNo/affiliate-dash/submit]',
|
|
},
|
|
),
|
|
)
|
|
|
|
router.get(
|
|
'/:token',
|
|
claimReadRateLimit,
|
|
createRouteHandler((req) => getKuaishouCloudClaimDetail(req.params.token), {
|
|
errorMessage: '查询快手领取详情失败',
|
|
scope: '[claims/:token]',
|
|
}),
|
|
)
|
|
|
|
router.post(
|
|
'/:token/uid',
|
|
claimWriteRateLimit,
|
|
createRouteHandler((req) => submitClaimUid(req.params.token, req.body || {}), {
|
|
successMessage: 'UID 已提交',
|
|
errorMessage: '提交 UID 失败',
|
|
scope: '[claims/:token/uid]',
|
|
}),
|
|
)
|
|
|
|
router.post(
|
|
'/:token/affiliate-dash/submit',
|
|
claimWriteRateLimit,
|
|
createRouteHandler((req) => submitAffiliateDashClaim(req.params.token, req.body || {}), {
|
|
successMessage: '发货已提交',
|
|
errorMessage: '提交发货失败',
|
|
scope: '[claims/:token/affiliate-dash/submit]',
|
|
}),
|
|
)
|
|
|
|
router.use((req, res) => {
|
|
res.status(404).json(buildNotFoundPayload(req))
|
|
})
|
|
|
|
export default router
|