# LeafSMS
**Repository Path**: jypiot_admin/leaf-sms
## Basic Information
- **Project Name**: LeafSMS
- **Description**: LeafSMS 是一款基于 Vue 3 和 Spring Boot 的开源学生信息管理系统，具备完善的多角色权限控制。该系统完全免费，适用于毕业设计、商业应用及教育管理场景，提供灵活高效的解决方案。
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: https://gitee.com/Yangshengzhou/leaf-sms/
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 13
- **Created**: 2026-05-22
- **Last Updated**: 2026-05-22
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Leaf SMS - 学生学籍管理系统
[](https://github.com/YangShengzhou03/LeafSMS) [](https://github.com/YangShengzhou03/LeafSMS) [](https://github.com/YangShengzhou03/LeafSMS) [](https://vuejs.org/) [](https://spring.io/projects/spring-boot) [](https://www.mysql.com/)
**一个现代化的学生学籍管理系统，采用前后端分离架构**
[快速开始](#快速开始) • [功能特性](#功能特性) • [API文档](./API_DOCUMENTATION.md)
## 项目简介
Leaf SMS（Student Management System）是一个现代化的学生学籍管理系统，采用前后端分离架构，支持多终端浏览器访问，无需本地安装。
## 功能特性
### 系统界面展示
*系统首页*
*管理员控制台*
*学生管理页面*
*个人资料页面*
*操作日志页面*
### 核心功能
- **学生信息管理**：支持学生基本信息的增删改查、批量导入导出以及信息变更记录追踪
- **学籍变动管理**：支持转入转出、休学复学、毕业等变动类型的申请与审核流程
- **班级信息管理**：包括班级维护、班主任分配和学生人数统计
- **成绩管理**：支持成绩录入、统计分析以及按学生查询所有成绩记录
- **考勤管理**：提供考勤记录录入、状态管理和统计分析功能
- **消息管理**：实现消息收发、未读提醒和已读标记
- **用户权限管理**：基于 RBAC 模型，支持多角色权限控制和密码管理
- **操作日志审计**：记录所有关键操作，支持日志查询和安全追溯
- **数据统计分析**：提供学生统计、变动统计、成绩统计和考勤统计等多维度数据分析
## 快速开始
### 一键部署
```bash
curl -sSL https://gitee.com/Yangshengzhou/leaf-sms/raw/master/docker-compose.yml -o docker-compose.yml && wget -O data.sql https://gitee.com/Yangshengzhou/leaf-sms/raw/master/data.sql && docker-compose up -d && sleep 20 && docker ps
```
部署完成后访问：http://localhost
测试账号：
| 邮箱 | 密码 | 角色 |
|--------|------|------|
| chenmh@qq.com | 123456 | 系统管理员 |
| liuxm@qq.com | 123456 | 教务管理员 |
| lixy@qq.com | 123456 | 班主任 |
| wangjg@qq.com | 123456 | 任课教师 |
| zhangwei@qq.com | 123456 | 家长 |
### K3s 部署
使用 K3s 集群部署，适合生产环境使用。
#### 1. 安装 K3s
```bash
curl -sfL https://rancher-mirror.rancher.cn/k3s/k3s-install.sh | INSTALL_K3S_MIRROR=cn sh -
```
#### 2. 验证 K3s 安装
```bash
kubectl get nodes
```
#### 3. 部署应用
```bash
kubectl create namespace leaf-sms && kubectl apply -f https://gitee.com/Yangshengzhou/leaf-sms/raw/master/leaf-sms-k3s.yaml
```
#### 4. 查看部署状态
```bash
kubectl get all -n leaf-sms
```
#### 5. 访问应用
部署完成后，通过以下地址访问：
- **前端**: `http://`
- **后端 API**: `http:///api`
#### 6. 查看日志
```bash
kubectl logs -f deployment/leafsms-backend -n leaf-sms
kubectl logs -f deployment/leafsms-frontend -n leaf-sms
kubectl logs -f deployment/leafsms-mysql -n leaf-sms
```
#### 7. 卸载应用
```bash
kubectl delete -f https://gitee.com/Yangshengzhou/leaf-sms/raw/master/leaf-sms-k3s.yaml
kubectl delete namespace leaf-sms
```
## 数据库设计
系统主要数据表及其功能说明：
| 表名 | 说明 |
|------|------|
| users | 用户表 - 存储系统用户基本信息和认证信息 |
| students | 学生信息表 - 存储学生基本信息和学籍信息 |
| classes | 班级信息表 - 存储班级基本信息和班主任信息 |
| student_changes | 学籍变动表 - 记录学生学籍变动申请和审核信息 |
| info_change_logs | 信息变更记录表 - 记录学生信息变更历史 |
| operation_logs | 操作日志表 - 记录系统关键操作日志 |
| grades | 成绩表 - 存储学生各科成绩信息 |
| attendance | 考勤表 - 存储学生考勤记录 |
| messages | 消息表 - 存储系统内部消息 |
## 开发指南
### 代码规范
- 遵循阿里巴巴 Java 开发手册
- 使用 ESLint 进行前端代码检查
- 提交信息遵循 Conventional Commits 规范
### 分支管理
- `main`：主分支，稳定版本
- `develop`：开发分支
- `feature/*`：功能分支
- `bugfix/*`：修复分支
## 许可证
本项目采用 MIT 许可证，详见 LICENSE 文件。