datai/datai-scenes/datai-scene-salesforce/docs/sessions/20260116-login-history-query-and-auto-login.md

name	description
20260116-login-history-query-and-auto-login	查询不同类型ORG登录历史及自动登录功能实现

会话记录: 查询不同类型ORG登录历史及自动登录功能实现

元数据 (Metadata)

• 会话ID: 20260116-login-history-query-and-auto-login
• 会话标题: 查询不同类型ORG登录历史及自动登录功能实现
• 日期: 2026-01-16
• 执行人: SSOT Architect
• 相关需求: REQ-007
• 相关ADR: ADR-007
• 相关提示词: 007-login-history-query-and-auto-login.md

触发原因 (Trigger)

用户需求：在 DataISfLoginController 中增加两个方法：

1. 查询不同类型org成功登录历史
2. 根据对应登录成功历史登录不同的org

现状分析 (Current State)

现有功能

• DataISfLoginController 已存在，包含以下接口：
  • POST /salesforce/login/doLogin - 执行登录操作
  • POST /salesforce/login/logout - 执行登出操作
  • GET /salesforce/login/current - 获取当前登录信息
  • POST /salesforce/login/autoLogin - 自动登录（使用最新历史）
• IDataiSfLoginHistoryService 已存在，包含查询登录历史的方法
• DataiSfLoginHistory 实体已存在，包含登录历史的所有字段

问题陈述

1. 无法查询特定类型ORG（如Source、Target、Sandbox、Production等）的成功登录历史记录
2. 无法基于指定的登录历史记录自动登录到对应的ORG环境
3. 开发人员和测试人员需要在多个环境间切换时，需要重复输入登录凭证，效率较低

目标 (Goal)

为 DataISfLoginController 添加两个新接口：

1. GET /salesforce/login/history/success/{orgType} - 查询不同类型org成功登录历史
2. POST /salesforce/login/autoLoginByHistory - 根据对应登录成功历史登录不同的org

使用的提示词 (Used Prompts)

• 007-login-history-query-and-auto-login.md - 查询不同类型ORG登录历史及自动登录功能实现提示词

执行过程 (Execution Process)

步骤 1: 搜索相关文件

搜索并阅读以下文件作为参考：

1. DataISfLoginController.java - 现有的登录控制器
2. IDataiSfLoginHistoryService.java - 登录历史服务接口
3. DataiSfLoginHistoryServiceImpl.java - 登录历史服务实现
4. DataiSfLoginHistoryMapper.java - 登录历史Mapper接口
5. DataiSfLoginHistoryMapper.xml - 登录历史Mapper XML

步骤 2: 实现Controller层新增接口

接口1: 查询不同类型org成功登录历史

• 路径: GET /salesforce/login/history/success/{orgType}
• 功能: 查询指定类型的成功登录历史记录
• 实现: 调用 loginHistoryService.selectSuccessLoginHistoryByOrgType(orgType) 方法

接口2: 根据对应登录成功历史登录不同的org

• 路径: POST /salesforce/login/autoLoginByHistory
• 功能: 根据指定的登录历史记录自动登录到对应ORG
• 实现:
  1. 调用 loginHistoryService.selectDataiSfLoginHistoryById(historyId) 查询历史记录
  2. 如果历史记录不存在，返回错误信息
  3. 调用 salesforceLoginService.autoLogin(historyId) 执行自动登录

步骤 3: 实现Service层新增方法

IDataiSfLoginHistoryService 接口

新增方法：

public List<DataiSfLoginHistory> selectSuccessLoginHistoryByOrgType(String orgType);

DataiSfLoginHistoryServiceImpl 实现类

新增方法：

@Override
public List<DataiSfLoginHistory> selectSuccessLoginHistoryByOrgType(String orgType)
{
    return dataiSfLoginHistoryMapper.selectSuccessLoginHistoryByOrgType(orgType);
}

步骤 4: 实现Mapper层新增方法

DataiSfLoginHistoryMapper 接口

新增方法：

public List<DataiSfLoginHistory> selectSuccessLoginHistoryByOrgType(String orgType);

DataiSfLoginHistoryMapper.xml

新增SQL：

<select id="selectSuccessLoginHistoryByOrgType" parameterType="String" resultMap="DataiSfLoginHistoryResult">
    <include refid="selectDataiSfLoginHistoryVo"/>
    where dslh.login_status = 'success' and dslh.org_type = #{orgType}
    order by dslh.create_time desc
</select>

AI 质疑与替代方案 (AI Questions & Alternatives)

质疑1: 是否需要创建新的Controller？

思考: 是否应该创建新的 DataiLoginHistoryController 来专门处理登录历史相关的操作？

结论: 不需要。根据 ADR-007 的决策，选择方案 A（扩展现有 Controller），因为：

1. 复用现有的 Controller 和 Service 层代码
2. 保持代码结构的一致性
3. 开发成本较低
4. 易于维护和测试

质疑2: 是否需要添加分页查询功能？

思考: 查询登录历史时是否需要支持分页？

结论: 当前版本不需要。根据需求文档，只需要查询所有成功登录历史，后续可以根据实际需求添加分页功能。

质疑3: 是否需要添加查询结果缓存？

思考: 查询登录历史时是否需要添加缓存以提高性能？

结论: 当前版本不需要。登录历史数据更新频率较低，且查询频率不高，不需要添加缓存。后续可以根据实际性能需求添加缓存。

最终方案 (Final Solution)

代码变更文件

1. DataISfLoginController.java - 添加两个新接口
2. IDataiSfLoginHistoryService.java - 添加一个新方法签名
3. DataiSfLoginHistoryServiceImpl.java - 添加一个新方法实现
4. DataiSfLoginHistoryMapper.java - 添加一个新方法签名
5. DataiSfLoginHistoryMapper.xml - 添加一个新SQL查询

关键代码片段

Controller层

@Operation(summary = "查询不同类型ORG成功登录历史")
@GetMapping("/history/success/{orgType}")
public AjaxResult getSuccessLoginHistoryByOrgType(@PathVariable String orgType) {
    logger.info("接收到查询登录历史请求，ORG类型: {}", orgType);
    
    try {
        List<DataiSfLoginHistory> historyList = loginHistoryService.selectSuccessLoginHistoryByOrgType(orgType);
        return AjaxResult.success("查询成功", historyList);
    } catch (Exception e) {
        logger.error("查询登录历史请求处理失败: {}", e.getMessage(), e);
        return AjaxResult.error("查询失败: " + e.getMessage());
    }
}

@Operation(summary = "根据登录历史自动登录")
@PostMapping("/autoLoginByHistory")
public AjaxResult autoLoginByHistory(@RequestBody java.util.Map<String, Long> request) {
    Long historyId = request.get("historyId");
    logger.info("接收到根据历史自动登录请求，历史ID: {}", historyId);
    
    try {
        DataiSfLoginHistory loginHistory = loginHistoryService.selectDataiSfLoginHistoryById(historyId);
        
        if (loginHistory == null) {
            logger.warn("未找到ID为 {} 的登录历史记录", historyId);
            return AjaxResult.error("未找到登录历史记录");
        }
        
        SalesforceLoginResult result = salesforceLoginService.autoLogin(historyId);
        
        if (result.isSuccess()) {
            logger.info("自动登录成功，用户ID: {}, 组织ID: {}, ORG类型: {}", 
                result.getUserId(), result.getOrganizationId(), result.getOrgType());
            return AjaxResult.success("自动登录成功", result);
        } else {
            logger.warn("自动登录失败，错误码: {}, 错误信息: {}", 
                result.getErrorCode(), result.getErrorMessage());
            return AjaxResult.error(result.getErrorCode(), result.getErrorMessage());
        }
    } catch (Exception e) {
        logger.error("自动登录请求处理失败: {}", e.getMessage(), e);
        return AjaxResult.error("自动登录失败: " + e.getMessage());
    }
}

复现步骤 (Reproduction Steps)

1. 启动应用服务
2. 使用 POST /salesforce/login/doLogin 接口登录到不同类型的ORG（Source、Target等）
3. 使用 GET /salesforce/login/history/success/{orgType} 接口查询指定类型的登录历史
4. 使用 POST /salesforce/login/autoLoginByHistory 接口根据历史记录自动登录

结果 (Outcome)

代码变更

• ✅ DataISfLoginController.java - 添加两个新接口
• ✅ IDataiSfLoginHistoryService.java - 添加一个新方法签名
• ✅ DataiSfLoginHistoryServiceImpl.java - 添加一个新方法实现
• ✅ DataiSfLoginHistoryMapper.java - 添加一个新方法签名
• ✅ DataiSfLoginHistoryMapper.xml - 添加一个新SQL查询

文档变更

• ✅ 创建需求文档 REQ-007.md
• ✅ 创建架构决策 ADR-007.md
• ✅ 创建提示词资产 007-login-history-query-and-auto-login.md
• ✅ 创建变更记录 0017-login-history-query-and-auto-login.md
• ✅ 创建会话记录 20260116-login-history-query-and-auto-login.md
• ✅ 更新唯一真源 docs/index.md
• ✅ 更新项目变更日志 CHANGELOG.md

功能验证

• ⏳ 待验证：查询Source类型的登录历史
• ⏳ 待验证：查询Target类型的登录历史
• ⏳ 待验证：查询Sandbox类型的登录历史
• ⏳ 待验证：查询不存在的ORG类型
• ⏳ 待验证：根据历史ID自动登录到Source ORG
• ⏳ 待验证：根据历史ID自动登录到Target ORG
• ⏳ 待验证：根据不存在的历史ID自动登录

后续优化 (Future Improvements)

性能优化

• 在 org_type 字段上添加索引以提高查询性能
• 考虑添加分页查询功能
• 考虑添加查询结果缓存

功能优化

• 支持按时间范围查询登录历史
• 支持按登录状态查询登录历史
• 支持导出登录历史记录

相关文档 (Related Documents)

• 需求文档
• 架构决策
• 提示词资产
• 变更记录

变更历史 (Change History)

日期	版本	变更内容	变更人
2026-01-16	1.0.0	初始版本	SSOT Architect