# 用户需求（规格）说明书

**项目名称**：基于SpringBoot框架的高考志愿辅助填报系统设计与实现  
**学生姓名**：向黎华  
**学号**：229970427  
**学院/班级**：软件学院 / 22软工8班  
**指导教师**：彭娟  

---

## 1. 引言

### 1.1 编写目的
本文档详细描述了**基于SpringBoot框架的高考志愿辅助填报系统**的用户需求。内容依据《本科毕业设计（论文）开题报告》中确定的6大业务模块进行编写，明确了系统的功能边界、用户角色及非功能性需求，是后续系统设计与测试的唯一基准。

### 1.2 项目背景
高考综合改革背景下，考生面临“专业+院校”或“专业组”的复杂志愿填报模式。本系统旨在利用大数据分析与智能推荐算法，解决信息不对称与决策困难问题。

## 2. 角色描述

| 角色 | 代码 | 核心权限 |
| :--- | :--- | :--- |
| **考生** | `Student` | 查询院校专业、分数位次；模拟填报、生成志愿方案；查看录取风险评估。 |
| **管理员** | `Admin` | 系统配置管理；院校专业数据维护；招生政策/公告发布；用户账号管理。 |
| **规划师** | `Planner` | (可选扩展) 辅助考生进行专业咨询与规划服务(参考 data.sql)。 |

## 3. 功能需求详述 (Six Core Modules)
依据开题报告，系统功能划分为以下六大模块：

### 3.0 核心业务流程图
下图展示了考生从登录到完成志愿填报的核心流转过程：

```mermaid
graph TD
    Start((开始)) --> Login[用户登录]
    Login --> Role{角色判断}
    
    Role -->|管理员| AdminHome[后台管理系统]
    Role -->|考生| StudentHome[考生服务中心]
    
    StudentHome --> Info[完善/确认个人信息]
    Info --> Analysis[查看分数位次分析]
    
    Analysis --> Strategy[制定填报策略]
    Strategy --> Recommend[智能推荐算法]
    
    Recommend --> List[生成推荐列表]
    List --> Select[挑选院校专业]
    
    Select --> Simulate[进入模拟填报表]
    Simulate --> Check[系统合理性校验]
    
    Check -->|存在风险| Modify[调整志愿梯度]
    Check -->|校验通过| Save[保存志愿方案]
    
    Save --> Export[导出/打印方案]
    Export --> End((结束))
```

### 3.1 院校专业管理模块 (School & Major Mgmt)
- **录入院校信息**：支持按省份、批次（本科/专科）、办学性质（公办/民办）录入与查询。
- **专业详情维护**：更新专业介绍、选科要求、学费标准、就业方向。
- **特色标记**：标记双一周、双万计划、985/211 属性。

### 3.2 分数位次管理模块 (Score & Rank Mgmt)
- **历年分数线**：收录各省份、各批次的院校专业录取分（最高/最低/平均分）。
- **位次换算 (核心)**：提供“一分一段表”查询，输入分数可自动换算为当年及往年位次。
- **同位分案例**：查询往年同位次考生的去向。

### 3.3 志愿填报管理模块 (Volunteer Mgmt)
- **智能推荐算法**：
    - 输入：考生成绩、选科、地域偏好、专业倾向。
    - 算法：基于“位次法”与“线差法”。
    - 输出：分梯度的推荐列表 —— **冲 (概率低)**、**稳 (概率适中)**、**保 (概率高)**。
- **志愿模拟填报**：提供仿真填报界面，支持多轮次模拟，保存草稿。
- **合理性校验**：自动检测志愿梯度是否合理，提示滑档风险。

### 3.4 考生信息管理模块 (Student Profile)
- **电子档案**：维护高考分数、选考科目、体检结果、政治面貌等。
- **版本回溯**：记录考生每一次生成的志愿填报方案版本，支持对比与恢复。
- **消息推送**：推送录取进程通知、征集志愿公告。

### 3.5 数据统计分析模块 (Data Analysis)
- **可视化报表**：
    - 院校录取分趋势图 (Line Chart)。
    - 热门专业排行榜 (Bar Chart, Top 10)。
    - 各省份录取人数分布图 (Map)。
- **精准查询**：支持组合条件多维筛选（如：只看“计算机类”且“分数<600”的“华东地区”高校）。

### 3.6 系统管理模块 (System Mgmt)
- **用户权限控制**：基于角色的权限分配 (RBAC)。
- **日志审计**：记录关键操作日志（数据修改、登录记录）。
- **数据备份**：定期备份核心业务数据。

### 3.7 核心用例描述 (Detailed Use Cases)
#### UC-01: 智能志愿推荐
- **参与者**: 考生
- **前置条件**: 考生已登录且完善了高考分数与选科信息。
- **基本流程**:
    1. 考生点击“智能推荐”菜单。
    2. 系统自动读取考生位次，并加载默认配置（偏好地域、偏好专业）。
    3. 考生可手动调整筛选条件（如：只看“公办”、“双一流”）。
    4. 点击“开始推荐”按钮。
    5. 系统基于位次法计算录取概率，返回“冲、稳、保”三组列表。
- **后置条件**: 推荐结果可被保存或直接用于模拟填报。

#### UC-02: 模拟志愿填报与校验
- **参与者**: 考生
- **基本流程**:
    1. 考生进入“模拟填报”界面，创建一个新草稿。
    2. 从收藏夹或推荐列表中添加院校专业到志愿栏。
    3. 调整志愿顺序（拖拽或置顶）。
    4. 点击“系统校验”按钮。
    5. 系统分析梯度（如：A志愿位次 < B志愿位次），若存在倒挂或滑档风险，弹出警告。
    6. 考生确认无误后提交保存。

## 4. 非功能需求

- **性能需求**：
    - 并发能力：支持 1000+ 用户同时在线浏览。
    - 推荐与计算耗时：< 1秒。
- **安全性**：
    - 密码采用 BCrypt 加密存储。
    - API 接口使用 JWT 进行身份校验。
    - 敏感数据（如身份证号）脱敏展示。
- **易用性**：页面响应式设计，适配 PC 端与移动端。