家校互动系统
基于 Spring Boot 3 与 Vue 3 的家校互动平台，支持通知发布、作业布置与批改、消息沟通、家长会管理；管理员可管理全系统用户。
项目截图
功能概览
| 模块 | 说明 |
|---|---|
| 首页 | 仪表盘：待办通知、未读消息、作业与家长会入口 |
| 通知 | 发布/查看通知，类型筛选，置顶与阅读确认 |
| 作业 | 布置作业、提交作业、批改与成绩 |
| 消息 | 私信、通讯录、群聊、家长留言 |
| 家长会 | 发布/查看家长会，时间地点与回执 |
| 用户管理 | 仅管理员：用户分页、编辑、重置密码、删除 |
| 孩子管理 | 仅家长：孩子信息管理 |
| 个人中心 | 个人信息、修改密码 |
角色与权限
| 角色 | 说明 |
|---|---|
| ADMIN | 管理员：用户管理（增删改、重置密码）；可发布通知/作业/家长会；无删除通知/作业权限 |
| TEACHER | 教师：发布通知/作业/家长会，批改作业，可删除通知/作业 |
| PARENT | 家长：查看通知、提交作业、消息、家长会，孩子管理 |
技术栈
- 后端：Spring Boot 3.x、Spring Security、JWT、MyBatis-Plus、MySQL、Redis、WebSocket
- 前端：Vue 3、Vite、Pinia、Vue Router、Element Plus、Axios
项目结构
Parent-School/
├── backend/ # 后端
│ ├── src/main/java/com/school/parent/
│ │ ├── common/ # 统一响应、异常
│ │ ├── config/ # Security、MyBatis、Redis、CORS、WebSocket
│ │ ├── security/ # JWT、登录过滤器
│ │ └── module/
│ │ ├── user/ # 用户、登录、注册、用户管理
│ │ ├── announcement/ # 通知
│ │ ├── homework/ # 作业与提交
│ │ ├── message/ # 私信、群聊、家长留言
│ │ └── meeting/ # 家长会
│ └── src/main/resources/
│ ├── application.yml
│ ├── schema.sql # 建表脚本
│ └── data-test.sql # 可选示例数据
│
└── frontend/ # 前端
├── src/
│ ├── api/ # 接口
│ ├── layouts/ # 布局（侧边栏、头部）
│ ├── views/ # 页面
│ ├── stores/ # Pinia
│ └── router/
└── vite.config.js # 开发代理 /api、/ws → 8080快速开始
1. 数据库
创建库并执行建表（脚本会创建 parent_school 及所有表）：
bash
cd backend
mysql -u root -p < src/main/resources/schema.sql或手动在 MySQL 中执行 backend/src/main/resources/schema.sql。
2. 配置
编辑 backend/src/main/resources/application.yml：
spring.datasource.url / username / password：MySQL 连接spring.data.redis：Redis（可选，部分功能依赖）jwt.secret：JWT 密钥（生产环境请改为 64 字符以上随机串）
3. 启动后端
bash
cd backend
mvn spring-boot:run默认端口：8080 。首次运行若无用户会自动创建管理员 admin / admin123。
4. 启动前端
bash
cd frontend
npm install --registry=https://registry.npmmirror.com
npm run dev默认端口：5173 ，代理 /api、/ws 到 8080。
5. 访问
- 前端：http://localhost:5173
- 登录后按角色看到对应菜单（管理员有「用户管理」，家长有「孩子管理」）。
测试数据（可选）
使用内置 TestDataGenerator 可一次性生成大量测试数据（仅当 spring.profiles.active=testdata 时执行，且不启动 Web 服务）：
bash
cd backend
mvn spring-boot:run "-Dspring-boot.run.profiles=testdata"生成规模（库中无用户时）：1 管理员 + 50 教师 + 200 家长，以及通知、作业、作业提交、私信、群聊、家长留言、家长会等。
| 数据类型 | 数量说明 |
|---|---|
| 用户 | admin / admin123；teacher001～teacher050、parent001～parent200 密码均为 123456 |
| 通知/作业/家长会等 | 见 TestDataGenerator 注释 |
若库中已有用户，则只复用现有用户并生成业务数据。也可仅执行 data-test.sql 插入少量示例数据。
API 概览
| 接口 | 说明 |
|---|---|
POST /api/auth/login |
登录 |
POST /api/auth/register |
注册 |
GET /api/auth/info |
当前用户信息 |
GET /api/announcement/list |
通知列表（分页、类型、关键字） |
GET /api/homework/list |
作业列表 |
GET /api/message/list |
会话列表 |
GET /api/meeting/list |
家长会列表 |
GET /api/user/page |
用户分页（仅 ADMIN） |
PUT /api/user/{id} |
更新用户（仅 ADMIN） |
DELETE /api/user/{id} |
删除用户（仅 ADMIN，不可删自己） |
更多见各 Controller。
说明
- 首次运行前请执行
schema.sql并配置数据库与jwt.secret。 - 管理员可由 InitRunner 自动创建（admin/admin123），或通过注册接口注册后手动改角色。
- 文件上传路径见
application.yml中的file.upload-path，可按需配置静态资源映射。