# alexandrebulete/laravel-benchmark architecture

> Architecture diagram of the GitHub repository alexandrebulete/laravel-benchmark, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/alexandrebulete/laravel-benchmark
- Repository: https://github.com/alexandrebulete/laravel-benchmark

## Overview

Laravel Benchmark is a Laravel package for executing repeatable benchmarks against an isolated database, collecting runtime and query metrics, and reporting optimization advice and baseline regressions. The main workflow starts with an Artisan command discovering or selecting a benchmark, then running its setup and measured code; results can be analyzed, compared with saved baselines, and displayed. The graph includes the documented installation/Docker capability and iteration statistics. Some command and database wiring is unsampled, so only relationships supported by the README or SOURCE INDEX are drawn.

Main entry points: [`src/BenchmarkCase.php`](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/BenchmarkCase.php) (Benchmark case), [`src/Console/DynamicBenchmarkCommand.php`](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Console/DynamicBenchmarkCommand.php) (Dynamic runner), [`src/Advisor/Advisor.php`](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/Advisor.php) (Advisor analysis), [`src/Console`](https://github.com/alexandrebulete/laravel-benchmark/tree/main/src/Console) (Benchmark commands)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Benchmark execution"]
  node_benchmark_commands["Benchmark commands"]
  node_dynamic_command["Dynamic runner"]
  node_registry["Benchmark registry"]
  node_benchmark_case["Benchmark case<br/>[BenchmarkCase.php]"]
  node_benchmark_database[("Isolated database")]
  node_iteration_stats["Iteration statistics"]
end

subgraph group_analysis["Query analysis"]
  node_query_collector["Query collector<br/>[QueryCollector.php]"]
  node_collected_query["Query metadata<br/>[CollectedQuery.php]"]
  node_advisor["Advisor analysis<br/>[Advisor.php]"]
  node_advisor_rules["Advisor rules"]
  node_advisor_report["Advisor report<br/>[AdvisorReport.php]"]
  node_performance_score["Performance score"]
  node_report_renderer["Report renderer"]
end

subgraph group_baselines["Baseline comparison"]
  node_baseline_storage[("Baseline storage")]
  node_baseline_result["Baseline result<br/>[BaselineResult.php]"]
  node_regression_detector["Regression detector"]
  node_comparison_result["Comparison result"]
end

subgraph group_setup["Setup and integration"]
  node_service_provider["Package provider"]
  node_installer["Installer command"]
  node_docker_template["Docker template"]
end

node_developer(("Developer"))
node_artisan(("Artisan CLI"))

node_developer -->|"invokes"| node_artisan
node_artisan -->|"runs"| node_benchmark_commands
node_benchmark_commands -->|"discovers benchmarks"| node_registry
node_benchmark_commands -->|"runs benchmark"| node_benchmark_case
node_dynamic_command -->|"runs benchmark"| node_benchmark_case
node_registry -->|"indexes subclasses"| node_benchmark_case
node_benchmark_case -->|"sets up database"| node_benchmark_database
node_benchmark_case -->|"collects queries"| node_advisor
node_benchmark_case -.->|"measures runs"| node_iteration_stats
node_advisor -->|"starts collection"| node_query_collector
node_query_collector -->|"records queries"| node_collected_query
node_advisor -->|"runs rules"| node_advisor_rules
node_advisor -->|"builds report"| node_advisor_report
node_dynamic_command -->|"scores report"| node_performance_score
node_benchmark_case -->|"renders report"| node_report_renderer
node_dynamic_command -->|"loads baseline"| node_baseline_storage
node_baseline_storage -->|"reads and writes"| node_baseline_result
node_dynamic_command -->|"compares results"| node_regression_detector
node_regression_detector -->|"produces comparison"| node_comparison_result
node_artisan -->|"installs package"| node_installer
node_installer -.->|"uses template"| node_docker_template
node_service_provider -->|"registers commands"| node_benchmark_commands

click node_benchmark_commands "https://github.com/alexandrebulete/laravel-benchmark/tree/main/src/Console"
click node_dynamic_command "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Console/DynamicBenchmarkCommand.php"
click node_registry "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/BenchmarkRegistry.php"
click node_benchmark_case "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/BenchmarkCase.php"
click node_benchmark_database "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Concerns/UsesBenchmarkDatabase.php"
click node_iteration_stats "https://github.com/alexandrebulete/laravel-benchmark/tree/main/src/Stats"
click node_query_collector "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/QueryCollector.php"
click node_collected_query "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/DTO/CollectedQuery.php"
click node_advisor "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/Advisor.php"
click node_advisor_rules "https://github.com/alexandrebulete/laravel-benchmark/tree/main/src/Advisor/Rules"
click node_advisor_report "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/DTO/AdvisorReport.php"
click node_performance_score "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/PerformanceScore.php"
click node_report_renderer "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/AdvisorReportRenderer.php"
click node_baseline_storage "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Baseline/BaselineStorage.php"
click node_baseline_result "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Baseline/BaselineResult.php"
click node_regression_detector "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Baseline/RegressionDetector.php"
click node_comparison_result "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Baseline/ComparisonResult.php"
click node_service_provider "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/BenchmarkServiceProvider.php"
click node_installer "https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Console/InstallBenchmarkCommand.php"
click node_docker_template "https://github.com/alexandrebulete/laravel-benchmark/blob/main/stubs/compose.benchmark.yml.stub"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_benchmark_commands,node_dynamic_command,node_registry,node_benchmark_case,node_benchmark_database,node_iteration_stats toneBlue
class node_query_collector,node_collected_query,node_advisor,node_advisor_rules,node_advisor_report,node_performance_score,node_report_renderer toneAmber
class node_baseline_storage,node_baseline_result,node_regression_detector,node_comparison_result toneMint
class node_service_provider,node_installer,node_docker_template toneRose
class node_developer,node_artisan toneIndigo
```

## Components

### Benchmark execution

- [Benchmark commands](https://github.com/alexandrebulete/laravel-benchmark/tree/main/src/Console): `src/Console`
- [Dynamic runner](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Console/DynamicBenchmarkCommand.php): `src/Console/DynamicBenchmarkCommand.php`
- [Benchmark registry](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/BenchmarkRegistry.php): `src/BenchmarkRegistry.php`
- [Benchmark case](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/BenchmarkCase.php): `src/BenchmarkCase.php`
- [Isolated database](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Concerns/UsesBenchmarkDatabase.php): `src/Concerns/UsesBenchmarkDatabase.php`
- [Iteration statistics](https://github.com/alexandrebulete/laravel-benchmark/tree/main/src/Stats): `src/Stats`

### Query analysis

- [Query collector](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/QueryCollector.php): `src/Advisor/QueryCollector.php`
- [Query metadata](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/DTO/CollectedQuery.php): `src/Advisor/DTO/CollectedQuery.php`
- [Advisor analysis](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/Advisor.php): `src/Advisor/Advisor.php`
- [Advisor rules](https://github.com/alexandrebulete/laravel-benchmark/tree/main/src/Advisor/Rules): `src/Advisor/Rules`
- [Advisor report](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/DTO/AdvisorReport.php): `src/Advisor/DTO/AdvisorReport.php`
- [Performance score](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/PerformanceScore.php): `src/Advisor/PerformanceScore.php`
- [Report renderer](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Advisor/AdvisorReportRenderer.php): `src/Advisor/AdvisorReportRenderer.php`

### Baseline comparison

- [Baseline storage](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Baseline/BaselineStorage.php): `src/Baseline/BaselineStorage.php`
- [Baseline result](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Baseline/BaselineResult.php): `src/Baseline/BaselineResult.php`
- [Regression detector](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Baseline/RegressionDetector.php): `src/Baseline/RegressionDetector.php`
- [Comparison result](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Baseline/ComparisonResult.php): `src/Baseline/ComparisonResult.php`

### Setup and integration

- [Package provider](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/BenchmarkServiceProvider.php): `src/BenchmarkServiceProvider.php`
- [Installer command](https://github.com/alexandrebulete/laravel-benchmark/blob/main/src/Console/InstallBenchmarkCommand.php): `src/Console/InstallBenchmarkCommand.php`
- [Docker template](https://github.com/alexandrebulete/laravel-benchmark/blob/main/stubs/compose.benchmark.yml.stub): `stubs/compose.benchmark.yml.stub`

### Other components

- **Developer**
- **Artisan CLI**

## Connections

- Developer → Artisan CLI: invokes (evidence: `README.md`)
- Artisan CLI → Benchmark commands: runs (evidence: `README.md`)
- Benchmark commands → Benchmark registry: discovers benchmarks (evidence: `src/Console/ListBenchmarksCommand.php`)
- Benchmark commands → Benchmark case: runs benchmark (evidence: `src/Console/RunBenchmarkCommand.php`)
- Dynamic runner → Benchmark case: runs benchmark (evidence: `src/Console/DynamicBenchmarkCommand.php`)
- Benchmark registry → Benchmark case: indexes subclasses (evidence: `src/BenchmarkRegistry.php`)
- Benchmark case → Isolated database: sets up database (evidence: `src/BenchmarkCase.php`)
- Benchmark case → Advisor analysis: collects queries (evidence: `src/BenchmarkCase.php`)
- Benchmark case → Iteration statistics: measures runs
- Advisor analysis → Query collector: starts collection (evidence: `src/Advisor/Advisor.php`)
- Query collector → Query metadata: records queries (evidence: `src/Advisor/QueryCollector.php`)
- Advisor analysis → Advisor rules: runs rules (evidence: `src/Advisor/Advisor.php`)
- Advisor analysis → Advisor report: builds report (evidence: `src/Advisor/Advisor.php`)
- Dynamic runner → Performance score: scores report (evidence: `src/Console/DynamicBenchmarkCommand.php`)
- Benchmark case → Report renderer: renders report (evidence: `src/BenchmarkCase.php`)
- Dynamic runner → Baseline storage: loads baseline (evidence: `src/Console/DynamicBenchmarkCommand.php`)
- Baseline storage → Baseline result: reads and writes (evidence: `src/Baseline/BaselineStorage.php`)
- Dynamic runner → Regression detector: compares results (evidence: `src/Console/DynamicBenchmarkCommand.php`)
- Regression detector → Comparison result: produces comparison (evidence: `src/Baseline/RegressionDetector.php`)
- Artisan CLI → Installer command: installs package (evidence: `README.md`)
- Installer command → Docker template: uses template
- Package provider → Benchmark commands: registers commands (evidence: `src/BenchmarkServiceProvider.php`)
