# 快速开始指南

本指南帮助您在 5 分钟内快速启动项目。

## 🚀 快速启动

### 第一步：克隆项目
```bash
git clone https://your-repo-url.git
cd interview_web
```

### 第二步：安装依赖
```bash
npm install
```

### 第三步：启动项目
```bash
npm run dev
```

访问 http://localhost:8080

## 📋 前置条件检查

确保您已安装：
- ✅ Node.js >= 16.0.0
- ✅ npm >= 7.0.0

检查版本：
```bash
node -v
npm -v
```

## ⚙️ 快速配置

### 1. 配置后端 API 地址

创建或编辑 `.env.development` 文件：
```env
VITE_API_URL=http://localhost:8000
VITE_PUBLIC_PATH=/
VITE_PORT=8080
```

### 2. 登录系统

默认账号：`superadmin`  
默认密码：`admin123456`

## 🎯 常用命令

### 开发环境
```bash
npm run dev          # 启动开发服务器
```

### 生产构建
```bash
npm run build        # 构建生产版本
npm run build:local  # 本地生产构建
```

### 代码检查
```bash
npm run lint-fix     # ESLint 自动修复
```

## 📖 下一步

### 学习项目结构
- 阅读 [项目说明文档](./PROJECT_README.md)
- 查看 [开发者指南](./DEVELOPER_GUIDE.md)

### 开始开发
- 阅读 [API 接口文档](./API_DOCUMENTATION.md)
- 查看现有模块代码示例

### 部署上线
- 阅读 [部署文档](./DEPLOYMENT.md)
- 配置生产环境

## 🆘 遇到问题？

### 常见问题
1. **端口被占用**
   ```bash
   # 修改 vite.config.ts 中的端口号
   server: { port: 3000 }
   ```

2. **依赖安装失败**
   ```bash
   # 清除缓存后重新安装
   npm cache clean --force
   npm install
   ```

3. **API 请求失败**
   - 检查后端服务是否启动
   - 检查 `.env.development` 配置

### 获取帮助
- 📖 查看项目文档
- 🐛 提交 Issue
- 💬 联系团队

## ✅ 验证安装

运行以下命令验证环境：
```bash
# 检查 Node.js 版本
node -v

# 检查依赖安装
ls node_modules

# 启动开发服务器
npm run dev

# 访问 http://localhost:8080
# 应该能看到登录页面
```

## 🎉 完成！

现在您已经成功启动了项目，可以开始开发了！

查看项目文档了解更多：
- [项目说明](./PROJECT_README.md)
- [开发指南](./DEVELOPER_GUIDE.md)
- [部署文档](./DEPLOYMENT.md)
- [API 文档](./API_DOCUMENTATION.md)

