47 lines
5.2 KiB
Markdown
47 lines
5.2 KiB
Markdown
# 已发布接口接入与取消酒店附件：交付说明
|
||
|
||
日期：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，均含早餐，不再重复询问。
|
||
|
||
## 尚未关闭的项
|
||
|
||
1. **FIT TA Record Locator 的真实写入和详情回查字段**。RSV 搜索有 `taRecordLocatorList`；公开 schema、官方样例仍未建立对应写读路径。[Oracle 26.3 Business Events](https://docs.oracle.com/en/industries/hospitality/opera-cloud/26.3/ocsuh/t_be_reservation_module.htm) 的 `TaRecordLocator` 是事件字段，不能直接当 REST 请求字段。真实 FIT 入口继续拦截；模拟字段只用于本机测试。
|
||
2. **真实环境接线和验收**。没有验证本项目应用授权、真实酒店写入与回查。公开目录访问曾成功，但连接仍间歇超时且 `/readyz` 返回过 503。目录发布不等于酒店业务已办成。
|
||
3. **正式取消／类型转换入口**。底层取消适配与本机 Change 流程已实现；正常 RuntimeFactory 仍是四类新建/同类型修改入口，尚未装配 Change 路由和真实取消原因/状态策略。不得把本机合成策略带入生产。
|
||
4. **原工作台与七封 EML**。没有加载本轮代码、初始化原测试环境前态或重放邮件。此前 30 个合成前态 + 43 项确认快照矩阵是旧版隔离证据；本轮未重跑该链，不能沿用为无附件新版 EML 全链验收。
|
||
|
||
3 个建议只读接口（PM 清单、OPERA 设置、Profile 关系）已确认发布，尚未作为新的业务流程调用。PM 查询如后续使用必须 `postingmaster=false`，避免原生 GET 隐式创建 PM。
|
||
|
||
## 下一步由用户操作
|
||
|
||
按以下顺序验收，不一次混测全部任务：
|
||
|
||
1. 由你或平台同事加载本轮后台代码和本机模拟装配。当前服务没有更新；只刷新网页不会加载后台变化。模拟 Oracle 状态在内存，重建服务不能配合旧办理日志冒充续办；需要独立数据集及与之匹配的工作台记录。
|
||
2. 在原支持 EML 的工作台，由你上传一封包含 GROUP NEW 的邮件并确认。检查实际 Block 编号、日期、TA、Rate、Breakfast、逐晚房量；接口记录应无附件清单/上传/删除。
|
||
3. 同团做 GROUP UPDATE，确认日期、TA、完整房量改变，Rate/Note/Account 不被重置。
|
||
4. 再用模拟 FIT NEW、UPDATE 检查同一 Guest、实际 Reservation 编号、房型房数、Rate、TA 和原 Note；多个房型分别显示实际编号。真实 FIT 暂不执行第 4 步。
|
||
5. 最后验证取消及类型转换：旧对象取消查询确认后才创建新对象；源 Allotment 有关联客人或查询不完整时应停下。故障恢复由你点击原任务的继续处理，检查已成功的创建/修改没有重复。
|
||
|
||
旧版含 SAVE_ATTACHMENTS 步骤或旧配置摘要的任务会停止，不能删步骤、改日志后强行续办。先核对已发生的酒店操作与原任务；只有确认未产生重复风险的新测试数据才重新确认。
|
||
|
||
`server/src/test/local-fit-simulation/manage.py` 是关闭 EML Agent 的独立合成 FIT 启动器；它可检验模拟链，不能替代七封 EML 的原工作台验收。启动/停止方式见该目录 README。本轮没有替用户执行这些操作。
|
||
|
||
## 本地验证
|
||
|
||
最终结果见[本轮证据](../../../.project-docs/50-evidence/topics/2026-09-17-no-hotel-attachments.md)。所有自动检查使用临时数据库、本地 HTTP 或编译；没有真实酒店调用、运行服务重启、运行数据准备、凭据或权限修改。
|