# 招生统计API文档

## 接口概览

| 接口名称 | 接口路径 | 请求方式 | 接口说明 |
| --- | --- | --- | --- |
| 获取统计概览 | /zsjy/statistics/overview | GET | 获取招生统计数据概览 |
| 获取专业分布 | /zsjy/statistics/major | GET | 获取专业分布统计数据 |
| 获取地区分布 | /zsjy/statistics/region | GET | 获取地区分布统计数据 |
| 获取性别比例 | /zsjy/statistics/gender | GET | 获取性别比例统计数据 |
| 获取报名趋势 | /zsjy/statistics/trend | GET | 获取报名趋势统计数据 |
| 获取状态分布 | /zsjy/statistics/status | GET | 获取各状态分布统计数据 |

## 接口详细说明

### 1. 获取统计概览

**接口地址**：`/zsjy/statistics/overview`

**请求方式**：GET

**权限要求**：`zsjy:statistics:overview`

**接口说明**：获取招生统计数据概览，包括总报名人数、今日报名人数、缴费情况、录取情况以及各类分布数据。

**请求参数**：无

**返回参数**：

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "totalEnrollments": 1050,           // 总报名人数
    "todayEnrollments": 25,             // 今日报名人数
    "paidCount": 850,                   // 已缴费人数
    "paymentRate": "80.95%",            // 缴费率
    "admittedCount": 750,               // 已录取人数
    "admissionRate": "71.43%",          // 录取率
    "majorDistribution": [              // 各专业报名人数分布
      {
        "name": "计算机科学与技术",
        "value": 350
      },
      {
        "name": "软件工程",
        "value": 280
      },
      // ...其他专业
    ],
    "regionDistribution": [             // 各地区报名人数分布
      {
        "name": "北京",
        "value": 150
      },
      {
        "name": "上海",
        "value": 120
      },
      // ...其他地区
    ],
    "genderRatio": {                    // 性别比例
      "M": 600,                         // 男生人数
      "F": 450                          // 女生人数
    },
    "weeklyTrend": [                    // 近7天报名趋势
      {
        "date": "2025-07-01",
        "count": 35
      },
      {
        "date": "2025-07-02",
        "count": 42
      },
      // ...其他日期
    ],
    "statusDistribution": {             // 各状态分布
      "0": 100,                         // 未开始
      "1": 200,                         // 信息审核中
      "2": 150,                         // 缴费确认中
      "3": 200,                         // 录取处理中
      "4": 100,                         // 最终审核中
      "5": 250,                         // 完成录取
      "6": 50                           // 退学
    }
  }
}
```

### 2. 获取专业分布

**接口地址**：`/zsjy/statistics/major`

**请求方式**：GET

**权限要求**：`zsjy:statistics:major`

**接口说明**：获取各专业报名人数分布统计数据。

**请求参数**：无

**返回参数**：

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "name": "计算机科学与技术",
      "value": 350
    },
    {
      "name": "软件工程",
      "value": 280
    },
    {
      "name": "网络工程",
      "value": 150
    },
    {
      "name": "数据科学与大数据技术",
      "value": 180
    },
    {
      "name": "人工智能",
      "value": 90
    }
  ]
}
```

### 3. 获取地区分布

**接口地址**：`/zsjy/statistics/region`

**请求方式**：GET

**权限要求**：`zsjy:statistics:region`

**接口说明**：获取各地区报名人数分布统计数据。

**请求参数**：无

**返回参数**：

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "name": "北京",
      "value": 150
    },
    {
      "name": "上海",
      "value": 120
    },
    {
      "name": "广东",
      "value": 180
    },
    {
      "name": "浙江",
      "value": 140
    },
    {
      "name": "江苏",
      "value": 130
    },
    {
      "name": "其他",
      "value": 330
    }
  ]
}
```

### 4. 获取性别比例

**接口地址**：`/zsjy/statistics/gender`

**请求方式**：GET

**权限要求**：`zsjy:statistics:gender`

**接口说明**：获取报名学生的性别比例统计数据。

**请求参数**：无

**返回参数**：

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "M": 600,    // 男生人数
    "F": 450     // 女生人数
  }
}
```

### 5. 获取报名趋势

**接口地址**：`/zsjy/statistics/trend`

**请求方式**：GET

**权限要求**：`zsjy:statistics:trend`

**接口说明**：获取指定天数的报名趋势统计数据。

**请求参数**：

| 参数名 | 类型 | 是否必须 | 说明 |
| --- | --- | --- | --- |
| days | Integer | 否 | 查询天数，默认为7天 |

**返回参数**：

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": [
    {
      "date": "2025-07-01",
      "count": 35
    },
    {
      "date": "2025-07-02",
      "count": 42
    },
    {
      "date": "2025-07-03",
      "count": 28
    },
    {
      "date": "2025-07-04",
      "count": 36
    },
    {
      "date": "2025-07-05",
      "count": 25
    },
    {
      "date": "2025-07-06",
      "count": 18
    },
    {
      "date": "2025-07-07",
      "count": 30
    }
  ]
}
```

### 6. 获取状态分布

**接口地址**：`/zsjy/statistics/status`

**请求方式**：GET

**权限要求**：`zsjy:statistics:status`

**接口说明**：获取各状态的人数分布统计数据。

**请求参数**：无

**返回参数**：

```json
{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "0": 100,    // 未开始
    "1": 200,    // 信息审核中
    "2": 150,    // 缴费确认中
    "3": 200,    // 录取处理中
    "4": 100,    // 最终审核中
    "5": 250,    // 完成录取
    "6": 50      // 退学
  }
}
```

## 状态码说明

| 状态码 | 说明 |
| --- | --- |
| 200 | 操作成功 |
| 401 | 未授权，请重新登录 |
| 403 | 没有权限，请联系管理员 |
| 500 | 服务器内部错误 |

## 数据字典

### 录取状态码

| 状态码 | 说明 |
| --- | --- |
| 0 | 未开始 |
| 1 | 信息审核中 |
| 2 | 缴费确认中 |
| 3 | 录取处理中 |
| 4 | 最终审核中 |
| 5 | 完成录取 |
| 6 | 退学 |
| 7 | 其他 |

### 性别代码

| 代码 | 说明 |
| --- | --- |
| M | 男 |
| F | 女 |