# paiban

**Repository Path**: sh_zouxw/paiban

## Basic Information

- **Project Name**: paiban
- **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-01-15
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 排班管理系统

## 项目简介

排班管理系统是一个用于管理班组信息、班次配置和值班排班的综合管理系统。系统支持灵活的班次配置（2班制或3班制），以及班组和人员的排班管理。

## 技术栈

- **框架：** Spring Boot 3.1.5
- **ORM：** MyBatis Plus 3.5.4.1
- **数据库：** MySQL 8.0+
- **工具类：** Hutool 5.8.22
- **API文档：** Knife4j 4.4.0
- **构建工具：** Maven
- **JDK版本：** 17

## 项目结构

```
paiban-system/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/paiban/
│   │   │       ├── common/          # 公共模块
│   │   │       ├── config/          # 配置类
│   │   │       ├── entity/          # 实体类
│   │   │       ├── mapper/          # Mapper接口
│   │   │       ├── service/         # Service层
│   │   │       ├── controller/     # Controller层
│   │   │       └── dto/             # DTO对象
│   │   └── resources/
│   │       ├── mapper/              # Mapper XML文件
│   │       └── application.yml      # 配置文件
│   └── test/                        # 测试代码
├── docs/                            # 文档
└── pom.xml                          # Maven配置
```

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.6+
- MySQL 8.0+

### 数据库配置

1. 创建数据库：
```sql
CREATE DATABASE paiban_system DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 修改 `application.yml` 中的数据库连接配置：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/paiban_system?...
    username: your_username
    password: your_password
```

### 运行项目

1. 克隆项目到本地
2. 导入Maven依赖
3. 配置数据库连接
4. 运行 `PaibanSystemApplication` 主类
5. 访问API文档：http://localhost:8080/doc.html

## API文档

启动项目后，访问 Swagger 文档：
- Knife4j文档：http://localhost:8080/doc.html

## 功能模块

- 人员管理
- 班组管理
- 班次管理
- 班次配置（支持2班制/3班制）
- 排班表管理
- 自动分配（抽管理）

## 开发进度

详见 `docs/实现任务列表.md`

## 许可证

Apache 2.0