# sports-analytics-club-at-utd/soccer-impact-engine-index architecture

> Architecture diagram of the GitHub repository sports-analytics-club-at-utd/soccer-impact-engine-index, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sports-analytics-club-at-utd/soccer-impact-engine-index
- Repository: https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index

## Overview

Soccer Impact Index is an experimental scouting website for supported midfielder and centre-back player-seasons. A visitor selects a website experience, browses player search/rankings and comparisons, or views team spatial-dominance heatmaps. The backend’s evidence-to-rating path reconstructs source-backed player facts, resolves identity and participation, derives action metrics, scores attributes, assembles ratings, and prepares delivery. The graph also preserves the documented public website capabilities and the separate experimental five-attribute experience. Several backend modules are unsampled; their connections are shown only where excerpts, the source index, or README support them.

Main entry points: [`src/source_reconstruction.py`](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/source_reconstruction.py) (Source reconstruction), [`src/rating_pipeline.py`](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/rating_pipeline.py) (Rating pipeline), [`frontend/src/dev/FiveAttributeExperimentalExperience.jsx`](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/dev/FiveAttributeExperimentalExperience.jsx) (Five-attribute experience), [`frontend/src/components/Search.jsx`](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/components/Search.jsx) (Player browsing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Website experiences"]
  node_app["Experience router<br/>[App.jsx]"]
  node_experimental["Five-attribute experience"]
  node_player_browse["Player browsing<br/>[Search.jsx]"]
  node_team_views["Team heatmaps<br/>[Teams.jsx]"]
  node_scorecard["Attribute presentation"]
end

subgraph group_evidence["Evidence preparation"]
  node_source_reconstruction["Source reconstruction"]
  node_participation_adapter["StatsBomb participation"]
  node_participation_intervals["Participation intervals"]
  node_identity["Event identity<br/>[identity.py]"]
  node_identity_evidence["Identity evidence"]
  node_action_metrics["Recovery and pass metrics"]
  node_press_actions["Press actions<br/>[press_actions.py]"]
end

subgraph group_ratings["Rating computation"]
  node_defensive_candidates["Defensive candidates"]
  node_dri["Defensive scoring<br/>[dri_scoring.py]"]
  node_press_scoring["Press scoring<br/>[press_scoring.py]"]
  node_assembly["Rating assembly<br/>[rating_assembly.py]"]
  node_pipeline["Rating pipeline<br/>[rating_pipeline.py]"]
end

subgraph group_presentation["Delivery and presentation"]
  node_delivery["Rating delivery<br/>[rating_delivery.py]"]
  node_frontend_delivery["Experimental data loading"]
  node_public_delivery["Public ratings delivery"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_app
node_app -->|"loads experimental view"| node_experimental
node_app -.->|"loads player experience"| node_player_browse
node_experimental -->|"loads ratings"| node_frontend_delivery
node_experimental -.->|"provides player browsing"| node_player_browse
node_experimental -->|"provides team views"| node_team_views
node_player_browse -.->|"uses rating presentation"| node_scorecard
node_source_reconstruction -->|"adapts participation"| node_participation_adapter
node_source_reconstruction -->|"uses intervals"| node_participation_intervals
node_source_reconstruction -->|"resolves identity"| node_identity
node_source_reconstruction -->|"uses recovery metrics"| node_action_metrics
node_source_reconstruction -->|"uses press metrics"| node_press_actions
node_identity_evidence -->|"delegates identity checks"| node_identity
node_pipeline -->|"evaluates candidates"| node_defensive_candidates
node_pipeline -->|"scores defense"| node_dri
node_pipeline -->|"scores press resistance"| node_press_scoring
node_pipeline -->|"assembles ratings"| node_assembly
node_delivery -->|"computes defensive ratings"| node_dri
node_delivery -->|"assembles delivered profiles"| node_assembly
node_frontend_delivery -->|"uses rating delivery"| node_delivery
node_public_delivery -.->|"supplies public player data"| node_player_browse

click node_app "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/App.jsx"
click node_experimental "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/dev/FiveAttributeExperimentalExperience.jsx"
click node_player_browse "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/components/Search.jsx"
click node_team_views "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/components/Teams.jsx"
click node_scorecard "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/lib/fiveAttributePresentation.js"
click node_source_reconstruction "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/source_reconstruction.py"
click node_participation_adapter "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/statsbomb_participation.py"
click node_participation_intervals "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/participation_intervals.py"
click node_identity "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/identity.py"
click node_identity_evidence "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/identity_evidence.py"
click node_action_metrics "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/metrics/recovery_coverage.py"
click node_press_actions "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/metrics/press_actions.py"
click node_defensive_candidates "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/defensive_candidates.py"
click node_dri "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/dri_scoring.py"
click node_press_scoring "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/press_scoring.py"
click node_assembly "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/rating_assembly.py"
click node_pipeline "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/rating_pipeline.py"
click node_delivery "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/rating_delivery.py"
click node_frontend_delivery "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/dev/experimentalDelivery.js"
click node_public_delivery "https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/lib/publicRatingsDelivery.js"

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_app,node_experimental,node_player_browse,node_team_views,node_scorecard toneBlue
class node_source_reconstruction,node_participation_adapter,node_participation_intervals,node_identity,node_identity_evidence,node_action_metrics,node_press_actions toneAmber
class node_defensive_candidates,node_dri,node_press_scoring,node_assembly,node_pipeline toneMint
class node_delivery,node_frontend_delivery,node_public_delivery toneRose
class node_visitor toneIndigo
```

## Components

### Website experiences

- [Experience router](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Five-attribute experience](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/dev/FiveAttributeExperimentalExperience.jsx): `frontend/src/dev/FiveAttributeExperimentalExperience.jsx`
- [Player browsing](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/components/Search.jsx): `frontend/src/components/Search.jsx`
- [Team heatmaps](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/components/Teams.jsx): `frontend/src/components/Teams.jsx`
- [Attribute presentation](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/lib/fiveAttributePresentation.js): `frontend/src/lib/fiveAttributePresentation.js`

### Evidence preparation

- [Source reconstruction](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/source_reconstruction.py): `src/source_reconstruction.py`
- [StatsBomb participation](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/statsbomb_participation.py): `src/statsbomb_participation.py`
- [Participation intervals](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/participation_intervals.py): `src/participation_intervals.py`
- [Event identity](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/identity.py): `src/identity.py`
- [Identity evidence](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/identity_evidence.py): `src/identity_evidence.py`
- [Recovery and pass metrics](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/metrics/recovery_coverage.py): `src/metrics/recovery_coverage.py`
- [Press actions](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/metrics/press_actions.py): `src/metrics/press_actions.py`

### Rating computation

- [Defensive candidates](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/defensive_candidates.py): `src/defensive_candidates.py`
- [Defensive scoring](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/dri_scoring.py): `src/dri_scoring.py`
- [Press scoring](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/press_scoring.py): `src/press_scoring.py`
- [Rating assembly](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/rating_assembly.py): `src/rating_assembly.py`
- [Rating pipeline](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/rating_pipeline.py): `src/rating_pipeline.py`

### Delivery and presentation

- [Rating delivery](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/src/rating_delivery.py): `src/rating_delivery.py`
- [Experimental data loading](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/dev/experimentalDelivery.js): `frontend/src/dev/experimentalDelivery.js`
- [Public ratings delivery](https://github.com/sports-analytics-club-at-utd/soccer-impact-engine-index/blob/main/frontend/src/lib/publicRatingsDelivery.js): `frontend/src/lib/publicRatingsDelivery.js`

### Other components

- **Visitor**

## Connections

- Visitor → Experience router: opens (evidence: `frontend/src/App.jsx`)
- Experience router → Five-attribute experience: loads experimental view (evidence: `frontend/src/App.jsx`)
- Experience router → Player browsing: loads player experience
- Five-attribute experience → Experimental data loading: loads ratings (evidence: `frontend/src/dev/FiveAttributeExperimentalExperience.jsx`)
- Five-attribute experience → Player browsing: provides player browsing
- Five-attribute experience → Team heatmaps: provides team views (evidence: `frontend/src/dev/FiveAttributeExperimentalExperience.jsx`)
- Player browsing → Attribute presentation: uses rating presentation
- Source reconstruction → StatsBomb participation: adapts participation (evidence: `src/source_reconstruction.py`)
- Source reconstruction → Participation intervals: uses intervals (evidence: `src/source_reconstruction.py`)
- Source reconstruction → Event identity: resolves identity (evidence: `src/source_reconstruction.py`)
- Source reconstruction → Recovery and pass metrics: uses recovery metrics (evidence: `src/source_reconstruction.py`)
- Source reconstruction → Press actions: uses press metrics (evidence: `src/source_reconstruction.py`)
- Identity evidence → Event identity: delegates identity checks (evidence: `src/identity_evidence.py`)
- Rating pipeline → Defensive candidates: evaluates candidates (evidence: `src/rating_pipeline.py`)
- Rating pipeline → Defensive scoring: scores defense (evidence: `src/rating_pipeline.py`)
- Rating pipeline → Press scoring: scores press resistance (evidence: `src/rating_pipeline.py`)
- Rating pipeline → Rating assembly: assembles ratings (evidence: `src/rating_pipeline.py`)
- Rating delivery → Defensive scoring: computes defensive ratings (evidence: `src/rating_delivery.py`)
- Rating delivery → Rating assembly: assembles delivered profiles (evidence: `src/rating_delivery.py`)
- Experimental data loading → Rating delivery: uses rating delivery (evidence: `frontend/src/dev/experimentalDelivery.js`)
- Public ratings delivery → Player browsing: supplies public player data
