# auto-feature

**Repository Path**: sevenclear/auto-feature

## Basic Information

- **Project Name**: auto-feature
- **Description**: 记录issue，自动化提供解决方案，判断是否需要人审批
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KBan - 需求管理与 AI Agent 协作平台

KBan 是一个需求管理平台，提供需求录入、API Key 管理、Issue 拆解和审核等能力。平台只定义数据模型和状态流转，不限制具体的使用方式——人和 Agent 都可以通过 API Key 自由操作所有接口。

## 技术栈

| 层 | 技术 |
|---|---|
| 后端 | Go + Gin + GORM + SQLite |
| 前端 | React + Vite + TypeScript + shadcn/ui + TailwindCSS |
| 认证 | 统一 API Key（Header: X-API-Key） |
| 存储 | 本地文件系统（./uploads/） |

## 快速启动

### 后端

```bash
cd backend
go run cmd/server/main.go
```

后端默认运行在 `http://localhost:8080`。

### 前端

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

前端默认运行在 `http://localhost:5173`，自动代理 API 请求到后端。

### 首次使用

1. 访问 `http://localhost:5173`
2. 系统会自动引导你初始化并创建管理员 API Key
3. 创建项目后会自动生成项目级 API Key

## 核心功能

- **项目管理**：创建/编辑/删除项目，每个项目独立的 API Key 体系
- **需求录入**：支持文字描述 + 图片附件（拖拽上传）
- **Issue 管理**：需求可拆解为多个 Issue，按难度分类
- **审核工作台**：查看 Agent 完成的 Issue，审核通过或打回
- **API Key 管理**：系统级（全能）+ 项目级（绑定项目）两级 Key

## API 认证

所有接口通过 `X-API-Key` Header 认证。

- 系统级 Key（`kb_system_` 前缀）：可访问所有项目
- 项目级 Key（`kb_proj_` 前缀）：只能访问所属项目

## 核心工作流

```
用户录入需求 → Agent 拉取需求 → Agent 拆解为 Issue → 人工确认方案 → Agent 开发 → 人工审核
```

## 测试

### 后端测试

```bash
cd backend
go test ./internal/handler/ -v
```

### 前端测试

```bash
cd frontend
npm test
```

## 项目结构

```
kban/
├── backend/
│   ├── cmd/server/main.go          # 入口
│   └── internal/
│       ├── config/                  # 配置
│       ├── database/                # 数据库初始化
│       ├── handler/                 # 接口处理器 + 测试
│       ├── middleware/              # 认证/限流/CORS/日志
│       ├── model/                   # 数据模型
│       ├── response/                # 统一响应
│       └── router/                  # 路由注册
├── frontend/
│   └── src/
│       ├── components/              # UI 组件
│       ├── lib/                     # API 封装
│       ├── pages/                   # 页面
│       ├── test/                    # 前端测试
│       └── types/                   # TypeScript 类型
└── .scratch/kban/                   # 开发需求文档（T1-T10）
```