同步V4与M011文档状态
This commit is contained in:
andy
@@ -2,7 +2,7 @@
|
||||
|
||||
| 项目 | 内容 |
|
||||
| --- | --- |
|
||||
| 文档状态 | 当前有效；CP1 / CP2 / CP3 已实现，生产链路默认关闭 |
|
||||
| 文档状态 | 当前有效；CP1 / CP2 / CP3 已实现，测试机 AgentBus 增强已开启，生产链路默认关闭；CP4 暂不推进 |
|
||||
| 适用范围 | AgentBus 入站邮件和 Debug EML 上传邮件中的 Excel 附件，在调用 SuperAgent Open API 前做结构化预处理 |
|
||||
| 当前目标 | 排除旅行名单类 Excel，抽取 Booking / 附加费类 Excel 中带背景色的业务行，生成安全 JSON 并附加到发给 SuperAgent 的 payload |
|
||||
| 依赖能力 | SourceMessage Inbox、Debug EML、AgentBus 自动分发、Apache POI、OSS 附件读取能力、SuperAgent Open API |
|
||||
@@ -19,7 +19,7 @@
|
||||
|
||||
## 2. 目标
|
||||
|
||||
- 在 AgentBus 自动分发和 Debug EML 上传两条链路中复用同一套 Excel 附件预处理逻辑；当前两条链路均已接入，生产链路仍由配置默认关闭。
|
||||
- 在 AgentBus 自动分发和 Debug EML 上传两条链路中复用同一套 Excel 附件预处理逻辑；当前两条链路均已接入，测试机 AgentBus 增强已开启，生产链路仍由配置默认关闭。
|
||||
- 识别并排除旅行名单类 Excel，避免把人员名单误当成 Booking 更新或附加费数据。
|
||||
- 对 Booking Update / Booking Surcharge 类 Excel，按最近月份筛选 sheet，只抽取有业务背景色的行。
|
||||
- 把抽取结果追加到发给 SuperAgent 的 AgentBus Outlook-like payload 中，字段建议为 `attachment_extractions[]`。
|
||||
@@ -352,7 +352,7 @@ server/src/main/java/cn/nianxx/thhotel/workflows/reservation/excelimport
|
||||
| `agentbus.superagent-dispatch.booking-excel-download-max-size` | `10MB` | AgentBus 自动分发读取单个 Excel 附件的最大大小，避免 worker 下载异常大文件 |
|
||||
| `debug.eml-upload.include-booking-excel-extractions` | `false` | Debug EML 是否返回并传递抽取结果 |
|
||||
|
||||
中文说明：建议先在 Debug EML 打开，验证样例 Excel 和 SuperAgent 结果稳定后，再在测试机打开 AgentBus 自动分发增强；生产仍保持默认关闭。
|
||||
中文说明：Debug EML 和测试机 AgentBus 自动分发增强已可用于验证样例 Excel 与 SuperAgent 结果稳定性；生产仍保持默认关闭，生产开启需要单独确认。
|
||||
|
||||
## 11. 错误处理和安全边界
|
||||
|
||||
@@ -403,12 +403,12 @@ server/src/main/java/cn/nianxx/thhotel/workflows/reservation/excelimport
|
||||
|
||||
- AgentBus dispatch worker 在调用 SuperAgent 前读取 SourceMessage 已保存附件引用，并通过后端对象存储端口下载 Excel 内容。
|
||||
- 复用 `ReservationBookingExcelAttachmentExtractionService` 执行同一预处理，非空结果追加到发给 SuperAgent 的 AgentBus Outlook-like payload。
|
||||
- 生产链路默认配置关闭，测试机可通过 `agentbus.superagent-dispatch.include-booking-excel-extractions=true` 验证后再评估开启。
|
||||
- 测试机 AgentBus 增强已开启；生产链路默认配置关闭，生产开启需单独确认。
|
||||
- 附件读取或解析失败时追加安全跳过结果 / warning 并继续调用 SuperAgent；日志和 payload 不写完整附件 URL、签名参数、API Key、Cookie 或 Secret。
|
||||
|
||||
### CP4：可选持久化和运营查询
|
||||
### CP4：可选持久化和运营查询（暂不推进）
|
||||
|
||||
如果后续需要追踪 Excel 解析历史，再单独设计持久化表，例如：
|
||||
当前 CP4 不进入近期开发计划。如果后续需要追踪 Excel 解析历史，再单独设计持久化表，例如：
|
||||
|
||||
```text
|
||||
workflow_reservation_booking_excel_import_batch
|
||||
|
||||
Reference in New Issue
Block a user