tests/load/reports/README.md

# Load Test Reports Directory

This directory stores load test results and baseline files for performance regression detection.

## Directory Structure

- `baseline.json` - Reference performance metrics for regression detection
- `load_test_*.json` - Historical Locust JSON results
- `load_test_*.html` - Historical HTML reports
- `load_test_*.log` - Historical test logs

## Updating Baseline

**Important:** Only update `baseline.json` on the main branch after verifying that performance improvements are legitimate.

To update the baseline:

```bash

# Run load tests

./backend/tests/scripts/run_load_tests.sh -u 200 -r 20 -t 10m



# Copy results to baseline

cp backend/tests/load/reports/load_test_<TIMESTAMP>.json backend/tests/load/reports/baseline.json



# Commit changes

git add backend/tests/load/reports/baseline.json

git commit -m "perf: update load test baseline to <TIMESTAMP>"

```

## Performance Regression Detection

Compare new results against baseline:

```bash

./backend/tests/scripts/compare_performance.py \

  backend/tests/load/reports/baseline.json \

  backend/tests/load/reports/load_test_<TIMESTAMP>.json

```

Exit code 1 indicates regression detected.

## Git Configuration

The `.gitignore` in this directory ignores all reports except `baseline.json` to keep repository size manageable.