面向学生办事与教务管理协同的学籍服务系统。项目提供学生服务门户和管理后台，支持学籍查询、学籍异动申请、公告与办事指南、服务评价、审核处理、统计报表、操作日志以及 AI 办事建议。
- 学生服务门户：学籍查询、学生登录与注册、异动申请、办事进度查询、公告、办事指南、服务评价和 AI 办事建议。
- 管理后台：学生、班级、院系和教职工信息管理；异动申请审核；公告、指南与反馈处理；操作日志与统计报表。
- 数据保障：MyBatis 持久化访问 MySQL；数据库不可用时，部分查询和办事流程可使用内置离线数据降级展示。
- AI 建议：通过可配置的兼容 Chat Completions 接口生成合规、可执行的办事与风险研判建议；未配置密钥时不会在仓库中保留任何真实密钥。
- Java 17
- Spring Boot 3.3.11
- MyBatis 3.0.4、PageHelper
- MySQL 8
- Lombok、JWT、Spring AOP
- 原生 HTML、CSS、JavaScript 静态页面
src/main/java/org/example/ Spring Boot 应用、控制器、服务与数据访问层
src/main/resources/static/ 学生门户、管理后台及共享前端资源
src/main/resources/application.yml 服务、数据库、对象存储和 AI 配置
sql/ MySQL 初始化与升级脚本
scripts/ 本地启动、数据库导入及文档处理脚本
src/test/ 单元测试与项目交付物检查
- JDK 17
- Maven 3.9 或更高版本（也可使用项目内的 Maven Wrapper）
- MySQL 8.0 或兼容版本
- 可选：DeepSeek 或兼容 Chat Completions API 的访问密钥
初始化脚本会重建 tlias 数据库及其示例数据。请仅在本地开发数据库中执行：
./scripts/import-db.ps1 -User root -Password "你的 MySQL 密码"也可以手动执行 sql/school_roll_management.sql。已有旧库需要增量调整时，参考 sql/tlias_schema_upgrade.sql。
复制示例文件为本地配置文件，并按实际环境填写数据库与 AI 参数：
Copy-Item .env.example .env常用配置项：
| 变量 | 说明 | 默认值 |
|---|---|---|
SERVER_PORT |
服务端口 | 18080 |
DB_URL |
MySQL JDBC 地址 | jdbc:mysql://localhost:3306/tlias |
DB_USERNAME |
数据库用户名 | root |
DB_PASSWORD |
数据库密码 | 空 |
LLM_ENDPOINT |
AI 服务 Chat Completions 地址 | DeepSeek 地址 |
LLM_MODEL |
AI 模型名称 | deepseek-chat |
DEEPSEEK_API_KEY |
AI 服务密钥 | 空 |
.env、.env.local 和所有真实密钥均由 .gitignore 排除，禁止提交。
mvn clean package
java -jar target/school-roll-management-0.0.1-SNAPSHOT.jar或者使用启动脚本，它会读取 .env 并自动构建：
./scripts/start-local.ps1服务启动后访问：
- 学生服务门户：
http://localhost:18080/或http://localhost:18080/portal.html - 管理后台：
http://localhost:18080/admin.html
初始化脚本中提供本地演示管理员账号 admin，密码 123456。仅用于本地演示，部署前必须更换。
运行完整测试：
mvn test应用配置位于 src/main/resources/application.yml，支持通过环境变量覆盖端口、数据库、阿里云 OSS 和 AI 服务参数。生产环境应使用安全的密钥管理方案注入敏感配置，切勿将数据库密码、对象存储凭证或 API 密钥提交到版本控制。
本项目用于软件系统开发实训交付。未单独声明的第三方组件遵循其各自许可证。