# git-checker

**Repository Path**: relaxhai/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**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git Repository Statistics

A Spring Boot-based web application for analyzing and visualizing contribution statistics from Git repositories.

![img.png](img.png)

## Features

- Support for multiple Git repositories
- Statistics include commit count, lines added, and lines deleted
- Visual representation of each contributor's statistics using interactive charts
- Custom date range selection for statistics
- Default view of the last week's statistics
- Detailed commit history view for each contributor
- Ability to view specific changes in each commit with syntax highlighting
- Responsive design for better usability on different devices

## Screenshots

### Commit History
![img_1.png](img_1.png)

### Commit Details
![img_3.png](img_3.png)

## Tech Stack

- Backend: JDK21,Spring Boot
- Frontend: HTML, JavaScript, jQuery, Chart.js, Bootstrap
- Version Control: JGit
- Build Tool: Maven
- Code Highlighting: highlight.js

## Quick Start

1. Clone the repository:

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

2. Configure Git repositories:

   Add the Git repositories you want to analyze in the `src/main/resources/application.properties` file:

   ```
   git.repositories[0].name=Repo1
   git.repositories[0].path=/path/to/repo1
   git.repositories[1].name=Repo2
   git.repositories[1].path=/path/to/repo2
   ```

3. Build the project:

   ```
   mvn clean package
   ```

4. Run the application:

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

5. Access the application:

   Open a web browser and navigate to `http://localhost:8080`

### Docker Deployment

1. Build the Docker image:

   ```
   docker build -t git-checker:latest .
   ```

2. Run the Docker container:

   ```
   docker run -p 8082:8080 \
     -v /path/to/your/repos:/app/repos \
     -e GIT_REPO_BASE_PATH=/app/repos \
     git-checker:latest
   ```

   Make sure to replace `/path/to/your/repos` with the actual path to your Git repositories on the host machine.

3. Access the application:

   Open a web browser and navigate to `http://localhost:8082`

### Docker Compose Deployment

1. Ensure you have Docker and Docker Compose installed.

2. Run the following command in the project root directory to start the service:

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

3. The service will start in the background. You can view the logs using:

   ```
   docker-compose logs -f git-checker
   ```

4. Access the application:

   Open a web browser and navigate to `http://localhost:8082`

5. To stop the service, run:

   ```
   docker-compose down
   ```

## Usage

1. Select a Git repository from the dropdown menu
2. Choose the start and end dates for the statistics (defaults to the last week)
3. Click the "Get Statistics" button to fetch the data
4. View the generated statistical charts
5. Click on a contributor's bar in the chart to view their detailed commit history
6. In the commit history modal, click on a commit to view the specific changes made in that commit

## Contributing

We welcome Issues and Pull Requests to help improve this project. Before submitting a Pull Request, please ensure your code adheres to the project's coding standards and passes all tests.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Contact

If you have any questions or suggestions, please feel free to reach out:

- Email: 1195726411@qq.com