feat(收口): 补齐 8 月迭代缺口并同步 Spec 与证据链
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
- 新增六对成对迁移 000232–000237:H5 弹窗类型、退款结算标识与申请人备注、优先轮询事实字段与两个新终态、通道阈值命中留痕、手机号最近解绑人、提现资格校验留痕 - 退款:原因必填与申请人备注、来源支付与渠道流水冻结、线下处理流水号补录审计、按订单查询可选退款方式、企微审批材料补齐且新增字段缺失映射即明确失败 - 优先轮询:人工关闭、有效期到期独立周期任务、失败与过期人工重触发、事实字段与异常重试查询、资产解析端点只读投影 - 通道阈值:命中事实同事务留痕与命中记录查询;员工账单:列表筛选与详情投影;商户池:列表投影与统计周期语义;H5:弹窗类型与类别排序 - 手机号:有效关联数量与最近解绑人、短信验证码失败次数限制;导出:佣金明细十五列与报表序号列 - 时间筛选:三处新增筛选纳入统一严格解析契约,员工账单产生时间参数改名 - 同步 12 份主 Spec 需求、两端点与异步任务证据链,门禁 context-health 与 OpenSpec 校验通过
This commit is contained in:
@@ -1,5 +1,7 @@
|
||||
package constants
|
||||
|
||||
import "time"
|
||||
|
||||
// PollingShardCount 轮询队列默认分片数
|
||||
// 千万级规模下,16 分片可将单队列深度控制在 ~60 万以内
|
||||
const PollingShardCount = 16
|
||||
@@ -45,6 +47,17 @@ const (
|
||||
// 本值不是可维护配置项,也不改变普通轮询的无限重试策略。
|
||||
const PollingPriorityMaxAttempts = 3
|
||||
|
||||
// PollingPriorityValidity 优先轮询项固定的有效期长度。
|
||||
// 自入队时间(事实行 priority_effective_from)起算,超期仍未完成的项转已过期终态并出队,
|
||||
// 保留触发类型、尝试次数与最近失败原因。与尝试上限同为代码常量,不新增可维护配置项。
|
||||
// 取 72 小时:覆盖最长轮询间隔叠加三次可恢复重试的时间,避免正常加急被过早判为超期。
|
||||
const PollingPriorityValidity = 72 * time.Hour
|
||||
|
||||
// TaskTypePollingPriorityExpiry 优先轮询项有效期到期处理任务类型(由 Asynq Scheduler 调度)。
|
||||
// 该任务只扫描并终结超期未完成项,MUST NOT 依赖查询或读侧隐式触发;
|
||||
// 未在 QueueForTaskType 中单独声明,按该函数默认分支落在 default 队列。
|
||||
const TaskTypePollingPriorityExpiry = "polling_priority:expiry"
|
||||
|
||||
// PollingPriorityClaimLease 优先轮询项的认领租约(秒)。
|
||||
// 必须长于既有轮询任务超时 60 秒,为执行收尾与重新入队留出余量;
|
||||
// 执行中且超过租约仍未被更新的优先项允许相邻执行接管领取。
|
||||
@@ -60,6 +73,32 @@ const (
|
||||
PollingPriorityStatusCompleted = "completed"
|
||||
// PollingPriorityStatusFailed 优先轮询项状态-失败出队(终态)
|
||||
PollingPriorityStatusFailed = "failed"
|
||||
// PollingPriorityStatusClosed 优先轮询项状态-已关闭(人工关闭终态,已出队)
|
||||
PollingPriorityStatusClosed = "closed"
|
||||
// PollingPriorityStatusExpired 优先轮询项状态-已过期(有效期到期终态,已出队)
|
||||
PollingPriorityStatusExpired = "expired"
|
||||
)
|
||||
|
||||
// PollingPriorityActiveStatuses 返回占用活动项唯一键的状态集合。
|
||||
// 与事实表部分唯一索引谓词 status IN ('pending','processing') 严格一致:
|
||||
// 已关闭与已过期是终态,不占键位,同一卡同一任务类型可再次入队或人工重触发。
|
||||
func PollingPriorityActiveStatuses() []string {
|
||||
return []string{PollingPriorityStatusPending, PollingPriorityStatusProcessing}
|
||||
}
|
||||
|
||||
// 轮询优先项执行结局常量(资产详情投影口径)。
|
||||
// 与项状态区分:项状态描述队列位置(含待执行、失败出队),结局描述「最近一次轮询的对外结论」。
|
||||
const (
|
||||
// PollingPriorityOutcomeProcessing 结局-处理中(待执行或执行中)
|
||||
PollingPriorityOutcomeProcessing = "processing"
|
||||
// PollingPriorityOutcomeSuccess 结局-执行成功
|
||||
PollingPriorityOutcomeSuccess = "success"
|
||||
// PollingPriorityOutcomeFailed 结局-轮询失败
|
||||
PollingPriorityOutcomeFailed = "failed"
|
||||
// PollingPriorityOutcomeClosed 结局-已关闭
|
||||
PollingPriorityOutcomeClosed = "closed"
|
||||
// PollingPriorityOutcomeExpired 结局-已过期
|
||||
PollingPriorityOutcomeExpired = "expired"
|
||||
)
|
||||
|
||||
// 轮询优先项触发类型常量
|
||||
@@ -129,11 +168,61 @@ func PollingPriorityStatusName(status string) string {
|
||||
return "已完成"
|
||||
case PollingPriorityStatusFailed:
|
||||
return "失败出队"
|
||||
case PollingPriorityStatusClosed:
|
||||
return "已关闭"
|
||||
case PollingPriorityStatusExpired:
|
||||
return "已过期"
|
||||
default:
|
||||
return "未知"
|
||||
}
|
||||
}
|
||||
|
||||
// PollingPriorityStatusOutcome 把优先项状态投影为对外执行结局。
|
||||
// 待执行与执行中都属于「处理中」:二者都没有产生新的对外结论。
|
||||
func PollingPriorityStatusOutcome(status string) string {
|
||||
switch status {
|
||||
case PollingPriorityStatusCompleted:
|
||||
return PollingPriorityOutcomeSuccess
|
||||
case PollingPriorityStatusFailed:
|
||||
return PollingPriorityOutcomeFailed
|
||||
case PollingPriorityStatusClosed:
|
||||
return PollingPriorityOutcomeClosed
|
||||
case PollingPriorityStatusExpired:
|
||||
return PollingPriorityOutcomeExpired
|
||||
default:
|
||||
return PollingPriorityOutcomeProcessing
|
||||
}
|
||||
}
|
||||
|
||||
// PollingPriorityOutcomeName 返回优先项执行结局的中文名称。
|
||||
func PollingPriorityOutcomeName(outcome string) string {
|
||||
switch outcome {
|
||||
case PollingPriorityOutcomeSuccess:
|
||||
return "执行成功"
|
||||
case PollingPriorityOutcomeFailed:
|
||||
return "轮询失败"
|
||||
case PollingPriorityOutcomeClosed:
|
||||
return "已关闭"
|
||||
case PollingPriorityOutcomeExpired:
|
||||
return "已过期"
|
||||
case PollingPriorityOutcomeProcessing:
|
||||
return "处理中"
|
||||
default:
|
||||
return "未知"
|
||||
}
|
||||
}
|
||||
|
||||
// PollingPriorityActive 判断状态是否为占用活动项唯一键的状态。
|
||||
func PollingPriorityActive(status string) bool {
|
||||
return status == PollingPriorityStatusPending || status == PollingPriorityStatusProcessing
|
||||
}
|
||||
|
||||
// PollingPriorityRetriggerable 判断状态是否允许人工重触发。
|
||||
// 只有失败出队与已过期的项才需要人工重新加急;已完成与已关闭是人工/系统已经确认的结论。
|
||||
func PollingPriorityRetriggerable(status string) bool {
|
||||
return status == PollingPriorityStatusFailed || status == PollingPriorityStatusExpired
|
||||
}
|
||||
|
||||
// PollingPriorityTriggerName 返回优先轮询项触发类型的中文名称。
|
||||
func PollingPriorityTriggerName(triggerType string) string {
|
||||
switch triggerType {
|
||||
|
||||
Reference in New Issue
Block a user