# mcs-zh

**Repository Path**: longineswarehouse/mcs-zh

## Basic Information

- **Project Name**: mcs-zh
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-20
- **Last Updated**: 2025-01-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MCS项目
## 项目安装运行说明

### 一、环境安装配置
#### 1.node 安装
- `node`安装下载

`node` 下载地址 https://nodejs.org/zh-cn/download/ \
安装步骤可参考 https://www.runoob.com/nodejs/nodejs-install-setup.html \
如需安装指定 `node` 版本，可直接下载对应版本 https://nodejs.org/dist/ \
本项目推荐安装 v16.10.0 及以上稳定版本（以下示例说明均在 v16.10.0 的基础上操作）

- 确认是否安装成功

`Win + R` 打开 `cmd` 窗口，执行 `node -v`，安装成功显示以下示例版本号，则表示安装成功
```
C:\Users\Administrator>node -v
v16.10.0
```
`node` 安装成功会自带有 `npm` (项目安装包有用到该工具)，使用 `npm -v` 查看是否安装成功
```
C:\Users\Administrator>npm -v
7.24.0
```
#### 2.pnpm 安装(项目运行使用到的工具)
- `pnpm` 安装下载

`cmd` 窗口执行 `npm install -g pnpm` 全局安装pnpm

- 确认是否安装成功

执行`pnpm -v` 安装成功显示以下示例版本号，则表示安装成功
```
C:\Users\Administrator>pnpm -v
7.13.5
```

其他安装方式，可参考 https://pnpm.io/zh/installation

### 二、项目启动
#### 1.初始化项目
`cmd` 窗口进入项目文件夹根目录，执行 `pnpm i` 初始化项目所使用的的包

`cmd` 出现如下示例初始化过程，各种初始化的项目的工具包版本，成功会自动退出命令
```js
E:\ameth-frontend>pnpm i
Lockfile is up to date, resolution step is skipped
Packages: +485
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Packages are hard linked from the content-addressable store to the virtual store.
  Content-addressable store is at: E:\.pnpm-store\v3
  Virtual store is at:             node_modules/.pnpm
Progress: resolved 485, reused 484, downloaded 0, added 485, done

dependencies:
+ @antv/x6 1.34.5
+ @antv/x6-vue-shape 1.5.3
+ ······

devDependencies:
+ @intlify/vite-plugin-vue-i18n 6.0.3
+ @types/file-saver 2.0.5
+ ......
-------------------------------------------------------------------------

Done in 23s

E:\ameth-frontend>
```

#### 2.运行项目
`cmd` 窗口进入项目文件夹根目录执行 `pnpm run dev` 启动项目

项目启动成功会出现如下示例，自动打开浏览器访问下方地址，如遇到未自动打开，则自行复制地址去浏览器打开
```
E:\mcs\ameth-frontend> pnpm run dev

> ameth-frontend@0.0.0 dev E:\mcs\ameth-frontend
> vite


  VITE v3.2.0  ready in 23216 ms

  ➜  Local:   http://localhost:5173/
  ➜  Network: http://192.168.25.252:5173/
```
#### 3.客户端安装修改访问本地IP接口的说明

主要修改两个文件，进入项目根目录

- vite.config.ts
替换下方 `target` 的 ip 地址为需要访问的接口的 ip 地址
```js
server: {
  open: true,
  host: '0.0.0.0',
  proxy: {
    '/web': {
      target: 'http://39.96.183.175:8080',
      ws: true,
      changeOrigin: true,
      rewrite: (path: string) => path.replace(/^\/web/, ''),
    },
  },
  hmr: {
    overlay: false,
  },
}
```
- public/config.js
替换下方 ip 地址为需要访问的接口的 ip 地址\
requestUrl: 为接口请求地址\
ws： 为 websocket 地址
```js
const hostname39 = '39.96.183.175'
const hostnameDev = '172.16.4.24' // 工厂测试服 Fab_dev 路径
const hostnameProd15 = '172.17.5.15'  // 工厂Fab_prod Ap01 服务器 路径
const hostnameProd21 = '172.17.5.21' // 工厂Fab_prod Ap02 服务器 路径
const hostname = hostnameDev  // 后端本地调试只需修改 hostname 为自己本地接口的ip，需修改本地接口的端口可自行修改 websocket 和 接口请求地址的端口

window.config = {
  // websocket连接地址
  ws: [`ws://${hostname}:8080/web/ws?user=`,  `ws://${hostname}:8080/web/chat?user=`], // T1ws
  wsT2: [`ws://${hostname}:8081/web/ws?user=`, `ws://${hostname}:8081/web/chat?user=`], // T2ws
  // 接口请求地址
  requestUrl: `http://${hostname}:8080`, // T1 生产环境 t1 Fab_prod 负载均衡接口访问  7080
  requestT2Url: `http://${hostname}:8081`, // T2 生产环境 t2 Fab_prod 负载均衡接口访问 7081
  // 打包后线上页面启动路径
  host: hostname + ':8090', // T1
  hostT2: hostname + ':8091', // T2
  // 监控界面获取初始化状态和Port的InOutType的等待时间，默认单位毫秒
  monitorStateLoadTime: 3000,
  // 监控界面检索节点的延迟
  searchMonitorNodeTime: 3500,
};
```

mcs_client地址：http://39.96.183.175:8090/

swagger 管理文档： http://39.96.183.175:8080/web/doc.html

项目开发任务进度：https://doc.weixin.qq.com/sheet/e3_AT8AxgbvAL8TnuEEPxWQzuOAC7Qvk?scode=ACMAaQciADc6xOOXxSAT8AxgbvAL8&force_open_in_wx=1&tab=BB08J2

禅道地址：http://39.96.183.175/