31 次代码提交

此分支

此分支

所有分支

作者	SHA1	备注	提交日期
jw	953d953bdc	docs(changelog): #7455 团期十五个 admin 端点补判权（写口 manage / 详情名单 view / 列表看板 list）	2026-09-10 17:56:28 +08:00
jw	c95ab182dc	docs(changelog): #7378 团期行程逐日汇总与逐户下钻（GB-ADM-018/019，新增接口）	2026-09-09 17:57:34 +08:00
jw和Claude Opus 5	2b45ee9d44	docs(changelog): 团期人员配置 staffList 必填 + 备品候选关键字转义 + 加备品行改定点查（#7377） ... 收口 2026-09-03 团期人员/备品合并后审计的余项（F-03/F-05/F-06/F-07），随 PR #7028 合入 dev-v3。 两处对外行为变更需前端注意： - PUT /v3/admin/group-batch/:productBatchId/staff 的 staffList 改为必填， 字段缺失或名字写错一律 400；改前会被当成「传空=清空」，静音软删整团配置还返 200。 「显式传 [] 即清空」这条语义不变。 - 备品候选列表的 keyword 转义 LIKE 通配符，搜 % 或 _ 由「返回全库」变为「零结果」。 第三处对调用方透明：加备品行改走资源域新增的定点查，解除「备品库超 500 条后 第 501 条起加不进」的隐性上限，契约与错误码不变。 后端已部署 TEST 并经真实网关逐条实测；order-v3 全量 9303 例、resource 全量 2707 例 0 失败。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-09 16:25:30 +08:00
jw和Claude Opus 5	b22e67ca69	docs(changelog): #7304 团期时间线只读端点 GB-ADM-096（新增接口，面向 mmg） ... group_batch_status_log 此前只写不可读：十余条链路持续写入，全仓零生产读回方， 运营在页面上一条也看不到——#7283 那条「同步失败靠时间线让运营看见并手动去产品 后台取消班期」的唯一可见兜底入口因此实际不可见。 新增 GET /v3/admin/order/group-batch/:groupBatchId/status-logs：按 changedAt 升序 全量返回，extra 由 JSON 字符串解析成结构化对象，事件类型与前后状态的中文名由后端 给出（前端不必自建映射表），权限同码 group-batch:view。 backend_status=deployed / gateway_status=verified：已部署 TEST 并经真实网关逐条 取证 AC-1~AC-6，含读回 #7283 的 BATCH_PRODUCT_CANCEL_FAILED 兜底留痕。 frontend_status=pending（mmg 待接团期详情的「操作记录/时间线」区块）。 Refs HL#7304 (PR #7359, 合并提交 0b85f6831) Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-09 13:45:07 +08:00
jw和Claude Opus 5	b22345d167	docs(changelog): #7294 补充 actualRefundAmount 的暂定值/定稿值口径（PR #7354） ... 退款单在流团事务【提交之后】才建（异步），所以 approve 响应体里的 actualRefundAmount 是暂定值＝退款诉求合计；随后服务端逐户回读实际建单结果， 把没建出退款单的户剔掉，改写成定稿值。要展示准确金额请重新拉一次详情。 本文原本已写「actualRefundAmount 只统计成功发起退款的户」，PR #7354 之前 实现其实是 Σ诉求、有户建单失败就对不上；现在实现与本文口径一致了。 顺带修两处当前校验器不再接受的 frontmatter： consumer hl-ui → admin；not_required 不得保留 frontend_owner / verified_at。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-08 18:58:20 +08:00
jw和Claude Opus 5	9c1290d1c7	docs(changelog): #7344 取消班期活跃订单判据 fail-closed（聚合失败取保守侧 CANCELLING，出入参零变化） ... 管理端取消班期在判「班期还有没有活跃订单」时用的是 fail-open 取数：order-v3 实时聚合一失败就退化为「无活跃订单」，班期被落成终态 CANCELLED 且全仓无路径 可自愈。改为聚合失败取保守侧 CANCELLING + WARN，与订单域内部入口口径对齐。 接口 / 字段 / 路径 / 参数 / 枚举 / 错误码零变化，batchStatus 取值集合与语义 不变，CANCELLING 与 CANCELLED 在下游四处判定中等价 → frontend_status=not_required。 backend_status=deployed / gateway_status=verified：已部署测试服，经真实网关实测 三条路径（无订单→CANCELLED、真实下单→CANCELLING、注入聚合失败→CANCELLING+WARN）， 落库均以 SQL 复核。 Refs HL#7344 (PR #7348, 合并提交 2071286a1) Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01R2LSgt2xhmX2ae9M3rkdZg	2026-09-08 17:24:56 +08:00
jw	e22dbe465c	docs(changelog): #7284 / #7287 / #7294 团期三单交接 mmg（均已部署测试服并实测） ... - #7284 团期下单校验改判实时库存：满员班期退单后能重新下单；满员时错误码由 581028 改为 581031 / 581034；产品域库存聚合失败改 fail-closed（下单返 581027，展示链路不变）。 前端待办：若对 581028 有特殊文案需改判；接口结构零变化。 - #7287 团期达门槛自动成团 + 未成团动作闸：新增自动成团定时任务（落地即暂停，需运营开启）； 团期详情新增 formingRooms / formingPeople / thresholdSource 且两个门槛改取实时值； 班期表单与批量创建新增 minParticipants；未成团 / 未建团的资源动作拒 589552 / 589553。 前端三项待办：成团弹窗「已售」改读 formingRooms、班期表单加最低成团人数、补录两个错误码。 - #7294 流团对已付款户也取消并发起退款：审批单「实退金额」不再恒为 0，改为「已发起退款金额」； 新增 589554「团期下有出行中的子订单，不可流团」，发起与批复两个入口都会返。 前端待办：补录 589554，并把「实退金额」文案改为「已发起退款金额」。 三份均按 v2 模板逐接口八子节撰写，本地校验器 PASS。	2026-09-08 16:47:02 +08:00
jw	d795a2f0bb	docs(changelog): #7159 补齐 581034 网关端到端实测证据，作废「未实跑」旧记录 ... #7135/#7159 同 PR #7169 交付，本文档是 #7159 的口径落点。2026-09-06 记录的 「581034 线上端到端未实跑」已于 2026-09-07 09:2x 由网关实测补齐（12-01 期 maxParticipants 改 3 → adultCount=4 返 581034、=2 返 200 建单后取消复原）， 原文表述已作废。同时补 Issue #7159 反链，并按前端交付实况回填 target_release。	2026-09-08 16:29:47 +08:00
jw和Claude Opus 4.8	c276b2790c	docs(changelog): 补 #7023 团期物资阶段门（验收补做时发现缺 changelog） ... #7023 三端点新增阶段门（非 MATERIAL_PREPARING 返 589520）+ 合同保险前置门， 属接口行为变更但原工单未列 changelog。走验收标准时补上。 已合入 dev-v3；2026-09-07 TEST 网关实测非物资准备态 POST supplies 返 589520。 纯服务端拒绝，前端按错误码提示（frontend not_required）。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-09-07 16:43:53 +08:00
jw和Claude Opus 4.8	133955c190	docs(changelog): #7234 敏感读取判权统一到 token 当前角色（车务明文+供应商域） ... 契约不变，仅拒绝口径与审计语义：判权依据由库默认角色改为本次请求 token 当前角色（X-Admin-Role）， 撤权最迟 10 分钟生效。TEST 网关实测通过（AC-10/11/12），PR #7272 已合 dev-v3。 backend_status=deployed / gateway_status=verified。 Refs #7234 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-09-07 16:27:38 +08:00
jw和Claude Opus 4.8	15d63f0ba2	docs(changelog): #7095 #7080 TEST 网关实测通过，回写 deployed ... 两单 2026-09-07 部署 dev-v3 到测试服并过网关实测： - #7095 团期转订单：候选查询、成功转期（计数守恒 2/1→0/0 与 0/0→2/1、金额重算、 订单归属改到目标期、订单侧 GROUP_BATCH_TRANSFER timeline）、容量守卫拒绝路径全过。 含后续修复 #7270（订单 timeline 漏实现）、#7278（容量 0=不限口径，网关实测暴露）。 - #7080 团期配人扇出：第7期55户配导游后 guide 芯片 TODO(0/55)→DONE(55/55)， 清空后回落 TODO(0)——改前扇出不同步订单侧状态、芯片恒 TODO，此为修复直接证据。 backend_status pending→deployed，gateway_status→verified，verified_at 2026-09-07。 文件名日前缀按推送日改为 07。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>	2026-09-07 15:49:31 +08:00
jw和Claude Opus 4.8	699fc4c04e	docs(changelog): #7263 大期数团期产品库存字段静默降级修复（修复，前端无需改动） ... 分片下沉 product-v2 GroupBatchStockHelper，≥约260期 GROUP 产品的库存/已报名/ 有效订单数/展示态由静默错值恢复准确；无接口/字段/路径/参数/枚举/错误码变化。 后端 PR #7268 squash f1eb72444 合入 dev-v3，测试服 313 期 AC-1~AC-13 实测通过。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T5raGi2iBzrbDwiENbpWY2	2026-09-07 15:13:58 +08:00
jw和Claude Opus 5	347d5ec664	docs(changelog): 团期合同保险面板与逐户出具 #7105 ... 新增面板读、手动开、作废重开、批量催签四个端点。 如实标注三条： 1. 出具依赖房/车/导/摄四项 ready，而 hotel_ready 线上无任何写入方（#4132）， 故面板 issuable 恒 false、三个写动作恒返 589548 —— 前端可先接， 但 #4132 落地前看不到出具效果；面板读与催签不受限制，已实测可用。 2. 出具成功的正向路径未在网关侧实测（该状态在 TEST 造不出来）， 仅单测覆盖；589549 同样未在真实环境命中。 3. 上线必须先部署 hl-user-service 再部署 order-v3，否则写动作全返 589507。 门的口径以 #7248/PR#7249 修正后为准（判四项 ready，不判团期状态）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-07 14:34:51 +08:00
jw和Claude Opus 5	0f2c589874	docs(changelog): 前端待办汇总第 5 项解除依赖——#7250 changelog 已发布 ... 完成 #7250 AC-9 后半句：把第 5 项芯片计数 tooltip 的依赖指向本单 changelog， 并更新为「依赖已解除，可开工」。 两处过时表述： - status_note 原写「其 changelog 已写好但待测试服实测后才发布,故本条仍挂起」 - 第 5 项正文原写「后端 #7250 的 changelog 发布后再做…该篇待测试服实测后发布」 现均改为已发布：07_7250_* 于 2026-09-07 通过测试服 AC-1~AC-9 实测后推送 (commit 16e0133)，PR #7254 已合入 dev-v3 (47c9a6d29)。 注：本次提交同时带入该文件此前未提交的两行改动（指向 #7250 文件名、 status_note 补 PR #7254 说明），二者与本次更新是同一件事的前后半段， 分开提交会留下自相矛盾的中间态。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-07 12:54:16 +08:00
jw和Claude Opus 5	16e0133257	docs(changelog): #7250 团期看板芯片透出 chipStats 计数 — 实测通过，解除挂起 ... PR #7254 合入 dev-v3（47c9a6d29）后，草稿的 status_note 写明「待部署测试服 并过网关实测后改 deployed 再推送」。2026-09-07 已部署 dev-v3 到测试服并逐条 走完 AC-1~AC-9，故回写 backend_status=deployed / gateway_status=verified / verified_at=2026-09-07 并推送。 网关实测要点： - chipStats 六项与 chips/{chip} 明细端点的 totalCount/doneCount 逐一相等 - error 计数与明细 items 里失败态户数相等（vehicle 芯片：55 户中 1 户 REJECTED_TO_CONSULTANT，chipStats.vehicle.error=1） - 跨 6 个产品 55 行普通聚合分支满足「error>0 当且仅当 chips=ERROR」，违例 0 - 54 个零户行计数全零，未建团行 chips 仍为 TODO（本单不统一零户状态） - board / 详情 / export / chips 明细四个接口均不含 chipStats，无回归 - VO 纯新增 58 行零删除；Service 层无查询增减，aggregateAll 仍单次调用 AC-6d 原缺 listPage_notFormedRow_chipStatsAllZero（只有 zeroOrderRow 那条， 覆盖的是命中行不是未建团行），已由 PR #7258 补齐（6d3b38de7）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-07 12:17:38 +08:00
jw和Claude Opus 5	3b2883d1d3	docs(changelog): #7245 团期看板班期名去空格 + 不限容量 remain 统一 null + board 库存同源 ... 三个读端点（GB-ADM-001 分页 / board / GB-ADM-002 详情）的响应值修正， 路径、入参、响应结构均未变。 关键变化：remainRooms 与 remainParticipants 为 null 表示「不限」，前端 不要按 === 0 判满员。改前容量为 0 时返 0，而同列表未建团行返 null， 两类行语义打架，运营会看到「剩余 0 人」误判满员。 另两处：batchName 由服务端去前后空白（产品侧存量脏值经合并层实时透出， 存量列不自愈）；board 未建团行已用房数改取产品侧 occupiedRooms（含线下 占位），与分页及 product schedule/list 同源——改前容量 8/占位 3/线上 0 时 board 回「剩 8」而实际剩 5。 2026-09-07 测试环境网关实测 AC-1/2/4/4b/5/6 全部通过；本地全量 8728 例 0 failures。backend_status=deployed / gateway_status=verified。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-07 11:57:10 +08:00
jw和Claude Opus 5	da07ac2ebf	docs(changelog): 团期流团改为申请与审批 #7196 ... 发起流团端点语义变更（立即执行 → 提交申请，理由改必填，新增权限与阶段限制）， 新增审批中心列表 / 申请详情 / 同意 / 拒绝 4 个端点。 后端已部署 TEST 并实测 R1-R10 全过；前端待接。 如实记录三条限制：批准后无客户通知、抄送定制师只记录不推送、 已付款户流团不会被取消/退款（存量问题，本单未修，另行排期）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-07 10:14:31 +08:00
jw和Claude Opus 5	41f3f69500	docs(changelog): #7060 成团驱动子订单流程推进，打通定制师配房配车待办 ... POST /v3/admin/order/group-batch/:groupBatchId/group 新增副作用：成团时把 该团活跃子订单从 AWAITING_PROFILE 推进到 RESOURCE_PREPARING，由既有 syncFlowTodos 产生配房/配车待办派给定制师。 接口路径、入参、出参均未变，前端无需改动；变化在服务端副作用。 调用方若缓存过子订单状态需刷新。 边界：只从 AWAITING_PROFILE 推进，AWAITING_PAY 不越过支付闸门；重复成团 幂等（CAS）；待办派发走独立事务，失败不回滚成团。 2026-09-06 测试环境造数补验，6 组用例通过。核心两条在真实数据上确证： 成团后子订单 flowStatus 由 AWAITING_PROFILE 变为 RESOURCE_PREPARING； 另一单成团时为 AWAITING_PAY，成团后未被推进。 backend_status=deployed / gateway_status=verified。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-06 16:41:24 +08:00
jw和Claude Opus 5	70c1f44650	新增团期调整满团名额同步产品域库存接口说明（#7178） ... 修的是「调了不生效」：调名额此前只写订单域，而库存权威在产品域， 导致加名额放不出空位、减名额停不了售，但看板数字会变。 请求体不兼容变更：{maxParticipants,maxRooms} 两个绝对值 → {capacityDelta,reason} 净增量且只调户数；新增阶段门（仅招募中、 资源准备中可调）与 group-batch:manage 权限校验；响应改为返回 调整前后值、已报名与余量。 后端已部署 TEST 并实测：加减名额驱动满团即停/放开继续招募、 低于已报名拒绝且零写入、物料准备起阶段门、已成团加名额仍保持成团。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-06 16:21:40 +08:00
jw和Claude Opus 5	a7c44c0caa	docs(changelog): 团期财务总览与预支复用订单预支（#7154 / PR #7170） ... Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-06 16:20:04 +08:00
jw和Claude Opus 5	62c52b8024	新增团期手动成团门槛与提前成团留痕接口说明（#7158） ... 成团接口新增可选请求体 formedNote、新增 group-batch:manage 权限校验、 重复成团改为语义化 589537；团期详情与产品班期两侧新增最低成团户数 minToForm。 后端已部署 TEST 并实测：带理由成团成功、重复成团 589537、 不传 body 兼容路径均通过；网关链路已验证。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-06 14:56:28 +08:00
jw和Claude Opus 5	be5afcf30a	团期退单户改为「提交申请 + 管理员审批」，070 破坏性变更 + 072~075 新增（#7100） ... 070 由「调用即退款」改为「只建待审申请单」，响应体 Result<Void> → 对象； 新增审批列表/详情/通过/取消退单四个端点，审批限 ADMIN/SUPER_ADMIN 角色。 金额口径写明两个数（已付 / 预计退）：早期阶段退的是订金应付额、与已付无关， 后期阶段以已付额按退改政策扣减——这条是 TEST 实测暴露 #7126 缺陷后更正的说法。 已过网关真测（2026-09-05）：19 项含提交/驳回后该户仍在团里/再次提交/通过后名额回落， 预估与实退一致；验证产生的两张退款单已作废，测试环境资金零变动。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-05 08:18:03 +08:00
jw	a611948477	团期人员配置位成员改由字典决定，取值域三处对齐（#7079） ... PR #7085 合入 dev-v3（合并提交 d1b724d59），2026-09-04 部署测试环境 并经真实网关鉴权实测 7 条用例。 核心证据：15:30:33 往 group_batch_staff_slot_guide 插一行 GUIDE_ASSISTANT， 15:35:44（301 秒后）导游位候选由 7 人变 8 人——未改代码、未重启、未重新部署。 随后连打 8 次全部返回 8 人，两个实例都已回源。演示行验证后已撤除。 2 个接口的候选池来源与落库取值变更，路径/入参/出参结构全部不变： - GET /v3/admin/group-batch/:groupBatchId/staff/candidates 候选池成员由字典决定，582113 文案变更 - PUT /v3/admin/group-batch/:groupBatchId/staff staffRole 落真实 staffType 含字典初始化脚本 sql/dict_group_batch_staff_slot.sql（幂等，需手工执行）。 dict_type_id 取 8071/8072——8021/8022 在本机与测试环境都已被 contract_status / contract_platform 占用。 staff_role 取值域测试环境实测三处一致（字典 = 枚举 = @Pattern，8 项）。 frontend_status=not_required：路径、入参、出参结构均未变，前端无需改动； 但不要再硬编码候选池成员，也不要沿用自己提交的 staffRole 回显。	2026-09-04 15:37:23 +08:00
jw和Claude Opus 5	db6698061b	docs(changelog): #7066 团期子订单列表补应收总额 totalAmount ... GET /v3/admin/order/group-batch/:groupBatchId/orders 出参新增 totalAmount 应收总额，口径复用既有 OrderAmountUtil.payableForDisplay（取消单归 0）， 与 calcBalance 口径一致。纯 additive，不新建端点、不改老字段语义。 关键变化：前端不要再用 paidAmount + balanceAmount 反推应收总额。 balanceAmount 被钳在 ≥0，超付/退款/取消单三种情况反推值都偏大。 2026-09-04 于测试环境网关实测 8 组用例全部通过，两处在真实数据上 命中本单要修的缺陷： - 超付单 totalAmount=2943.00，旧反推得 3270.00，偏差 327.00 - 取消单 totalAmount=0.00 而 paidAmount=3270.00，旧算法会把已取消 子订单显示成有应收 backend_status=deployed / gateway_status=verified。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-04 15:01:20 +08:00
jw	2096a47340	团期导游位下游按配置位归组，GUIDE 与 LEADER 一视同仁（#7063） ... PR #7065 合入 dev-v3（合并提交 f37b6ee0f），2026-09-04 部署测试环境 并经真实网关鉴权实测 AC-2/AC-3/AC-4/AC-5/AC-9。 4 个接口的副作用与取值口径变更，路径/入参/出参结构全部不变： - PUT /v3/admin/group-batch/:groupBatchId/staff 导游位配 GUIDE 也置 guide_ready - POST /v3/admin/order/:id/staff GUIDE 也写 guide_status 与 GUIDE_DONE - DELETE /v3/admin/order/:id/staff/:staffAssignmentId 按导游位整组计数，不再误置空 - GET /v3/admin/order/:id/print-itinerary 导游栏 GUIDE 优先、缺位回退 LEADER 顺带修一处更深的缺陷：ready 回填此前用产品侧 batchId 打 order_group_batch 主键， rows=0 只 WARN 不抛，改前不论配 GUIDE 还是 LEADER，guide_ready 从未被置位过。 frontend_status=not_required：路径、入参、出参结构均未变，前端无需改动。	2026-09-04 14:25:48 +08:00
jw和Claude Opus 5	828d9ae2e4	docs(changelog): #6986 团期物资从备品库选择 + suppliesName 二选一校验 ... 新增 GET /v3/admin/order/group-batch/:groupBatchId/supplies/candidates， 从资源域备品库拉候选并标记本团期已加入项；资源域新增内部接口 GET /internal/supplies/list-available，两个服务需同时部署。 记录本次行为变更：POST .../supplies 的 suppliesName 由 @NotBlank 改为与 suppliesResourceId 二选一，传 resourceId 时名称从库取并覆盖入参。 新增错误码 589518 备品库查询失败、589519 所选备品不存在或已下架。 2026-09-03 于测试环境网关实测 10 条正负向用例全部通过， 写入用例已删除还原；backend_status=deployed / gateway_status=verified。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-03 15:22:10 +08:00
jw和Claude Opus 5	d2c39b6c24	docs(changelog): #6950 团期人员配置候选列表新增接口 + staffRole 白名单校验 ... 新增 GET /v3/admin/group-batch/:groupBatchId/staff/candidates，导游位并收 GUIDE/LEADER 并按 staffId 去重，摄影位只收 PHOTOGRAPHER，其余位返 582113。 同时记录本次行为变更：PUT .../staff 的 staffList[].staffRole 新增 @Pattern 白名单校验，越界值由原先原样入库改为返回 400。 2026-09-03 于测试环境网关实测 10 条正负向用例全部通过， backend_status=deployed / gateway_status=verified。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>	2026-09-03 14:57:42 +08:00
jw	26c23c5b7e	docs: 标记 #5407 后端已合并	2026-08-01 16:43:15 +08:00
jw	96a73275ca	docs: 景区列表移除 deinfo（#5407）	2026-08-01 16:42:34 +08:00
jw	1d5e0efb43	docs: 回写景区 deinfo 后端合并状态 (#5405)	2026-08-01 16:27:53 +08:00
jw	dce6e0f77b	docs: 交接景区列表 deinfo 契约 (#5405)	2026-08-01 16:26:49 +08:00