# orange

**Repository Path**: liuke9010/orange

## Basic Information

- **Project Name**: orange
- **Description**: AI辅助生成的服务代码
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-17
- **Last Updated**: 2026-06-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: use

## README

# Orange 大橙子管理系统

一个基于 Spring Boot 开发的员工考勤管理系统，提供员工管理、考勤记录、请假申请等功能。

## 技术栈

- **后端框架**: Spring Boot 3.3.6
- **Java 版本**: 17
- **数据库**: PostgreSQL
- **ORM框架**: MyBatis-Plus 3.5.14
- **模板引擎**: Thymeleaf
- **构建工具**: Maven
- **其他**: Lombok

## 主要功能

### 1. 员工管理
- 员工信息的增删改查
- 员工状态管理（在职/离职）
- 员工搜索功能

### 2. 考勤管理
- 员工签到/签退
- 考勤记录查询
- 考勤规则配置
- 考勤仪表板

### 3. 请假管理
- 请假申请提交
- 请假审批流程
- 请假记录查询

## 项目结构

```
orange/
├── src/
│   ├── main/
│   │   ├── java/com/aruis/orange/
│   │   │   ├── config/           # 配置类
│   │   │   ├── controller/       # 控制器层
│   │   │   ├── mapper/           # 数据访问层
│   │   │   ├── model/            # 实体类
│   │   │   └── service/          # 服务层
│   │   └── resources/
│   │       ├── db/               # 数据库初始化脚本
│   │       ├── mapper/           # MyBatis XML映射文件
│   │       ├── templates/        # Thymeleaf模板页面
│   │       └── application.properties  # 配置文件
│   └── test/
└── pom.xml
```

## 快速开始

### 1. 环境要求
- JDK 17+
- PostgreSQL 数据库
- Maven 3.6+

### 2. 数据库配置

创建数据库并执行初始化脚本：

```sql
-- 创建数据库
CREATE DATABASE orange_attendance;

-- 执行 src/main/resources/db/init.sql 脚本
```

### 3. 修改配置文件

根据你的数据库配置修改 `src/main/resources/application.properties`：

```properties
spring.datasource.url=jdbc:postgresql://localhost:5432/orange_attendance
spring.datasource.username=your_username
spring.datasource.password=your_password
```

### 4. 运行项目

使用 Maven 编译并运行：

```bash
mvn clean install
mvn spring-boot:run
```

或者直接运行主类 `OrangeApplication`。

### 5. 访问应用

启动成功后，访问：http://localhost:9529

## 数据库表结构

### employee（员工表）
- 员工基本信息：姓名、工号、部门、职位等
- 状态：0-在职，1-离职

### attendance_record（考勤记录表）
- 记录员工每天的签到/签退信息
- 包含签到/签退时间和地点

### leave_request（请假申请表）
- 员工请假申请记录
- 包含请假类型、时间、审批状态

### attendance_rule（考勤规则表）
- 配置考勤时间规则
- 默认规则：09:00上班，18:00下班

### sys_user（系统用户表）
- 系统用户信息
- 默认管理员：admin / admin123

## 默认数据

系统初始化后包含以下测试数据：
- 5名测试员工（EMP001-EMP005）
- 默认考勤规则（09:00-18:00）
- 默认管理员账户

## 开发说明

### 构建项目
```bash
mvn clean package
```

### 运行测试
```bash
mvn test
```

## 许可证

本项目仅供学习和交流使用。