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
🚀 快速开始
方式一：本地开发
# 后端
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 部署
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：租户级，管理用户和 Workerproject_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）