2. 核心需求

需求列表

需求 ID	优先级	需求描述	状态	所属模块
R-101	P0	短信服务独立部署，提供统一发送 API	草稿	短信微服务
R-102	P0	短信模板管理（创建、审核、启用/停用）	草稿	短信微服务
R-103	P1	短信异步发送与状态回调	草稿	短信微服务
R-104	P1	多租户接入与配额管理	草稿	短信微服务
R-201	P0	支付配置管理（创建、编辑、停用）	草稿	支付重构
R-202	P0	微信服务商分账模式	草稿	支付重构
R-203	P0	微信服务商直接收款模式	草稿	支付重构
R-204	P1	支付宝直接收款模式	草稿	支付重构
R-205	P0	网点-支付配置绑定管理	草稿	支付重构
R-206	P1	支付结果通知与对账	草稿	支付重构

P0 需求（必须有）

R-101：短信服务独立部署，提供统一发送 API

需求描述： 将短信发送能力从快递业务中完全剥离，部署为独立微服务。提供 RESTful API，支持单条/批量发送、发送记录查询。全平台所有业务线统一通过该服务发送短信。

验收标准：

• [ ] 短信微服务独立部署，与快递服务解耦
• [ ] 提供 POST /api/v1/sms/send 单条发送接口
• [ ] 提供 POST /api/v1/sms/batch-send 批量发送接口
• [ ] 提供 GET /api/v1/sms/records 发送记录查询接口
• [ ] 支持 API Key 鉴权，各接入方使用独立密钥
• [ ] 快递业务已切换至新短信服务，旧代码清理完毕

R-102：短信模板管理

需求描述： 统一的短信模板管理中心，支持模板 CRUD、审核流程、签名管理。模板需兼容阿里云、腾讯云等主流短信渠道的模板规范。

验收标准：

• [ ] 支持创建/编辑/删除短信模板
• [ ] 模板包含：模板名称、渠道类型、模板 ID、模板内容、变量占位符
• [ ] 签名独立管理，每个模板绑定一个签名
• [ ] 模板启用/停用开关
• [ ] 模板变量校验（发送时校验入参变量数量与模板匹配）

R-201：支付配置管理

需求描述： 建立网点级别的支付配置中心。管理员可创建多个收款配置（每个配置绑定一种支付模式和对应商户参数），然后将配置分配给指定网点。一个网点最多绑定两个支付配置：一个微信渠道配置（分账或直收二选一）和一个支付宝渠道配置（可选）。

验收标准：

• [ ] 支持创建/编辑/删除支付配置
• [ ] 每种支付模式对应不同的配置参数 Schema（微信分账/微信直收/支付宝直收）
• [ ] 配置列表支持按模式筛选、按状态筛选
• [ ] 网点管理页面可查看/修改当前绑定的微信和支付宝支付配置
• [ ] 一个网点最多绑定一个微信配置和一个支付宝配置

R-202：微信服务商分账模式

需求描述： 以微信支付服务商模式为基础，实现服务商分账能力。用户支付后，资金按预设比例/金额自动分账到平台、加盟商、设备供应商等多个接收方。

验收标准：

• [ ] 支付时携带分账参数，支付成功后发起分账
• [ ] 支持按比例分账和固定金额分账两种方式
• [ ] 分账接收方最多支持 10 个
• [ ] 支持分账查询接口
• [ ] 分账失败支持重试和告警

R-203：微信服务商直接收款模式

需求描述： 以微信支付服务商模式为基础，实现不涉及分账的直接收款。服务商旗下子商户直接收款，平台通过其他方式（如定期结算）收取服务费。

验收标准：

• [ ] 支持子商户进件（或已有子商户绑定）
• [ ] 支付请求自动路由到对应子商户
• [ ] 支付结果回调通知到业务系统
• [ ] 支持退款（全额/部分）

R-205：网点-支付配置绑定管理

需求描述： 提供直观的网点支付配置绑定管理界面。管理员可为每个自助洗衣网点分别指定微信渠道支付配置和支付宝渠道支付配置。客户端分为微信小程序和支付宝小程序两个独立 App，前端根据所在平台自动获取对应渠道的支付配置。

验收标准：

• [ ] 网点详情页展示当前微信支付配置和支付宝支付配置（如有）
• [ ] 微信渠道只能绑定一个配置（分账或直收二选一）
• [ ] 支付宝渠道最多绑定一个配置，可以不绑（仅微信收款）
• [ ] 支持更换各渠道的支付配置（需确认操作）
• [ ] 配置切换后立即生效，无需重启服务

P1 需求（应该有）

R-103：短信异步发送与状态回调

需求描述： 短信发送采用异步模式，请求入队后立即返回，通过回调或 Webhook 通知业务方发送结果。

验收标准：

• [ ] 发送请求落库后立即返回，不阻塞调用方
• [ ] 支持配置回调 URL，发送完成后通知结果
• [ ] 消息队列保证不丢消息（持久化 + ACK 机制）
• [ ] 发送失败自动重试（最多 3 次）

R-104：多租户接入与配额管理

需求描述： 支持多条业务线作为独立租户接入短信服务，每个租户有独立的日发送配额、速率限制和费用统计。

验收标准：

• [ ] 租户注册：分配独立 API Key 和 Secret
• [ ] 日配额可配置，超限自动拦截
• [ ] 发送速率限制（QPS 可配置）
• [ ] 租户维度发送量和费用统计

R-204：支付宝直接收款模式

需求描述： 支持支付宝直接收款，作为微信支付的补充。独立于微信支付体系，网点可选择支付宝作为收款方式。

验收标准：

• [ ] 支持支付宝 APP 支付 / H5 支付
• [ ] 支付结果异步通知处理
• [ ] 支持退款
• [ ] 配置与微信支付相互独立，互不影响

R-206：支付结果通知与对账

需求描述： 统一的支付结果通知机制和日终对账能力，财务人员可按网点、按支付渠道查看交易汇总和明细。

验收标准：

• [ ] 支付成功后通过统一回调通知业务方
• [ ] 对账单支持按日期、网点、支付渠道筛选
• [ ] 对账单导出为 Excel
• [ ] 异常交易（金额不一致、未到账）标记与告警