# Smart Schedule Frontend

**Repository Path**: zuitu/smart-schedule-frontend

## Basic Information

- **Project Name**: Smart Schedule Frontend
- **Description**: 智能 K-12 学校排课系统 - 前端项目
- **Primary Language**: TypeScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-17
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Smart Schedule Frontend

智能 K-12 学校排课系统 - 前端项目

## 技术栈

- **框架**: Vue 3 + TypeScript
- **构建工具**: Vite 5
- **UI 组件**: Element Plus
- **状态管理**: Pinia
- **路由**: Vue Router
- **HTTP 客户端**: Axios

## 开发指南

### 环境要求

- Node.js 18+
- npm 9+

### 安装依赖

```bash
npm install
```

### 启动开发服务器

```bash
npm run dev
```

开发服务器默认运行在 `http://localhost:3000`，API 请求会自动代理到后端服务 `http://localhost:8080`。

### 构建生产版本

```bash
npm run build
```

构建产物输出到 `dist/` 目录。

### 预览生产构建

```bash
npm run preview
```

## 项目结构

```
src/
├── api/              # API 请求封装
├── components/       # 可复用组件
├── router/           # 路由配置
├── stores/           # Pinia 状态管理
├── types/            # TypeScript 类型定义
├── utils/            # 工具函数
└── views/            # 页面组件
```

## 后端 API 配置

开发环境下，API 代理配置在 `vite.config.ts` 中：

```typescript
server: {
  proxy: {
    '/api': {
      target: 'http://localhost:8080',
      changeOrigin: true,
    },
  },
}
```

生产环境部署时，需要配置反向代理（如 Nginx）将 `/api` 请求转发到后端服务。

## 与其他项目的关系

本前端项目与后端项目 **smart-schedule-agent** 配合使用：

- 后端仓库: `../smart-schedule-agent`
- 后端 API 文档: `http://localhost:8080/swagger-ui.html`