删除前端废弃组件和示例文件

This commit is contained in:
ylweng
2025-09-12 21:53:14 +08:00
parent 7e093946a8
commit bc3b3d7b52
98 changed files with 14136 additions and 14931 deletions

131
admin-system/ENV_CONFIG.md Normal file
View File

@@ -0,0 +1,131 @@
# 环境变量配置说明
## 概述
本项目支持通过环境变量配置API地址和其他配置项实现开发、测试、生产环境的灵活切换。
## 环境变量列表
### API配置
| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| `VITE_API_BASE_URL` | `/api` | API基础路径相对路径通过代理转发 |
| `VITE_API_FULL_URL` | `http://localhost:5350/api` | 完整API地址直接调用 |
| `VITE_API_TIMEOUT` | `10000` | 请求超时时间(毫秒) |
| `VITE_USE_PROXY` | `true` | 是否使用Vite代理 |
### 百度地图配置
| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| `VITE_BAIDU_MAP_API_KEY` | `SOawZTeQbxdgrKYYx0o2hn34G0DyU2uo` | 百度地图API密钥 |
### 应用配置
| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| `VITE_APP_TITLE` | `宁夏智慧养殖监管平台` | 应用标题 |
| `VITE_APP_VERSION` | `1.0.0` | 应用版本 |
## 环境配置文件
### 开发环境 (.env.development)
```bash
# API配置
VITE_API_BASE_URL=/api
VITE_API_FULL_URL=http://localhost:5350/api
VITE_API_TIMEOUT=10000
VITE_USE_PROXY=true
# 百度地图API
VITE_BAIDU_MAP_API_KEY=your_baidu_map_api_key
# 应用配置
VITE_APP_TITLE=宁夏智慧养殖监管平台
VITE_APP_VERSION=1.0.0
```
### 生产环境 (.env.production)
```bash
# API配置
VITE_API_BASE_URL=/api
VITE_API_FULL_URL=https://your-domain.com/api
VITE_API_TIMEOUT=15000
VITE_USE_PROXY=false
# 百度地图API
VITE_BAIDU_MAP_API_KEY=your_production_baidu_map_api_key
# 应用配置
VITE_APP_TITLE=宁夏智慧养殖监管平台
VITE_APP_VERSION=1.0.0
```
## 使用方法
### 1. 创建环境文件
```bash
# 复制示例文件
cp .env.example .env.development
cp .env.example .env.production
# 编辑配置文件
vim .env.development
vim .env.production
```
### 2. 在代码中使用
```javascript
// 在组件中使用环境变量
import { API_CONFIG } from '@/config/env.js'
// 获取API基础URL
const apiUrl = API_CONFIG.baseUrl
// 获取完整API URL
const fullApiUrl = API_CONFIG.fullBaseUrl
// 检查是否为开发环境
if (API_CONFIG.isDev) {
console.log('开发环境')
}
```
### 3. API工具使用
```javascript
// 使用代理模式(推荐)
import { api } from '@/utils/api'
const result = await api.get('/farms')
// 使用直接调用模式
import { directApi } from '@/utils/api'
const result = await directApi.get('/farms')
```
## 配置优先级
1. 环境变量文件 (.env.development, .env.production)
2. 默认配置 (env.js)
3. 硬编码默认值
## 注意事项
1. **环境变量必须以 `VITE_` 开头**,才能在客户端代码中访问
2. **生产环境建议使用HTTPS**,确保安全性
3. **API密钥不要提交到版本控制系统**,使用环境变量管理
4. **代理模式适用于开发环境**,生产环境建议使用直接调用
5. **修改环境变量后需要重启开发服务器**
## 故障排除
### 1. 环境变量不生效
- 检查变量名是否以 `VITE_` 开头
- 确认环境文件位置正确
- 重启开发服务器
### 2. API请求失败
- 检查 `VITE_API_FULL_URL` 配置是否正确
- 确认后端服务是否启动
- 检查网络连接
### 3. 代理不工作
- 检查 `vite.config.js` 中的代理配置
- 确认 `VITE_USE_PROXY` 设置为 `true`
- 检查后端服务端口是否正确