### REQ-USR-001 用户登录


**目标**: 用户通过用户名+密码完成身份认证，获取 JWT Token 用于后续接口鉴权

- **输入**: 

   - **表1**：

   | 字段  | 类型 | 必填 | 输入方式 | 显示来源    | 预加载   | 默认值 | 业务规则        |
   | --- | ---- | --- | ---- | ------- | ----- | --- | ----------- |
   | 用户名 | 文本 | 是   | 手工输入 | —       | —     | —   | —          |
   | 密码  | 文本 | 是   | 手工输入 | —       | —     | —   | 输入显示星号      |
   | 版本  | 文本 | 是   | 下拉单选 | `公司表`   | 页面加载时 | 标准版 |             |

- **输出**: 成功/失败

- **跨字段规则**: 校验用户名 + 密码哈希；连续失败达到阈值临时锁定账号；登录成功签发限时 token 并返回基本用户信息
- **边界**: token 设置合理过期时间；接口需具备防暴力破解保护
- **验收**: 正确凭据返回 Token 且可通过鉴权接口验证；错误密码返回通用错误消息（不区分用户名或密码错误）；锁定账号返回锁定提示
- **依赖表**: `t_user`（认证主体 + 失败计数 + 锁定时间 + 登录时间）/ `t_company`（「版本」下拉数据源）
- **依赖接口**: `POST /api/usr/auth/login`（本 REQ 提供）；后续配套 `POST /api/usr/auth/refresh`、`POST /api/usr/auth/logout` 由同模块衍生接口（不另立 REQ）