# DevFlow

**Repository Path**: dawn_start/dev-flow

## Basic Information

- **Project Name**: DevFlow
- **Description**: No description available
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-13
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevFlow - AI智能研发管理平台

## 项目简介

DevFlow是一个面向中小型软件开发团队的AI原生研发管理平台, 提供需求管理、任务管理、代码审查、效能分析等功能。

## 技术栈

- 后端: Java 17 + Spring Boot 3.2 + Spring AI
- 数据库: MySQL 8.0 + Redis 7.x
- AI: DeepSeek API + Spring AI
- 构建: Maven

## 快速开始

### 1. 环境准备

- JDK 17+
- Maven 3.8+
- MySQL 8.0+
- Redis 7.x+

### 2. 数据库准备

```sql
CREATE DATABASE devflow DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

### 3. 配置

修改 `src/main/resources/application.yml`:

```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/devflow?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai
    username: your_username
    password: your_password

  data:
    redis:
      host: localhost
      port: 6379

  ai:
    openai:
      api-key: your_api_key
      base-url: https://api.deepseek.com
```

### 4. 运行

```bash
# 开发环境
mvn spring-boot:run

# 或者打包后运行
mvn clean package -DskipTests
java -jar target/devflow-backend-1.0.0.jar
```

### 5. 访问

- API地址: http://localhost:8080
- API文档: http://localhost:8080/swagger-ui.html (待集成)

## API接口

### 认证接口

```bash
# 注册
POST /api/auth/register
{
  "username": "testuser",
  "email": "test@example.com",
  "password": "123456",
  "tenantName": "测试公司"
}

# 登录
POST /api/auth/login
{
  "email": "test@example.com",
  "password": "123456"
}
```

### 项目接口

```bash
# 创建项目
POST /api/projects
Headers: X-Tenant-Id: 1, X-User-Id: 1
{
  "name": "测试项目",
  "description": "项目描述"
}

# 获取项目列表
GET /api/projects?page=0&size=20
Headers: X-Tenant-Id: 1

# 获取项目详情
GET /api/projects/1
Headers: X-Tenant-Id: 1

# 更新项目
PUT /api/projects/1
Headers: X-Tenant-Id: 1
{
  "name": "新项目名称"
}

# 删除项目
DELETE /api/projects/1
Headers: X-Tenant-Id: 1
```

### 任务接口

```bash
# 创建任务
POST /api/projects/1/tasks
{
  "title": "实现用户登录功能",
  "description": "实现邮箱+密码登录",
  "priority": "high",
  "assigneeId": 1,
  "estimatedHours": 8
}

# 获取任务列表
GET /api/projects/1/tasks?page=0&size=20

# 获取任务详情
GET /api/projects/1/tasks/1

# 更新任务
PUT /api/projects/1/tasks/1
{
  "title": "新任务标题"
}

# 更新任务状态
PATCH /api/projects/1/tasks/1/status
{
  "status": "in_progress"
}

# 删除任务
DELETE /api/projects/1/tasks/1

# 获取任务统计
GET /api/projects/1/tasks/stats
```

### AI接口

```bash
# AI问答
POST /api/ai/chat
{
  "question": "什么是微服务架构?"
}

# AI代码审查
POST /api/ai/review-code
{
  "code": "public void test() { ... }"
}

# AI需求分析
POST /api/ai/analyze-requirement
{
  "requirement": "实现用户登录功能..."
}

# AI需求拆解
POST /api/ai/split-requirement
{
  "requirement": "实现用户登录功能..."
}
```

## 项目结构

```
devflow-backend/
├── src/main/java/com/devflow/
│   ├── controller/      # 控制器
│   ├── service/         # 服务层
│   ├── repository/      # 数据访问
│   ├── model/           # 实体类
│   ├── dto/             # 数据传输对象
│   ├── config/          # 配置类
│   ├── exception/       # 异常处理
│   └── util/            # 工具类
├── src/main/resources/
│   └── application.yml  # 配置文件
└── pom.xml              # Maven配置
```

## 开发计划

- [x] 用户认证(注册/登录/JWT)
- [x] 项目管理(CRUD)
- [x] 任务管理(CRUD/状态流转)
- [x] AI问答/代码审查/需求分析/测试用例/文档生成
- [x] 需求管理(CRUD/AI分析)
- [x] 效能分析(任务统计/需求统计/效能指标)
- [x] 前端页面(工作台/项目/任务/需求/分析/AI/消息/个人中心)
- [x] 消息通知
- [x] 文件管理
- [x] JWT认证过滤器
- [x] 用户资料更新/密码修改
- [ ] 多租户完善(数据隔离)
- [ ] 权限管理(角色/权限)

## 许可证

MIT License