# DevMind

**Repository Path**: hogler/dev-mind

## Basic Information

- **Project Name**: DevMind
- **Description**: 连接 Gitea 代码仓库，自动分析 Git 提交记录，生成开发日报、周报、月报与项目研发分析。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DevMind AI（开发智脑）

企业研发智能助手：连接 Gitea 代码仓库与 AI 大模型，自动分析 Git 提交记录，生成开发日报、周报、月报与项目研发分析。

## 模块说明

| 目录 | 说明 |
|-|-|
| devmind-server | 后端服务（Java 17 + Spring Boot 3，含数据同步与 AI 智能体） |
| devmind-web | 管理后台（Vue3 + TypeScript + Vite + Element Plus + ECharts） |
| database | 数据库脚本 |
| doc | 项目文档 |

## 项目结构

```text
dev-mind
│
├── docker-compose.yml                    # 本地开发环境（MySQL、Redis）
│
├── doc                                   # 项目文档
│   ├── PROJECT_STRUCTURE.md              # 项目结构设计
│   ├── REQUIREMENT.md                    # 需求文档
│   ├── DevMind AI 项目 AI 开发约束规范.md
│   └── Gitea 提交记录智能日志生成系统工程设计文档.md
│
├── devmind-web                           # 管理后台（Vue3 + TS + Vite）
│   ├── WEB_REQUIREMENT.md                # Web端需求说明
│   └── src
│       ├── api                           # 接口封装（Mock/真实双通道）
│       ├── components                    # 公共组件（BaseChart等）
│       ├── layouts                       # 后台布局
│       ├── mock                          # 模拟数据层
│       ├── router                        # 路由与登录守卫
│       ├── stores                        # Pinia状态（user/system/ai）
│       ├── types                         # 类型定义
│       ├── utils                         # request封装与Token管理
│       └── views                         # 10个业务页面（含Gitea配置页）
│
├── database                              # 数据库脚本
│   ├── init.sql                          # 初始化脚本
│   ├── table                             # 建表脚本（含默认管理员数据）
│   │   ├── git_repository.sql            # 仓库配置表
│   │   ├── git_branch.sql                # 仓库分支表
│   │   ├── git_commit_log.sql            # 提交记录表
│   │   ├── git_commit_branch.sql         # 提交-分支关联表
│   │   ├── ai_report.sql                 # AI报告表
│   │   ├── ai_model_config.sql           # AI模型配置表
│   │   ├── system_config.sql             # 系统配置表（含Gitea连接配置字段）
│   │   ├── sys_user.sql                  # 用户表
│   │   ├── sys_user_data.sql             # 默认管理员（admin/123456）
│   │   ├── sys_user_token.sql            # 登录Token表
│   │   ├── analysis_project.sql          # 分析项目表
│   │   └── analysis_task.sql             # 分析任务表
│   └── upgrade                           # 已有库升级脚本
│       ├── v1.1_git_commit_log.sql
│       ├── v1.2_auth_project_task.sql
│       ├── v1.3_gitea_settings.sql
│       ├── v1.4_commit_files_longtext.sql
│       ├── v1.5_branch_support.sql
│       └── v1.6_repo_key_project.sql
│
└── devmind-server                        # 后端服务
    ├── pom.xml
    └── src/main/java/com/devmind
        ├── DevMindApplication.java       # 启动类
        ├── controller                    # 接口层（鉴权/仓库/同步/Gitea配置/模型/报告/统计/项目/任务/驾驶舱/系统配置）
        ├── service                       # 业务层
        │   └── impl                      # 业务层实现
        ├── mapper                        # 数据访问层
        ├── entity                        # 数据库实体
        ├── dto                           # 请求参数对象
        ├── vo                            # 返回对象
        ├── enums                         # 枚举定义
        ├── config                        # 系统配置（GiteaProperties、MybatisPlusConfig）
        ├── exception                     # 异常处理（BusinessException、GlobalExceptionHandler）
        ├── integration                   # 外部系统集成
        │   ├── gitea                     # Gitea客户端与DTO
        │   └── ai                        # AI大模型客户端（OpenAI兼容协议）与DTO
        ├── agent                         # AI智能体
        │   ├── common                    # Prompt模板加载器
        │   └── rule                      # 规则引擎（Commit前缀分类）
        └── utils                         # 工具类

        resources
        ├── application.yml               # 应用配置
        └── prompts                       # Prompt模板
            ├── commit.txt
            ├── daily.txt
            └── weekly.txt

        test/java/com/devmind             # 单元测试（同步/规则分类/AI切换/报告生成）
```

## 快速开始

1. 启动本地环境（MySQL、Redis）：

```bash
docker compose up -d
```

2. 配置环境变量后启动后端（也可启动后在「Gitea配置」页面配置，页面配置优先）：

```bash
export GITEA_URL=http://localhost:3000
export GITEA_TOKEN=你的Gitea令牌
cd devmind-server
mvn spring-boot:run
```

3. 启动前端（默认连接真实后端，开发代理已配置到 8080）：

```bash
cd devmind-web
npm install
npm run dev
# 访问 http://localhost:5173 ，默认账号：admin / 123456（首次部署后请及时修改）
# 无后端环境演示：.env 中 VITE_USE_MOCK=true，使用内置模拟数据
```

> 已有数据库环境升级：依次执行 `database/upgrade/v1.2_auth_project_task.sql`（项目/任务/Token表与默认管理员）、`v1.3_gitea_settings.sql`（system_config增加Gitea配置字段）、`v1.4_commit_files_longtext.sql`（git_commit_log.files改LONGTEXT，支持大提交文件列表）、`v1.5_branch_support.sql`（新增分支表与提交-分支关联表，支持全分支同步）、`v1.6_repo_key_project.sql`（仓库表增加重点项目标记字段）。
> 同步说明：一键同步只处理项目管理中已开启的仓库，并拉取仓库下全部分支的提交；提交按仓库+sha去重，分支归属记录在关联表；Gitea上已删除的分支自动标记失效。
> 报告说明：报告中心支持按提交人生成日报/周报/月报并可下载Markdown；仓库管理可标记重点项目置顶显示；Commit分析支持仓库/分支/提交人筛选。
> Gitea连接推荐通过管理后台「Gitea配置」页面录入：Token保存后仅显示掩码，不可查看，可通过「修改令牌」操作更换。

## 文档

- [项目结构设计](doc/PROJECT_STRUCTURE.md)
- [AI 开发约束规范](doc/DevMind%20AI%20项目%20AI%20开发约束规范.md)
- [工程设计文档](doc/Gitea%20提交记录智能日志生成系统工程设计文档.md)