From 5442f805238d19166f5345d4e11e0b1d59b86bfc Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Fri, 2 Oct 2026 18:08:31 +0800
Subject: [PATCH] =?UTF-8?q?docs(changelog):=20#8708=20=E4=BA=8C=E6=9C=9F?=
 =?UTF-8?q?=E6=9C=AA=E6=94=AF=E4=BB=98=E8=AE=A2=E5=8D=95=E8=87=AA=E5=8A=A8?=
 =?UTF-8?q?=E5=8F=96=E6=B6=88=E6=97=B6=E5=88=BB=E7=94=B1=E5=88=9B=E5=BB=BA?=
 =?UTF-8?q?=E5=90=8E=202h=20=E6=81=A2=E5=A4=8D=E4=B8=BA=2024h=EF=BC=8C?=
 =?UTF-8?q?=E6=8E=A5=E5=8F=A3=E5=A5=91=E7=BA=A6=E4=B8=8D=E5=8F=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
---
 ...”¯ä»˜è®¢å�•è‡ªåŠ¨å�–消时刻改为24h-ä¿®å¤�-管ç�†å�Žå�°.md | 98 +++++++++++++++++++
 1 file changed, 98 insertions(+)
 create mode 100644 changelogs-v2/2026-10/02_8708_未支付订�自动�消时刻改为24h-修�-管���.md

diff --git a/changelogs-v2/2026-10/02_8708_未支付订�自动�消时刻改为24h-修�-管���.md b/changelogs-v2/2026-10/02_8708_未支付订�自动�消时刻改为24h-修�-管���.md
new file mode 100644
index 00000000..e940ad85
--- /dev/null
+++ b/changelogs-v2/2026-10/02_8708_未支付订�自动�消时刻改为24h-修�-管���.md
@@ -0,0 +1,98 @@
+---
+schema: "hl-changelog/v2"
+ticket: "8708"
+title: "二期未支付订�自动�消时刻由创建� 2h ��为 24h，接�契约��"
+consumer: "multiple"
+author: "wx(GIT)"
+change_type: "修�"
+backend_status: "deployed"
+gateway_status: "not_required"
+frontend_status: "not_required"
+frontend_owner: ""
+frontend_ref: ""
+target_release: ""
+verified_at: ""
+status_note: "接�路径�入��出��错误����；�化的�是二期待支付订�被系统自动�消的时刻：由创建�约 2h ��为创建� 24h，与已展示的支付截止时刻 expiryTime 一致。"
+updated_at: "2026-10-02"
+base: "dev-v3"
+---
+
+# 二期订�：未支付订�自动�消时刻��为创建� 24h
+
+> **�务**: hl-order-service-v3（�消判定与扫�任务）�hl-user-service（定时任务调度）
+> **关� Issue**: #8708
+> **关� PR**: #8729（�并�交 89c87fd217）
+> **部署状�**: 测试环境已部署并实测，�「五�实测验��
+> **影�范围**: �程�订�详情/列表与�起支付�管���订�详情与线下收款登记——�影�订�何时被自动�消，�改任何字段
+
+---
+
+## ⚠� 关键�化
+
+**改�**：二期订�对外展示的支付截止时刻是创建� 24h（`expiryTime = 创建时刻 + expiryMinutes`，`expiryMinutes` 为 1440），但系统在创建�约 2h 就把未支付订�自动�消。2~24h 之间，客户看到的截止时刻还没到，订��已是 CANCELLED：�程�无法��起支付，管���也无法登记线下收款。
+
+**改�**：系统按�一个截止时刻�消。`创建时刻 + expiryMinutes` 到达�，在下一次�分钟扫�中�消，�消原因为「订�超时未支付，系统自动�消�。
+
+---
+
+## 一�背景
+
+**根因**：自动�消原��� RocketMQ 延迟消�触�。RocketMQ 4.x 延迟消�最长 2h，24h 窗�的过期消�实际在约 2h �投递并�消订�；测试� SYSTEM_AUTO_CANCEL 记录的延迟全部是 120 分钟。
+
+**�果**（二期尚未上生产，影���于测试�数�）：
+
+- 客户在创建� 2~24h 之间无法支付；
+- �消会连带房务释放：测试�有 8 ��消��房被软删并回补库存；
+- 客户在�消��起��消��到账的款�入 `CANCELLED_PAID`，需�人工退款。
+
+---
+
+## 二��端改动
+
+- 窗� ≤ 120 分钟的订��由延迟消�触��消；消费延迟消�时增加到期判定，截止时刻未到��消。
+- 新增�分钟一次的扫�任务：order-v3 `OrderExpiryJob`，由 user-service 定时任务�内部接� `POST /v3/internal/jobs/order-expiry/run` 触�，按「创建时刻 + expiryMinutes ≤ 当�时刻��消。窗�超过 120 分钟的订��它�消；延迟消�丢失时，它也是兜底。
+- 该内部接��网关访问一律返回 403，�端��调用，也无需调用。
+- 到期判定与�程�展示的 `expiryTime` 共用�一个计算（`OrderPayWindow`）：展示的截止时刻就是系统�消的��。
+
+---
+
+## 三�对�端的影�
+
+**�端无需改动。** 接�路径�入��出��错误����。
+
+### �观察到的行为�化
+
+| 端 | 接� | 改� | 改� |
+|---|---|---|---|
+| �程� | 订�详情�订�列表（order-v3 内部端点 `GET /v3/internal/mp/order/{orderId}`�`GET /v3/internal/mp/order/list`，��程��务转�） | 创建约 2h �订��为 CANCELLED，`expiryTime` ��返回 | 截止时刻到达�订��� PENDING_PAY，`expiryTime` �续返回 |
+| �程� | �起支付（order-v3 内部端点 `POST /v3/internal/mp/order/{orderId}/payment/unified-order`，��程��务转�） | 2~24h 之间订�已�消，返回 520104「订�当�状���许支付� | 截止时刻到达��正常�起支付 |
+| 管��� | `GET /v3/admin/order/{id}` | 创建约 2h �为 CANCELLED | 截止时刻到达�为 PENDING_PAY |
+| 管��� | `POST /v3/admin/order/{orderId}/payment/manual-receipt` | 2~24h 之间订�已�消，无法登记 | 截止时刻到达��正常登记；登记�订�离开待支付，��被自动�消 |
+
+### 字段�径（�未�化）
+
+- �程�详情/列表的 `expiryTime`：仅订�为 PENDING_PAY 时返回，值为 `创建时刻 + expiryMinutes`（`expiryMinutes` 为空时按 1440 计）；其他状�返回 null。
+- 管���创��应的 `expiryMinutes`：�为 1440。
+
+---
+
+## 四�覆盖范围与边界
+
+- 范围：二期 order-v3 的待支付订�。一期 v2 订���影�。
+- 已支付或已登记线下收款的订�离开待支付，�会被自动�消。
+- 撤销线下收款�回到待支付的订�，系统�自动�消，需人工处�（与改�一致）。
+- �消时刻：截止时刻之�的下一次�分钟扫�，按设计在截止时刻� 2 分钟内。
+- 按产��置��支付窗�，�在本次范围。
+
+---
+
+## 五�实测验�（测试环境）
+
+- **部署�存�**：创建早于部署时刻 24h 以上��待支付的订��扫�全部�消（剔除撤销收款�回到待支付的�，计数为 0）。阳性对照�部署�为超期待支付，部署�转为 CANCELLED，状�日志新增一� SYSTEM_AUTO_CANCEL 记录。
+- **新建订�**：管���新建两张核心订�，创建� 132 分钟两��为 PENDING_PAY（改�此时已被�消）。对其中一张登记线下收款，返回 code 200，订�转为已付定金，状�日志中没有自动�消记录。
+
+---
+
+## 关�
+
+- 工� #8708，PR #8729