# ai作业系统前端

**Repository Path**: lingxi066/HomeWork_frontend

## Basic Information

- **Project Name**: ai作业系统前端
- **Description**: 作业系统前端相关代码
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-10-20
- **Last Updated**: 2026-05-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Vue

## README

# HomeWork 前端项目

一个基于 Vue 3 + TypeScript + Vite 的作业管理系统前端。

## 项目地址

- **前端项目**: https://gitee.com/lingxi066/HomeWork_frontend
- **后端项目**: https://gitee.com/lingxi066/homework_backend

## 技术栈

- **前端框架**: Vue 3 (Composition API)
- **构建工具**: Vite
- **开发语言**: TypeScript
- **UI 组件库**: Element Plus
- **状态管理**: Pinia
- **路由管理**: Vue Router
- **HTTP 客户端**: Axios
- **数据验证**: Zod
- **工具库**: dayjs, lodash-es

## 功能特性

### 用户管理
- 用户登录/注册
- 身份验证（教师/学生）
- 个人信息管理

### 作业管理
- 创建/编辑/删除作业
- 作业列表展示
- 作业详情查看
- 作业提交与批改

### 题目管理
- 创建/编辑/删除题目
- 题目类型支持：填空题、单选题、多选题
- 题目批量操作

### 团队管理
- 创建/加入团队
- 团队成员管理
- 团队作业分配

### 答题功能
- 在线答题
- 答案提交
- 答题卡管理
- 自动批改（客观题）

### 批改功能
- 教师批改作业
- 分数统计
- 评语添加

## 项目结构

```
src/
├── apis/           # API 接口定义
├── assets/         # 静态资源
├── components/     # 公共组件
├── router/         # 路由配置
├── services/       # 服务层（HTTP 配置等）
├── stores/         # Pinia 状态管理
├── types/          # TypeScript 类型定义
├── utils/          # 工具函数
└── views/          # 页面组件
```

## 快速开始

### 环境要求

- Node.js 20.19.0+ 或 22.12.0+
- npm 或 yarn

### 安装依赖

```bash
npm install
```

### 开发环境

```bash
npm run dev
```

开发服务器将在 http://localhost:5173 启动。

### 构建生产版本

```bash
npm run build
```

### 类型检查

```bash
npm run type-check
```

### 预览生产构建

```bash
npm run preview
```

## 开发指南

### 代码规范

- 使用 TypeScript 严格模式
- 遵循 Vue 3 Composition API 最佳实践
- 组件使用 `<script setup>` 语法
- 使用 Element Plus 组件库
- 状态管理使用 Pinia

### 组件开发

1. 组件文件命名使用 PascalCase（如 `QuestionCard.vue`）
2. 使用 TypeScript 接口定义 Props
3. 遵循单一职责原则
4. 样式使用 scoped CSS

### API 调用

API 调用统一在 `src/apis/` 目录下定义，使用 `src/services/http.ts` 配置的 Axios 实例。

### 状态管理

使用 Pinia 进行状态管理，持久化使用 `pinia-plugin-persistedstate`。

## 配置说明

### 配置文件

所有配置项统一在 `src/config/index.ts` 中管理，支持环境变量覆盖。

### 环境变量

项目使用 Vite 环境变量，可在 `.env` 文件中配置。参考 `.env.example` 文件：

```env
# API 配置
VITE_API_BASE_URL=http://localhost:8000

# 应用配置
VITE_APP_NAME=HomeWork 作业管理系统
VITE_APP_VERSION=1.0.0

# 功能开关
VITE_ENABLE_DEBUG=true
VITE_ENABLE_MOCK=false
```

### 配置文件结构

```typescript
// src/config/index.ts
const config = {
  api: {
    baseURL: import.meta.env.VITE_API_BASE_URL || "http://localhost:8000",
    timeout: 10000,
  },
  app: {
    name: "HomeWork 作业管理系统",
    version: "1.0.0",
  },
  // ... 其他配置
};
```

### 使用配置

在代码中导入配置：

```typescript
import config from '@/config';

// 使用 API 配置
const baseURL = config.api.baseURL;

// 使用应用配置
const appName = config.app.name;
```

## 部署

### 构建

```bash
npm run build
```

构建产物位于 `dist/` 目录。

### 服务器部署

将 `dist/` 目录内容部署到 Web 服务器（如 Nginx、Apache）即可。

## 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交代码变更
4. 创建 Pull Request

## 许可证

MIT License

## 联系方式

如有问题或建议，请通过 Gitee 项目页面提交 Issue。

---

**项目维护者**: lingxi066