From 75acb12f957d2010c95bd2c3ae9e350cf2acace9 Mon Sep 17 00:00:00 2001
From: zhouyonggao <1971162852@qq.com>
Date: Fri, 13 Mar 2026 17:10:16 +0800
Subject: [PATCH] =?UTF-8?q?docs(api):=20=E6=9B=B4=E6=96=B0=E6=8E=A5?=
 =?UTF-8?q?=E5=8F=A3=E5=93=8D=E5=BA=94=E5=92=8C=E8=AE=A2=E5=8D=95=E7=8A=B6?=
 =?UTF-8?q?=E6=80=81=E8=A7=84=E5=88=99=E6=96=87=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 规范请求追踪ID生成规则，支持雪花算法或UUID确保唯一性
- 新增时间格式规范，内部使用yyyyMMddHHmmss，交互时需转换格式
- 明确邮储服务开放平台接口校验权益码过期的描述和返回提示区分
- 修改订单初始状态为"服务未预约"(100)，预约成功后更新为"服务已预约"(200)
- 细化订单状态流转规则，新增从未预约到已预约状态的变更路径
- 注明服务预约接口幂等策略中code字段与邮储接口rightsCode的映射关系
---
 docs/需求文档-PRD.md | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/docs/需求文档-PRD.md b/docs/需求文档-PRD.md
index f3be8d5..b3ca1e6 100644
--- a/docs/需求文档-PRD.md
+++ b/docs/需求文档-PRD.md
@@ -425,9 +425,11 @@
 
 ---
 
-#### 3.1.5 服务状态查询接口
+#### 3.1.5 服务状态查询接口（内部接口）
 
-**功能描述**：根据权益码查询服务预约状态
+**功能描述**：调用邮储「高端客户权益积分预约服务状态查询接口」，根据权益码查询邮储侧的服务预约状态。用于服务取消、服务预约等流程中验证邮储侧订单状态。
+
+**说明**：此接口为内部调用邮储接口，非对外提供的接口。
 
 **业务规则**：
 1. 根据权益码查询订单
@@ -961,15 +963,15 @@ ycjfsc:token:psbc
 
 ```
 1. 接收蓝色兄弟核销回调
-2. 更新订单状态为「待通知」(250)，记录核销时间
+2. 记录核销时间，创建通知任务(task_type=1)
 3. 立即响应蓝色兄弟"ok"（快速响应，避免超时）
 4. 异步处理：
    - 调用邮储服务完成接口
-   - 成功：更新订单状态为「已完成」(300)
-   - 失败：保留状态250，等待重试机制处理
+   - 成功：更新订单状态为「已完成」(300)，任务状态为已完成(2)
+   - 失败：任务状态为失败(3)，等待重试机制处理
 ```
 
-**说明**：不使用本地事务，通过重试+补偿+对账三重机制保证最终一致性。
+**说明**：不使用本地事务，通过重试+补偿+对账三重机制保证最终一致性。订单状态统一使用100/200/300/400/500五个状态，通知处理过程通过通知任务表(ycjfsc_notify_task)进行管理。
 
 **机制二：消息重试策略**
 
@@ -984,7 +986,7 @@ ycjfsc:token:psbc
 | 第7次 | 1小时 | 1小时46分40秒 |
 | 第8次 | 2小时 | 3小时46分40秒 |
 
-超过8次仍失败，标记为「通知异常」(350)，人工介入处理。
+超过8次仍失败，任务保持失败状态，等待告警通知后人工介入处理。
 
 **机制三：定时补偿任务**