5.2 KiB
5.2 KiB
已发布接口接入与取消酒店附件:交付说明
日期:2026-09-17。当前完成的是本地代码和隔离测试;原工作台运行环境没有更新,未操作真实酒店。
本轮结果
| 项目 | 当前结论 |
|---|---|
| 平台缺口清单 | 已取得 0.11.0/184 项目录及完整 OpenAPI,5 个核心、3 个建议只读均已发布,无需重复封装。 |
| 下一 Block 状态 | 消费端改用 GET /api/v1/blocks/next-status,传 currentStatus,无需 Block ID;支持 includeCateringStatus。 |
| FIT 取消 | POST /api/v1/reservations/{reservationID}/cancellations 按原生 201 处理。 |
| 房量写入回查 | 接受平台 pages/query/pagination_complete 格式;分页完整不等于房量正确,仍独立查询并逐晚、逐房型核对。 |
| 已写入、待核验 | 原生 200/201 且 pending_verification 保留资源编号与原调用身份,保存为 ACCEPTED,不能算整单成功、不能重发。当前不会仅凭另一次数值相同的 GET 自动提升为完成;异常仍需核查。 |
| 酒店附件 | GROUP/FIT 新建和修改不要求 Excel、附件权限、linkType;不读酒店附件清单、不上传、不替换、不删除,也不生成附件执行步骤或完成条件。 |
| 邮件原件 | 来源邮件 Excel 解析、查看下载保留。历史酒店附件调用事实仍在审计中;没有删除任何历史酒店文件。 |
| FIT Note | 继续按原 Note ID 与历史写入来源核对,保留无关 Note;取消附件不放宽备注归属检查。 |
| 模拟工具 | 下一状态路径和取消 201 已同步;当前模拟装配去掉附件依赖,Java fixture 和临时 Go 副本编译通过。没有启动模拟服务。 |
参数规则保持:GROUP Block Name=Tour Code;GROUP/FIT TA Record Locator=Tour Code。无 Tour 时不提交 TA 字段。GRPA3 对应 BUALUANG、GRPA4 对应 LEELA,均含早餐,不再重复询问。
尚未关闭的项
- FIT TA Record Locator 的真实写入和详情回查字段。RSV 搜索有
taRecordLocatorList;公开 schema、官方样例仍未建立对应写读路径。Oracle 26.3 Business Events 的TaRecordLocator是事件字段,不能直接当 REST 请求字段。真实 FIT 入口继续拦截;模拟字段只用于本机测试。 - 真实环境接线和验收。没有验证本项目应用授权、真实酒店写入与回查。公开目录访问曾成功,但连接仍间歇超时且
/readyz返回过 503。目录发布不等于酒店业务已办成。 - 正式取消/类型转换入口。底层取消适配与本机 Change 流程已实现;正常 RuntimeFactory 仍是四类新建/同类型修改入口,尚未装配 Change 路由和真实取消原因/状态策略。不得把本机合成策略带入生产。
- 原工作台与七封 EML。没有加载本轮代码、初始化原测试环境前态或重放邮件。此前 30 个合成前态 + 43 项确认快照矩阵是旧版隔离证据;本轮未重跑该链,不能沿用为无附件新版 EML 全链验收。
3 个建议只读接口(PM 清单、OPERA 设置、Profile 关系)已确认发布,尚未作为新的业务流程调用。PM 查询如后续使用必须 postingmaster=false,避免原生 GET 隐式创建 PM。
下一步由用户操作
按以下顺序验收,不一次混测全部任务:
- 由你或平台同事加载本轮后台代码和本机模拟装配。当前服务没有更新;只刷新网页不会加载后台变化。模拟 Oracle 状态在内存,重建服务不能配合旧办理日志冒充续办;需要独立数据集及与之匹配的工作台记录。
- 在原支持 EML 的工作台,由你上传一封包含 GROUP NEW 的邮件并确认。检查实际 Block 编号、日期、TA、Rate、Breakfast、逐晚房量;接口记录应无附件清单/上传/删除。
- 同团做 GROUP UPDATE,确认日期、TA、完整房量改变,Rate/Note/Account 不被重置。
- 再用模拟 FIT NEW、UPDATE 检查同一 Guest、实际 Reservation 编号、房型房数、Rate、TA 和原 Note;多个房型分别显示实际编号。真实 FIT 暂不执行第 4 步。
- 最后验证取消及类型转换:旧对象取消查询确认后才创建新对象;源 Allotment 有关联客人或查询不完整时应停下。故障恢复由你点击原任务的继续处理,检查已成功的创建/修改没有重复。
旧版含 SAVE_ATTACHMENTS 步骤或旧配置摘要的任务会停止,不能删步骤、改日志后强行续办。先核对已发生的酒店操作与原任务;只有确认未产生重复风险的新测试数据才重新确认。
server/src/test/local-fit-simulation/manage.py 是关闭 EML Agent 的独立合成 FIT 启动器;它可检验模拟链,不能替代七封 EML 的原工作台验收。启动/停止方式见该目录 README。本轮没有替用户执行这些操作。
本地验证
最终结果见本轮证据。所有自动检查使用临时数据库、本地 HTTP 或编译;没有真实酒店调用、运行服务重启、运行数据准备、凭据或权限修改。