Skip to content

金刚系统计划任务

金刚系统的长期任务主要放在 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_pendingstandard_staff_dispatch_timeoutstandard_order_settlement_processstandard_order_notification_processdevelopment_bonus_releasedevelopment_bonus_refund_reconcilestaff_station_level_refreshstaff_withdrawal_payout_processstore_score_daily_settlementmonthly_brand_feedaily_business_stats_notify。重跑前先确认任务幂等、锁状态和 --dry-run 是否可用。

即将删除链路

与小羽佳订单协同相关的历史任务不作为本次交接维护重点。后续如果业务删除该链路,应同时清理旧任务配置、旧文档入口和历史告警口径。

任务排查步骤

  1. 确认宝塔或调度平台是否仍启用该脚本。
  2. 查看脚本调用的内部接口、token 和环境变量是否正确。
  3. 查后端日志,确认任务开始、结束、处理数量和异常。
  4. 查业务表状态,确认是否重复处理或漏处理。
  5. 资金、分账、提现类任务必须先备份相关数据,再补跑。

用于金刚项目内部协作、运营培训和客户说明。