# erp

**Repository Path**: ppliang98/erp

## Basic Information

- **Project Name**: erp
- **Description**: No description available
- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-01
- **Last Updated**: 2026-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 印刷厂 ERP 系统

> 基于 Spring Boot + Vue 3 的印刷行业 ERP 系统

## 📁 项目结构

```
erp/
├── erp-backend/          # 后端 Spring Boot 项目
├── erp-frontend/         # 前端 Vue 3 项目
├── deploy/               # 部署配置
│   ├── docker-compose.yml
│   ├── Dockerfile
│   ├── nginx.conf
│   └── init.sql          # 数据库初始化脚本
└── docs/                 # 项目文档
    ├── 需求规格说明书.md
    ├── 数据库设计文档.md
    ├── 系统架构设计文档.md
    └── 接口设计文档.md
```

## 🚀 快速开始

### 环境要求

- JDK 1.8+
- Node.js 18+
- MySQL 8.0
- Redis 7.x

### 1. 初始化数据库

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

### 2. 启动后端

```bash
cd erp-backend

# 修改 application.yml 中的数据库连接信息
# 修改 application.yml 中的 Redis 连接信息

# 启动
mvn spring-boot:run

# 或者打包后运行
mvn clean package -DskipTests
java -jar target/erp-backend.jar
```

访问地址：http://localhost:8080/api/doc.html

### 3. 启动前端

```bash
cd erp-frontend

# 安装依赖
npm install

# 开发模式
npm run dev

# 生产构建
npm run build
```

访问地址：http://localhost:5173

### 4. 默认账号

| 角色 | 用户名 | 密码 |
|------|--------|------|
| 超级管理员 | admin | admin123 |

## 📖 文档

- [需求规格说明书](docs/需求规格说明书.md)
- [数据库设计文档](docs/数据库设计文档.md)
- [系统架构设计文档](docs/系统架构设计文档.md)
- [接口设计文档](docs/接口设计文档.md)

## 🛠️ 技术栈

### 后端

- Spring Boot 2.7.18
- MyBatis-Plus 3.5.5
- Sa-Token 1.37.0（权限框架）
- Knife4j 4.3.0（API 文档）
- Redis 7.x（缓存 + Session）
- MySQL 8.0

### 前端

- Vue 3.4+（Composition API）
- Vite 5.x
- Element Plus 2.5+
- Vue Router 4.x
- Pinia 2.x
- Axios 1.x

## 📦 核心模块

| 模块 | 说明 |
|------|------|
| 🗄️ 库存管理 | 物料/仓库/批次/出入库/盘点 |
| 📋 订单跟踪 | 销售订单→工单→工序进度→发货 |
| 💰 自动报价 | 纸张+印刷+印后工艺，自动计算成本与利润 |
| 🏭 生产管理 | Job Ticket / BOM / 工序进度 / 质检 |
| 🛒 采购管理 | 供应商价格 / 采购订单 / 验收入库 |
| 💳 财务管理 | 应收应付 / 资金流水 / 发票 / 成本核算 |
| ⚙️ 系统管理 | 用户 / 角色 / 部门 / 菜单 / 数据字典 |

## 🔧 开发规范

### 分支命名

```
feature/xxx      # 新功能
fix/xxx          # Bug 修复
docs/xxx         # 文档更新
refactor/xxx     # 重构
test/xxx         # 测试相关
chore/xxx        # 构建/工具更新
```

### Commit 规范

```
feat: 新增xx功能
fix: 修复xx问题
docs: 更新xx文档
style: 代码格式调整
refactor: 重构xx
perf: 性能优化
test: 新增测试
chore: 构建/工具更新
```

## 📄 License

MIT