# maven-project **Repository Path**: qzh200/maven-project ## Basic Information - **Project Name**: maven-project - **Description**: A Maven project - **Primary Language**: Java - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-08-29 - **Last Updated**: 2025-12-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 学生信息管理系统 📚 一个基于Spring Boot开发的现代化学生信息管理系统,提供完整的学生数据管理、用户认证、活动记录追踪等功能。 ## 🚀 项目特色 - 🎯 **现代化UI设计** - 采用Tailwind CSS构建响应式界面 - 🔐 **安全认证系统** - 支持用户注册、登录、邮箱激活 - 📊 **完整的学生管理** - CRUD操作、搜索、分页、数据统计 - 📋 **活动记录追踪** - 详细记录用户操作历史 - 📧 **邮件通知系统** - 账户激活、密码重置邮件发送 - 🛡️ **数据安全保护** - Spring Security集成,会话管理 ## 🛠️ 技术栈 ### 后端技术 - **Spring Boot 3.5.5** - 主框架 - **Spring Data JPA** - 数据持久化 - **Spring Security** - 安全认证 - **Spring Boot Mail** - 邮件服务 - **MySQL** - 数据库 - **HikariCP** - 连接池 - **Java 21** - 编程语言 ### 前端技术 - **JSP + JSTL** - 服务端渲染 - **Tailwind CSS** - 样式框架 - **Font Awesome** - 图标库 - **JavaScript** - 前端交互 ### 开发工具 - **Maven** - 项目管理和构建 - **H2 Database** - 测试数据库 ## 📋 功能模块 ### 🔐 用户认证模块 - 用户注册(邮箱验证) - 用户登录/登出 - 密码重置(邮箱验证) - 会话管理 - 权限控制 ### 👥 学生管理模块 - 学生信息增删改查 - 多条件搜索和筛选 - 分页显示 - 数据统计 - 批量操作 ### 📊 个人资料模块 - 个人信息查看和编辑 - 账户状态管理 - 登录历史查看 ### 📋 活动记录模块 - 用户操作日志记录 - 活动类型分类统计 - 按时间范围查询 - 详细操作历史 ## 🚀 快速开始 ### 环境要求 - **Java 21+** - **Maven 3.6+** - **MySQL 8.0+** - **网络连接**(用于邮件发送功能) ### 安装步骤 1. **克隆项目** ```bash git clone cd maven ``` 2. **配置数据库** ```sql -- 创建数据库(如果不存在) CREATE DATABASE student_management CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; ``` 3. **配置邮件服务** 编辑 `src/main/resources/application.properties` 文件: ```properties # 邮件配置 - 请替换为你的邮箱配置 spring.mail.host=smtp.qq.com spring.mail.username=your-email@qq.com spring.mail.password=your-app-password app.from-email=your-email@qq.com ``` 4. **配置数据库连接** ```properties # MySQL数据库连接配置 spring.datasource.url=jdbc:mysql://localhost:3306/student_management?useSSL=false&serverTimezone=Asia/Shanghai&characterEncoding=UTF-8 spring.datasource.username=root spring.datasource.password=your-password ``` 5. **构建和运行** ```bash # 构建项目 mvn clean package -DskipTests # 运行应用 java -jar target/maven-0.0.1-SNAPSHOT.jar ``` 6. **访问应用** 打开浏览器访问:`http://localhost:8081` ## 📝 使用指南 ### 初次使用 1. **注册账户** - 访问注册页面 - 填写用户信息 - 验证邮箱激活账户 2. **登录系统** - 使用激活的账户登录 - 进入主界面 3. **管理学生信息** - 添加学生记录 - 搜索和筛选学生 - 编辑学生信息 - 查看统计数据 ### 主要页面 - **首页** (`/`) - 系统概览和功能介绍 - **登录** (`/login`) - 用户登录 - **注册** (`/register`) - 新用户注册 - **学生管理** (`/student/list`) - 学生信息管理 - **个人资料** (`/profile`) - 个人信息管理 - **活动记录** (`/profile/activities`) - 操作历史查看 ## 🗄️ 数据库设计 ### 核心数据表 1. **users** - 用户表 - 用户基本信息 - 账户状态管理 - 登录凭证 2. **students** - 学生表 - 学生基本信息 - 联系方式 - 班级信息 3. **activity_logs** - 活动日志表 - 操作记录 - 时间戳 - IP地址跟踪 4. **activation_tokens** - 激活令牌表 - 邮箱验证 - 密码重置令牌 ## 🔧 配置说明 ### 应用配置 ```properties # 服务器端口 server.port=8081 # 应用信息 app.name=学生管理系统 app.base-url=http://localhost:8081 ``` ### 数据库配置 ```properties # JPA配置 spring.jpa.hibernate.ddl-auto=update spring.jpa.show-sql=true spring.jpa.properties.hibernate.format_sql=true ``` ### 连接池配置 ```properties # HikariCP连接池 spring.datasource.hikari.maximum-pool-size=20 spring.datasource.hikari.minimum-idle=5 spring.datasource.hikari.connection-timeout=30000 ``` ## 🧪 测试 ```bash # 运行所有测试 mvn test # 运行特定测试类 mvn test -Dtest=StudentServiceTest # 跳过测试构建 mvn package -DskipTests ``` ## 📊 项目结构 ``` src/ ├── main/ │ ├── java/org/example/maven/ │ │ ├── config/ # 配置类 │ │ ├── controller/ # 控制器 │ │ ├── entity/ # 实体类 │ │ ├── interceptor/ # 拦截器 │ │ ├── repository/ # 数据访问层 │ │ ├── service/ # 业务逻辑层 │ │ └── util/ # 工具类 │ ├── resources/ │ │ └── application.properties │ └── webapp/ │ ├── *.jsp # JSP页面 │ └── profile/ # 个人资料相关页面 └── test/ # 测试代码 ``` ## 🤝 贡献指南 1. Fork 项目 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`) 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`) 4. 推送到分支 (`git push origin feature/AmazingFeature`) 5. 创建 Pull Request ## 📄 许可证 本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情 ## 🐛 问题反馈 如果您遇到任何问题或有建议,请通过以下方式联系: - 提交 [Issue](https://github.com/your-repo/issues) - 发送邮件至:support@example.com ## 📚 更新日志 ### v0.0.1-SNAPSHOT (当前版本) - ✅ 基础用户认证系统 - ✅ 学生信息管理功能 - ✅ 活动记录追踪 - ✅ 邮件通知系统 - ✅ 响应式UI设计 ## 🔮 未来计划 - [ ] 批量导入/导出功能 - [ ] 高级搜索功能 - [ ] 数据可视化图表 - [ ] 移动端适配优化 - [ ] API接口开发 - [ ] 多语言支持 --- **开发团队** ❤️ 使用 Spring Boot 和 现代化技术栈构建 如果这个项目对您有帮助,请给我们一个 ⭐ Star!