# admin

基于vue3 + vite 重写的新版后台管理系统

---

## node.js 的版本需要  v18.0.0+

```shell

// 检查你的node版本, 如果低于v18.0.0, 请先更新node.js

node -v

```

---

### 推荐使用  `yarn` 管理依赖

如果电脑上还没有安装 `yarn` ，执行以下命令安装 `yarn`

``` shell
npm install -g yarn

//或者

cnpm install -g yarn
```

切换为私有源

```shell

hnrm use hcxxy
hyrm use hcxxy

```

然后在 此项目下 执行

```shell
yarn

// 或者

yarn install
```

---

### `yarn` 的相关命令

安装依赖

```shell
yarn add 依赖名

// 或者
yarn add -D 依赖名
```

检测依赖更新

```shell
yarn upgrade-interactive --latest
```


js-fast-way 文档

- **[文档地址](https://js-fast-way.vercel.app/)**
- **[国内文档地址](http://izaizaiaa.gitee.io/js-fast-way)**


---


### 打包说明

`build:zip` 为一键打包为zip的方式
`build:zip:wgt` 为一键打包为zip的方式（不包含 `/public/plugins` 文件夹）

`build:test` 为一键打包，然后自动上传到测试服务器上并自动部署的方式
`build:test:wgt` 为一键打包，然后自动上传到测试服务器上并自动部署的方式（不包含 `/public/plugins` 文件夹）

- 慎用以下命令，会自动上传到生产服务器上并自动部署

`build:online` 为一键打包，然后自动上传到生产服务器上并自动部署的方式
`build:online:wgt` 为一键打包，然后自动上传到生产服务器上并自动部署的方式（不包含 `/public/plugins` 文件夹）


### 其它说明

一般来说，`/public/plugins` 很少出现变动的情况。

在服务器上更新时，请注意，不要删除服务器上存在的 `plugins`，否则会出现异常。

如果本地 `/public/plugins` 文件夹 有变动，请使用 非 `wgt` 的打包方式



### 代码规范说明

项目启用了 `eslint` 作为代码规范检测

在 `vscode` 中，需要安装 `eslint` 插件，并且在 `settings.json` 中添加以下配置

```json
{
    "eslint.autoFixOnSave": true,
    "eslint.validate": [
        "javascript",
        "javascriptreact",
        {
            "language": "html",
            "autoFix": true
        },
        {
            "language": "vue",
            "autoFix": true
        }
    ],
    "editor.codeActionsOnSave": {
        "source.fixAll.eslint": true
    }
}
```

这时，在保存代码时，会自动格式化和处理掉一些不规范的代码，但这并不是准确的，保存后，请再检查下，是否有存在不合理的地方，进行手动优化。

在 `webstorm` 中，不需要安装插件，打开 webstorm 设置，语言和框架，`eslint`，勾选自动，再勾选保存时运行，即可。