feat: 初始化web项目,接口创建种子用户

This commit is contained in:
R524809
2026-01-05 13:29:23 +08:00
parent b387081979
commit 84ddca26b5
45 changed files with 4526 additions and 318 deletions

110
apps/web/ENV.md Normal file
View File

@@ -0,0 +1,110 @@
# 环境变量配置说明
本项目使用 Vite 的环境变量系统来管理不同环境的配置。
## 环境变量文件
### `.env`
默认环境变量文件,所有环境都会加载。通常包含本地开发的默认配置。
### `.env.development`
开发环境配置,运行 `pnpm dev` 时会自动加载。
### `.env.production`
生产环境配置,运行 `pnpm build` 时会自动加载。
### `.env.local`
本地环境变量文件(**不会被 git 跟踪**),用于覆盖默认配置。
- 复制 `.env.local.example``.env.local` 并根据需要修改
- 此文件优先级最高,会覆盖其他环境变量文件中的同名变量
## 环境变量列表
| 变量名 | 说明 | 默认值 | 示例 |
|--------|------|--------|------|
| `VITE_PORT` | 开发服务器端口 | `5173` | `5173` |
| `VITE_API_BASE_URL` | API 基础地址 | `http://localhost:3200/api` | `https://api.example.com/api` |
| `VITE_APP_NAME` | 应用名称 | `投小记` | `投小记` |
| `VITE_APP_TITLE` | 应用标题 | `投小记 - 投资决策与复盘工具` | - |
| `VITE_ENV` | 环境标识 | `development` | `production` |
| `VITE_USE_MOCK` | 是否启用 Mock 数据 | `false` | `true` |
| `VITE_DEBUG` | 是否显示调试信息 | `true` (开发) / `false` (生产) | `true` |
## 使用方法
### 1. 在代码中使用环境变量
```typescript
// 方式1使用配置对象推荐
import { envConfig } from '@/config/env'
const apiUrl = envConfig.apiBaseUrl
const appName = envConfig.appName
// 方式2直接使用 import.meta.env不推荐缺少类型提示
const apiUrl = import.meta.env.VITE_API_BASE_URL
```
### 2. 在 API 服务中使用
```typescript
import { api } from '@/services/api'
// 使用配置好的 API 客户端
const data = await api.get('/users')
```
### 3. 修改环境变量
#### 开发环境
编辑 `.env.development` 文件
#### 生产环境
编辑 `.env.production` 文件,或在部署平台设置环境变量
#### 本地个性化配置
1. 复制 `.env.local.example``.env.local`
2.`.env.local` 中修改需要的变量
## 注意事项
1. **变量命名**:所有需要在客户端代码中使用的环境变量必须以 `VITE_` 开头
2. **类型安全**:使用 `src/config/env.ts` 中的 `envConfig` 对象可以获得类型提示
3. **敏感信息**:不要在环境变量文件中存储敏感信息(如密钥、密码),这些应该通过后端 API 获取
4. **Git 跟踪**
- `.env``.env.development``.env.production` 会被 git 跟踪
- `.env.local``.env*.local` 不会被 git 跟踪(已在 .gitignore 中配置)
## 部署说明
### 开发环境
```bash
pnpm dev
# 会自动加载 .env 和 .env.development
```
### 生产环境
```bash
pnpm build
# 会自动加载 .env 和 .env.production
```
### 预览构建结果
```bash
pnpm preview
# 会使用生产环境配置预览构建结果
```
## 常见问题
### Q: 如何修改 API 地址?
A: 修改对应环境的 `.env` 文件中的 `VITE_API_BASE_URL` 变量
### Q: 如何在不同端口运行?
A: 修改 `.env.development` 中的 `VITE_PORT` 变量,或使用命令行参数:
```bash
VITE_PORT=3000 pnpm dev
```
### Q: 环境变量修改后不生效?
A: 重启开发服务器,环境变量只在启动时加载