22 lines
1.7 KiB
Markdown
22 lines
1.7 KiB
Markdown
# Integration Service 模块指引
|
||
|
||
## 职责与边界
|
||
|
||
- 负责百度 OCR、Amazon Logistics/SP-API 等第三方适配和能力开关；不保存业务主数据。
|
||
- 二期重量 OCR 由 `file/` 调用；本服务只返回识别结果，不保存 `file_object`、入库单或重量确认记录。
|
||
|
||
## 模块入口与验证
|
||
|
||
- 应用/配置：`IntegrationServiceApplication.java`、`config/IntegrationProperties.java`
|
||
- 内部接口：`controller/IntegrationProviderController.java`、`WeightOcrController.java`
|
||
- OCR 编排：`service/ocr/WeightOcrBatchService.java`、`ImageCropper.java`、`WeightCandidateSelector.java`
|
||
- 供应商适配：`provider/IntegrationProviderAdapter.java`、`BaiduOcrAdapter.java`、`AmazonLogisticsAdapter.java`
|
||
- 安全：`security/InternalServiceTokenGuard.java`；配置 `application.yml`、`../config/nacos/{local,cn}/integration-service.yml`
|
||
- 测试：`src/test/java/com/baiyue/integration/`；`mvn -pl integration-service -am test`
|
||
|
||
## 修改约束与分期
|
||
|
||
- 密钥、原始响应和客户敏感数据不得写入日志；真实调用默认关闭，适配器负责超时、重试、限流、错误归一化。
|
||
- OCR 只能访问受控输入/输出目录，接口仅接受内部服务令牌；契约变更同步检查 File 的 `WeightOcrClient` 和测试。
|
||
- 一期仅保留通用适配基础；二期服务 File 重量 OCR，凭证缺失时走人工修正降级；三期仅在船期来源、频率、限流、超时、最近有效结果和过期标识的契约稳定后接入外部查询，不建设报关自动对接。阶段文档：`../../docs/二期/README.md`、`../../docs/三期/三期开工门禁.md`、`../../docs/三期/三期需求确认表.md`。
|