# MBTI测评系统

**Repository Path**: runler/ai_mbti

## Basic Information

- **Project Name**: MBTI测评系统
- **Description**: Trae AI 用MCP:  chrome-devtools-mcp设计的 MBTI测评系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-24
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MBTI测评系统
MCP:  chrome-devtools-mcp  高德地图天气

个人规则
# 目前电脑操作系统安装使用的是windows11,语言是中文，node版本是23.11.0;
# 前端项目使用vue3+typescript,构建工具使用vite;包管理工具使用pnpm;
# 后端项目使用pyton+fastapi,包管理工具使用uv,数据库请使用sqlite3;
# 项目代码请尽量标注中文注释；

## 项目简介

MBTI测评系统是一个功能完整的性格测评平台，基于MBTI理论设计，包含用户管理、测评题库、作答系统、结果分析和分享功能。系统采用响应式设计，确保在PC端和移动端均有良好的用户体验。

## 技术栈

- **前端**: Vue3 + TypeScript + Vite
- **后端**: Python + FastAPI
- **数据库**: SQLite3
- **认证**: JWT + bcrypt
- **包管理**: 前端使用pnpm，后端使用uv

## 安装指南

### 前端安装

1. 确保已安装Node.js（版本23.11.0或更高）
2. 安装pnpm（如果未安装）：
   ```bash
   npm install -g pnpm
   ```
3. 安装前端依赖：
   ```bash
   pnpm install
   ```

### 后端安装

1. 确保已安装Python（版本3.10或更高）
2. 安装uv（如果未安装）：
   ```bash
   pip install uv
   ```
3. 安装后端依赖：
   ```bash
   cd backend
   uv add fastapi uvicorn python-jose[cryptography] passlib[bcrypt] python-multipart
   ```

## 运行指南

### 启动后端服务

```bash
cd backend
uv run uvicorn main:app --reload
```

后端服务将运行在 http://127.0.0.1:8000

### 启动前端服务

```bash
pnpm run dev
```

前端服务将运行在 http://localhost:5173（如果端口被占用，会自动使用其他端口）

## 使用指南

### 1. 用户注册

- 访问前端首页，点击"立即注册"
- 填写用户名、邮箱和密码
- 点击"注册"按钮完成注册

### 2. 用户登录

- 访问前端首页，点击"登录"
- 输入注册时的邮箱和密码
- 点击"登录"按钮完成登录

### 3. 开始测评

- 登录后，系统会自动跳转到测评页面
- 按照提示回答93道MBTI测试题目
- 系统会自动保存作答进度，支持断点续答
- 完成所有题目后，点击"提交测评"

### 4. 查看结果

- 测评提交后，系统会自动跳转到结果页面
- 查看详细的MBTI性格分析报告
- 了解自己的性格类型、优势和劣势

### 5. 分享结果

- 在结果页面，点击"分享结果"
- 选择分享方式：分享为图片、分享为文本或分享到社交平台
- 按照提示完成分享操作

### 6. 查看统计数据

- 在导航栏中点击"数据统计"
- 查看系统的测评数据统计和分析报表

## 系统功能

- ✅ 用户注册与登录
- ✅ MBTI测评题库（93道题目）
- ✅ 测评作答与进度保存
- ✅ 结果分析与报告生成
- ✅ 结果分享功能
- ✅ 数据统计与报表
- ✅ 响应式设计（适配PC和移动端）
- ✅ 数据安全（密码加密、JWT认证）

## 注意事项

1. 本系统使用SQLite3作为数据库，数据存储在本地
2. 系统支持1000+同时在线用户
3. 请确保后端服务和前端服务同时运行
4. 如需修改后端API地址，请修改前端的 `src/services/api.ts` 文件中的 `baseURL`

## 项目结构

### 前端结构

```
├── src/
│   ├── views/          # 页面组件
│   ├── services/       # API服务
│   ├── router/         # 路由配置
│   ├── main.ts         # 应用入口
│   └── App.vue         # 根组件
├── public/             # 静态资源
├── package.json        # 前端依赖
└── vite.config.ts      # Vite配置
```

### 后端结构

```
├── backend/
│   ├── routes/         # API路由
│   │   ├── auth.py     # 认证相关
│   │   ├── assessment.py # 测评相关
│   │   ├── result.py   # 结果相关
│   │   └── stats.py    # 统计相关
│   ├── main.py         # 后端入口
│   └── mbti.db         # SQLite数据库
```

## 开发说明

- 前端代码使用TypeScript，确保类型安全
- 后端代码使用FastAPI，提供自动API文档
- 数据库使用SQLite3，方便部署和测试
- 所有组件均采用响应式设计，确保跨设备兼容性

## 测试说明

1. 注册新用户并登录
2. 完成MBTI测评
3. 查看测评结果
4. 尝试分享结果
5. 查看统计数据

## 部署说明

1. 前端构建：
   ```bash
   pnpm run build
   ```
   构建产物将生成在 `dist` 目录

2. 后端部署：
   - 使用uvicorn启动生产服务
   - 配置适当的服务器环境

## 联系方式

如有问题或建议，请联系项目维护者。