shiyuyun/Wyndham-RSVN-0918
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
Wyndham-RSVN-0918/docs/project/integrations/ohip-no-ta-local-test-20260918.md
鲨鱼辣椒 bc71026246
Some checks failed
verify / booking-verify (push) Has been cancelled
Details
完善酒店接口确认字段与回读核对并同步工作台最新改动
2026-09-18 15:38:52 +08:00

6.3 KiB
Raw Permalink Blame History

无 TA 版本：本机测试交付

新版本已交付：FIT NEW条件TA接入。本页及原无TA包是历史版本；新包在 .planning/fit-new-ta-20260918/release/，特殊类型到沙箱页面对应尚待验证。

后续规则已变更：用户现要求 GROUP NEW不传TA；FIT NEW有Tour Code时传入TA Record Locator、无则不传。见新CR。本文及包体记录的是此前无TA版本，尚未实现新要求中的FIT有值写入，不应据此验收该项。

2026-09-18。代码及独立模拟已完成；现有工作台尚未更新。下一步由用户更新测试服务，再上传邮件测试。 平台接口连接的就是沙箱；本轮没有要求重新确认环境，也没有操作平台沙箱业务。

本次完成

流程 现在如何调用与定位
GROUP 新建/修改 保留 Block Name、日期、账户联系人、已约定默认值及逐晚房量；GROUP 修改继续只改日期/房量。按 Block Name 定位后核对 Block ID/酒店。
FIT 新建 客档创建/查询、预订创建/查询已接；保存实际 Oracle 预订编号。
FIT 修改 从同酒店、同本地预订范围、同环境的最近成功办理结果取得完整编号，再逐笔调用 getReservation/putReservation；支持既定的房型新增/合并。
源 Allotment 取消 关联预订及下一状态检查、Block 取消、状态回查。
FIT→GROUP、GROUP→FIT 校验最终新建参数、取消原对象并核实，再创建新类型；使用上述保存编号定位 FIT。

GROUP/FIT 均不发送、清空、按 TA 搜索或要求核验 TA；没有改用其他参考号/备注替代。邮件及本地 Tour Code、GROUP Block Name 保留。酒店附件上传保持取消。Source Code 的 TA 是另一业务代码，正常保留。

没有新增需要平台封装的接口。正式接入工厂也已更新，但它仍使用受信的酒店/档案/取消配置和已有权限，测试代码不会自动替平台赋权。

模拟参数与结果

已造好 10 个房型、21 个 Rate Code、两组账户/联系人、Guest、Market/Source/Reservation Type/Payment/Currency、Initial/Actual 房量、状态和独立取消原因。GRPA3=BUALUANG、GRPA4=LEELA，均含早。参数文件是合成数据，不包含酒店真实档案 ID。

  • 47 个参数场景符合预期：45 个完成，2 个因不能暗中取消多余 FIT 而零写入拒绝。
  • 3 类取消故障符合预期，取消结果未知时不会重复发送。
  • 1,034 条调用摘要没有 TA 请求字段、没有附件操作。
  • 后端完整回归 2,706 项：2,689 通过、17 条件跳过、0 失败/错误；前端相关 41 项、类型检查、模拟器 67 项通过。
  • 已确认 GROUP 修改保留酒店既有 TA；旧 TA 检查点不能静默续办。

最终合成验收位于 .planning/no-ta-20260918/acceptance-6/；acceptance-result.json、summary.json、parameters/results.json、faults/results.json 和调用目录可复核。临时服务已停止，临时连接文件已删除。模拟对象存在于这次独立验收的保存状态，没有导入当前工作台或平台沙箱。

用户接下来操作

  1. 先更新测试后端。 本机交付目录为 .planning/no-ta-20260918/release/。使用平台沙箱接口的正常运行配置，选 th-hotel-server-0.0.1-SNAPSHOT.jar；目前旧 CP33 本机模拟装配，选 th-hotel-local-simulation.jar。不要把本机模拟包用于平台沙箱配置。
  2. 沿用相应启动配置，由用户替换程序路径并重启。 本机原配置是 /Users/chillishark/Library/LaunchAgents/com.chillishark.th-hotel-simple.backend-8082.plist；其中旧包路径是 server/var/local-replay/runtime/ohip-cp33-hotel-catalog-20260917/th-hotel-local-simulation.jar。新本机包绝对路径为 /Users/chillishark/Wyndham-RSVN0804/Wyndham-RSVN-0908/.planning/no-ta-20260918/release/th-hotel-local-simulation.jar。本轮未修改该配置或原包。数据库、凭据及环境文件沿用原配置；不要以合成文件覆盖真实或既有档案配置。
  3. 若继续使用旧 CP33 本机模拟酒店，还需同步模拟服务。 原实例未加载取消/严格参数模拟的本轮版本；仅换后端包不足以验收全部流程。模拟代码、目录和独立启动说明位于 server/src/test/local-fit-simulation/README.md，严格参数入口是 check_parameters.py，目录是 catalog.example.json。它会启动完整独立链并在结束后停止；这不是当前工作台数据导入工具。当前工作台与新模拟实例绑定、目录/数据同步仍须由用户操作，不能把新空酒店直接搭配旧 FIT 编号使用。
  4. 刷新页面，先测试全新 GROUP 和 FIT。 确认成功后再测同笔修改；另建测试笔测 Allotment 取消及双向转换。首次使用新的 Tour Code，避免重复 NEW。查看“确认值、实际调用、酒店查询结果”是否一致。
  5. 上传 EML/XML、员工确认和沙箱操作均由用户执行。 原失败任务不要直接续办来测试新规则；旧检查点会因范围版本变化而拒绝。此轮没有上传文件，也没有点击原任务确认/继续。

交付目录的 manifest.json 保存包体及目录 SHA-256；普通包不含本机模拟装配。前端源代码已改并通过检查，现有开发页面刷新加载；若使用静态发布页面，则沿用原前端构建发布步骤。

本期限制

  • 在 Oracle 手工创建、且本系统没有保存完整编号的旧 FIT，不能自动修改/取消/转换。 暂停 TA 后不按姓名或备注猜匹配；也不开放随意填写编号的入口。先通过本系统成功新建的测试笔可验证后续流程。
  • 同一范围最近一次办理失败、未完成或历史有歧义时，会停止，不跳过后选择更早成功记录。
  • 原有多笔 FIT 不能通过减房隐式取消其中一笔；此情况仍提示人工处理。
  • 极长 Note 的聚合显示超出原有 16,000 字符证据上限时，整单不会标为完全核验成功；没有借本次 TA 收尾放宽此界限。
  • 本轮证明消费端参数接入和独立模拟结果，未代做现有页面邮件全链或平台沙箱业务验收。

完整开发证据见 证据记录。