# 人才卡升级申请页面操作说明

## 页面信息

- 页面名称：人才卡升级申请
- 路由：`/pages/card-upgrade/card-upgrade`
- 源码：`pages/card-upgrade/card-upgrade.uvue`
- 入口：个人中心“升级人才卡”。
- 当前状态：多组资料填写、删除、图片选择、校验和提交成功状态已完成，真实上传与审核接口待接入。

## 功能点

| 功能 | 当前实现 | 后续接口目标 |
| --- | --- | --- |
| 默认资料 | 进入页面默认展示一组荣誉/奖项表单。 | 后台可返回草稿或历史未提交资料。 |
| 添加资料 | 点击“添加荣誉/奖项”追加一组表单。 | 支持后台限制最大资料组数。 |
| 删除资料 | 第一组为基础资料且不可删除；第二组及之后新增的表单显示删除按钮。 | 删除已保存草稿时同步更新后台。 |
| 荣誉名称 | 输入新获得的荣誉称号或奖项。 | 字段长度和敏感词规则以后端为准。 |
| 获得时间 | 使用日期选择器填写。 | 后台校验日期范围和格式。 |
| 印证资料 | 从相册或相机选择一张压缩图片进行预览。 | 正式接入文件上传、压缩、鉴权和删除接口。 |
| 提交校验 | 按组校验名称、日期和印证资料是否完整。 | 后端再次进行完整业务校验。 |
| 提交成功 | 页面展示“提交成功，待管理员确认”。 | 以后端创建申请成功及申请状态为准。 |

## 操作说明

1. 用户从个人中心进入申请表单，页面默认展示一组资料。
2. 填写荣誉/奖项名称、获得时间并上传印证资料。
3. 点击“添加荣誉/奖项”可继续增加一组资料。
4. 第一组资料始终保留；点击新增资料右上角“删除”可移除对应新增组。
5. 点击“提交”，资料完整时进入提交成功状态。
6. 点击“返回”回到个人中心。

## 异常处理

| 场景 | 页面处理要求 |
| --- | --- |
| 表单未填写完整 | 明确提示第几组缺少名称、时间或印证资料。 |
| 图片选择失败 | 保留已填写内容，允许重新选择。 |
| 图片上传失败 | 标记失败的具体图片，支持单项重试，不重复提交成功图片。 |
| 提交失败 | 保留所有表单内容和已上传文件，展示原因及重试入口。 |
| 重复提交 | 使用后端幂等键避免生成重复升级申请。 |
| 登录失效 | 恢复登录后返回本页并恢复本地草稿。 |

## 接口数据建议

```text
applicationId: string
targetCardLevel: string
honors: Array<{
  name: string
  obtainedDate: string
  proofFileIds: string[]
}>
status: draft | submitted | reviewing | approved | rejected
rejectReason: string
```