# teacher

**Repository Path**: laowang667/teacher

## Basic Information

- **Project Name**: teacher
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-03-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 教务考勤管理系统

## 项目简介

一款适配中小型培训机构的轻量化教务考勤管理系统，聚焦"考勤登记 + 教务记录"核心场景。

### 技术栈

#### 后端
- Java JDK 17
- Spring Boot 3.2.0
- MyBatis-Plus 3.5.5
- Spring Security (BCrypt 加密)
- JWT (Token 认证)
- MySQL 8.0

#### 前端
- Vue 3.4
- Vite 5.0
- Element Plus 2.5
- Pinia 2.1
- Vue Router 4.2
- Axios 1.6

## 快速开始

### 1. 数据库初始化

```sql
-- 执行 SQL 脚本创建数据库和表
mysql -u root -p < src/main/resources/schema.sql
```

### 2. 后端配置

修改 `src/main/resources/application.yml` 中的数据库连接信息：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/teacher_attendance?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password
```

### 3. 启动后端服务

```bash
# 在项目根目录执行
mvn clean install
mvn spring-boot:run
```

后端服务将在 http://localhost:8080/api 启动

### 4. 前端配置

```bash
# 进入前端目录
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端服务将在 http://localhost:3000 启动

## 默认账号

- 管理员账号：`admin`
- 密码：`admin123`

## 功能模块

### 1. 数据概览模块
- 今日/本周上课班次统计
- 考勤完成率
- 异常考勤统计
- 各科目授课频次

### 2. 考勤登记模块（核心）
- 选择日期/科目进行考勤登记
- 支持老师/学生两类角色考勤状态
- 批量登记（同班级/同科目学生一键设置）
- 异常考勤备注
- 快速修改已提交记录

### 3. 考勤记录模块
- 多维度查询（日期、星期、时间段、老师、学生、科目、状态）
- 完整信息追溯
- Excel 导出

### 4. 基础设置模块
- 科目管理
- 老师管理
- 学生管理
- 上课时段管理
- 调课/补课标记

### 5. 权限管理模块
- 管理员：系统全量操作权限
- 普通用户：仅本人操作权限
- JWT Token 认证（2 小时有效期）
- BCrypt 密码加密

## API 接口规范

### 统一返回格式

```json
{
  "code": 200,
  "message": "操作成功",
  "data": {},
  "timestamp": 1234567890
}
```

### 状态码说明

- `200`: 成功
- `400`: 参数错误
- `401`: 未登录或 Token 失效
- `403`: 权限不足
- `500`: 系统错误

## 开发计划

- [x] 项目初始化
- [x] 数据库设计
- [x] 后端基础框架搭建
- [x] 权限管理模块
- [x] 前端页面开发（登录页、主布局、数据概览页）
- [ ] 基础设置模块（待开发）
- [ ] 考勤登记模块（待开发）
- [ ] 考勤记录模块（待开发）
- [ ] 数据概览模块（待开发）
- [ ] 系统集成测试

## 当前进度

**已完成功能：**
- ✅ 完整的数据库设计（9 张表）
- ✅ Spring Security + JWT 认证授权
- ✅ BCrypt 密码加密
- ✅ 前后端分离架构
- ✅ 登录、主界面、数据概览页面
- ✅ 统一异常处理和返回结果
- ✅ 完善的开发文档

**系统已可运行并进行登录操作！**

## 注意事项

1. 确保 MySQL 版本为 8.0+
2. 确保 Java 版本为 17+
3. 首次运行需要执行 schema.sql 初始化数据库
4. 默认管理员密码建议首次登录后修改

## 许可证

MIT License