# 登录页

## 基本信息

| 项目 | 内容 |
| --- | --- |
| 路由 | `/pages/login/login` |
| 页面目标 | 引导人才用户完成授权登录后进入人才卡服务。 |
| 进入方式 | 小程序首次打开、登录失效后重定向进入。 |
| 当前状态 | 已完成视觉与本地交互骨架；未接入真实登录接口。 |

## 功能点

| 编号 | 功能 | 说明 | 当前状态 |
| --- | --- | --- |
| F-001 | 手机号一键登录 | 用户确认协议后拉起微信手机号授权，授权结果交由后台换取登录态。 | 前端授权已接入，后台待对接 |
| F-003 | 协议确认 | 登录前可勾选用户服务协议和隐私政策；当前静态版本默认已勾选，后续是否调整为默认未勾选按隐私合规要求执行。 | 已完成前端交互 |
| F-004 | 协议查看 | 点击后进入统一富文本协议页，分别加载用户协议和隐私与权限协议；从协议页可安全返回登录页。 | 前端页面已接通，正式文本待接口 |

## 操作说明

1. 用户进入页面后，可查看人才卡平台品牌与服务说明。
2. 用户勾选协议后，点击“手机号一键登录”拉起微信手机号授权；授权成功后进入首页。
3. 未勾选协议时点击登录，页面提示先同意相关协议。
4. 点击《用户协议》或《隐私与权限协议》分别携带 `type=user/privacy`、`source=login` 进入统一富文本协议页；协议页使用安全返回回到登录页，不再显示占位弹窗。

## 接口与数据

| 数据项/动作 | 接口标识 | 参数 | 返回字段 | 状态 |
| --- | --- | --- | --- |
| 微信登录 | `auth.wechatLogin` | 微信临时登录凭证、用户授权结果 | accessToken、refreshToken、用户资料、是否首次登录 | 待后台确认 |
| 手机号登录 | `auth.phoneLogin` | 加密手机号凭证/短信验证码 | accessToken、refreshToken、用户资料 | 待后台确认 |
| 协议文本 | `auth.agreement` | 协议类型、版本 | 标题、正文、版本、生效日期 | 待后台确认 |

## 异常处理

| 场景 | 用户可见提示 | 恢复方式 |
| --- | --- | --- |
| 未同意协议 | 请先阅读并同意相关协议 | 勾选协议后再次登录。 |
| 用户拒绝授权 | 已取消授权，可稍后重试 | 保留在登录页，不清除当前勾选状态。 |
| 网络异常 | 网络连接异常，请检查网络后重试 | 提供再次点击登录的入口。 |
| 登录凭证失效 | 登录已失效，请重新登录 | 清理本地令牌后重新拉起登录。 |

## 验收清单

- [x] 使用自定义导航并适配微信顶部安全区。
- [x] 微信授权、手机号登录及协议勾选入口可点击。
- [x] 未勾选协议有明确提示。
- [ ] 已接入真实登录、刷新令牌和登录失效处理。
- [x] 登录页已接入统一协议富文本页面。
- [ ] 已接入后台正式协议文本与版本记录。