# LaborSettlementPlatform

**Repository Path**: butterflyjay/labor-settlement-platform

## Basic Information

- **Project Name**: LaborSettlementPlatform
- **Description**: 基于Spring Boot的劳务结算平台，贴合公司实际业务需求。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业级管理系统

## 项目概述

一套完整的企业级管理系统，支持角色权限、在线Excel、支付审核、人员管理等核心功能。

## 技术栈

### 后端技术栈
- Spring Boot 2.7.18
- Spring Security 5.7.x + JWT
- MyBatis Plus 3.5.3.x
- MySQL 8.0.40
- Redis 6.x
- EasyExcel 3.3.x
- Swagger 2.x

### 前端技术栈
- Vue 3.3.x + Composition API
- Element Plus 2.3.x
- Axios 1.5.x
- Vue Router 4.x
- Pinia 2.1.x
- ECharts 5.4.x
- XLSX (SheetJS)

## 项目结构

```
Pay_app/
├── backend/                 # 后端项目
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/payapp/
│   │   │   │   ├── config/      # 配置类
│   │   │   │   ├── controller/   # 控制器
│   │   │   │   ├── service/      # 服务层
│   │   │   │   ├── mapper/       # Mapper接口
│   │   │   │   ├── entity/       # 实体类
│   │   │   │   ├── dto/          # 数据传输对象
│   │   │   │   ├── vo/           # 视图对象
│   │   │   │   ├── common/       # 通用类
│   │   │   │   ├── exception/    # 异常处理
│   │   │   │   ├── security/     # 安全配置
│   │   │   │   └── util/         # 工具类
│   │   │   └── resources/
│   │   │       ├── application.yml
│   │   │       └── db/
│   │   │           └── schema.sql
│   │   └── pom.xml
│   └── README.md
├── frontend/                # 前端项目
│   ├── src/
│   │   ├── api/             # API接口
│   │   ├── assets/          # 静态资源
│   │   ├── components/      # 组件
│   │   ├── layout/          # 布局
│   │   ├── router/          # 路由
│   │   ├── store/           # 状态管理
│   │   ├── styles/          # 样式
│   │   ├── utils/           # 工具函数
│   │   ├── views/           # 页面
│   │   ├── App.vue
│   │   └── main.js
│   ├── package.json
│   └── vite.config.js
└── README.md
```

## 功能模块

### 1. 权限管理模块
- 用户管理：CRUD、重置密码、分配角色
- 角色管理：角色CRUD、权限分配（菜单级、按钮级）
- 菜单管理：动态路由配置、图标管理、排序
- 操作日志：记录用户操作、支持检索

### 2. 在线Excel模块
- 模板管理：预定义Excel模板
- 数据导入：支持校验规则、错误提示、批量导入
- 数据导出：条件筛选导出、自定义列导出
- 在线预览：表格数据展示、编辑、保存

### 3. 项目流程模块
- 项目创建：初始化项目内容
- 定义料单表：资料员提交项目料单表
- 审定流程：项目经理可下载料单表送审，或者标注问题
- 审定后：可根据三种付款方式导入或编辑特定的excel支付表
- 财务：财务人员可下载项目经理上传的表格或者标注问题
- 统计：可根据支付表内容统计一个项目的详细支付信息

### 4. 人员管理模块
- 员工档案：基本信息、工作经历、教育背景
- 部门管理：组织架构树、部门人员统计
- 岗位管理：岗位设置、职责说明

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.6+
- Node.js 16+
- MySQL 8.0+
- Redis 6.0+

### 后端启动

1. 创建数据库并执行初始化脚本
```bash
mysql -u root -p < backend/src/main/resources/db/schema.sql
```

2. 修改数据库配置
编辑 `backend/src/main/resources/application.yml`，修改数据库连接信息

3. 启动Redis服务

4. 运行后端项目
```bash
cd backend
mvn spring-boot:run
```

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

Swagger文档：http://localhost:8080/api/swagger-ui.html

### 前端启动

1. 安装依赖
```bash
cd frontend
npm install
```

2. 启动开发服务器
```bash
npm run dev
```

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

### 默认账号
- 用户名：admin
- 密码：admin123（需要在数据库中重置为加密后的密码）

## 开发规范

1. 代码规范：遵循阿里巴巴Java开发手册、ESLint规范
2. 注释要求：关键业务逻辑必须有中文注释
3. 异常处理：全局异常处理、业务异常分类
4. 日志记录：操作日志、系统日志分离
5. 单元测试：关键业务方法必须有单元测试
6. API文档：Swagger接口文档完整

## 许可证

MIT License