docs: add comprehensive user documentation
- Add README.md with installation, configuration, and usage guide - Add docs/USER_GUIDE.md with detailed step-by-step workflows - Include database setup scripts for MySQL and SQL Server - Add troubleshooting section with common issues
This commit is contained in:
Misaka
262
docs/USER_GUIDE.md
Normal file
262
docs/USER_GUIDE.md
Normal file
@@ -0,0 +1,262 @@
|
||||
# ERPAuto 用户指南
|
||||
|
||||
## 目录
|
||||
|
||||
1. [简介](#简介)
|
||||
2. [安装指南](#安装指南)
|
||||
3. [配置说明](#配置说明)
|
||||
4. [使用指南](#使用指南)
|
||||
5. [数据库设置](#数据库设置)
|
||||
6. [常见问题](#常见问题)
|
||||
|
||||
---
|
||||
|
||||
## 简介
|
||||
|
||||
ERPAuto 是一个专为 ERP 系统设计的自动化工具，主要功能包括：
|
||||
|
||||
- **数据提取**：自动从 ERP 系统批量下载物料计划数据为 Excel 文件
|
||||
- **物料清理**：自动删除指定订单的物料代码
|
||||
- **数据库存储**：支持将提取的数据存储到 MySQL 或 SQL Server 数据库
|
||||
|
||||
---
|
||||
|
||||
## 安装指南
|
||||
|
||||
### 系统要求
|
||||
|
||||
- **操作系统**：Windows 10/11, macOS 10.15+, Linux
|
||||
- **内存**：至少 4GB RAM
|
||||
- **Node.js**：版本 18 或更高
|
||||
|
||||
### 安装步骤
|
||||
|
||||
1. **下载应用**
|
||||
- 从发布页面下载对应系统的安装包
|
||||
- Windows: `ERPAuto-Setup-x.x.x.exe`
|
||||
- macOS: `ERPAuto-x.x.x.dmg`
|
||||
- Linux: `ERPAuto-x.x.x.AppImage`
|
||||
|
||||
2. **安装**
|
||||
- Windows: 运行安装程序，按照提示完成安装
|
||||
- macOS: 将应用拖拽到 Applications 文件夹
|
||||
- Linux: 赋予执行权限后运行
|
||||
|
||||
3. **首次运行**
|
||||
- 启动应用
|
||||
- 首次运行需要先配置 ERP 连接信息
|
||||
|
||||
---
|
||||
|
||||
## 配置说明
|
||||
|
||||
### ERP 连接配置
|
||||
|
||||
应用需要配置 ERP 系统的连接信息。在主界面点击「设置」->「ERP 配置」：
|
||||
|
||||
| 配置项 | 说明 | 示例 |
|
||||
| ------- | -------------- | ----------------------------- |
|
||||
| ERP URL | ERP 系统地址 | `https://192.168.1.100:8082/` |
|
||||
| 用户名 | ERP 登录用户名 | `admin` |
|
||||
| 密码 | ERP 登录密码 | `******` |
|
||||
|
||||
### 数据库配置（可选）
|
||||
|
||||
如需将提取的数据存储到数据库，需要配置数据库连接：
|
||||
|
||||
**MySQL 配置：**
|
||||
|
||||
| 配置项 | 默认值 | 说明 |
|
||||
| -------- | ----------- | ---------------- |
|
||||
| 主机 | `localhost` | MySQL 服务器地址 |
|
||||
| 端口 | `3306` | MySQL 端口 |
|
||||
| 用户名 | `root` | 数据库用户名 |
|
||||
| 密码 | - | 数据库密码 |
|
||||
| 数据库名 | `erpauto` | 数据库名称 |
|
||||
|
||||
**SQL Server 配置：**
|
||||
|
||||
| 配置项 | 默认值 | 说明 |
|
||||
| -------- | ----------- | ------------------ |
|
||||
| 服务器 | `localhost` | SQL Server 地址 |
|
||||
| 端口 | `1433` | SQL Server 端口 |
|
||||
| 用户名 | `sa` | 登录用户名 |
|
||||
| 密码 | - | 登录密码 |
|
||||
| 数据库 | `erpauto` | 数据库名称 |
|
||||
| 加密 | `false` | 是否启用 SSL 加密 |
|
||||
| 信任证书 | `true` | 是否信任服务器证书 |
|
||||
|
||||
---
|
||||
|
||||
## 使用指南
|
||||
|
||||
### 数据提取功能
|
||||
|
||||
**使用场景：** 从 ERP 系统批量下载多个订单的物料计划数据。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入「数据提取」页面
|
||||
2. 在左侧输入框中输入订单号，每行一个：
|
||||
```
|
||||
SC70202602120085
|
||||
SC70202602120120
|
||||
SC70202602120137
|
||||
```
|
||||
3. 设置批量大小（建议 100-500）
|
||||
4. 点击「开始提取」
|
||||
5. 等待提取完成，查看结果统计
|
||||
|
||||
**提取结果说明：**
|
||||
|
||||
- **下载文件数**：成功下载的 Excel 文件数量
|
||||
- **记录数**：提取的总记录数
|
||||
- **错误数**：失败的订单数量
|
||||
|
||||
### 物料清理功能
|
||||
|
||||
**使用场景：** 删除指定订单中的特定物料代码。
|
||||
|
||||
**操作步骤：**
|
||||
|
||||
1. 进入「物料清理」页面
|
||||
2. 输入订单号（每行一个）
|
||||
3. 输入要删除的物料代码（每行一个）
|
||||
4. **重要**：首次使用建议勾选「干运行模式」
|
||||
5. 点击「开始清理」
|
||||
6. 查看清理结果
|
||||
|
||||
**干运行模式：**
|
||||
|
||||
- 勾选后，系统仅预览将要删除的数据，不实际执行删除
|
||||
- 建议先用干运行模式确认数据正确
|
||||
- 确认无误后，取消勾选执行实际删除
|
||||
|
||||
**清理结果说明：**
|
||||
|
||||
- **处理订单数**：成功处理的订单数量
|
||||
- **删除物料数**：实际删除的物料数量
|
||||
- **跳过物料数**：未找到或跳过的物料数量
|
||||
- **订单详情**：每个订单的详细处理结果
|
||||
|
||||
---
|
||||
|
||||
## 数据库设置
|
||||
|
||||
### MySQL 数据库初始化
|
||||
|
||||
```sql
|
||||
CREATE DATABASE IF NOT EXISTS erpauto CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||||
|
||||
USE erpauto;
|
||||
|
||||
-- 创建物料数据表
|
||||
CREATE TABLE IF NOT EXISTS material_data (
|
||||
id INT AUTO_INCREMENT PRIMARY KEY,
|
||||
order_number VARCHAR(50) NOT NULL,
|
||||
material_code VARCHAR(100) NOT NULL,
|
||||
material_name VARCHAR(255),
|
||||
quantity DECIMAL(10, 2),
|
||||
unit VARCHAR(20),
|
||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||
INDEX idx_order (order_number),
|
||||
INDEX idx_material (material_code)
|
||||
);
|
||||
```
|
||||
|
||||
### SQL Server 数据库初始化
|
||||
|
||||
```sql
|
||||
CREATE DATABASE erpauto;
|
||||
GO
|
||||
|
||||
USE erpauto;
|
||||
GO
|
||||
|
||||
-- 创建物料数据表
|
||||
CREATE TABLE material_data (
|
||||
id INT IDENTITY(1,1) PRIMARY KEY,
|
||||
order_number NVARCHAR(50) NOT NULL,
|
||||
material_code NVARCHAR(100) NOT NULL,
|
||||
material_name NVARCHAR(255),
|
||||
quantity DECIMAL(10, 2),
|
||||
unit NVARCHAR(20),
|
||||
created_at DATETIME DEFAULT GETDATE()
|
||||
);
|
||||
GO
|
||||
|
||||
CREATE INDEX idx_order ON material_data(order_number);
|
||||
CREATE INDEX idx_material ON material_data(material_code);
|
||||
GO
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
### 1. 无法登录 ERP 系统
|
||||
|
||||
**问题描述：** 点击登录后提示认证失败
|
||||
|
||||
**解决方法：**
|
||||
|
||||
1. 确认用户名和密码正确
|
||||
2. 检查 ERP 系统是否可访问
|
||||
3. 确认账号有足够权限
|
||||
|
||||
### 2. 提取时卡在加载中
|
||||
|
||||
**问题描述：** 点击提取后一直显示加载中
|
||||
|
||||
**解决方法：**
|
||||
|
||||
1. 检查网络连接
|
||||
2. 减少批量大小
|
||||
3. 确认 ERP 系统运行正常
|
||||
4. 刷新页面后重试
|
||||
|
||||
### 3. 物料清理无数据
|
||||
|
||||
**问题描述：** 清理时显示没有可删除的数据
|
||||
|
||||
**解决方法：**
|
||||
|
||||
1. 确认订单号正确
|
||||
2. 确认物料代码在该订单中存在
|
||||
3. 先用干运行模式查看是否有匹配数据
|
||||
|
||||
### 4. 数据库连接失败
|
||||
|
||||
**问题描述：** 无法连接到数据库
|
||||
|
||||
**解决方法：**
|
||||
|
||||
1. 确认数据库服务已启动
|
||||
2. 检查数据库配置信息
|
||||
3. 确认防火墙允许数据库端口
|
||||
4. 测试数据库连接：
|
||||
|
||||
```bash
|
||||
# MySQL
|
||||
mysql -h localhost -u root -p
|
||||
|
||||
# SQL Server
|
||||
sqlcmd -S localhost -U sa
|
||||
```
|
||||
|
||||
### 5. 应用闪退
|
||||
|
||||
**问题描述：** 应用启动后立即关闭
|
||||
|
||||
**解决方法：**
|
||||
|
||||
1. 查看日志文件获取错误信息
|
||||
2. 重新安装应用
|
||||
3. 确认系统满足最低要求
|
||||
4. 尝试以管理员身份运行
|
||||
|
||||
---
|
||||
|
||||
## 技术支持
|
||||
|
||||
如有其他问题，请联系技术支持团队或提交 Issue。
|
||||
Reference in New Issue
Block a user