# kebiao

**Repository Path**: yangxsa/kebiao

## Basic Information

- **Project Name**: kebiao
- **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-06-30
- **Last Updated**: 2026-07-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 课表系统

一个基于 Spring Boot + Vue3 的课表管理系统，支持课程管理、课表安排和模板配置功能。

## 项目简介

课表系统是一套完整的前后端分离项目，用于管理课程信息和课表安排。系统采用现代化技术栈构建，提供友好的用户界面和 RESTful API。

## 技术栈

### 后端
- **JDK 21** - Java 运行环境
- **Spring Boot 3.2.5** - 后端框架
- **MySQL 8.0+** - 数据库
- **MyBatis-Plus 3.5.6** - ORM 框架
- **Hutool 5.8.26** - 工具库
- **Knife4j 4.4.0** - API 文档
- **JWT 0.12.5** - 身份认证

### 前端
- **Vue 3** - 前端框架
- **Element Plus** - UI 组件库
- **Vite** - 构建工具
- **Pinia** - 状态管理

## 功能模块

### 1. 认证管理
- 用户登录
- 获取用户信息
- 用户退出

### 2. 课程管理
- 课程列表查询
- 新增课程
- 编辑课程
- 删除课程

### 3. 课表管理
- 课表安排列表
- 新增课表安排
- 编辑课表安排
- 删除课表安排
- 导入/导出课表

### 4. 模板配置
- 模板列表
- 模板选项
- 保存/更新/删除模板

## 快速开始

### 环境要求

- JDK 21+
- Maven 3.8+
- MySQL 8.0+
- Node.js 18+ (前端)

### 后端部署

1. **创建数据库**

```bash
mysql -u root -p < sql/init.sql
```

2. **修改数据库配置**

编辑 `src/main/resources/application.yml`：

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/timetable_db
    username: your_username
    password: your_password
```

3. **启动后端服务**

```bash
# 开发模式启动
mvn spring-boot:run

# 打包后启动
mvn clean package -DskipTests
java -jar target/timetable-backend-1.0.0.jar
```

### 前端部署

```bash
# 安装依赖
cd front
pnpm install

# 开发模式启动
pnpm dev

# 生产构建
pnpm build
```

## 默认账号

- 用户名：`admin`
- 密码：`123456`

## API 文档

服务启动后访问：http://localhost:8080/doc.html

### 主要接口

| 模块 | 接口 | 方法 | 描述 |
|------|------|------|------|
| 认证 | /api/auth/login | POST | 用户登录 |
| 认证 | /api/auth/info | GET | 获取用户信息 |
| 课程 | /api/timetable/course/list | POST | 课程列表 |
| 课程 | /api/timetable/course | POST | 新增课程 |
| 课表 | /api/timetable/schedule/list | POST | 课表列表 |
| 模板 | /api/timetable/template/list | GET | 模板列表 |

## 项目结构

```
├── pom.xml                    # Maven 配置
├── sql/
│   └── init.sql               # 数据库初始化脚本
├── Dockerfile                 # Docker 部署配置
└── src/
    ├── main/
    │   ├── java/com/timetable/
    │   │   ├── TimetableApplication.java    # 启动类
    │   │   ├── config/                      # 配置类
    │   │   ├── controller/                  # 控制器
    │   │   ├── entity/                      # 实体类
    │   │   ├── service/                     # 业务逻辑
    │   │   ├── mapper/                      # 数据访问层
    │   │   ├── interceptor/                 # 拦截器
    │   │   └── util/                        # 工具类
    │   └── resources/
    │       └── application.yml               # 应用配置
    └── test/                                # 测试代码
```

## Docker 部署

```bash
# 构建镜像
docker build -t timetable-backend .

# 运行容器
docker run -d -p 8080:30883 --name timetable timetable-backend
```

## 许可证

MIT License