Test Results Hub is a lightweight and efficient reporting tool designed to collect, store, and visualize test execution results. It focuses on capturing only failed test cases, optimizing storage and performance. The system integrates with JUnit test reports, MinIO for storage, and Grafana for visualization.

✅ Test Failure Tracking – Stores only failed test cases to minimize storage usage
✅ Performance Optimized – Uses efficient data structures for fast query execution
✅ Database-Driven – Supports PostgreSQL/MySQL for structured reporting
✅ MinIO Integration – Saves full test reports in cloud storage
✅ Grafana Dashboard – Provides real-time test analytics & failure histograms
✅ CI/CD Ready – Works with Jenkins, GitHub Actions, and other pipelines

test-results-hub/
│── src/                # Application source code
│   ├── api/            # REST API Endpoints
│   ├── db/             # Database models & queries
│   ├── minio/          # MinIO storage handling
│   ├── parsers/        # JUnit XML Parser
│   ├── services/       # Business logic & processing
│── grafana/            # Grafana configuration & dashboards
│── scripts/            # Utility scripts for setup
│── tests/              # Unit & integration tests
│── docker-compose.yml  # Docker setup
│── .env.example        # Environment variables template
│── README.md           # Project documentation

Ensure you have the following installed:

• Docker & Docker Compose
• Python 3.9+ (if using FastAPI) or Java 17+ (if using Spring Boot)
• PostgreSQL or MySQL
• MinIO (S3-compatible storage)
• Grafana

Clone the repository:

git clone https://github.com/your-username/test-results-hub.git
cd test-results-hub

Set up environment variables:

cp .env.example .env

Modify .env with your database & MinIO credentials.

Using Docker Compose:

docker-compose up -d

This will start the database, MinIO, and Grafana.

Alternatively, run services manually:

# Start PostgreSQL
docker run --name test-db -e POSTGRES_USER=user -e POSTGRES_PASSWORD=pass -d postgres

# Start MinIO
docker run --name minio -e MINIO_ACCESS_KEY=access -e MINIO_SECRET_KEY=secret -d minio/minio server /data

1. Open Grafana at http://localhost:3000/
2. Login (default: admin/admin)
3. Import the JSON dashboard from grafana/dashboards/

📌 Test Failure Histogram – Most frequently failing tests
📌 Failure Trends – See test pass/fail trends over time
📌 CI/CD Integration – Identify flaky tests in automated pipelines

Example API call:

curl -X POST http://localhost:8000/api/tests/upload -F "[email protected]"

name: Run Tests & Upload Results
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout Code
        uses: actions/checkout@v3

      - name: Run Tests
        run: mvn test | tee test-results.xml

      - name: Upload to Test Results Hub
        run: curl -X POST http://your-api-url/api/tests/upload -F "[email protected]"

This project is licensed under the GNU GENERAL PUBLIC License.

Contributions are welcome! Please follow the guidelines:

1. Fork the repository
2. Create a new branch (feature-xyz)
3. Commit changes (git commit -m "Add feature xyz")
4. Open a Pull Request