# openfootball/england architecture

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

- Interactive diagram: https://gitdiagram.com/openfootball/england
- Repository: https://github.com/openfootball/england

## Overview

This repository is a public-domain Football.TXT dataset for English and Welsh football, not an application with in-repository runtime code. Users can take league, cup, and squad data into external tools to produce database or export formats. The graph reflects README-documented workflows and tree-visible data; no source excerpts were available to verify further processing details.

Main entry points: [`2024-25`](https://github.com/openfootball/england/tree/master/2024-25) (Recent leagues), [`2000-01`](https://github.com/openfootball/england/tree/master/2000-01) (Earlier seasons)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_seasons["Season Data"]
  node_recent_seasons["Recent leagues"]
  node_current_season["Current leagues"]
  node_future_season["Future leagues"]
  node_season_cups["Cup matches<br/>[eflcup.txt]"]
  node_recent_squads["Club squads"]
  node_older_seasons["Earlier seasons"]
end

subgraph group_archive["Historical Data"]
  node_early_archive["Early league archive"]
  node_recent_archive["1990s archive"]
end

subgraph group_supplemental["Supplemental Data"]
  node_rsssf_data["RSSSF records"]
end

subgraph group_workflow["External Workflow"]
  node_sportdb["sportdb tool"]
  node_football_sqlite["SQLite loader"]
end

node_user(("Dataset user"))
node_database[("Football database")]
node_exports["JSON / CSV"]

node_user -->|"runs build"| node_sportdb
node_sportdb -->|"reads datasets"| node_recent_seasons
node_sportdb -->|"reads datasets"| node_older_seasons
node_sportdb -->|"builds database"| node_database
node_user -->|"loads files"| node_football_sqlite
node_football_sqlite -->|"reads match files"| node_recent_seasons
node_football_sqlite -->|"loads matches"| node_database
node_user -.->|"requests export"| node_sportdb
node_sportdb -.->|"builds exports"| node_exports

click node_recent_seasons "https://github.com/openfootball/england/tree/master/2024-25"
click node_current_season "https://github.com/openfootball/england/tree/master/2025-26"
click node_future_season "https://github.com/openfootball/england/tree/master/2026-27"
click node_season_cups "https://github.com/openfootball/england/blob/master/2024-25/eflcup.txt"
click node_recent_squads "https://github.com/openfootball/england/tree/master/2023-24/squads"
click node_older_seasons "https://github.com/openfootball/england/tree/master/2000-01"
click node_early_archive "https://github.com/openfootball/england/tree/master/archive/1880s"
click node_recent_archive "https://github.com/openfootball/england/tree/master/archive/1990s"
click node_rsssf_data "https://github.com/openfootball/england/tree/master/rsssf"

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_recent_seasons,node_current_season,node_future_season,node_season_cups,node_recent_squads,node_older_seasons,node_user toneBlue
class node_early_archive,node_recent_archive,node_database toneAmber
class node_rsssf_data toneMint
class node_sportdb,node_football_sqlite toneRose
class node_exports toneIndigo
```

## Components

### Season Data

- [Recent leagues](https://github.com/openfootball/england/tree/master/2024-25): `2024-25`
- [Current leagues](https://github.com/openfootball/england/tree/master/2025-26): `2025-26`
- [Future leagues](https://github.com/openfootball/england/tree/master/2026-27): `2026-27`
- [Cup matches](https://github.com/openfootball/england/blob/master/2024-25/eflcup.txt): `2024-25/eflcup.txt`
- [Club squads](https://github.com/openfootball/england/tree/master/2023-24/squads): `2023-24/squads`
- [Earlier seasons](https://github.com/openfootball/england/tree/master/2000-01): `2000-01`

### Historical Data

- [Early league archive](https://github.com/openfootball/england/tree/master/archive/1880s): `archive/1880s`
- [1990s archive](https://github.com/openfootball/england/tree/master/archive/1990s): `archive/1990s`

### Supplemental Data

- [RSSSF records](https://github.com/openfootball/england/tree/master/rsssf): `rsssf`

### External Workflow

- **sportdb tool**
- **SQLite loader**

### Other components

- **Dataset user**
- **Football database**
- **JSON / CSV**

## Connections

- Dataset user → sportdb tool: runs build
- sportdb tool → Recent leagues: reads datasets
- sportdb tool → Earlier seasons: reads datasets
- sportdb tool → Football database: builds database
- Dataset user → SQLite loader: loads files
- SQLite loader → Recent leagues: reads match files
- SQLite loader → Football database: loads matches
- Dataset user → sportdb tool: requests export
- sportdb tool → JSON / CSV: builds exports