4.4 KiB
OHIP现有接口调用适配CP2-A交接
2026-09-15,Implemented / Local HTTP Verified。用户明确技术问题由开发自主处理,产品不确定项再询问。本阶段CR。
实际交付
新增integrations.ohip.edge下5个生产类:OhipEdgeOperation固定13个已发布操作;OhipEdgeCall显式单步输入和确认引用;OhipEdgeCallResult内部证据;OhipEdgeProtocolConverter协议转换;OhipEdgeHttpAdapter单次HTTP发送。
支持预订/Block搜索、详情、校验、Block房量读取、档案搜索/详情,以及postReservation/putReservation/postBlock/putBlock四项已有写入。没有泛化代理或未发布的房量/附件接口。
实际运行主线尚未引用这些类,没有Spring注册、Controller、worker、数据库绑定、凭据加载或服务重启。构造器必须显式提供HTTPS地址、预期酒店和凭据供应者;本次只在127.0.0.1合成服务上调用。CP1草稿没有自动转换为可执行调用,原工作台确认与本地记录保持。
源码核对解决的疑问
平台仓库https://git.nianxx.cn/brother7/edge-service-oracle-ohip,固定提交b5e1a30650c66dc2bdea7e42d6d7d84a16d5382f。源码没有房量/附件操作实现,也没有FIT TA recorder特殊转换。
hotel_confirmation_id是调用方提供并由平台记录/纳入摘要的确认引用,没有独立签发流程。未来调用方应绑定真实持久确认版本;本阶段只接收显式上下文。- 读取返回
operation_id/hotel_id/oracle_request_id/data;写入返回ConfirmedWriteResult,其resource为上述读取文档。CLI的ok/status外层不是业务REST协议。 - 平台verified只表示调用getReservation/getBlock成功,没有比较最终字段。客户端返回
WRITE_READBACK_AVAILABLE,businessComplete()始终false。 - unknown不能当未写入;
write_verification_pending明确表示写入完成而查询待完成;审计收尾也可能在写入后返回503。稳定错误码按此分别处理。
完整取证在父工作区源码结论;没有修改、推送或发布平台代码。
关键技术行为
调用只允许固定路径、已核实查询名及编码后的单个资源ID。写入正文根符合四项创建/修改结构,一次仅一个业务对象;更新正文ID与路径ID、正文酒店和确认酒店与配置必须一致。确认外层保留case/task/真实确认引用/调用方稳定幂等键,客户端不生成新键。请求正文限制2MiB,Note等JSON字符串保持原值。
HTTPS、禁止重定向、响应18MiB上限、55秒总网络等待(含响应正文);每次call单次发送,无应用层自动重试,正文禁止二次订阅。显式调用同一次请求可重放,沿用相同正文和幂等键。结果未知时如何恢复由后续持久执行层决定,客户端不自行重放。
回执区分未发送、读取可用、写入后读回可用、写入后查询待完成、处理中、幂等冲突、明确拒绝、写入未知及读取失败。安全代码/关联标识和接收时间可供后续诊断;原生正文仅内部保留供业务核验,不放入toString或错误提示。错误message不透出,错酒店/操作/更新资源ID、缺字段、CLI外层或畸形成功响应均不被当成成功。
验证结果与限制
36项新增测试通过;完整后端verify成功,合计1,431项:1,415通过、16条件跳过、0失败/错误。原CP1的17项测试保持通过。测试覆盖四项写入、9项读取/校验、13种错误组合、固定路由与独立catalog切片、跨酒店/对象拒绝、Note原文、重放正文稳定、断连不重发、重定向、正文慢响应与大小限制、凭据提供失败及单次订阅。
没有使用真实凭据、Oracle、Agent或外部PostgreSQL条件烟测。新测试使用localhost合成HTTP,并不证明Oracle字段或真实酒店行为已验证。凭据供应者尚未接实际私密配置;最终字段/房量/附件核验、实际对象匹配、确认快照持久读取和执行恢复均待后续阶段。
下一步继续处理平台房量和附件链路、FIT TA写入证据,再接持久执行和员工回显。固定GC/TEN/BTQR、最终人工参数、Note原文、附件替换和加床排除规则保持,不需要用户重复解释技术参数。