# task-orbit

**Repository Path**: heygody/task-orbit

## Basic Information

- **Project Name**: task-orbit
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Task Orbit

人机协同任务管理平台，支持人工任务与 AI Agent 任务的统一调度与流转。

## 技术栈

- 后端：Go + Gin + GORM + MySQL
- 前端：Vue 3 + Ant Design Vue + Vite
- 认证：JWT

## 项目结构

```
├── cmd/server/         # 程序入口
├── internal/
│   ├── config/         # 配置加载
│   ├── handler/        # HTTP 处理器
│   ├── middleware/      # 认证 & RBAC 中间件
│   ├── model/          # 数据模型 & 自动迁移
│   ├── router/         # 路由注册
│   └── service/        # 业务逻辑
├── pkg/
│   ├── jwt/            # JWT 工具
│   └── response/       # 统一响应格式
├── web/                # Vue 前端
├── deploy/             # Nginx 配置
└── config.yaml         # 应用配置
```

## 核心功能

- 项目管理：创建项目、成员管理、项目归档
- 任务管理：创建/分配/流转/子任务，支持 human 和 ai 两种任务类型
- 任务状态机：pending → accepted → in_progress → completed → closed，支持转发和拒绝
- AI Agent API：独立的 Agent Token 认证，支持 AI 自动领取和提交任务
- Webhook：任务状态变更时触发外部通知
- 角色权限：admin / pm / member 三级 RBAC
- 数据看板：项目概览、成员工作量、任务统计

## 快速开始

### 环境要求

- Go 1.25+
- Node.js 18+
- MySQL 8.0+

### 后端

```bash
# 修改 config.yaml 中的数据库连接信息
vim config.yaml

# 启动（首次运行会自动建表和创建管理员账号）
go run cmd/server/main.go
```

服务默认监听 `:8080`。

### 前端

```bash
cd web
npm install
npm run dev
```

### 构建部署

```bash
# 后端
go build -o server cmd/server/main.go

# 前端
cd web && npm run build
```

生产环境可参考 `deploy/nginx.conf` 配置反向代理。

## API 概览

所有接口前缀 `/api/v1`，认证接口需携带 `Authorization: Bearer <token>` 请求头。

| 模块 | 路径 | 说明 |
|------|------|------|
| 认证 | `POST /auth/login` | 登录获取 token |
| 用户 | `/users` | 用户管理（admin） |
| 项目 | `/projects` | 项目 CRUD（admin/pm） |
| 任务 | `/projects/:id/tasks` | 任务创建与列表 |
| 任务操作 | `/tasks/:taskId/accept\|start\|complete\|close\|forward` | 任务状态流转 |
| AI Agent | `/agent/tasks` | Agent 任务领取与提交 |
| 看板 | `/dashboard/*` | 数据概览 |
| 统计 | `/stats/*` | 多维度统计 |
| Webhook | `/webhooks` | Webhook 管理（admin） |

## License

MIT