wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态
2,283 提交 20 分支 0 Git标签
提交图

373 次代码提交

作者 SHA1 备注 提交日期
API Changelog Bot
a6a18e9943 @ 
docs(changelog-v2): 房务聊天/站内信4修复+未读实时SSE (#4326)
@
 2026-06-24 10:49:29 +08:00
yaosutu
45e2af81f8 docs(changelog): 财务详情新增应收总额 payableAmount 字段 双端管理后台 (#4321) 
财务Tab/订单详情头部/订单列表 3 个 admin 接口出参各新增 payableAmount(应收总额)派生字段。
 2026-06-24 10:32:39 +08:00
API Changelog Bot
4b866a0371 docs(changelog-v2): 房务异常标记完成+已确认改已完成+释放/转单修复 (#4312 #4318 #4319) 2026-06-23 17:56:09 +08:00
API Changelog Bot
3c32adb73e docs(changelog-v2): 定制师侧订单详情/调整快照候选暴露真实房型 roomTypeId(#4204 P2,PR#4313) 2026-06-23 17:42:23 +08:00
yaosutu
f85aa74eb5 docs(发票): PR #4311 收口——4份发票 changelog 勘误（amount 改 JSON number 元） 
修正范围：
- 23_4290_发票申请入参票种修正-修改接口-管理后台.md
- 23_4290_发票申请票种修正-修改接口-小程序端.md
- 23_4258_发票详情接口-新增接口-管理后台.md
- 23_4265_发票列表page结构调整-修改接口-管理后台.md

主要变更（4份文件均已对齐最终线上契约）：
1. amount 入参/出参全部改为 JSON number（单位元，如 986.00），
   原「integer 分/字符串分/×100」描述已作废
2. 各文件顶部勘误节追加「截至 PR #4311 收口」条目，
   关联 Issue #4290/#4296/#4310、PR #4292/#4302/#4311
3. 详情接口边界示例：专票 email 由 null 改为始终有值（全电子交付）
4. 列表接口：records.amount 和 stats.amount 均改为 number 类型
 2026-06-23 17:09:06 +08:00
yaosutu
3e00271082 docs(changelog-v2): 退款待办统计接口出参改数组+分页新增statusGroup参数（#4303/#4308） 2026-06-23 17:06:40 +08:00
API Changelog Bot
b658d8671d docs(changelog-v2): 房务详情逐日城市改区县+候选真实房型roomTypeId(#4300/#4305)+聊天发送人企微名(#4309) 2026-06-23 16:39:55 +08:00
yaosutu
a47eeeedcb docs(invoice): 发票申请最终契约 - 新增2文件 + 勘误2文件（#4290 #4292 #4302） 
新增：
- changelogs-v2/2026-06/23_4290_发票申请入参票种修正-修改接口-管理后台.md
- changelogs-v2-mp/2026-06/23_4290_发票申请票种修正-修改接口-小程序端.md

勘误：
- 23_4258_发票详情接口：删除 mailAddress 出参字段、去掉 ELECTRONIC 枚举、email 改为始终有值
- 23_4265_发票列表：invoiceType 枚举去掉 ELECTRONIC（普票/专票两值）

契约定稿要点：invoiceType 只有 VAT_NORMAL/VAT_SPECIAL；email 始终必填+格式；
专票限 COMPANY 抬头（581523）；专票五项全必填（581515）；删 mailAddress（全电子交付）
 2026-06-23 16:05:51 +08:00
API Changelog Bot
bfa877f3db docs(chat): 在线/离线实时SSE已上线(22_4223 §12, presence事件, #4273 PR#4299) 2026-06-23 15:43:42 +08:00
API Changelog Bot
79468ab61f docs(changelog): 车务§13.5未派看板数据打通(#4284/4286/4295)+车辆VIN错误码600107→600113(#4279) — 管理后台 2026-06-23 15:21:17 +08:00
API Changelog Bot
1e9f9ad881 docs(chat): 真已读readByPeer+im-chat-read SSE + 房务侧detail.messages已上线实测(22_4223§11/22_4237§8, #4288/#4289 PR#4294) 2026-06-23 15:15:33 +08:00
API Changelog Bot
b30dee3d22 docs(changelog-v2): 订单取消房务生命周期收口(#4287) + control_status词汇单源化(#4293) 2026-06-23 15:04:17 +08:00
API Changelog Bot
b5cb91defd docs(chat): 聊天「已读」是前端写死+抢单前应显「留言」澄清(22_4223 §10 / 22_4237 H2) 
- 后端 ChatMessageRespVO 无任何已读/送达字段(9字段已列全),14:05已读=前端硬拼,后端给不了
- 抢单前我方消息=留言(待房务接单),抢单后=已送达,别写死「已读」
- 留言→抢单后送达后端全包(bindHouseClaimer.rebindUnreadReceiver),测试时没抢单故正确未送达
- 房务管家抢单池门控保持不变,与定制师单向留言不冲突
- 标2项可选后端增强待wx定:真已读回执/抢单池留言计数预览
 2026-06-23 14:16:47 +08:00
yaosutu
2a24c42ba5 feat(发票模块): 新增发票详情接口 + 发票列表 page 结构升级（管理后台·#4258/#4265） 
- 新增 GET /v3/admin/order/invoice/{id} 发票详情接口（全量字段含专票四项/开票痕迹/推送痕迹）
- GET /v3/admin/order/invoice/page 列表行新增 9 个订单冗余字段
- tab 入参新增 NONE（未申请，代客申请候选）
- tabCounts 和 stats 从扁平对象改为数组（破坏性）
 2026-06-23 12:37:57 +08:00
yaosutu
7907e2aaa6 docs(changelog): 退款申诉新增接口 + 统一售后工单下线 双端 (#4250) 
售后拆分重构(PR #4251 #4254)对外接口变更:
- 小程序端(changelogs-v2-mp): 申诉新增 4 接口(发起/我的/详情/撤回)+ /v3/mp/aftersale/ticket* 下线 404
- 管理后台(changelogs-v2): 申诉新增 2 接口(分页/详情,关联展示来源+触发退款)+ /v3/admin/aftersale/ticket* 下线 404
- 申诉复用退款审批(无独立申诉审批);投诉仅移包路径不变
- 13 节自包含:全字段+枚举(appealType/appealStatus)+错误码 530601-609+示例(含工单 404 异常)
 2026-06-23 12:26:01 +08:00
API Changelog Bot
3f0c4037fd docs(changelog): #4256/#4266/#4274 房务守卫一致性审计修复(询房守卫+终态闸口808121+按钮enable对齐) 2026-06-23 11:49:36 +08:00
API Changelog Bot
65d5980a7d docs(changelog): 22_4223 §9 切真细节契约 — 答前端Q1(open-house选传/后端不解析对端)/Q2(list+sentAt字符串yyyy-MM-dd/isMine)/Q3(SSE已LIVE别轮询)+在线态SSE工单#4273 2026-06-23 11:44:16 +08:00
API Changelog Bot
a5c7d90b8d docs(changelog): 联系房务契约裁决 — 作废误写的23_(基于stale代码), 22_4223补裁决答前端3问(open-house live/抢单前可发/在线态轮询/FLEET deferred) 2026-06-23 11:32:18 +08:00
API Changelog Bot
a63cadb822 docs(changelog): 定制师侧联系房务聊天门控+去mock+对接真实房务(管理后台前端) — 后端契约已就绪实测 2026-06-23 11:09:34 +08:00
API Changelog Bot
c3060cc10a docs(changelog): 配房行程逐日城市改区县(后端 #4264 已上线) 字段契约 cityName=区县/cityCode=市级 2026-06-23 10:50:51 +08:00
API Changelog Bot
2f8156e0ff 文档(order/admin): 房务6态全返回-订单详情进度条6步(#4255)+我的订单筛选6tab(#4261) 已上线可对接 2026-06-23 10:30:16 +08:00
API Changelog Bot
f0443f4368 docs(changelog): 房务管家定制师需求漏候选酒店(#4237 第3项) — 补本单实测复证+验收对齐目标 2026-06-23 10:00:58 +08:00
API Changelog Bot
01bb12416e docs(changelog): 房务管家操作日志 operator 渲染前端项(#4237) — 渲染 operator.name 而非整串 JSON 2026-06-23 09:49:03 +08:00
yaosutu
75dea54f2f docs(changelog): 退款待办工作台后端接口(stats统计+resubmit重新发起+page列表增强) 管理后台 (#4226) 2026-06-22 17:48:20 +08:00
API Changelog Bot
b661ff7e89 文档(order+user/admin): 房务「联系房务」面板真实化已上线可对接(#4223 PR#4247) 
取代同日「需求澄清·实现中」版。已部署测试服+API验证:
- 订单详情 hotelRequirementBrief 加 claimerId(未抢单 null->前端「未知」)
- 聊天 open/open-house/conversations 加 peerOnline(真实在线态,SSE+Redis TTL near-live)
- 新端点 POST /admin/message/chat/open-house(HOUSE 订单维度单会话 HOUSE:{orderId})
- 抢单前发消息·抢单/转单后送达(后端自动);同人不自聊
 2026-06-22 17:44:44 +08:00
yaosutu
41acbe58bb 文档：发票待办补齐三 PR - 财务列表 NONE Tab + 订单字段 + 推送接口（#4233/#4235/#4238，Issue #4228~4230） 2026-06-22 17:10:36 +08:00
API Changelog Bot
9618b1f163 Merge branch 'main' of https://git.1814.love:8443/wx/hl-api-changelog 2026-06-22 17:06:10 +08:00
API Changelog Bot
56be7eedae docs(changelog-v2): 房务管家 #4237 补 H — 留言空态对齐定制师需求=1留言 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 17:05:50 +08:00
yaosutu
df6bee83b8 docs(v2/aftersale): v2 申诉退款 execute-appeal 接口废弃 → 迁移至 v3 售后工单 resolve 
v2 PUT /order/refund/{id}/execute-appeal 在 v3 不存在（404）
新流程：POST /v3/admin/aftersale/ticket/{id}/resolve 处置时核定金额，OA 通过后自动退款
关联 Issue #4161
 2026-06-22 17:05:26 +08:00
API Changelog Bot
56c5498167 docs(changelog): #4246 房务操作日志记录定制师提需求(读侧合成,op_type REQUIREMENT_SUBMIT) 2026-06-22 17:04:22 +08:00
API Changelog Bot
3d4e3967e7 docs(changelog-v2): 房务管家 #4237 进度条6态+留言计数 已部署验证版字段契约 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 17:00:48 +08:00
yaosutu
ee75e0ca36 文档：退款原因管理补 reason/list 列表端点（PR #4243，Issue #4242） 2026-06-22 16:35:50 +08:00
yaosutu
8144e7d197 docs(v2): 早鸟优惠 v3 管理后台对接 changelog 补建菜单说明 
前端迁移指引加第1步：v3 后台需新建早鸟优惠菜单入口（二期独立工程不会从 v2 自动带菜单），页面照搬 v2 即可。注意事项同步补一条。
 2026-06-22 16:23:41 +08:00
yaosutu
3c50202413 文档：退款政策与原因管理接口 v2->v3 路径对照与算法差异说明（管理后台） 2026-06-22 16:23:41 +08:00
API Changelog Bot
8f9153e630 Merge branch 'main' of https://git.1814.love:8443/wx/hl-api-changelog 2026-06-22 16:22:24 +08:00
API Changelog Bot
6e457dad42 docs(changelog-v2): 房务管家订单详情/抢单池 渲染缺口+抢单门控 (#4237) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 16:21:51 +08:00
yaosutu
d564ea71e7 docs(order/admin): 早鸟优惠管理页面 v3 接口对接说明 — 路径迁移指引（#4053/#4064/#4076/#4082） 2026-06-22 16:20:59 +08:00
API Changelog Bot
1750cb69ab docs(changelog): #4231 配房工作台抢了才能配 — 未抢单拒绝配房(808116)+前端按钮置灰 2026-06-22 16:02:17 +08:00
yaosutu
0df61a7b61 docs(order/admin): 订单列表售后 Tab 接口变更通知 (#4222/#4225) 
GET /v3/admin/order/status-group-counts 返回数组由 5 项增至 6 项，新增末项售后(AFTERSALE)。
GET /v3/admin/order statusGroup 参数新增枚举值 AFTERSALE。
售后为横切叠加语义，计数不纳入全部总数，与出行阶段 Tab 正交。
 2026-06-22 15:47:41 +08:00
API Changelog Bot
38960ac9d3 docs(changelog-v2): 配房需求面板前端接入 — 房型 roomTypeId 模型 + 酒店/备注渲染 (#4209/#4216/#4221) 
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-22 15:26:38 +08:00
API Changelog Bot
efa63eca69 文档(order/admin): 订单详情联系房务在线态结论修正(#4223)——作废前版「去掉在线态」,改后端补真实presence+claimerId 
- 上一版误判产品意图(让前端删在线态)作废
- 规格(wx):抢单后真实在线/离线,抢单前房务专员显示「未知」
- 后端补:SSE presence(Redis+TTL)+chat peerOnline+订单详情claimerId
- 正式联调字段等上线测试服验证后更新版
 2026-06-22 15:13:32 +08:00
API Changelog Bot
fd965deb4f docs(changelog): #4220 补内部留言结构化语句只读卡片(wx 确认格式) — 前端展示不动聊天 2026-06-22 15:12:20 +08:00
yaosutu
60350ddecf 推 changelog：订单财务明细查询（优惠/增项清单）接口说明 — #4205 变更预览历史数据源用法 2026-06-22 14:58:50 +08:00
API Changelog Bot
70f9e64dcb docs(changelog): #4220 配房需求回显修复 — 段×候选结构+晚数dayNumber+候选≠分住(后端已修+前端待改) 2026-06-22 14:56:03 +08:00
API Changelog Bot
b52da8dd2f 文档(order/admin): 订单详情「联系房务」面板在线态+房务专员为前端假数据核实(前端BUG) 
- 在线绿点=前端写死(后端无在线态来源,HouseStaffQueryReqVO.online注释明写不生效;聊天VO无online字段;SSE连接表不对外)
- 房务专员=抢单人,抢单前claimer为空属占位
- 反向定制师→联系房务真对接缺claimerId(订单详情仅暴露claimerName),需要时后端补
 2026-06-22 14:53:23 +08:00
yaosutu
cbad66ecc7 文档(aftersale+order/admin): 管理后台——售后工单机审auditStatus(#4196 PR#4203)+订单售后中展示aftersaleStatus(#4197 PR#4208) 2026-06-22 14:25:34 +08:00
yaosutu
0e9a44568f feat: 订单增减项改造 changelog（Issue #4205，PR #4207） 
新增统一端点 POST /v3/admin/order/{orderId}/adjustment + 字典化项目名 + 出参增 itemCode/itemName
 2026-06-22 12:40:39 +08:00
API Changelog Bot
2c00668800 docs(admin): 房务月度对账 月度环比+PDF导出 + 缺口答复 (PR #4202) 2026-06-22 11:39:01 +08:00
API Changelog Bot
26ff684c82 docs(admin): 配房移除多家庭团familyIndex字段 (PR #4193) 2026-06-22 10:53:40 +08:00
API Changelog Bot
b1d70a9020 docs(changelog): order-v3 每日审查修正 发票金额String序列化(admin)+售后mp归属校验(mp) 2026-06-22 01:25:05 +08:00