feat(收口): 补齐 8 月迭代缺口并同步 Spec 与证据链
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:
2026-09-18 15:34:29 +08:00
parent 5e78809b93
commit 5ed6b39deb
142 changed files with 7878 additions and 964 deletions

View File

@@ -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 {