From 8398b10e5eae78eb0494acc2caaf346877c2045c Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sat, 21 Mar 2026 08:42:58 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BA=A7=E5=93=81=E8=AE=A2=E5=8D=95=E6=A8=A1?=
 =?UTF-8?q?=E5=9D=97=E6=94=B9=E8=BF=9B=EF=BC=9A=E5=9B=A2=E6=9C=9F=E8=87=AA?=
 =?UTF-8?q?=E5=8A=A8=E5=85=B3=E9=97=AD+=E5=B0=BE=E6=AC=BE=E8=87=AA?=
 =?UTF-8?q?=E5=8A=A8=E5=8F=96=E6=B6=88+=E6=97=A5=E6=9C=9F=E5=8F=98?=
 =?UTF-8?q?=E6=9B=B4=E9=87=8D=E6=96=B0=E8=AE=A1=E4=BB=B7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../2026-03-21_product_order_improvement.md   | 56 +++++++++++++++++++
 1 file changed, 56 insertions(+)
 create mode 100644 changelogs/2026-03/2026-03-21_product_order_improvement.md

diff --git a/changelogs/2026-03/2026-03-21_product_order_improvement.md b/changelogs/2026-03/2026-03-21_product_order_improvement.md
new file mode 100644
index 0000000..ca8aed1
--- /dev/null
+++ b/changelogs/2026-03/2026-03-21_product_order_improvement.md
@@ -0,0 +1,56 @@
+# 产品与订单模块改进
+
+**日期**: 2026-03-21
+**服务**: hl-product-service, hl-order-service
+**类型**: 功能增强
+
+---
+
+## 功能说明
+
+### 1. 团期报名截止自动关闭
+
+团期（GROUP 产品）超过报名截止日期后，系统每小时自动扫描，将 ENROLLING/CONFIRMED 状态的过期团期自动关闭为 CLOSED。
+
+**前端影响**：无需改动。过期团期不再显示"可报名"状态，`batchStatus` 会变为 `CLOSED`。
+
+---
+
+### 2. 尾款到期自动取消
+
+定金模式（DEPOSIT）订单，如果距出发日期不足 3 天仍未付尾款，系统每天凌晨自动取消订单。
+
+**前端影响**：无需改动。订单状态会变为 `CANCELLED`，`cancelReason` 为"尾款未在出发前3天付清，系统自动取消"。建议在待付尾款页面增加倒计时提示。
+
+---
+
+### 3. 出发日期变更自动重新计价
+
+管理员修改订单出发日期后，系统自动基于新日期的价格日历重新计算售价。
+
+**前端影响**：
+- 订单详情页的 `totalPrice` 可能因日期变更而更新
+- 时间线（timeline）中会记录价格变动详情，如："售价已更新: 5980.00 → 6280.00（+300.00）"
+- 如果价格偏差超过 50%，不会自动更新，时间线记录"价格偏差超过50%，未自动更新，请手动核查"
+
+---
+
+## 接口变更
+
+**本次无接口变更**。以上功能均为后端定时任务和内部逻辑增强，不影响现有接口的请求/响应格式。
+
+已有接口行为变化：
+
+| 接口 | 变化说明 |
+|------|---------|
+| GET /admin/product/item/{productId}/batch/list | 过期团期 batchStatus 会自动变为 CLOSED |
+| GET /mp/order/{orderId} | 尾款逾期订单 status 会自动变为 CANCELLED |
+| PUT /admin/order/{orderId}/edit | 修改出发日期后 totalPrice 可能自动更新 |
+
+---
+
+## 注意事项
+
+- 尾款截止默认 3 天（出发前 3 天），后续可配置
+- 价格自动更新有 50% 偏差保护，超出不会自动改价
+- 团期关闭后不可恢复报名，需重新创建团期