# WorkWise

**Repository Path**: yuke666123/work-wise

## Basic Information

- **Project Name**: WorkWise
- **Description**: 面向中小微企业 / 团队的智能办公 SaaS，以多 Agent 协同替代行政、文秘、内勤等重复工作，主打轻量化、开箱即用，是试错成本最低、现金流最快的方向。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-15
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WorkWise - 全能办公多 Agent 平台

> 用 AI 替小公司员工干杂活的 SaaS 工具

[![Python](https://img.shields.io/badge/Python-3.11+-blue.svg)](https://www.python.org/)
[![FastAPI](https://img.shields.io/badge/FastAPI-0.104+-green.svg)](https://fastapi.tiangolo.com/)
[![Vue](https://img.shields.io/badge/Vue-3.3+-brightgreen.svg)](https://vuejs.org/)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

## ✨ 产品特性

- 🤖 **5 个 AI Agent 协同工作** — 总控调度、文档处理、会议纪要、待办提醒、邮件沟通
- 📄 **智能文档处理** — PDF/Word/Excel 解析、摘要、关键信息提取
- 🎙️ **会议纪要自动化** — 语音转文字、结构化纪要、待办提取
- ✅ **智能任务管理** — 多渠道任务聚合、定时提醒、逾期催办
- 📧 **邮件助手** — 一键生成、润色、汇总往来邮件
- 🎨 **精美 UI** — 现代简约设计、渐变色彩、流畅动画

## 🏗️ 技术栈

### 后端
- **框架**: FastAPI + Python 3.11+
- **数据库**: PostgreSQL + SQLAlchemy 2.0 (异步)
- **缓存**: Redis
- **AI 框架**: CrewAI + LangGraph
- **大模型**: 通义千问 API
- **认证**: JWT + bcrypt

### 前端
- **框架**: Vue 3 + Composition API + TypeScript
- **UI 库**: Element Plus
- **构建工具**: Vite
- **状态管理**: Pinia
- **路由**: Vue Router

## 📁 项目结构

```
workwise/
├── backend/                    # 后端服务
│   ├── app/
│   │   ├── agents/            # 5 个 AI Agent
│   │   │   ├── orchestrator.py  # 总控调度
│   │   │   ├── document.py      # 文档处理
│   │   │   ├── meeting.py       # 会议纪要
│   │   │   ├── reminder.py      # 待办提醒
│   │   │   └── email.py         # 邮件沟通
│   │   ├── api/               # API 接口
│   │   ├── models/            # 数据库模型
│   │   ├── schemas/           # Pydantic 模型
│   │   └── services/          # 业务逻辑
│   ├── tests/                 # 测试文件
│   └── requirements.txt
├── frontend/                   # 前端应用
│   ├── src/
│   │   ├── components/        # 组件
│   │   │   ├── common/        # 通用组件
│   │   │   └── business/      # 业务组件
│   │   ├── views/             # 页面
│   │   ├── api/               # API 封装
│   │   ├── stores/            # 状态管理
│   │   └── styles/            # 样式
│   └── package.json
├── docker-compose.yml          # Docker 编排
└── README.md
```

## 🚀 快速开始

### 方式一：Docker Compose（推荐）

```bash
# 克隆项目
git clone https://gitee.com/yuke666123/work-wise.git
cd work-wise

# 启动所有服务
docker-compose up -d

# 访问应用
# 前端: http://localhost:3000
# 后端 API: http://localhost:8000
# API 文档: http://localhost:8000/docs
```

### 方式二：本地开发

#### 后端

```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 文件，填入你的配置

# 启动数据库（需要先安装 PostgreSQL 和 Redis）
# 创建数据库 workwise

# 运行数据库迁移
alembic upgrade head

# 启动后端服务
uvicorn app.main:app --reload --port 8000
```

#### 前端

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev

# 构建生产版本
npm run build
```

## 📚 API 文档

启动后端服务后，访问以下地址查看 API 文档：

- **Swagger UI**: http://localhost:8000/docs
- **ReDoc**: http://localhost:8000/redoc

### 主要 API 接口

| 模块 | 接口 | 说明 |
|:-----|:-----|:-----|
| 认证 | `POST /api/v1/auth/register` | 用户注册 |
| 认证 | `POST /api/v1/auth/login` | 用户登录 |
| 文档 | `POST /api/v1/document/upload` | 上传文档 |
| 文档 | `POST /api/v1/document/summarize` | 生成摘要 |
| 会议 | `POST /api/v1/meeting/upload` | 上传音频 |
| 会议 | `POST /api/v1/meeting/minutes` | 生成纪要 |
| 任务 | `POST /api/v1/task/create` | 创建任务 |
| 任务 | `GET /api/v1/task/list` | 任务列表 |
| 邮件 | `POST /api/v1/email/draft` | 生成邮件 |
| 邮件 | `POST /api/v1/email/polish` | 润色邮件 |

## 🧪 运行测试

```bash
cd backend

# 运行所有测试
pytest

# 运行特定测试文件
pytest tests/test_auth.py

# 运行并生成覆盖率报告
pytest --cov=app --cov-report=html
```

## 🎨 前端设计

### 色彩系统

```css
--primary-gradient: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
--primary-color: #667eea;
--success-color: #10b981;
--warning-color: #f59e0b;
--danger-color: #ef4444;
```

### 页面特性

- 🔐 **登录页** — 渐变背景 + 毛玻璃效果 + 浮动动画
- 📊 **工作台** — 渐变统计卡片 + 时间线 + 快速操作
- 📄 **文档页** — 拖拽上传 + 处理选项卡片 + 代码块结果
- 🎙️ **会议页** — 自定义音频播放器 + 结构化纪要
- ✅ **任务页** — 胶囊筛选按钮 + 彩色状态条卡片
- 📧 **邮件页** — 类型选择卡片 + 邮件样式预览

## 🔧 环境变量

```env
# 数据库
DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5432/workwise
REDIS_URL=redis://localhost:6379/0

# JWT
JWT_SECRET=your-super-secret-jwt-key
JWT_ALGORITHM=HS256
JWT_EXPIRATION=86400

# AI 模型
DASHSCOPE_API_KEY=your-dashscope-api-key

# 文件上传
UPLOAD_DIR=./uploads
MAX_FILE_SIZE=52428800  # 50MB
```

## 📦 部署

### 生产环境部署

```bash
# 构建并启动
docker-compose -f docker-compose.prod.yml up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down
```

### 环境要求

- Python 3.11+
- Node.js 18+
- PostgreSQL 15+
- Redis 7+
- Docker & Docker Compose（可选）

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 👥 团队

- **项目负责人**: 余柯

## 🙏 致谢

- [FastAPI](https://fastapi.tiangolo.com/)
- [Vue.js](https://vuejs.org/)
- [Element Plus](https://element-plus.org/)
- [通义千问](https://dashscope.aliyun.com/)

---

**⭐ 如果这个项目对你有帮助，请给个 Star 支持一下！**