foodie-server/specs/033-native-push-routing/tasks.md

Tasks: 可切换的原生业务推送通道

2026-10-26 原生用户语音追加

进度：实现中（本地验证已通过，未提交）。

• T025 对齐 035 新增用户原生 sound 解析及 FCM/APNs 重载，测试入口支持可选 language；uni 与原商家/骑手声音保持。
• T026 交付 63 个 WAV 及 manifest、App 渠道/前台播放/系统声音和 Apipost 接入说明。
• T027 执行 JDK 21 推送与闪送通知定向测试、package、音频元数据和差异检查，记录真实未验证项；验证内容与 035 T019 共用。

验证记录：JDK 21 定向 *Push*Test,FlashDeliveryNotificationServiceTest 共 141 项全部通过，package 退出 0；63 WAV 编码/时长/manifest 映射及 git diff --check 通过。未执行完整回归、部署、真实云端投递或 App 真机播放，未提交。详细记录见 035 T019。

Input: specs/033-native-push-routing/spec.md、plan.md

Execution: 当前 test-202609v2 分支；不创建新分支。每项先写并运行失败测试，再实现、验证、核对暂存范围并提交。默认模式始终为 uni。

Phase 1: 默认通道与配置（US1）

• T001 [US1] 在 ruoyi-admin/src/main/java/com/ruoyi/app/push/ 定义接收端枚举、business-push 配置及原生模式启动校验；ruoyi-admin/src/main/resources/application.yml 仅设置默认 uni 与非秘密占位符。
• T002 [US1] 在 ruoyi-admin/src/test/java/com/ruoyi/app/push/BusinessPushPropertiesTest.java 覆盖默认启动、原生凭据缺失/无效和三端配置。

Phase 2: 原生发送器（US2、US3）

• T003 [US2] 在 FcmPushSender.java 实现三命名 FirebaseApp 和按接收端 FCM 发送；在 FcmPushSenderTest.java 验证项目隔离、payload、失效错误与无敏感日志。
• T004 [US3] 在 ApnsPushSender.java 实现三端证书型 APNs HTTP/2 发送及环境选择；在 ApnsPushSenderTest.java 验证 topic、payload、证书错误与响应分类。

Phase 3: 统一路由与业务集成（US1–US4）

• T005 [US1–US4] 在 BusinessPushService.java 实现 uni/native 选择、当前账号 token 读取、地址判定及异常隔离；在 BusinessPushServiceTest.java 覆盖默认 uni、六种原生组合及不自动回退。
• T006 [US1–US4] 修改 PayPush.java 的普通业务包装方法委托 T005；保留低层 uniCloud 方法供 uni 模式及排除路径使用，验证消息中心不重复入库。
• T007 [US2–US4] 将在用普通业务直连与 CID 前置过滤迁移到统一路由：MerchantNotificationRouter.java、LinePayOrderNotificationService.java、OmgPaymentNotifyService.java 和当前有效订单 Controller；同步更新相关测试。门店订单仍是分管账号优先、无符合条件分管账号时主账号兜底，不同时通知两类账号。不改音视频、废弃入口或临时测试推送接口。

Phase 4: 文档与验证

• T008 在 specs/033-native-push-routing/quickstart.md 记录三端凭据配置、默认关闭、启用/回退、真机检查；更新 specs/012-im-user-integration/code-status.md 与 docs/order-push-overview.md。
• T009 使用 JDK 21 运行定向测试和 ruoyi-admin 模块构建；核对完整 diff、暂存范围及未执行的外部 FCM/APNs 真机验证，再提交文档收口。

Dependencies

T001–T002 → T003/T004 → T005–T006 → T007 → T008–T009。FCM 与 APNs 发送器可以独立评审，但本任务按当前会话顺序执行，不启动 Agent。

2026-09-29 追加：随包凭据（默认通道不变）

• T010 更新三端资源命名和配置：每端一份独立 Firebase server.json、一份 APNs 普通证书、一份 packetName/pwd 配置，名称含 user/merchant/rider；实际文件提交 Git，默认 uni 不加载。
• T011 测试先行支持 classpath 读取 FCM JSON、APNs 配置和 .p12，保持原有外部路径兼容；开发/正式只切换 APNs 网关。
• T012 更新部署说明并运行 JDK 21 定向测试、模块构建和资源打包检查；仅暂存本功能代码、文档与三端凭据后提交，真机外发仍单独验证。

2026-09-29 追加：仅原生通道的多骑手新单批量

• T013 先写失败测试：骑手端 FCM multicast 保留业务 payload 与逐 token 结果；原生外卖、闪送新单进入批量分支，uni 仍逐骑手发送。
• T014 Android 骑手按已本地化文案和 payload 分组批量发送，逐人发布消息中心事件；iOS 保留原有逐设备异步发送，失败不回退 uni。
• T015 更新操作文档，运行 JDK 21 定向与回归测试、模块构建，核对变更及暂存范围。

2026-10-23 追加：无需切换业务模式的原生测试

• T016 先写失败测试：默认 uni 时只按需初始化目标端 FCM/APNs，iOS 测试固定发送到 APNs 正式网关。
• T017 新增匿名 POST /system/push/testNative，直接使用请求提供的设备 Token，不查询账号；返回服务商接受或脱敏失败类别，保留普通业务推送模式。

• [x] T018 更新 ApiPost 示例与风险说明，完成差异检查、定向测试和模块构建；真实手机通知由部署后人工验证。

  2026-10-26 本地固定配置

• [x] 去掉business-push所有显式环境变量占位符；三端路径、密码、topic按本地配套文件固定，保持uni/production当前默认，补充来源注释与使用说明。

• [x] APNs证书加载、配置校验、测试入口及发票鉴权定向回归通过；用户要求核对后分项中文提交并推送，提交状态及SHA以Git为准。

2026-10-26：本地JDK21合并定向测试39项通过，失败/错误均0，包含真实三端classpath证书加载、模拟APNs/FCM响应及发票鉴权；不代表真实设备投递成功。未执行服务器部署或真实外部推送，BadDeviceToken尚待实际安装包/当前token/部署配置联调验证。

2026-10-26 追加：使用参考工程的 Pushy 发送方式

• T019 对照 qtw-push-server，补充类型化 APNs 通知、苹果接受/拒绝测试；新增工厂签名在旧实现下编译失败，确认尚未具备 Pushy 发送能力。
• T020 以 Pushy 0.13.10 替换 JDK HttpClient，保留原有证书/消息/铃声；按端和环境缓存客户端，等待苹果真实响应并脱敏分类，有限时关闭资源，添加说明注释。
• T021 验证正式测试与开发业务客户端隔离、复用、关闭、超时/中断/异常及三端证书加载；完成推送定向测试、JDK 21 模块构建与 diff 检查，记录真实设备投递未验证。

验证记录：JDK 21 mvn -pl ruoyi-admin -am -Dmaven.test.skip=true package dependency:build-classpath 与随后本地 install 均退出 0，确认 JAR 包含 pushy-0.13.10.jar 和受项目统一版本管理的 Netty HTTP/2 依赖。本轮常规 reactor 测试被工作区并行新增的 PosOrderImGroupMapperTest 引用未实现的 setImGroupId 阻断，未修改这部分文件。为避免并行构建覆盖 target/classes，复制构建结果至 target/apns-validation，使用 JDK 21 javac 定向编译本轮推送源码和全部 *Push*Test，再以同版 JUnit Platform Console 1.10.5 执行：78 项成功，0 失败/中止/跳过。日志为 ruoyi-admin/target/apns-pushy-console-tests.log，报告在 target/apns-validation/reports。全量测试、服务器部署、真实 APNs/FCM 及 TestFlight/App Store 真机投递未执行，不能据此判定 BadDeviceToken 已解决。

2026-10-26 追加：APNs 测试/正式网关按配置选择

以下任务覆盖历史记录中“测试入口固定正式网关”的规则。

• T022 参数化复现旧实现错误：配置 development 且业务 uni 时，测试入口仍选 PRODUCTION；16 项 APNs 测试中该项失败，production 用例通过。
• T023 测试发送改为 sendForTest 并读取现有 apns-environment；当前 YAML 设 development，补充正式签名包使用 production 的注释；不增加环境变量、请求字段或网关失败自动切换。
• T024 更新规格、计划和接入说明，验证双环境原生测试、业务通道和客户端隔离，执行 JDK 21 推送定向测试、打包及差异检查；真实 APNs 投递单独验收。

验证记录：mvn -pl ruoyi-admin -am -Dtest=*Push*Test -Dsurefire.failIfNoSpecifiedTests=false package 在 JDK 21 下退出 0，79 项定向测试成功，0 失败/错误/跳过；包含 development 和 production 的测试入口用例及跨环境客户端隔离。git diff --check 通过。本轮未执行全量回归、服务器部署或真实 APNs 投递，测试证明配置路由已修正，不代表真机已收到通知。