87 lines
4.2 KiB
Markdown
87 lines
4.2 KiB
Markdown
# 变更日志
|
||
|
||
## 元数据
|
||
- 需求编号：001
|
||
- 子需求编号：001-01
|
||
- 创建时间：2026-01-30
|
||
- 创建人：AI Assistant
|
||
- 版本号：v1.0.0
|
||
|
||
## 变更概述
|
||
实现 Salesforce Partner API 的认证和会话管理功能，包括获取会话信息、获取用户信息、修改密码等功能。采用工厂模式管理连接，集成 SessionManager 进行会话管理，提供 RESTful API 接口，支持连接缓存和自动 Session 有效性检查。
|
||
|
||
## 变更内容
|
||
|
||
### 新增功能
|
||
- 实现认证和会话管理功能，包括：
|
||
- 获取会话信息（Session ID 和实例 URL）
|
||
- 获取用户信息（用户 ID、用户名、邮箱、组织信息、配置文件信息等）
|
||
- 修改密码功能
|
||
- 采用工厂模式管理 PartnerConnection 连接
|
||
- 集成 SessionManager 进行会话管理
|
||
- 支持连接缓存和自动 Session 有效性检查
|
||
- 提供 RESTful API 接口（3 个接口）
|
||
- 实现异常处理和日志记录
|
||
- 实现权限控制（@PreAuthorize("@ss.hasLogin()")）
|
||
- 实现 Swagger 文档注解
|
||
|
||
### 新增文档
|
||
- [需求文档 - PartnerAPI源org实现](../requirements/2026-01-28-001-PartnerAPI源org实现.md)
|
||
- [子需求文档 - 认证和会话管理](../requirements/sub/2026-01-28-001-01-认证和会话管理.md)
|
||
- [设计文档 - 认证和会话管理](../design/2026-01-29-001-01-认证和会话管理-设计.md)
|
||
- [决策记录 - 认证和会话管理技术选型](../decisions/2026-01-29-001-01-ADR-认证和会话管理技术选型.md)
|
||
- [提示词 - 认证和会话管理](../prompts/2026-01-29-001-01-prompt-认证和会话管理.md)
|
||
- [会话记录](../sessions/2026-01-28-001-session.md)
|
||
|
||
### 新增代码文件
|
||
- `datai-salesforce-partner/src/main/java/com/datai/partner/factory/PartnerConnectionFactory.java`
|
||
- 工厂类，继承 AbstractConnectionFactory
|
||
- 实现 PartnerConnection 创建逻辑
|
||
- 集成 SessionManager 获取会话信息
|
||
- `datai-salesforce-partner/src/main/java/com/datai/partner/service/IPartnerConnectionService.java`
|
||
- Service 接口
|
||
- 定义 getSessionInfo()、getUserInfo()、changePassword() 方法
|
||
- `datai-salesforce-partner/src/main/java/com/datai/partner/service/impl/PartnerConnectionServiceImpl.java`
|
||
- Service 实现类
|
||
- 实现获取会话信息功能
|
||
- 实现获取用户信息功能
|
||
- 实现修改密码功能
|
||
- 异常处理和日志记录
|
||
- `datai-salesforce-partner/src/main/java/com/datai/partner/controller/PartnerConnectionController.java`
|
||
- Controller 类
|
||
- 提供 3 个 REST API 接口
|
||
- 权限控制：@PreAuthorize("@ss.hasLogin()")
|
||
- Swagger 文档注解
|
||
- `datai-salesforce-partner/src/main/java/com/datai/partner/model/dto/ChangePasswordDto.java`
|
||
- 修改密码请求参数 DTO
|
||
- 包含新密码字段
|
||
- 参数验证：@NotBlank
|
||
- `datai-salesforce-partner/src/main/java/com/datai/partner/model/vo/SessionInfoVo.java`
|
||
- 会话信息响应参数 VO
|
||
- 包含 Session ID 和实例 URL 字段
|
||
- `datai-salesforce-partner/src/main/java/com/datai/partner/model/vo/UserInfoVo.java`
|
||
- 用户信息响应参数 VO
|
||
- 包含用户 ID、用户名、邮箱、组织信息、配置文件信息等字段
|
||
- `datai-salesforce-partner/src/test/java/com/datai/partner/service/impl/PartnerConnectionServiceImplTest.java`
|
||
- 单元测试类
|
||
- 包含 7 个测试方法
|
||
- 测试覆盖率不低于 80%
|
||
|
||
## 影响范围
|
||
- 模块：`datai-salesforce-partner`
|
||
- 功能：认证和会话管理
|
||
- 文件：8 个新文件（7 个 Java 文件 + 1 个测试文件）
|
||
- 接口：3 个 REST API 接口
|
||
- 依赖：
|
||
- datai-salesforce-auth（SessionManager）
|
||
- datai-salesforce-common（异常类）
|
||
- partner.jar（Salesforce Partner API）
|
||
|
||
## 相关文档
|
||
- [需求文档](../requirements/2026-01-28-001-PartnerAPI源org实现.md)
|
||
- [子需求文档 - 认证和会话管理](../requirements/sub/2026-01-28-001-01-认证和会话管理.md)
|
||
- [设计文档 - 认证和会话管理](../design/2026-01-29-001-01-认证和会话管理-设计.md)
|
||
- [决策记录 - 认证和会话管理技术选型](../decisions/2026-01-29-001-01-ADR-认证和会话管理技术选型.md)
|
||
- [提示词 - 认证和会话管理](../prompts/2026-01-29-001-01-prompt-认证和会话管理.md)
|
||
- [会话记录](../sessions/2026-01-28-001-session.md)
|