feat():learning后台管理前端页面初始化

This commit is contained in:
yuj
2025-12-04 17:51:24 +08:00
commit 83a614bd75
97 changed files with 23324 additions and 0 deletions

78
README_ENV.md Normal file
View File

@@ -0,0 +1,78 @@
# 环境变量配置
## 配置说明
项目支持通过环境变量配置,支持不同环境的部署需求。参考 `goalfymax-front` 项目的环境变量配置方式。
## 环境变量文件
### 开发环境
创建 `.env.development` 文件:
```bash
VITE_API_BASE_URL=http://localhost:8084
VITE_APP_TITLE=GoalfyMax Admin
VITE_APP_VERSION=1.0.0
VITE_ENABLE_DEVTOOLS=true
VITE_USE_MOCK=false
```
### 生产环境
创建 `.env.production` 文件:
```bash
VITE_API_BASE_URL=https://your-production-api.com
VITE_APP_TITLE=GoalfyMax Admin
VITE_APP_VERSION=1.0.0
VITE_ENABLE_DEVTOOLS=false
VITE_USE_MOCK=false
```
### 测试环境
创建 `.env.test` 文件:
```bash
VITE_API_BASE_URL=https://your-test-api.com
VITE_APP_TITLE=GoalfyMax Admin
VITE_APP_VERSION=1.0.0
VITE_ENABLE_DEVTOOLS=true
VITE_USE_MOCK=false
```
## 使用方法
### 1. 复制环境变量模板
```bash
cp env.example .env.development
```
### 2. 修改配置
编辑对应的环境变量文件,设置正确的配置值。
### 3. 启动项目
```bash
# 开发环境
npm run dev
# 生产环境构建
npm run build
```
## 环境变量说明
| 变量名 | 说明 | 默认值 |
|--------|------|--------|
| `VITE_API_BASE_URL` | API 基础地址 | `http://localhost:8084` |
| `VITE_APP_TITLE` | 应用标题 | `GoalfyMax Admin` |
| `VITE_APP_VERSION` | 应用版本 | `1.0.0` |
| `VITE_ENABLE_DEVTOOLS` | 启用开发工具 | `true` |
| `VITE_USE_MOCK` | 使用 Mock 数据 | `false` |
## 代理配置
开发环境下Vite 会自动代理 `/api` 请求到 `VITE_API_BASE_URL`,无需在代码中硬编码 API 地址。
## 注意事项
1. 环境变量文件需要以 `.env` 开头
2. 变量名必须以 `VITE_` 开头才能在客户端代码中使用
3. 生产环境构建时,环境变量会被编译到代码中
4. 敏感信息不要放在环境变量中,应该通过后端配置
5. 开发环境使用代理,生产环境直接使用环境变量中的 API 地址