# uxquiz

**Repository Path**: yimu51/uxquiz

## Basic Information

- **Project Name**: uxquiz
- **Description**: 模拟面试小程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-06
- **Last Updated**: 2026-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: vue3, Python, React, Redis, celery

## README

# U面儿 - 面试学习工具

面向 UI/UX/产品 岗位的面试练习工具，包含小程序端、老师后台和服务端。

## 项目结构

```
uxquiz/
├── backend/          # Flask 后端服务
├── mini/             # UniApp 微信小程序
├── frontend/         # React + Antd 老师后台
├── demo/             # 前端UI演示
└── prd.md            # 产品需求文档
```

## 快速开始

### 1. 后端服务

```bash
cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填写正确的配置

# 初始化数据库
python scripts/init_db.py

# 启动服务 (端口5600)
python run.py
```

**环境变量配置 (`.env` 文件)**：
| 变量 | 说明 | 默认值 |
|------|------|--------|
| `DB_HOST` | 数据库地址 | 127.0.0.1 |
| `DB_PORT` | 数据库端口 | 3333 |
| `DB_USER` | 数据库用户名 | uxquiz |
| `DB_PASSWORD` | 数据库密码 | - |
| `DB_NAME` | 数据库名称 | uxquiz |
| `ADMIN_USERNAME` | 管理员用户名 | admin |
| `ADMIN_PASSWORD` | 管理员密码 | admin123 |
| `WECHAT_APPID` | 微信小程序 AppID | - |
| `WECHAT_SECRET` | 微信小程序 Secret | - |
| `SERVER_PORT` | 服务端口 | 5600 |

### 2. 小程序

```bash
cd mini

# 安装依赖
npm install

# 开发模式
npm run dev:mp-weixin

# 使用微信开发者工具打开 dist/dev/mp-weixin 目录
```

### 3. 老师后台

```bash
cd frontend

# 安装依赖
npm install

# 开发模式 (端口3000)
npm run dev
```

## 技术栈

- **后端**: Python Flask + SQLAlchemy + JWT
- **小程序**: UniApp + Vue3 + Pinia
- **后台**: React + Ant Design + Zustand
- **数据库**: MySQL

## 数据库配置

数据库配置通过 `.env` 文件管理，请参考 `.env.example` 文件。

## API文档

主要接口：

- `POST /api/auth/wechat-login` - 微信登录
- `POST /api/auth/teacher-login` - 老师登录
- `GET/PUT /api/user/profile` - 用户画像
- `GET /api/questions` - 题目列表
- `GET /api/questions/recommend` - 推荐题目
- `GET/POST /api/tickets` - 工单管理
- `GET/POST /api/favorites` - 收藏管理
- `GET/POST /api/admin/questions` - 题库管理（后台）

## 功能特性

### 用户端小程序
- 微信一键登录
- 用户画像设置
- 文字练习模式
- 语音模拟面试
- 收藏题目
- 问老师咨询

### 老师后台
- 工单中心（回复用户问题）
- 题库管理（CRUD）
- 标签管理
- 版本控制与回滚