Files
mpay_v2_webman/app/queue/job/README.md
技术老胡 fd1f53f2ee feat: 完善支付通道和收款监听链路
新增 ChannelNotifyPayloadInterface 等支付插件通知契约,规范 pay_no 定位和插件返回校验。

新增微信、支付宝、收钱吧、Postar 个人收款插件适配,支持余额识别与备注识别。

新增 receipt-watcher 后端进程、Redis 队列 job 和平台事件监听,覆盖收款流水通知、商户通知、退款派发、转账派发与清算完成。

补齐个人收款监听相关系统配置、仓储、服务费冻结明细、订单后台操作和通道测试能力。

重构支付单创建、回调、费用、风控、结算和通道统计链路,统一状态流转与幂等处理。
2026-05-11 16:28:48 +08:00

27 lines
950 B
Markdown

# Queue Job 目录说明
本目录只放具体的队列业务任务类。
Job 的职责是:
- 校验队列消息 payload。
- 调用领域 Service 完成业务动作。
- 定义该任务自己的失败处理策略。
Job 不直接实现 `Webman\RedisQueue\Consumer`,也不声明队列名。队列名和 Redis 连接由 `app/queue/redis` 下的 Consumer 负责。
## 新增任务约定
1. 新建一个以 `Job` 结尾的类,例如 `TransferDispatchJob`
2. 继承 `app\queue\support\AbstractQueueJob`
3.`handle(array $data)` 中解析消息并调用对应 Service。
4. 不在 Job 中堆复杂业务逻辑,复杂流程应下沉到 `app/service`
5. Job 应保持无状态,单次消息的数据只从 `handle()` 参数传入。
## 目录边界
- 具体业务 Job 放这里。
- 队列 Consumer 放 `app/queue/redis`
- 抽象基类和队列辅助类放 `app/queue/support`
- 通用接口放 `app/common/interface`