# chain-cloud-admin-vue

**Repository Path**: devved/chain-cloud-admin-vue

## Basic Information

- **Project Name**: chain-cloud-admin-vue
- **Description**: 智链云途 - 后台管理系统
物流项目后台管理系统，涵盖运单管理、调度管理、组织架构、报表统计等核心功能模块。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-15
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智链云途 - 后台管理系统

物流项目后台管理系统，涵盖运单管理、调度管理、组织架构、报表统计等核心功能模块。

---

## 技术架构

| 技术 | 版本 |
|------|------|
| Vue | 2.6.10 |
| Vue CLI | 3.6.0 |
| Element UI | 2.13.2 |
| Vue Router | 3.0.6 |
| Vuex | 3.1.0 |
| Axios | 0.18.1 |
| ECharts | 4.9.0 |
| ECharts Liquidfill | 2.0.6 |
| Vue Baidu Map | 0.21.22 |
| SCSS (node-sass) | 4.9.0 |
| TypeScript | 4.9.5 |
| ESLint | 5.15.3 |
| Jest | 23.6.0 |

---

## 运行环境

- **Node.js**: 14.21.3
- **npm**: 6.14.18

项目依赖的 `node-sass` 等包对 Node 版本有严格要求，请务必使用指定版本，避免出现兼容性问题。

---

## 本地开发

### 1. 安装 nvm

`nvm-setup.exe` 已提供在课前资料中，双击按向导安装即可。（也可自行访问 https://github.com/coreybutler/nvm-windows/releases 下载）

安装完成后，打开命令行输入以下命令验证是否安装成功：

```bash
nvm -v
```

若输出版本信息（如 `1.1.12`），则说明安装成功。

### 2. 安装 Node.js

```bash
nvm install 14.21.3
nvm use 14.21.3
```

### 3. 解决 npm 安装失败问题

`nvm install` 在安装 Node 时有时会自动安装 npm 失败，表现为执行 `npm` 提示"不是内部或外部命令"。此时需要手动安装 npm：

**步骤一：** 在课前资料中找到 `cli-6.14.18.tar.gz`（即 npm 6.14.18 的压缩包），解压后将根文件夹重命名为 `npm`。

**步骤二：** 查看 nvm 的安装目录：

```bash
nvm root
```

**步骤三：** 将上一步的 `npm` 文件夹移动到 nvm 安装目录下对应 Node 版本目录的 `node_modules` 中。例如：

```
{你的nvm目录}/v14.21.3/node_modules/npm
```

**步骤四：** 进入 `npm/bin` 目录，将 `npm` 和 `npm.cmd` 两个文件复制到对应 Node 版本的根目录下。例如：

```
{你的nvm目录}/v14.21.3/
```

**步骤五：** 重新打开一个终端窗口，执行以下命令验证：

```bash
nvm use 14.21.3
npm -v
```

若输出版本号 `6.14.18`，则说明配置成功。

### 4. 安装依赖并启动

```bash
# 使用国内镜像加速
npm install --registry=https://registry.npmmirror.com
npm run dev
```

默认访问地址：`http://localhost:9528`

---

## 项目发布

### 1. 修改环境配置

编辑 `.env.development` 文件，修改以下变量：

```bash
VUE_APP_BASE_URL = 'http://你的后端地址:端口/manager'
VUE_APP_BAIDU_MAP_AK = '你的百度地图AK值'
```

示例：

```bash
VUE_APP_BASE_URL = 'http://192.168.150.1:9527/manager'
VUE_APP_BAIDU_MAP_AK = 'gkB8b3rua6esLdKJuM7cdxz8YAtHdnxp'
```

### 2. 构建打包

```bash
npm run build:test
```

### 3. 部署

将 `/dist` 目录下的所有文件上传到虚拟机的 `/itcast/admin-web` 目录。