Appearance
金刚系统计划任务
金刚系统的长期任务主要放在 storeapi/scripts/cron,标准入口是 storeapi/scripts/run_scheduled_worker.py。宝塔计划任务或外部调度通常调用 cron 脚本,再由脚本进入统一 worker;不要依赖云函数请求结束后的后台线程处理补偿、结算、通知和超时逻辑。
任务清单
| 脚本 | 业务含义 | 接手关注点 |
|---|---|---|
standard_staff_dispatch_pending.sh | 标准单待派发处理。 | 是否可重复执行、候选员工过滤、失败重试。 |
standard_staff_dispatch_timeout.sh | 标准单派发超时处理。 | 超时阈值、顺延或转人工、游标状态。 |
standard_order_settlement_process.sh | 标准单结算处理。 | 支付状态、分账状态、重复结算保护。 |
standard_order_notification_process.sh | 标准单通知处理。 | 通知对象、失败重试、是否影响接单。 |
staff_withdrawal_payout_process.sh | 员工提现打款处理。 | 财务金额、账户状态、第三方返回。 |
staff_onboarding_post_register.sh | 员工入驻后处理。 | 员工资料、门店绑定、后续任务补偿。 |
staff_station_level_refresh.sh | 员工站点等级刷新。 | 统计口径、刷新周期、是否影响派发。 |
development_bonus_release.sh | 发展奖励释放。 | 奖励条件、重复发放保护。 |
development_bonus_refund_reconcile.sh | 发展奖励退款核对。 | 退款状态、冲正逻辑、财务对账。 |
daily_business_stats_notify.sh | 日常业务统计通知。 | 通知群、统计口径、失败是否需要补发。 |
cleanup_stale_insurance_pending.py | 清理长时间待处理保险状态。 | 状态筛选、是否会误改正常单。 |
统一 worker 支持的金刚主线任务包括:standard_staff_dispatch_pending、standard_staff_dispatch_timeout、standard_order_settlement_process、standard_order_notification_process、development_bonus_release、development_bonus_refund_reconcile、staff_station_level_refresh、staff_withdrawal_payout_process、store_score_daily_settlement、monthly_brand_fee 和 daily_business_stats_notify。重跑前先确认任务幂等、锁状态和 --dry-run 是否可用。
即将删除链路
与小羽佳订单协同相关的历史任务不作为本次交接维护重点。后续如果业务删除该链路,应同时清理旧任务配置、旧文档入口和历史告警口径。
任务排查步骤
- 确认宝塔或调度平台是否仍启用该脚本。
- 查看脚本调用的内部接口、token 和环境变量是否正确。
- 查后端日志,确认任务开始、结束、处理数量和异常。
- 查业务表状态,确认是否重复处理或漏处理。
- 资金、分账、提现类任务必须先备份相关数据,再补跑。