# ai-gitlab-report

**Repository Path**: HEXGRID/ai-gitlab-report

## Basic Information

- **Project Name**: ai-gitlab-report
- **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-02-27
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Elements

一个基于 Vue 3 + NestJS 的现代化 AI 开发工作流工具，专注于提升开发效率和代码质量。

## ✨ 功能特性

### 🔗 GitLab 集成

- **项目管理**: 获取用户贡献的项目列表
- **分支管理**: 查看项目分支信息，支持主分支和活跃分支筛选
- **提交记录**: 智能获取用户在指定时间范围内的提交记录
- **用户管理**: 支持 GitLab 用户搜索和令牌管理

### 🤖 AI 能力

- **周报生成**: 基于 GitLab 提交记录自动生成工作周报
- **详细报告**: 生成包含代码变更分析的详细技术报告
- **流式响应**: 支持实时流式输出，提升用户体验
- **AI 对话**: 集成多种 AI 模型，支持上下文对话

### 🎨 现代化界面

- **Vue 3 + TypeScript**: 基于最新前端技术栈
- **Tailwind CSS**: 美观的现代化UI设计
- **Element Plus**: 丰富的组件库支持
- **响应式设计**: 适配多种设备屏幕

## 🏗️ 技术架构

### 前端 (ai-elements-vue-workflow)

```
Vue 3 + TypeScript + Vite
├── UI框架: Element Plus + Tailwind CSS
├── 状态管理: Pinia
├── HTTP客户端: Axios
├── 工具库: VueUse, date-fns
└── 动画: Motion Vue
```

### 后端 (ai-elements-api)

```
NestJS + TypeScript
├── Web框架: Express
├── AI集成: OpenAI API
├── HTTP客户端: Axios
└── 工具库: date-fns
```

## 🚀 快速开始

### 环境要求

- Node.js >= 20.19.0 || >= 22.12.0
- pnpm >= 10.26.0

### 安装依赖

```bash
# 安装前端依赖
cd ai-elements-vue-workflow
pnpm install

# 安装后端依赖
cd ../ai-elements-api
pnpm install
```

### 启动开发环境

#### 启动后端API

```bash
cd ai-elements-api
pnpm run start:dev
```

#### 启动前端应用

```bash
cd ai-elements-vue-workflow
pnpm run dev
```

### 构建生产版本

#### 构建前端

```bash
cd ai-elements-vue-workflow
pnpm run build
```

#### 构建后端

```bash
cd ai-elements-api
pnpm run build
```

## 📁 项目结构

```
ai-elements-vue/
├── ai-elements-vue-workflow/     # 前端Vue应用
│   ├── src/
│   │   ├── components/           # Vue组件
│   │   │   ├── ai-elements/      # AI相关组件
│   │   │   └── ui/              # UI组件库
│   │   ├── services/            # 服务层
│   │   │   ├── modules/         # 业务模块
│   │   │   └── types/           # TypeScript类型定义
│   │   ├── views/               # 页面视图
│   │   └── lib/                 # 工具库
│   ├── package.json
│   └── vite.config.ts
└── ai-elements-api/              # 后端API服务
    ├── src/
    │   ├── ai/                  # AI服务模块
    │   ├── gitlab/              # GitLab服务模块
    │   ├── common/              # 公共模块
    │   └── types/               # TypeScript类型定义
    └── package.json
```

## 🔧 配置说明

### AI 服务配置

在前端应用中配置 AI API 密钥和基础URL：

```typescript
interface ApiConfig {
  aiApiKey: string; // AI API 密钥
  aiBaseUrl?: string; // AI API 基础URL (可选)
}
```

### GitLab 配置

需要配置 GitLab 访问令牌和API地址：

```typescript
interface GitLabConfig {
  baseURL: string; // GitLab API 地址
  token: string; // 个人访问令牌
}
```

## 📜 可用脚本

### 前端脚本

```bash
pnpm run dev          # 启动开发服务器
pnpm run build        # 构建生产版本
pnpm run preview      # 预览生产构建
pnpm run type-check   # TypeScript类型检查
pnpm run lint         # ESLint代码检查
pnpm run format       # Prettier代码格式化
```

### 后端脚本

```bash
pnpm run start:dev    # 启动开发服务器 (带热重载)
pnpm run start:debug  # 启动调试模式
pnpm run start:prod   # 启动生产服务器
pnpm run build        # 构建生产版本
pnpm run format       # Prettier代码格式化
```

## 🤝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。

## 🙋‍♂️ 支持

如果您在使用过程中遇到问题或有建议，请：

1. 查看 [Issues](../../issues) 页面
2. 创建新的 Issue 描述问题
3. 提供详细的错误信息和复现步骤

---

**AI Elements** - 让 AI 助力您的开发工作流 🚀