Files
junhong_cmp_fiber/internal/task/polling_priority_expiry.go
break 5ed6b39deb
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
feat(收口): 补齐 8 月迭代缺口并同步 Spec 与证据链
- 新增六对成对迁移 000232–000237:H5 弹窗类型、退款结算标识与申请人备注、优先轮询事实字段与两个新终态、通道阈值命中留痕、手机号最近解绑人、提现资格校验留痕
- 退款:原因必填与申请人备注、来源支付与渠道流水冻结、线下处理流水号补录审计、按订单查询可选退款方式、企微审批材料补齐且新增字段缺失映射即明确失败
- 优先轮询:人工关闭、有效期到期独立周期任务、失败与过期人工重触发、事实字段与异常重试查询、资产解析端点只读投影
- 通道阈值:命中事实同事务留痕与命中记录查询;员工账单:列表筛选与详情投影;商户池:列表投影与统计周期语义;H5:弹窗类型与类别排序
- 手机号:有效关联数量与最近解绑人、短信验证码失败次数限制;导出:佣金明细十五列与报表序号列
- 时间筛选:三处新增筛选纳入统一严格解析契约,员工账单产生时间参数改名
- 同步 12 份主 Spec 需求、两端点与异步任务证据链,门禁 context-health 与 OpenSpec 校验通过
2026-09-18 15:34:29 +08:00

58 lines
2.2 KiB
Go

package task
import (
"context"
"time"
"github.com/hibiken/asynq"
"go.uber.org/zap"
pollingSvc "github.com/break/junhong_cmp_fiber/internal/service/polling"
"github.com/break/junhong_cmp_fiber/pkg/auditcontext"
"github.com/break/junhong_cmp_fiber/pkg/constants"
"github.com/break/junhong_cmp_fiber/pkg/errors"
)
// PollingPriorityExpiryHandler 执行优先轮询项有效期到期处理任务。
//
// 该任务只做一件事:把超过固定有效期仍未完成的优先项转已过期终态并出队。
// 到期判定与查询、读侧完全解耦,读接口 MUST NOT 隐式触发过期处理;
// 本轮扫描未处理完的剩余项由下一轮计划任务继续,任务可重复执行。
type PollingPriorityExpiryHandler struct {
service *pollingSvc.PriorityExpiryService
logger *zap.Logger
}
// NewPollingPriorityExpiryHandler 创建优先轮询项有效期到期处理任务处理器。
func NewPollingPriorityExpiryHandler(service *pollingSvc.PriorityExpiryService, logger *zap.Logger) *PollingPriorityExpiryHandler {
if logger == nil {
logger = zap.NewNop()
}
return &PollingPriorityExpiryHandler{service: service, logger: logger}
}
// Handle 执行一次有效期到期扫描。
// 审计上下文固定为计划任务来源,与审计注册表中该动作允许的操作者与来源一致。
func (h *PollingPriorityExpiryHandler) Handle(ctx context.Context, task *asynq.Task) error {
if h == nil || h.service == nil {
return errors.New(errors.CodeServiceUnavailable, "优先轮询项有效期到期处理任务未配置")
}
taskType := constants.TaskTypePollingPriorityExpiry
if task != nil && task.Type() != "" {
taskType = task.Type()
}
ctx = auditcontext.With(ctx, auditcontext.Context{
ActorKind: constants.AuditActorScheduledJob, ActorID: taskType,
ActorName: "优先轮询项有效期到期处理计划任务", Source: constants.AuditSourceScheduler,
})
expiredCount, err := h.service.ExpireOverdue(ctx, time.Now().UTC())
if err != nil {
h.logger.Error("优先轮询项有效期到期处理失败", zap.Error(err))
return err
}
if expiredCount > 0 {
h.logger.Info("优先轮询项有效期到期处理完成", zap.Int("expired_count", expiredCount))
}
return nil
}