# 前端开发

FastBee 前端基于 Vue 2 + ElementUI 构建。

## 页面导读

- **适用场景**: 需要修改管理端页面、新增业务页面或调试接口联调的前端开发者。
- **前置条件**: 已安装 Node.js 和 npm；本地联调时后端服务已在 8080 端口运行。
- **操作路径**: 进入 vue 目录 → npm install → npm run dev → 浏览器访问并登录验证。
- **验收点**: 开发服务正常启动，登录成功，页面接口数据正常加载；npm run build:prod 构建成功。

## 环境搭建

前置条件：已安装 Node.js 和 npm。

```bash
cd vue
npm install
npm run dev          # 开发模式
npm run build:prod   # 生产构建
```

依赖下载缓慢时，可切换镜像源后重试：

```bash
npm config set registry https://registry.npmmirror.com
```

## 目录结构

```
vue/src/
├── api/          # 后端 API 调用封装
├── assets/       # 静态资源
├── components/   # 公共组件
├── directive/    # 自定义指令
├── layout/       # 布局组件
├── plugins/      # 插件配置
├── router/       # 路由配置
├── store/        # Vuex 状态管理
├── utils/        # 工具函数
└── views/        # 页面视图
```

## 开发规范

* 页面文件放在 `views/` 目录，按模块组织子目录
* API 请求封装在 `api/` 目录
* 公共组件放在 `components/` 目录
* 使用 ElementUI 组件库，遵循其设计规范

## 代理配置

开发环境通过 `vue.config.js` 配置代理，将 `/dev-api` 请求转发到后端服务：

```js
proxy: {
  '/dev-api': {
    target: 'http://localhost:8080',
    changeOrigin: true,
    pathRewrite: { '^/dev-api': '' }
  }
}
```

## 验证运行

1. `npm run dev` 启动成功后，浏览器打开终端输出的本地地址
2. 使用默认账号 `admin` / `admin123` 登录
3. 打开设备管理等页面，确认接口数据正常加载（需要后端服务已在 8080 端口运行）

## 生产构建与部署

`npm run build:prod` 的构建产物输出到 `vue/dist` 目录。部署时将目录内容复制到 Nginx 的 Web 根目录，并按[系统部署](https://www.fastbee.cn/doc/open/v2/install/system.md)中的 Nginx 配置将 `/prod-api/` 代理到后端服务。

## 常见问题

### 页面报 Network Error 或接口 404？

确认后端服务已在 8080 端口运行；开发环境检查 `vue.config.js` 中 `/dev-api` 代理的 `target` 是否指向后端地址。

### npm install 失败或依赖下载缓慢？

先切换镜像源 `npm config set registry https://registry.npmmirror.com` 后重试；仍失败时删除 `node_modules` 目录重新安装。

### 登录后接口返回 401？

登录态 Token 失效或请求未携带 Token，重新登录即可；接口认证方式见 [API 接口](https://www.fastbee.cn/doc/open/v2/dev/api.md)。
