# learn-fronted

**Repository Path**: i-dont-want-to-learn-java/learn-fronted

## Basic Information

- **Project Name**: learn-fronted
- **Description**: 智教易购平台前端
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-12
- **Last Updated**: 2025-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智教易购平台

## 项目简介
这是一个基于Vue3 + TypeScript + Vite的在线教育平台前端项目。

## 环境要求
- Node.js >= 18.0.0
- npm >= 8.0.0

## 安装步骤

### 1. 克隆项目
```bash
git clone <your-repository-url>
cd learn-fronted
```

### 2. 安装依赖
```bash
# 推荐使用 npm ci 确保版本一致
npm ci

# 如果 npm ci 失败，可以尝试
npm install
```

### 3. 启动开发服务器
```bash
npm run dev
```

## 常见问题解决

### OpenAPI生成错误
如果遇到 `TypeError: Cannot read properties of undefined (reading 'version')` 错误：

1. **清理依赖并重新安装**
```bash
# Windows
rmdir /s node_modules
del package-lock.json
npm install

# macOS/Linux
rm -rf node_modules package-lock.json
npm install
```

2. **检查Node.js版本**
```bash
node --version
# 确保版本 >= 18.0.0
```

3. **检查后端服务**
```bash
# 确保后端服务正在运行
# 检查端口 9527 是否可访问
curl http://localhost:9527/user/v3/api-docs
```

4. **重新生成API代码**
```bash
npm run openapi
npm run fix-api
```

### 服务不可访问问题
如果某些服务无法访问，脚本会自动跳过并继续处理其他服务。

### 端口占用问题
如果5173端口被占用，Vite会自动选择其他可用端口。

## 项目脚本

- `npm run dev` - 启动开发服务器
- `npm run build` - 构建生产版本
- `npm run openapi` - 生成API代码
- `npm run fix-api` - 修复API文件结构
- `npm run clean-api` - 清理API模块（选择性清理）
- `npm run type-check` - 类型检查
- `npm run lint` - 代码检查

## API更新工作流程

### 当后端接口更新时：

1. **选择性清理**（推荐）：
   ```bash
   # 只清理需要更新的模块
   npm run clean-api user      # 清理user模块
   npm run clean-api media     # 清理media模块
   
   # 或者清理所有模块
   npm run clean-api all
   ```

2. **重新生成**：
   ```bash
   npm run openapi
   ```

3. **修复结构**：
   ```bash
   npm run fix-api
   ```

### 优势：
- ✅ 只更新必要的模块，保留其他正常工作的API
- ✅ 减少生成时间和错误风险
- ✅ 支持增量更新

## 项目结构
```
src/
├── api/           # API接口
├── components/    # 组件
├── stores/        # 状态管理
├── views/         # 页面
├── router/        # 路由
└── utils/         # 工具函数
```

## 技术栈
- Vue 3 + Composition API
- TypeScript
- Vite
- Pinia (状态管理)
- Vue Router
- Ant Design Vue
- Axios

## 开发规范
- 使用TypeScript进行类型检查
- 遵循Vue3 Composition API最佳实践
- 使用ESLint和Prettier保持代码质量