软件学院学籍管理系统平台

本项目是软件系统开发实训交付项目，基于原有 Java Web / Spring Boot 原型改造升级而来，题目为“软件学院学籍管理系统平台的设计与实现”。系统围绕“查询-申请-审核-反馈”的学籍服务主线，提供学生端门户和教务后台管理两类入口。

实训信息

• 实训时间：2026年6月29日-2026年7月10日
• 项目名称：软件学院学籍管理系统平台
• 交付内容：源代码与可运行服务、数据库脚本、实训报告、实训日记、答辩材料
• 示例参考：反诈先锋实战示例项目的“前台门户 + 后台管理 + 数据表 + 资源素材 + 统计展示 + 运行脚本”完整链路

核心功能

• 学生端门户：学籍查询、异动申请、办理进度、办事指南、智能办事建议
• 后台管理端：登录鉴权、学生档案、行政班级、学院组织、异动审核、统计报表
• 业务闭环：学生提交申请，教务审核通过或驳回，学生端查询处理结果
• AI 建议：可选接入 DeepSeek Chat Completions API；未配置密钥时使用本地规则返回建议
• 离线保障：数据库不可用时，关键门户接口使用本地保障数据，方便教学环境演示

技术栈

• Java 17
• Spring Boot 3.3.11
• Spring Web
• MyBatis
• MySQL
• PageHelper
• JWT
• Spring AOP
• 静态 HTML/CSS/JavaScript 前端
• DeepSeek Chat Completions API（可选）

项目结构

pom.xml
sql/school_roll_management.sql
src/main/java/org/example/controller      REST 控制层
src/main/java/org/example/service         业务服务接口
src/main/java/org/example/service/impl    业务服务实现
src/main/java/org/example/dao             MyBatis DAO
src/main/java/org/example/llm             大模型客户端
src/main/java/org/example/config          配置类
src/main/resources/org/example/dao        MyBatis XML 映射
src/main/resources/static                 学生端与后台端静态页面
src/test/java/org/example                 单元测试与项目交付测试

本地运行

1. 初始化数据库：

mysql -u root -p < sql/school_roll_management.sql

2. 设置可选环境变量：

$env:DB_URL="jdbc:mysql://localhost:3306/tlias"
$env:DB_USERNAME="root"
$env:DB_PASSWORD=""
$env:SERVER_PORT="18080"

3. 启动服务：

mvn clean package
java -jar target/school-roll-management-0.0.1-SNAPSHOT.jar

4. 访问入口：

• 学生端门户：http://127.0.0.1:18080/portal.html
• 学籍查询：http://127.0.0.1:18080/portal-query.html
• 异动申请：http://127.0.0.1:18080/portal-apply.html
• 办理进度：http://127.0.0.1:18080/portal-progress.html
• 智能建议：http://127.0.0.1:18080/portal-ai.html
• 后台入口：http://127.0.0.1:18080/admin.html

后台测试账号

username: admin
password: 123456

AI 配置

AI 功能不强制依赖外部密钥。未配置密钥时，系统会使用本地规则生成办事建议。

可选环境变量：

• DEEPSEEK_API_KEY
• LLM_ENDPOINT，默认 https://api.deepseek.com/chat/completions
• LLM_MODEL，默认 deepseek-v4-flash
• LLM_MAX_TOKENS
• LLM_TEMPERATURE
• LLM_REQUEST_TIMEOUT_SECONDS

验证命令

mvn test
mvn package -DskipTests

当前基线：mvn test 通过 11 个测试，覆盖 JWT、离线保障数据、门户控制器、项目文件和 AI 架构约束。

升级工作链路

项目升级遵循以下闭环：

实训要求识别
  -> 题目与交付物确认
  -> 原型与反诈先锋示例对照
  -> 需求边界收敛
  -> 前后台功能拆分
  -> 数据库与 DAO 层整理
  -> 服务层业务校验和状态流转
  -> 学生端与后台端页面联调
  -> AI 建议与离线保障补充
  -> 单元测试、打包、浏览器验证
  -> 报告、日记、运行说明和答辩材料归档

更详细的模块地图和后续升级路线见 PROJECT_MAP.md。

Local env file

Copy .env.example to .env, then fill database and DeepSeek values. Keep .env local and do not commit it.

`powershell Copy-Item .env.example .env

edit .env: set DB_URL, DB_USERNAME, DB_PASSWORD, DEEPSEEK_API_KEY

.\scripts\start-local.ps1 `