# feiniao-be-data

飞鸟后台数据平台前端脚手架（基于 feiniao-farm-h5 精简抽取）。

## 技术栈

- Vue 3 + Vue Router 4 + Axios
- Element Plus
- OpenLayers（`src/common/ol_common.js`）

## 快速开始

```bash
npm install
npm run dev
```

| 命令 | 说明 |
|------|------|
| `npm run dev` | 开发环境（Vite） |
| `npm run local` | 本地环境 |
| `npm run pro` | 生产接口联调 |
| `npm run build` | 生产构建 |
| `npm run preview` | 预览构建产物 |

## 目录结构

```
src/
├── api/
│   ├── config.js          # 接口域名 / CDN / 忽略提示关键字
│   └── modules/           # 接口模块（自动挂载为 VE_API.xxx）
├── common/
│   └── ol_common.js       # 地图公共方法（WMTS / WKT / fit）
├── plugins/
│   ├── axios.js           # 请求封装（token 走 localStorage）
│   ├── element.js
│   └── permission.js      # 路由守卫（title / token）
├── router/
│   ├── helper.js          # createPage（默认 keepAlive: true）
│   ├── routes.js          # 路由表
│   └── index.js
├── utils/auth.js          # token 读写
├── views/home/            # 脚手架占位页（可替换）
├── styles/
├── App.vue                # 全局 keep-alive
└── main.js
```

## 新增页面（推荐写法）

1. 新建 `src/views/xxx/index.vue`（纯 `<script setup>`）
2. 在 `src/router/routes.js` 注册：

```js
import { createPage } from "./helper";

export default [
  createPage({
    path: "/xxx",
    name: "Xxx",
    component: () => import("@/views/xxx/index.vue"),
    title: "页面标题",
    // keepAlive: false, // 默认 true，不需要缓存时关闭
  }),
];
```

## 新增接口

在 `src/api/modules/` 新建文件，例如 `farm.js`：

```js
const config = require("../config");

module.exports = {
  list: {
    url: config.base_dev_url + "v2/farm/list",
    type: "get",
  },
};
```

页面调用：`this.VE_API.farm.list(params)` 或 `proxy.VE_API.farm.list(params)`。

## 环境变量

环境配置在 `env.config.js`，由 Vite `define` 注入为 `VE_ENV`：

- `SERVER` → `base_dev_url`
- `PYSERVER` → `base_py_url`
- `NEW_SERVER` → `base_new_url`