From 0e1780b8b90cdb90d4cd039537e97ffa56c0dc3c Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Mon, 29 Jun 2026 14:36:36 +0800 Subject: [PATCH] =?UTF-8?q?docs(changelog-v2):=20=E6=88=BF=E5=8A=A1?= =?UTF-8?q?=E6=97=A5=E5=8E=86=E8=A1=A5=E5=B7=B2=E5=AE=8C=E6=88=90=E7=8A=B6?= =?UTF-8?q?=E6=80=81=E7=82=B9(PR=20#4624)=E5=89=8D=E7=AB=AF=E5=AF=B9?= =?UTF-8?q?=E6=8E=A5=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 日历 statusDots 新增第5类 confirmed(已完成,blue)+summary.confirmed字段+status筛选支持confirmed; finalize完成的团不再误显进行中,与订单详情对齐。前端按label+color通用渲染或补confirmed白名单。 --- ...态点_finalize单不再误显进行中_前端对接-管理后台.md | 36 +++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 changelogs-v2/2026-06/52_4624_房务日历补已完成状态点_finalize单不再误显进行中_前端对接-管理后台.md diff --git a/changelogs-v2/2026-06/52_4624_房务日历补已完成状态点_finalize单不再误显进行中_前端对接-管理后台.md b/changelogs-v2/2026-06/52_4624_房务日历补已完成状态点_finalize单不再误显进行中_前端对接-管理后台.md new file mode 100644 index 0000000..88d3841 --- /dev/null +++ b/changelogs-v2/2026-06/52_4624_房务日历补已完成状态点_finalize单不再误显进行中_前端对接-管理后台.md @@ -0,0 +1,36 @@ +# 房务日历：新增「已完成」状态点，finalize 完成的团不再误显「进行中」 + +> 模块：房务管家 · 日历视图（管理后台） +> 类型：后端修复 + 前端对接（日历 statusDots 新增第 5 类取值） +> 日期：2026-06-29 +> 关联：PR #4624（已合并 dev-v3 + 部署测试服 + API 实测闭环） + +## 背景 +房务手测发现：订单详情显示「已完成」的团，在日历视图里却显示「进行中」——口径不一致。 +根因：日历此前只有 4 类状态点（异常/待配房/进行中/询房中），缺「已完成」桶；finalize 完成的需求（house_status=CONFIRMED）其配房行 confirm_status 仍是 CONFIRMED，被归进「进行中」。 + +## 后端改动（已上线测试服） +`GET /admin/house/calendar` 与 `GET /admin/house/calendar/day` 的返回新增「已完成」桶： + +1. **statusDots[] 新增第 5 类取值**： + ```json + { "status": "confirmed", "label": "已完成", "count": 1, "color": "blue" } + ``` + - 触发：该团需求 house_status=CONFIRMED（房务已最终回传） + - 整团（订单维度）覆盖其全部已确认配房行 → 该团所有住宿晚在日历显「已完成」蓝点 + +2. **summary 新增字段 `confirmed`**（月度摘要「已完成」团数）： + ```json + "summary": { "totalNights": 12, "inProgress": 2, "inquiry": 1, "pending": 0, "exception": 0, "confirmed": 2 } + ``` + +3. **status 筛选参数**支持 `confirmed`（与原 inProgress/inquiry/pending/exception 并列，逗号多选）。 + +## 【前端必看】 +- 日历状态点渲染若是按 `status` 白名单硬编码的（只认 inProgress/inquiry/pending/exception），**请补 `confirmed` 一类**，否则 finalize 完成的团会从日历消失（比修复前更糟）。 +- 推荐做法：直接用接口返回的 `label` + `color` 通用渲染（status 仅作筛选 key），后端已自描述。 +- 颜色约定（与文档 §2.6 一致）：异常=red / 待配房=gray / 进行中=green / 询房中=yellow / **已完成=blue（新增）**。 + +## 口径对齐说明（无需前端处理，仅知悉） +- 「待最终确认」(PENDING_FINALIZE) 在日历仍归「进行中」绿点（wx 拍板保持现状，日历为天级概览，不单列该态）；详情/我的接单/工作台首页仍各自显「待最终确认」。 +- 「询房中」(inquiry) 是日历专属细分态（assignment 级有 INQUIRING 行），系统其它视图按 house_status 显「配房中」——文档 §2.6 设计如此，非缺陷。