# gaokaoVolunteerAssistant

**Repository Path**: kml/gaokaoVolunteerAssistant

## Basic Information

- **Project Name**: gaokaoVolunteerAssistant
- **Description**: 四川高考志愿填报智能助手，整合2026招生计划/历年录取分数/一分一段/投档线，基于DeepSeek提供AI对话与冲稳保志愿推荐（Spring Boot 3 + Vue 3 + MySQL）
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-26
- **Last Updated**: 2026-08-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gaokao 高考志愿填报智能助手

面向四川考生的高考志愿填报查询与 AI 智能推荐系统。整合 **2026 年招生计划、历年专业录取分数线、一分一段、院校投档分、院校/专业基础信息**，并提供基于 DeepSeek 的 AI 对话预测与三模式志愿推荐。

## 项目结构

```
code/
├── gaokao-backend/    # Spring Boot 后端（端口 8080）
│   └── src/main/resources/application.example.yml  # 配置模板（真实配置不入库）
├── gaokao-frontend/   # Vue 3 + Vite 前端
├── scripts/           # Python 数据导入脚本（01~16 按序执行）
└── sql/
    ├── init.sql       # 数据库结构（15 张表，与线上库一致）
    └── data/          # 全量真实数据（每表一个 .sql.gz，共 ~80MB）
```

## 技术栈

| 端 | 技术 |
|---|---|
| 后端 | Java 21 · Spring Boot 3 · MyBatis-Plus · Springdoc · DeepSeek AI |
| 前端 | Vue 3 · TypeScript · Vite 5 · Element Plus · Pinia · ECharts |
| 数据 | MySQL 8 (utf8mb4) · Python 导入脚本 |

## 数据库（gaokao）

| 表 | 说明 |
|---|---|
| `admission_plan` | 2026 年招生计划（38.6 万条） |
| `admission_score` | 历年专业录取分数线（32 万条） |
| `school_score` | 院校投档分 |
| `score_rank` | 一分一段表 |
| `school` | 院校基础信息（含保研率、特色专业等） |
| `school_major_intro` | 院校×专业介绍（6.3 万条，最大数据表） |
| `admission_charter` | 招生章程全文（含录取规则） |
| `major_group_score` | 专业组投档分数 |
| `major` / `special_major` / `major_detail` | 专业信息 / 特色专业 / 专业详情 |
| `plan_with_score_view` | 招生计划 × 历年分数预计算表 |
| `batch_normalization` | 批次名归一化映射 |
| `ai_conversation` / `ai_cache` | AI 对话历史 / DeepSeek 回答缓存 |

## 快速开始

### 1. 初始化数据库

```bash
# 1) 建表（15 张表结构）
mysql -u <user> -p < code/sql/init.sql

# 2) 导入全量数据（解压后逐表导入）
cd code/sql/data
for f in *.sql.gz; do gunzip -k "$f"; done
mysql -u <user> -p gaokao < batch_normalization.sql
# ... 其余表依次导入，或：
for f in *.sql; do mysql -u <user> -p gaokao < "$f"; done
```

### 2. 后端

```bash
# 复制模板并填入数据库连接与 DeepSeek API Key
cp gaokao-backend/src/main/resources/application.example.yml \
   gaokao-backend/src/main/resources/application.yml

cd code/gaokao-backend
mvn spring-boot:run
# Swagger UI: http://localhost:8080/swagger-ui.html
```

### 3. 前端

```bash
cd code/gaokao-frontend
npm install
npm run dev        # http://localhost:5173 （/api 自动代理到 8080）
```

### 4. 数据导入（可选）

按 `code/scripts/run_all.sh` 中的顺序执行 Python 脚本，将 Excel 数据导入 MySQL。

## 功能亮点

- 🔍 招生计划 / 录取分数 / 一分一段 / 投档线多维查询，支持 物理/历史 分科筛选
- 🏫 院校详情：院校简介、保研率、特色专业、招生章程、城市产业匹配
- 🤖 AI 智能对话：基于 DeepSeek，支持学校/专业问答与回答缓存
- 📊 三模式志愿推荐：冲/稳/保 梯度推荐，结合 2024-2026 分数与位次
- 📱 移动端优先的响应式设计（Element Plus）

> ⚠️ 注意：`application.yml` 与 `.env.*` 包含真实凭据，已被 `.gitignore` 排除，请使用 `application.example.yml` 模板配置。

## 赞助支持

如果这个项目对你有帮助，欢迎赞助支持作者，感谢你的认可！

<p align="center">
  <img src="assets/alpay.jpg" width="240" alt="支付宝赞助" />&nbsp;&nbsp;&nbsp;&nbsp;
  <img src="assets/way.jpg" width="240" alt="微信赞助" />
</p>