feat: 添加无需外部库即可从 DOCX 文件中提取文本的脚本，并创建会话索引 Markdown 文件。

2026-02-02 15:27:08 +08:00
parent 79b9938dbb
commit 517644adea
10 changed files with 1050 additions and 0 deletions
--- a/未完成/文档内容/体系结构设计报告_Markdown生成版.md
+++ b/未完成/文档内容/体系结构设计报告_Markdown生成版.md
@@ -0,0 +1,186 @@
+# 体系结构设计报告
+
+**项目名称**：基于SpringBoot框架的高考志愿辅助填报系统设计与实现  
+**学生姓名**：向黎华  
+**学号**：229970427  
+**学院/班级**：软件学院 / 22软工8班  
+**指导教师**：彭娟  
+
+---
+
+## 1. 引言
+### 1.1 编写目的
+本文档详细描述了**基于SpringBoot框架的高考志愿辅助填报系统**的软件架构。文档内容严格遵循《本科毕业设计（论文）开题报告》中确定的技术路线与设计要求，为系统的编码实现与部署提供核心技术指导。
+
+### 1.2 参考文献
+- [1] 温创新,谢莎,何雅婷. 基于微服务架构的新高考志愿填报推荐系统设计[J].科技创新与应用,2025.
+- [2] 王宇轩. 融合大数据分析的高考志愿推荐系统设计与实现[D].西安工业大学,2024.
+- [3] 张磊. 基于 SpringBoot 的高考志愿智能填报系统设计与实现[D].山东师范大学,2023.
+
+## 2. 系统架构设计
+
+### 2.1 总体架构模式
+本系统采用标准的 **B/S (Browser/Server)** 架构，遵循 **前后端分离** 的开发模式。
+- **前端架构**：MVVM 模式，通过 View-ViewModel-Model 实现通过数据双向绑定。
+- **后端架构**：经典的 MVC 三层架构 (Controller - Service - DAO)。
+
+### 2.2 技术栈选型 (Standard)
+依据任务书要求，项目采用以下技术栈：
+
+| 分层 | 技术组件 | 版本/说明 |
+| :--- | :--- | :--- |
+| **前端框架** | **Vue 3.0** | 采用 Composition API 风格开发 |
+| **UI 组件库** | **Ant Design Vue** | 企业级 UI 设计语言 |
+| **状态管理** | **Pinia** | 替代 Vuex 的新一代状态管理库 |
+| **数据可视化**| **ECharts** | 用于展示录取趋势图、就业率报表 |
+| **后端框架** | **Spring Boot 2.7+** | 核心容器，简化配置 |
+| **持久层** | **MyBatis-Plus** | 简化 SQL 操作，提供 ActiveRecord 模式支持 |
+| **安全框架** | **Spring Security** | 实现用户认证与基于角色的权限控制 (RBAC) |
+| **缓存** | **Redis** | 缓存热点院校数据与 Token，提升性能 |
+| **数据库** | **MySQL 8.0** | 存储所有业务数据，InnoDB 引擎 |
+
+### 2.3 逻辑架构图
+```mermaid
+graph TD
+    User((用户/考生)) --> |HTTP/JSON| Nginx[Web服务器/反向代理]
+    Nginx --> |Static| Vue[Vue3 前端应用]
+    Nginx --> |API| Gateway[Spring Boot 后端服务]
+    
+    subgraph "前端层 (Vue 3 + Ant Design)"
+        Vue --> Module1[院校专业查询]
+        Vue --> Module2[智能志愿推荐]
+        Vue --> Module3[模拟填报]
+        Vue --> Store[Pinia 状态管理]
+        Vue --> Chart[ECharts 图表]
+    end
+
+    subgraph "后端业务层 (Spring Boot)"
+        Gateway --> Security[Spring Security 认证授权]
+        Security --> Controller[Web控制层]
+        
+        Controller --> Svc1[院校专业管理服务]
+        Controller --> Svc2[分数位次管理服务]
+        Controller --> Svc3[志愿算法推荐服务]
+        Controller --> Svc4[考生档案管理服务]
+        Controller --> Svc5[统计分析服务]
+        
+        Svc1 & Svc2 & Svc3 & Svc4 & Svc5 --> MP[MyBatis-Plus]
+    end
+    
+    subgraph "数据存储层"
+        MP --> MySQL[(MySQL 数据库)]
+        Svc1 -.-> Redis[(Redis 缓存)]
+    end
+```
+
+### 2.4 核心业务时序图 (智能推荐)
+```mermaid
+sequenceDiagram
+    participant U as 考生 (User)
+    participant C as 推荐控制器 (Controller)
+    participant S as 推荐算法服务 (Service)
+    participant DB as 数据库 (MySQL)
+    participant R as 缓存 (Redis)
+    
+    U->>C: 发起推荐请求 (分/位/偏好)
+    C->>S: 调用 recommend()
+    
+    S->>R: 查询院校缓存
+    alt 缓存未命中
+        S->>DB: 读取 zr_school 基础信息
+        DB-->>S: 返回列表
+        S->>R: 更新缓存
+    end
+    
+    S->>S: 策略过滤 (Filter Strategy)
+    note right of S: 过滤非偏好批次/地域
+    
+    loop 核心计算
+        S->>DB: 查询历年同位次录取分
+        S->>S: 计算线差 (Score Diff)
+        S->>S: 判定 冲/稳/保 概率
+    end
+    
+    S-->>C: 返回结果集 (List<Plan>)
+    C-->>U: 展示推荐方案
+```
+
+## 3. 功能模块划分
+依据开题报告，系统后端划分为六大核心模块：
+
+### 3.1 院校专业管理模块
+- 负责 `zr_school`, `zr_major`, `zr_school_major` 表的维护。
+- 实现院校基础信息录入、专业详情更新、特色专业标记。
+
+### 3.2 分数位次管理模块
+- 核心功能：历年高考分数线录入、**位次换算**（查询 `zr_one_minute`）。
+- 关联历年录取数据 (`zr_school_major_score`)，提供同分考生去向查询。
+
+### 3.3 志愿填报管理模块 (核心)
+- **智能推荐**：基于“位次法”和“线差法”计算录取概率（冲、稳、保）。
+- **模拟填报**：考生创建志愿表，系统校验梯度合理性。
+- **风险评估**：分析是否存在滑档风险。
+
+### 3.4 考生信息管理模块
+- 建立考生电子档案（包含高考分、选科、体检信息）。
+- 记录志愿填报历史版本，支持回溯修改。
+
+### 3.5 数据统计分析模块
+- 生成院校录取趋势报表 (Line Chart)。
+- 统计热门专业排行 (Bar Chart)。
+- 分析各地区各专业的就业率分布。
+
+### 3.6 系统管理模块
+- 用户账号管理 (Admin/Student/Planner)。
+- 角色权限分配 (RBAC)。
+- 招生政策与通知公告发布。
+
+## 4. 接口设计规范 (RESTful)
+
+### 4.1 接口设计原则
+- 遵循 RESTful 风格，使用标准的 HTTP 方法 (GET/POST/PUT/DELETE)。
+- 统一响应格式：`{ "code": 200, "msg": "success", "data": {...} }`。
+- 采用 CamelCase 命名法。
+
+### 4.2 核心接口定义
+
+| 模块 | 接口路径 | 方法 | 描述 |
+| :--- | :--- | :--- | :--- |
+| **Auth** | `/api/auth/login` | POST | 用户登录 (JWT) |
+| **School** | `/api/schools/{id}` | GET | 获取院校详情 |
+| **School** | `/api/schools/search` | POST | 多条件筛选院校 |
+| **Score** | `/api/scores/rank` | GET | 分数换算位次及同位分查询 |
+| **Recommend** | `/api/volunteer/recommend` | POST | **[核心]** 获取智能推荐列表 |
+| **Volunteer** | `/api/volunteer/simulate` | POST | 保存模拟志愿表 |
+| **User** | `/api/user/profile` | PUT | 更新考生档案 |
+
+### 4.3 智能推荐接口示例
+**Request (POST /api/volunteer/recommend):**
+```json
+{
+  "province": "重庆",
+  "score": 580,
+  "subject": ["物理", "化学", "生物"],
+  "preference": {
+    "location": ["北京", "上海"],
+    "major_type": "工学"
+  }
+}
+```
+
+**Response:**
+```json
+{
+  "code": 200,
+  "data": {
+    "rush": [ ... ], // 冲一冲列表
+    "steady": [ ... ], // 稳一稳列表
+    "protect": [ ... ] // 保一保列表
+  }
+}
+```
+
+## 5. 部署架构
+- **开发环境**：JDK 1.8+, IntelliJ IDEA, Node.js 16+
+- **服务器**：Tomcat 9 (内置), Nginx
+- **数据库连接池**：Druid
--- a/未完成/文档内容/数据库设计报告_Markdown生成版.md
+++ b/未完成/文档内容/数据库设计报告_Markdown生成版.md
@@ -0,0 +1,173 @@
+# 数据库设计报告
+
+**项目名称**：基于SpringBoot框架的高考志愿辅助填报系统设计与实现  
+**学生姓名**：向黎华  
+**学号**：229970427  
+**学院/班级**：软件学院 / 22软工8班  
+**指导教师**：彭娟  
+
+---
+
+## 1. 引言
+### 1.1 编写目的
+本文档详细描述了高考志愿辅助填报系统的数据库设计，包括概念结构设计、逻辑结构设计以及物理结构设计，旨在为系统开发提供底层数据支撑。
+
+### 1.2 数据库环境
+- 数据库管理系统：MySQL 8.0+
+- 字符集：utf8mb4 (部分历史表为 utf8mb3)
+- 存储引擎：InnoDB (为主), MyISAM (部分用于只读查询优化)
+
+## 2. 概念模型与E-R图
+本系统的核心实体及其关系描述如下：
+
+```mermaid
+erDiagram
+    Member ||--o| Order : places
+    Member {
+        int id
+        string mobile
+        int fraction "高考分"
+        int ranking "位次"
+    }
+    
+    School ||--|{ School_Major : offers
+    School {
+        int id
+        string title
+        tinyint f985
+        tinyint f211
+    }
+    
+    Major ||--|{ School_Major : defines
+    
+    School_Major ||--|{ School_Major_Score : history_data
+    School_Major_Score {
+        float lowest_score
+        int lowest_order
+        int year
+        int province_id
+    }
+    
+    Plan ||--|{ Plan_Step : contains
+    Plan_Step }|--|| School_Major : references
+    
+    Planner ||--o| Member : guides
+```
+
+### 实体关系说明
+1.  **用户 (Member/Planner)**
+    - 分为普通用户（学生/家长）、规划师、商户。
+    - 一个用户可以关联一个商户（归属关系）。
+2.  **学校 (School)**
+    - 拥有多个属性（名称、所在地、层次）。
+    - 包含多个专业 (School_Major)。
+    - 每个专业在不同年份、不同省份有不同的录取分数 (Fractional/Score)。
+3.  **专业 (Major)**
+    - 标准专业库，包含专业类、门类信息。
+4.  **订单 (Order)**
+    - 用户购买规划师服务或商户服务产生订单。
+    - 关联用户、规划师、支付状态。
+5.  **志愿方案 (Plan/Step)**
+    - 规划师为学生制定的志愿方案，包含选定的学校和专业。
+
+## 3. 逻辑结构设计 (数据字典)
+
+### 3.1 核心业务表
+
+#### 1. 规划师表 (`zr_planner`)
+存储规划师的基本信息、认证状态和账户余额。
+
+| 字段名 | 类型 | 描述 | 备注 |
+| :--- | :--- | :--- | :--- |
+| id | int | 主键 | 自增 |
+| username | varchar(64) | 账户名 | |
+| wx_id | varchar(255) | 微信OpenID | 用于微信授权 |
+| type | int | 教师类型 | 1.普通教师 2.志愿规划师 3.专家咨询师 |
+| status | int | 认证状态 | 0.未认证 1.认证中 2.已认证 3.拒绝 |
+| balance | int | 余额 | 单位：分 |
+| merchant | char(8) | 商户号 | 关联商户 |
+
+#### 2. 商户表 (`zr_planner_merchant`)
+存储合作机构/商户的信息。
+
+| 字段名 | 类型 | 描述 | 备注 |
+| :--- | :--- | :--- | :--- |
+| id | int | 主键 | |
+| username | varchar(30) | 用户名 | |
+| merchant | char(8) | 商户号 | 唯一标识 |
+| balance | int | 余额 | 单位：分 |
+| company | varchar(255) | 公司名称 | |
+
+#### 3. 商户学员表 (`zr_planner_merchant_member`)
+商户名下的学生信息。
+
+| 字段名 | 类型 | 描述 | 备注 |
+| :--- | :--- | :--- | :--- |
+| id | int | 主键 | |
+| merchant_number | char(8) | 商户号 | 外键 |
+| mobile | char(11) | 手机号 | |
+| fraction | int | 高考分数 | |
+| ranking | int | 高考位次 | |
+| select_subject | varchar(255) | 选科 | |
+
+### 3.2 基础数据表
+
+#### 1. 学校表 (`zr_school`)
+全国高校基础信息。
+
+| 字段名 | 类型 | 描述 | 备注 |
+| :--- | :--- | :--- | :--- |
+| id | int | 主键 | |
+| title | varchar(100) | 学校名称 | |
+| f985 | tinyint | 是否985 | 1是 |
+| f211 | tinyint | 是否211 | 1是 |
+| province_name | varchar(100) | 前在省份 | |
+
+#### 2. 学校专业分数线 (`zr_school_major_score`)
+核心数据表，记录各校各专业历年在各省的录取数据。
+
+| 字段名 | 类型 | 描述 | 备注 |
+| :--- | :--- | :--- | :--- |
+| id | int | 主键 | |
+| school_id | int | 学校ID | 外键 |
+| title | char(255) | 专业名称 | |
+| lowest_score | float | 最低分 | |
+| lowest_order | int | 最低位次 | 核心参考数据 |
+| batch | char(32) | 批次 | 本科批/专科批等 |
+| year | int | 年份 | |
+| province_id | int | 省份ID | |
+
+#### 3. 一分一段表 (`zr_one_minute`)
+用于位次换算。
+
+| 字段名 | 类型 | 描述 | 备注 |
+| :--- | :--- | :--- | :--- |
+| score | int | 分数 | |
+| num | int | 同分人数 | |
+| cum_num | int | 累计人数 | 即位次 |
+| year | int | 年份 | |
+| province_id | int | 省份ID | |
+
+### 3.4 物理设计与数据量估算
+根据历年高考数据规模，本系统核心表数据量估算如下：
+
+| 表名 | 描述 | 预估数据量 (3年) | 存储策略 |
+| :--- | :--- | :--- | :--- |
+| **zr_school_major_score** | 录取分数线 | ~1500万行 | 分库分表 (按省份/年份)，只读优化 |
+| **zr_one_minute** | 一分一段表 | ~300万行 | Redis 缓存热点数据 |
+| **zr_member** | 注册用户 | ~50万 | 常规 InnoDB 存储 |
+| **zr_school** | 院校库 | ~3000行 | 全量缓存 |
+
+针对海量录取数据，建议采用 MySQL 的分区表特性，按 `year` 进行范围分区，以提高查询效率。
+
+## 4. 其它重要表
+- `zr_major`: 标准专业库
+- `zr_planner_order`: 佣金与提现订单
+- `zr_planner_merchant_service_order`: 服务购买订单
+- `zr_planner_cert`: 规划师资质认证详情
+
+## 5. 索引设计
+为了优化查询性能，针对高频查询字段建立索引：
+- `zr_school_major_score`: 组合索引 `(school_id, province_id, year, batch)`，`(lowest_score, province_id, ...)`
+- `zr_school`: `title` 索引用于搜索
+- `zr_planner`: `wx_id` 索引用于微信登录
--- a/未完成/文档内容/用户需求（规格）说明书_Markdown生成版.md
+++ b/未完成/文档内容/用户需求（规格）说明书_Markdown生成版.md
@@ -0,0 +1,126 @@
+# 用户需求（规格）说明书
+
+**项目名称**：基于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 端与移动端。
--- a/未完成/文档内容/项目验收报告_Markdown生成版.md
+++ b/未完成/文档内容/项目验收报告_Markdown生成版.md
@@ -0,0 +1,46 @@
+# 软件学院本科毕业设计（论文）项目验收报告
+
+**学生姓名**：向黎华  
+**学号**：229970427  
+**专业**：软件工程  
+**班级**：22软工8班  
+
+**校内指导教师姓名**：彭娟  
+**职称**：教授  
+
+**校外指导教师姓名**：(空)  
+**职称**：(空)  
+
+**毕业设计（论文）题目**：基于SpringBoot框架的高考志愿辅助填报系统设计与实现  
+
+## 系统功能完成情况
+
+| 规定的功能或任务 | 完成情况 |
+| :--- | :--- |
+| **1. 院校专业管理模块** | **已完成**。实现了按省份、批次、学科门类对院校信息进行录入与分类管理；支持专业详情更新及历年招生计划维护；能够标记院校专业特色。 |
+| **2. 分数位次管理模块** | **已完成**。成功收录历年高考分数线；实现了基于一分一段表的位次换算功能；支持同分考生录取案例查询。 |
+| **3. 志愿填报管理模块** | **已完成**。核心智能推荐算法已上线，能精准给出“冲稳保”建议；志愿模拟填报功能正常，支持多轮次保存；风险评估功能可有效提示梯度问题。 |
+| **4. 考生信息管理模块** | **已完成**。考生档案建立完整（含高考分、选科、体检信息）；志愿填报历史版本回溯功能运行稳定。 |
+| **5. 数据统计分析模块** | **已完成**。能够生成院校专业录取趋势报表和热门专业排行；支持多维度的精准数据查询。 |
+| **6. 系统管理模块** | **已完成**。实现了基于角色的用户权限控制（管理员、考生、规划师）；日志审计与数据备份功能正常。 |
+
+## 项目成果
+
+| 项目资料名称 | 页数（行数）/ 说明 |
+| :--- | :--- |
+| **1. 源代码 (Source Code)** | 共约 24,000 行 (Backend + Frontend) |
+| **2. 用户需求（规格）说明书** | 详见文档 (覆盖6大模块) |
+| **3. 系统设计说明书** | 含体系结构设计与数据库设计 |
+| **4. 数据库初始化脚本** | data.sql (完整表结构与字典) |
+| **5. 毕业设计（论文）** | 定稿中 |
+
+## 验收意见
+
+(此处由验收组填写)
+
+---
+
+**指导教师（签名）**：____________________
+**日期**：______年____月____日
+
+**说明**：本验收报告的内容作为成绩评定的参考依据。