# 查询所有登录成功历史分组数据

## 接口信息

- **接口路径**: `GET /auth/history/latest-success-grouped`
- **接口描述**: 查询所有登录成功的历史记录，按username和instanceUrl分组，每组返回最新一条数据
- **权限要求**: `auth:history:list`
- **请求类型**: GET

## 请求参数

无

## 响应数据

### 成功响应

```json
{
  "code": 200,
  "message": "查询成功",
  "rows": [
    {
      "id": 1,
      "loginType": "password",
      "username": "admin@example.com",
      "passwordEncrypted": null,
      "securityTokenEncrypted": null,
      "clientId": null,
      "clientSecretEncrypted": null,
      "grantType": null,
      "orgAlias": null,
      "privateKeyPath": null,
      "code": null,
      "state": null,
      "sessionId": "xxxxx",
      "environmentCode": null,
      "environmentId": null,
      "instanceUrl": "https://xxx.my.salesforce.com",
      "organizationId": "00Dxxxxxxxxxxxx",
      "orgType": "Source",
      "requestIp": "192.168.1.1",
      "requestPort": 8080,
      "userAgent": "Mozilla/5.0",
      "deviceType": "PC",
      "browserType": "Chrome",
      "osType": "Windows",
      "loginStatus": "success",
      "errorCode": null,
      "errorMessage": null,
      "sessionIdResult": "xxxxx",
      "refreshTokenEncrypted": null,
      "tokenType": "Bearer",
      "expiresIn": 3600,
      "requestTime": "2026-01-16 10:00:00",
      "responseTime": "2026-01-16 10:00:01",
      "durationMs": 1000,
      "operator": "admin",
      "deptId": 1,
      "createBy": "admin",
      "createTime": "2026-01-16 10:00:01",
      "updateBy": "admin",
      "updateTime": "2026-01-16 10:00:01",
      "remark": null
    }
  ],
  "total": 1
}
```

### 失败响应

```json
{
  "code": 500,
  "message": "查询失败",
  "data": null
}
```

## 功能说明

1. **分组逻辑**: 按照用户名（username）和实例URL（instanceUrl）进行分组
2. **最新记录**: 每个分组只返回创建时间最新的一条记录
3. **登录状态**: 只返回登录状态为 success 的记录
4. **数据转换**: 返回的数据会自动转换为 VO 对象

## 使用场景

- 查看不同用户在不同环境下的最新登录记录
- 快速了解系统中的活跃用户和环境
- 用于登录历史分析和统计

## 相关接口

- [查询登录历史信息列表](./0001-list.md)
- [获取登录历史信息详细信息](./0003-get-info.md)

## 相关文档

- [需求文档](../../../requirements/REQ-007.md)
- [架构决策](../../../decisions/adr/0007-login-history-query-and-auto-login.md)