# itsplk/ps5-payloads-mirror architecture

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

- Interactive diagram: https://gitdiagram.com/itsplk/ps5-payloads-mirror
- Repository: https://github.com/itsplk/ps5-payloads-mirror

## Overview

This repository maintains a catalog and downloadable mirror of PlayStation 5 payload releases. The main workflow is either adding a release interactively or updating catalogued releases: retrieve release metadata and artifacts, record them in the payload catalog, refresh the README listing, and maintain stale-download statistics. The README also documents the payloads as user-facing downloads. The sampled sources establish these operations; the workflow that invokes the updater is not established here.

Main entry points: [`update_payloads.py`](https://github.com/itsplk/ps5-payloads-mirror/blob/main/update_payloads.py) (Release updater), [`add_payload.py`](https://github.com/itsplk/ps5-payloads-mirror/blob/main/add_payload.py) (Add payload), [`payloads.json`](https://github.com/itsplk/ps5-payloads-mirror/blob/main/payloads.json) (Payload catalog), [`README.md`](https://github.com/itsplk/ps5-payloads-mirror/blob/main/README.md) (Payload listing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_management["Catalog management"]
  node_add["Add payload<br/>[add_payload.py]"]
  node_updater["Release updater<br/>[update_payloads.py]"]
end

subgraph group_mirror["Payload mirror"]
  node_catalog[("Payload catalog<br/>[payloads.json]")]
  node_artifacts[("Mirrored artifacts")]
  node_stats[("Download statistics")]
end

subgraph group_publication["Published catalog"]
  node_readme["Payload listing<br/>[README.md]"]
end

node_maintainer(("Maintainer"))
node_release_sources["Release sources"]
node_mirror_release["GitHub mirror release"]
node_download_user(("Download user"))

node_maintainer -->|"enters release"| node_add
node_add -->|"fetches release"| node_release_sources
node_updater -->|"checks releases"| node_release_sources
node_add -->|"downloads artifact"| node_artifacts
node_add -->|"records payload"| node_catalog
node_add -->|"refreshes listing"| node_updater
node_updater -->|"downloads updates"| node_artifacts
node_updater -->|"updates entries"| node_catalog
node_updater -->|"manages release assets"| node_mirror_release
node_updater -->|"records stale downloads"| node_stats
node_updater -->|"renders listing"| node_readme
node_download_user -->|"browses payloads"| node_readme
node_download_user -->|"downloads payload"| node_mirror_release

click node_add "https://github.com/itsplk/ps5-payloads-mirror/blob/main/add_payload.py"
click node_updater "https://github.com/itsplk/ps5-payloads-mirror/blob/main/update_payloads.py"
click node_catalog "https://github.com/itsplk/ps5-payloads-mirror/blob/main/payloads.json"
click node_stats "https://github.com/itsplk/ps5-payloads-mirror/blob/main/download_stats.json"
click node_readme "https://github.com/itsplk/ps5-payloads-mirror/blob/main/README.md"

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_add,node_updater,node_download_user toneBlue
class node_catalog,node_artifacts,node_stats toneAmber
class node_readme toneMint
class node_maintainer,node_release_sources,node_mirror_release toneIndigo
```

## Components

### Catalog management

- [Add payload](https://github.com/itsplk/ps5-payloads-mirror/blob/main/add_payload.py): `add_payload.py`
- [Release updater](https://github.com/itsplk/ps5-payloads-mirror/blob/main/update_payloads.py): `update_payloads.py`

### Payload mirror

- [Payload catalog](https://github.com/itsplk/ps5-payloads-mirror/blob/main/payloads.json): `payloads.json`
- **Mirrored artifacts**
- [Download statistics](https://github.com/itsplk/ps5-payloads-mirror/blob/main/download_stats.json): `download_stats.json`

### Published catalog

- [Payload listing](https://github.com/itsplk/ps5-payloads-mirror/blob/main/README.md): `README.md`

### Other components

- **Maintainer**
- **Release sources**
- **GitHub mirror release**
- **Download user**

## Connections

- Maintainer → Add payload: enters release (evidence: `add_payload.py`)
- Add payload → Release sources: fetches release (evidence: `add_payload.py`)
- Release updater → Release sources: checks releases (evidence: `update_payloads.py`)
- Add payload → Mirrored artifacts: downloads artifact (evidence: `add_payload.py`)
- Add payload → Payload catalog: records payload (evidence: `add_payload.py`)
- Add payload → Release updater: refreshes listing (evidence: `add_payload.py`)
- Release updater → Mirrored artifacts: downloads updates (evidence: `update_payloads.py`)
- Release updater → Payload catalog: updates entries (evidence: `update_payloads.py`)
- Release updater → GitHub mirror release: manages release assets (evidence: `update_payloads.py`)
- Release updater → Download statistics: records stale downloads (evidence: `update_payloads.py`)
- Release updater → Payload listing: renders listing (evidence: `update_payloads.py`)
- Download user → Payload listing: browses payloads (evidence: `README.md`)
- Download user → GitHub mirror release: downloads payload (evidence: `README.md`)
