# WorkPlay

**Repository Path**: qdyg/WorkPlay

## Basic Information

- **Project Name**: WorkPlay
- **Description**: WorkPlay 是一个面向小团队的轻量级任务协作平台，通过等级经验、金币、连击、抽奖、六芒星技能雷达等游戏化机制，激励团队成员高效完成工作。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-16
- **Last Updated**: 2026-07-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WorkPlay

> 任务管理 + 游戏化激励，让工作像玩游戏一样上瘾。

WorkPlay 是一个面向小团队的轻量级任务协作平台，通过等级经验、金币、连击、抽奖、六芒星技能雷达等游戏化机制，激励团队成员高效完成工作。

---

## 技术栈

| 层 | 技术 |
|---|------|
| 前端 | Vue 3 + TypeScript + Naive UI + Pinia + Vue Router 4 |
| 后端 | FastAPI (Python) + SQLAlchemy 2.0 异步 |
| 数据库 | SQLite（开发）/ PostgreSQL（生产可切换） |
| 认证 | JWT (OAuth2) Bearer Token |

---

## 快速开始

### 环境要求

- Python 3.11+
- Node.js 18+
- [可选] PostgreSQL

### 1. 克隆项目

```bash
git clone <repo-url>
cd WorkPlay
```

### 2. 启动后端

```bash
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
```

后端 API 文档：`http://localhost:8000/docs`

### 3. 启动前端

```bash
cd frontend
npm install
npm run dev
```

前端界面：`http://localhost:5173`

---

## 项目结构

```
WorkPlay/
├── backend/
│   └── app/
│       ├── main.py              # FastAPI 入口 + CORS
│       ├── config.py            # 配置
│       ├── database.py          # 数据库引擎
│       ├── auth.py              # JWT 鉴权
│       ├── security.py          # 密码哈希 + Token
│       ├── models.py            # ORM 模型（7张表）
│       ├── schemas.py           # Pydantic 请求/响应
│       ├── game_engine.py       # 游戏化引擎
│       ├── level_utils.py       # 等级经验计算
│       └── api/v1/              # REST API 路由
├── frontend/
│   └── src/
│       ├── main.ts              # 入口
│       ├── router/              # 路由配置
│       ├── stores/              # Pinia 状态管理
│       └── views/               # 页面组件
└── docs/                        # 文档
```

---

## 功能特性

### 核心任务管理
- 任务创建与指派，支持优先级、截止时间、预估工时
- 任务节点拆分，多人协作完成
- 状态机流转：待处理 → 进行中 → 审核中 → 已完成

### 游戏化激励
- **等级系统**：1~99 级，三次方增长经验曲线（累计 9,999,999 EXP）
- **金币系统**：完成任务赚取、抽奖消耗
- **连击机制**：连续及时完成获得 combo 加成
- **抽奖系统**：消耗金币抽取随机奖励
- **六芒星雷达**：技能维度可视化成长

### 团队协作
- 团队创建与邀请码加入
- 团队负载面板，成员工作量可视化
- 排行榜：总榜 / 周榜 / 月榜

---

## 等级经验公式

累计经验采用三次方增长曲线：

```
cum_exp(L) = round(9,999,999 × (L-1)³ / 98³)
```

| 等级 | 累计经验需求 |
|------|-------------|
| Lv.2 | 11 |
| Lv.10 | 8,500 |
| Lv.50 | 1,307,500 |
| Lv.99 | 9,999,999 |

---

## 文档

- [产品需求文档](docs/PRD.md)
- [开发进度](docs/DEVELOPMENT_PROGRESS.md)

---

## License

MIT