# 经历填写页 API 接口文档 (`pages/experience`)

## 1. 获取全量经历列表

*   **接口说明**: 用于进入经历页面时，一次性获取用户的教育、工作、项目经历列表，进行分类展示。
*   **请求路径**: `/resume/experience`
*   **请求方法**: `GET`
*   **公共头部**: `Authorization: Bearer {Token}`
*   **接口返回 JSON 数据**:

| 字段名 | 类型 | 说明 | 示例值 |
| :--- | :--- | :--- | :--- |
| code | Number | 状态码 | 200 |
| msg | String | 提示信息 | "获取成功" |
| data | Object | 数据详情 | { ... } |
| data.education | Array | 教育经历列表 | [ ... ] |
| data.work | Array | 工作经历列表 | [ ... ] |
| data.project | Array | 项目经历列表 | [ ... ] |

---

## 2. 教育经历管理

### 2.1 添加/更新教育经历
*   **接口说明**: 保存教育经历。如果传递 `id` 则为更新，不传递则为新增。
*   **请求路径**: `/resume/education`
*   **请求方法**: `POST`
*   **接口参数**:

| 参数名 | 类型 | 必填 | 说明 | 示例值 |
| :--- | :--- | :--- | :--- | :--- |
| id | Number | 否 | 经历 ID (更新时必填) | 123 |
| school | String | 是 | 学校名称 | "清华大学" |
| degree | String | 是 | 学历: `本科`, `硕士`, `博士` 等 | "本科" |
| major | String | 是 | 专业 | "会计学" |
| start_time | String | 是 | 开始时间 (YYYY-MM) | "2019-09" |
| end_time | String | 否 | 结束时间 (YYYY-MM)，不填则视为至今 | "2023-06" |

*   **接口示例**:
```json
// 请求示例
{
  "school": "清华大学",
  "degree": "本科",
  "major": "会计学",
  "start_time": "2019-09",
  "end_time": "2023-06"
}
```

### 2.2 删除教育经历
*   **请求路径**: `/resume/education/{id}`
*   **请求方法**: `DELETE`

---

## 3. 工作经历管理

### 3.1 添加/更新工作经历
*   **接口说明**: 保存工作经历。
*   **请求路径**: `/resume/work`
*   **请求方法**: `POST`
*   **接口参数**:

| 参数名 | 类型 | 必填 | 说明 | 示例值 |
| :--- | :--- | :--- | :--- | :--- |
| id | Number | 否 | 经历 ID | 456 |
| company | String | 是 | 公司名称 | "XX审计师事务所" |
| position | String | 是 | 职位名称 | "审计助理" |
| start_time | String | 是 | 开始时间 | "2023-07" |
| end_time | String | 否 | 结束时间，不填为至今 | "2024-03" |
| content | String | 否 | 工作内容描述 | "负责财务报表审计..." |

### 3.2 删除工作经历
*   **请求路径**: `/resume/work/{id}`
*   **请求方法**: `DELETE`

---

## 4. 项目经历管理

### 4.1 添加/更新项目经历
*   **接口说明**: 保存项目经历。
*   **请求路径**: `/resume/project`
*   **请求方法**: `POST`
*   **接口参数**:

| 参数名 | 类型 | 必填 | 说明 | 示例值 |
| :--- | :--- | :--- | :--- | :--- |
| id | Number | 否 | 经历 ID | 789 |
| name | String | 是 | 项目名称 | "XX大型国企年度审计项目" |
| role | String | 是 | 在项目中担任的角色 | "项目负责人" |
| start_time | String | 是 | 项目开始时间 | "2023-11" |
| end_time | String | 否 | 项目结束时间 | "2024-01" |
| desc | String | 是 | 项目描述/职责 | "负责现场审计工作的全面协调..." |

### 4.2 删除项目经历
*   **请求路径**: `/resume/project/{id}`
*   **请求方法**: `DELETE`

---

## 5. 辅助接口：行业/职位选择

*   **接口说明**: 用于在填写经历或意向时，获取层级化的行业或职位数据列表。
*   **请求路径**: `/common/category-list`
*   **请求方法**: `GET`
*   **接口参数**:
    - `type`: `industry` (行业), `position` (职位)
*   **返回 JSON 示例**:
```json
{
  "code": 200,
  "data": [
    {
      "id": 1,
      "name": "财务/审计/税务",
      "children": [
        { "id": 101, "name": "审计经理" },
        { "id": 102, "name": "审计助理" }
      ]
    }
  ]
}
```