161 lines
6.0 KiB
Markdown
161 lines
6.0 KiB
Markdown
# AI Worker 项目管理平台
|
||
|
||
> 以"项目"为中心、以"AI Worker"为执行单元的项目管理平台。
|
||
> 管目标、管任务、管人机协作、管质量、管成本。
|
||
|
||
## 🎯 MVP 功能
|
||
|
||
- **多租户隔离**：行级租户隔离，支持部门级/公司级用户隔离
|
||
- **项目管理**：项目全生命周期管理（立项→规划→执行→验收→归档）
|
||
- **AI Worker 管理**：模型注册、角色定义、工具白名单、成本上限
|
||
- **任务编排**：任务创建、分配给 AI Worker 或人、执行、产出物管理
|
||
- **HITL 审核门**：人工审核/验收，AI 不可绕过
|
||
- **成本核算**：Token / 调用次数 / 成本，按项目×任务×Worker×模型多维核算
|
||
- **RBAC 权限**：5级角色（super_admin → tenant_admin → project_manager → reviewer → worker）
|
||
- **Dashboard**：项目/任务/Worker/成本/审核 全景看板
|
||
|
||
## 🏗️ 技术架构
|
||
|
||
```
|
||
前端：React 18 + TypeScript + Ant Design 5 + Vite
|
||
后端：FastAPI + SQLAlchemy + Pydantic v2
|
||
认证：JWT + bcrypt
|
||
LLM网关：OpenAI兼容协议（支持OpenAI/DeepSeek/vLLM等）
|
||
数据库：SQLite (开发) / PostgreSQL (生产)
|
||
```
|
||
|
||
## 📁 代码组织
|
||
|
||
```
|
||
ai-worker-platform/
|
||
├── backend/
|
||
│ ├── app/
|
||
│ │ ├── main.py # FastAPI 入口
|
||
│ │ ├── config.py # 配置管理
|
||
│ │ ├── database.py # 数据库引擎/会话
|
||
│ │ ├── core/ # 核心工具层
|
||
│ │ │ ├── security.py # JWT + 密码哈希
|
||
│ │ │ ├── tenant.py # 租户上下文
|
||
│ │ │ ├── exceptions.py # 自定义异常
|
||
│ │ │ └── permissions.py # RBAC 权限定义
|
||
│ │ ├── models/ # 数据模型层（每域一个文件）
|
||
│ │ │ ├── base.py # Base + Mixin
|
||
│ │ │ ├── tenant.py # 租户
|
||
│ │ │ ├── user.py # 用户（人+AI）
|
||
│ │ │ ├── project.py # 项目
|
||
│ │ │ ├── task.py # 任务
|
||
│ │ │ ├── worker.py # AI Worker
|
||
│ │ │ ├── artifact.py # 产出物
|
||
│ │ │ ├── review.py # 审核门
|
||
│ │ │ └── cost.py # 成本记录
|
||
│ │ ├── schemas/ # Pydantic schemas（每域一个文件）
|
||
│ │ ├── services/ # 业务逻辑层
|
||
│ │ │ ├── auth_service.py
|
||
│ │ │ ├── project_service.py
|
||
│ │ │ ├── task_service.py
|
||
│ │ │ ├── worker_service.py
|
||
│ │ │ ├── execution_service.py # 任务执行引擎
|
||
│ │ │ ├── review_service.py # 审核流程
|
||
│ │ │ ├── cost_service.py # 成本治理
|
||
│ │ │ └── llm_service.py # LLM 网关
|
||
│ │ └── api/v1/ # API路由层（每域一个文件）
|
||
│ │ ├── deps.py # 认证/租户/权限依赖
|
||
│ │ ├── auth.py
|
||
│ │ ├── tenants.py
|
||
│ │ ├── users.py
|
||
│ │ ├── projects.py
|
||
│ │ ├── tasks.py
|
||
│ │ ├── workers.py
|
||
│ │ ├── reviews.py
|
||
│ │ ├── artifacts.py
|
||
│ │ └── dashboard.py
|
||
│ ├── requirements.txt
|
||
│ ├── Dockerfile
|
||
│ └── run.py
|
||
├── frontend/
|
||
│ ├── src/
|
||
│ │ ├── api/ # API 客户端
|
||
│ │ ├── components/ # 共享组件
|
||
│ │ ├── pages/ # 页面视图
|
||
│ │ ├── stores/ # 状态管理 (Zustand)
|
||
│ │ └── types/ # TypeScript 类型
|
||
│ ├── Dockerfile
|
||
│ └── nginx.conf
|
||
├── docker-compose.yml
|
||
└── README.md
|
||
```
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 方式一：本地开发
|
||
|
||
```bash
|
||
# 后端
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
cp .env.example .env # 编辑配置
|
||
python init_db.py # 初始化数据库 + 创建管理员
|
||
python run.py # 启动后端 (http://localhost:8000)
|
||
|
||
# 前端
|
||
cd frontend
|
||
npm install
|
||
npm run dev # 启动前端 (http://localhost:5173)
|
||
```
|
||
|
||
默认管理员账号：`admin@test.com` / `admin123`
|
||
|
||
### 方式二：Docker 部署
|
||
|
||
```bash
|
||
cp .env.example .env # 配置 LLM API Key
|
||
docker-compose up -d
|
||
# 前端: http://localhost:3000
|
||
# 后端: http://localhost:8000
|
||
# 数据库: PostgreSQL on localhost:5432
|
||
```
|
||
|
||
## 🔄 核心流程
|
||
|
||
```
|
||
项目经理创建项目 → 拆解任务 → 分配给 AI Worker
|
||
→ AI 执行任务（LLM 调用）→ 生成产出物
|
||
→ 自动质检 → 提交审核
|
||
→ 审核人审批（通过/打回）→ 归档
|
||
```
|
||
|
||
**设计原则：AI 负责干活，人负责定义目标和把关。**
|
||
|
||
## 🔐 多租户与权限
|
||
|
||
- **租户隔离**：所有业务数据表包含 `tenant_id` 字段，查询自动过滤
|
||
- **5级角色**：
|
||
- `super_admin`：平台级，管理所有租户
|
||
- `tenant_admin`：租户级，管理用户和 Worker
|
||
- `project_manager`：创建/管理项目，分配任务
|
||
- `reviewer`：审核 AI 产出
|
||
- `worker`：执行任务（人或 AI）
|
||
|
||
## 📊 API 端点
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| POST | /api/v1/auth/login | 登录 |
|
||
| POST | /api/v1/auth/register | 注册 |
|
||
| GET | /api/v1/auth/me | 当前用户 |
|
||
| GET/POST | /api/v1/projects | 项目列表/创建 |
|
||
| GET/PUT/DELETE | /api/v1/projects/{id} | 项目详情/更新/删除 |
|
||
| GET | /api/v1/projects/{id}/stats | 项目统计 |
|
||
| GET/POST | /api/v1/tasks | 任务列表/创建 |
|
||
| POST | /api/v1/tasks/{id}/assign | 分配任务 |
|
||
| POST | /api/v1/tasks/{id}/execute | 执行任务 |
|
||
| GET/POST | /api/v1/workers | Worker列表/注册 |
|
||
| POST | /api/v1/workers/{id}/test | 测试Worker连接 |
|
||
| GET | /api/v1/reviews | 审核列表 |
|
||
| POST | /api/v1/reviews/{id}/decision | 审核决策 |
|
||
| GET | /api/v1/dashboard | 全局看板 |
|
||
|
||
## 📝 版本
|
||
|
||
- v1.0.0 - MVP（2026-08-12）
|