# git-checker

**Repository Path**: wuhaii/git-checker

## Basic Information

- **Project Name**: git-checker
- **Description**: 基于 Spring Boot 的 Git 仓库贡献统计可视化工具，支持多仓库分析和自定义日期范围。
A Spring Boot-based Git repository contribution statistics visualization tool, supporting multi-repository analysis and custom date ranges.
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 0
- **Created**: 2024-09-17
- **Last Updated**: 2025-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git 仓库统计

一个基于 Spring Boot 的 Web 应用程序，用于分析和可视化 Git 仓库的贡献统计信息。

![img.png](img.png)

## 功能特性

- 支持多个 Git 仓库
- 统计信息包括提交次数、添加的行数和删除的行数
- 使用交互式图表直观展示每个贡献者的统计信息
- 自定义日期范围选择统计信息
- 默认显示最近一周的统计信息
- 查看每个贡献者的详细提交历史
- 能够查看每次提交的具体更改，并支持语法高亮
- 响应式设计，适应不同设备的使用

## 截图

### 提交历史
![img_1.png](img_1.png)
### 提交详情
![img_3.png](img_3.png)

## 技术栈

- 后端：JDK21,Spring Boot
- 前端：HTML, JavaScript, jQuery, Chart.js, Bootstrap
- 版本控制：JGit
- 构建工具：Maven
- 代码高亮：highlight.js

## 快速开始

1. 克隆仓库：

   ```
   git clone https://gitee.com/wuhaii/git-checker.git
   ```

2. 配置 Git 仓库：

   在 `src/main/resources/application.properties` 文件中添加你想要分析的 Git 仓库：

   ```
   git.repositories[0].name=仓库1
   git.repositories[0].path=/path/to/repo1
   git.repositories[1].name=仓库2
   git.repositories[1].path=/path/to/repo2
   ```

3. 构建项目：

   ```
   mvn clean package
   ```

4. 运行应用：

   ```
   java -jar target/git-checker-0.0.1-SNAPSHOT.jar
   ```

5. 访问应用：

   在浏览器中打开 `http://localhost:8080`

### Docker 部署

1. 构建 Docker 镜像：
   ```
   docker build -t git-checker:latest .
   ```

2. 运行 Docker 容器：
   ```
   docker run -p 8082:8080 \
     -v /root/.jenkins/workspace:/app/repos \
     -e GIT_REPO_BASE_PATH=/app/repos \
     git-checker:latest
   ```

   确保将 `/root/.jenkins/workspace` 替换为您主机上包含所有 Git 仓库的实际路径。

3. 访问应用：
   打开浏览器，访问 `http://localhost:8082`

### 使用 Docker Compose 部署

1. 确保你已经安装了 Docker 和 Docker Compose。

2. 在项目根目录下运行以下命令启动服务：
   ```
   docker-compose up -d
   ```

3. 服务将在后台启动。你可以使用以下命令查看日志：
   ```
   docker-compose logs -f git-checker
   ```

4. 访问应用：
   打开浏览器，访问 `http://localhost:8082`

5. 要停止服务，运行：
   ```
   docker-compose down
   ```

## 使用方法

1. 从下拉菜单中选择一个 Git 仓库
2. 选择统计信息的起始和结束日期（默认为最近一周）
3. 点击"获取统计信息"按钮来获取数据
4. 查看生成的统计图表
5. 点击图表中贡献者的柱状图来查看其详细的提交历史
6. 在提交历史模态框中，点击某个提交可以查看该提交的具体更改

## 贡献

我们欢迎 Issue 和 Pull Request 来帮助改进这个项目。在提交 Pull Request 之前，请确保你的代码符合项目的编码标准并通过所有测试。

## 许可证

本项目采用 MIT 许可证。详情请见 [LICENSE](LICENSE) 文件。

## 联系方式

如果你有任何问题或建议，欢迎联系：

- 邮箱：1195726411@qq.com
- Gitee：[@wuhaii](https://gitee.com/wuhaii)