datai/datai-scenes/datai-scene-salesforce/docs/changelog/2026-01-28-003-changelog.md

53 lines
2.6 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 变更日志
## 元数据
- 需求编号003
- 创建时间2026-01-28
- 创建人AI Assistant
- 版本号v1.0.0
## 变更概述
实现 Metadata API 源 Org 的连接管理功能包括连接工厂、会话管理、REST API 接口及连接日志记录。
## 变更内容
### 新增功能
- **Metadata 连接工厂**
- 实现 `MetadataConnectionFactory`,继承 `AbstractConnectionFactory`
- 支持从 Partner URL 转换为 Metadata URL`/u/` -> `/m/`)。
- 集成 `SessionManager` 获取 Session ID。
- **连接服务层**
- 实现 `IMetadataConnectionService` 及其实现类。
- 提供连接状态查询、连接测试、连接刷新、连接关闭功能。
- 记录连接日志到数据库。
- **REST API 接口**
- `GET /api/metadata/connection/status`:获取连接状态。
- `POST /api/metadata/connection/test`:测试连接。
- `POST /api/metadata/connection/refresh`:刷新连接。
- `POST /api/metadata/connection/close`:关闭连接。
- **数据模型与持久化**
- 新增 `DataiMetadataConnection` 实体类。
- 新增 `DataiMetadataConnectionMapper` 接口(复用 MyBatis Plus
- 新增 DTO/VO 类:`SetCallOptionsDto`, `ConnectionStatusVo`
### 新增代码文件
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/factory/MetadataConnectionFactory.java`
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/service/IMetadataConnectionService.java`
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/service/impl/MetadataConnectionServiceImpl.java`
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/controller/MetadataConnectionController.java`
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/model/domain/DataiMetadataConnection.java`
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/model/dto/SetCallOptionsDto.java`
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/model/vo/ConnectionStatusVo.java`
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/mapper/DataiMetadataConnectionMapper.java`
- `datai-salesforce-metadata/src/main/java/com/datai/metadata/config/MetadataConnectionConfig.java`
## 影响范围
- 模块:`datai-salesforce-metadata`
- 功能Metadata API 连接管理
- 数据库:无新增表(复用现有基础设施或内存处理,日志记录复用通用结构)
## 相关文档
- [需求文档](../requirements/2026-01-28-003-MetadataAPI源org实现.md)
- [设计文档](../design/2026-02-02-003-01-连接管理-设计.md)
- [决策记录](../decisions/2026-02-02-003-01-ADR-连接管理技术选型.md)
- [提示词](../prompts/2026-02-02-003-01-prompt-Metadata连接管理.md)