From 601129a28dad5925d3af324cc79f980f26c9d0a8 Mon Sep 17 00:00:00 2001 From: zhouyonggao <1971162852@qq.com> Date: Fri, 13 Mar 2026 17:13:02 +0800 Subject: [PATCH] =?UTF-8?q?docs(order):=20=E6=9B=B4=E6=96=B0=E8=AE=A2?= =?UTF-8?q?=E5=8D=95=E5=8F=B7=E5=8F=8A=E7=9B=B8=E5=85=B3=E4=B8=9A=E5=8A=A1?= =?UTF-8?q?=E5=8F=B7=E7=94=9F=E6=88=90=E8=A7=84=E5=88=99=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 优化订单号(order_no)生成规则,采用时间戳+机器ID+序列号结构,确保全局唯一且可读性强 - 详细说明外部业务号(out_biz_no)的格式和用途,添加服务类型编码实现幂等标识 - 新增合作方交易流水号(partner_tx_sri_no)规则,满足邮储服务开放平台接口要求 - 补充各类编号示例及特点,便于理解与实际应用 --- docs/需求文档-PRD.md | 32 ++++++++++++++++++++++++++++++-- 1 file changed, 30 insertions(+), 2 deletions(-) diff --git a/docs/需求文档-PRD.md b/docs/需求文档-PRD.md index 3d82ecb..71692dd 100644 --- a/docs/需求文档-PRD.md +++ b/docs/需求文档-PRD.md @@ -873,8 +873,36 @@ ### 4.2 数据规则 -1. **订单号生成规则**:渠道号(2位) + 日期(8位) + 序列号(8位) -2. **外部业务号生成规则**:订单号 + 随机数(4位),保证唯一性和幂等性 +1. **订单号生成规则(order_no)**: + - 格式:`{YYMMDDHHmmss}{machineId}{sequence}` + - 长度:20位 + - 结构: + - 时间戳(12位):YYMMDDHHmmss,例如 `260313142530` + - 机器ID(2位):`01-99`,支持多实例部署 + - 序列号(6位):`000001-999999`,每秒重置 + - 示例:`26031314253001000001` + - 特点:按时间排序、可读性强、全局唯一 + +2. **外部业务号生成规则(out_biz_no)**: + - 用途:调用蓝色兄弟接口的幂等标识 + - 格式:`{order_no}{service_type}` + - 长度:26位(在蓝色兄弟2~32位限制内) + - 结构: + - 订单号(20位):上述order_no + - 服务类型(6位):邮储服务编码,例如 `310001` + - 示例:`26031314253001000001310001` + - 特点:包含业务信息、可追溯、幂等 + +3. **合作方交易流水号生成规则(partner_tx_sri_no)**: + - 用途:调用邮储服务开放平台接口 + - 格式:`{tranChnl}{YYYYMMDD}{sequence}` + - 长度:18位(邮储接口规范要求) + - 结构: + - 渠道号(2位):12-手机银行,17-电话银行,41-CRM零售 + - 日期(8位):YYYYMMDD,例如 `20260313` + - 序列号(8位):`00000001-99999999`,每日重置 + - 示例:`122026031300000001` + - 特点:符合邮储规范、包含渠道信息 3. **状态流转**: - 100(未预约) → 200(已预约):预约成功 - 200(已预约) → 300(已完成):券码核销