# beck-8/subs-check architecture

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

- Interactive diagram: https://gitdiagram.com/beck-8/subs-check
- Repository: https://github.com/beck-8/subs-check

## Overview

subs-check is a subscription aggregation and proxy-node inspection service. A configured or manually triggered run fetches and merges subscriptions, checks node availability, performs media-unlock and filtering stages, optionally measures speed, then saves and exposes results. The application also provides an authenticated web panel, subscription conversion/export, scheduled runs, notifications, and configurable local or remote storage. Edges follow sampled source references and explicit README claims; several documented capabilities have no sampled implementation excerpt, so their links are omitted or marked unverified.

Main entry points: [`check/check.go`](https://github.com/beck-8/subs-check/blob/master/check/check.go) (Availability Checks), [`app/app.go`](https://github.com/beck-8/subs-check/blob/master/app/app.go) (Application), [`save/save.go`](https://github.com/beck-8/subs-check/blob/master/save/save.go) (Save Results), [`app/server.go`](https://github.com/beck-8/subs-check/blob/master/app/server.go) (Web Server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and Control"]
  node_application["Application<br/>[app.go]"]
  node_configuration["Configuration<br/>[config.go]"]
  node_notification["Notifications<br/>[notify.go]"]
end

subgraph group_inspection["Subscription Inspection"]
  node_subscription_fetch["Subscription Fetch<br/>[get.go]"]
  node_deduplication["Node Deduplication<br/>[dedup.go]"]
  node_availability["Availability Checks<br/>[check.go]"]
  node_media_checks["Media Unlock Checks"]
  node_filtering["Node Filtering<br/>[filter.go]"]
  node_speed_test["Speed Testing<br/>[speed.go]"]
  node_progress["Run Progress<br/>[progress.go]"]
end

subgraph group_interfaces["Web and Export"]
  node_webserver["Web Server<br/>[server.go]"]
  node_export_cache[("Export Cache<br/>[export.go]")]
  node_substore_client["Sub-Store Client<br/>[substore.go]"]
end

subgraph group_persistence["Results and Storage"]
  node_result_snapshot["Results Snapshot<br/>[results.go]"]
  node_save_orchestrator["Save Results<br/>[save.go]"]
  node_storage_backends["Storage Backends"]
end

node_operator(("Operator"))
node_substore_service["Sub-Store Service"]
node_subscription_sources(("Subscription Sources"))
node_proxy_nodes(("Proxy Nodes"))
node_web_client(("Web Client"))
node_remote_storage[("Remote Storage")]

node_operator -->|"starts"| node_application
node_application -->|"loads"| node_configuration
node_application -.->|"starts"| node_webserver
node_application -->|"triggers"| node_availability
node_web_client -->|"requests"| node_webserver
node_webserver -->|"triggers checks"| node_availability
node_webserver -->|"manages exports"| node_export_cache
node_subscription_sources -->|"provides subscriptions"| node_subscription_fetch
node_subscription_fetch -->|"provides nodes"| node_availability
node_availability -->|"checks unlocks"| node_media_checks
node_availability -->|"filters nodes"| node_filtering
node_availability -->|"tests speed"| node_speed_test
node_availability -->|"updates counters"| node_progress
node_proxy_nodes -.->|"receives tests"| node_availability
node_application -->|"saves results"| node_save_orchestrator
node_save_orchestrator -->|"writes snapshot"| node_result_snapshot
node_save_orchestrator -->|"writes files"| node_storage_backends
node_save_orchestrator -->|"updates subscription"| node_substore_client
node_substore_client -->|"calls API"| node_substore_service
node_save_orchestrator -->|"refreshes exports"| node_export_cache
node_export_cache -->|"fetches conversions"| node_substore_service
node_storage_backends -.->|"uploads results"| node_remote_storage
node_application -->|"sends notices"| node_notification

click node_application "https://github.com/beck-8/subs-check/blob/master/app/app.go"
click node_configuration "https://github.com/beck-8/subs-check/blob/master/config/config.go"
click node_webserver "https://github.com/beck-8/subs-check/blob/master/app/server.go"
click node_subscription_fetch "https://github.com/beck-8/subs-check/blob/master/proxy/get.go"
click node_deduplication "https://github.com/beck-8/subs-check/blob/master/proxy/dedup.go"
click node_availability "https://github.com/beck-8/subs-check/blob/master/check/check.go"
click node_media_checks "https://github.com/beck-8/subs-check/tree/master/check/platform"
click node_filtering "https://github.com/beck-8/subs-check/blob/master/check/filter.go"
click node_speed_test "https://github.com/beck-8/subs-check/blob/master/check/platform/speed.go"
click node_progress "https://github.com/beck-8/subs-check/blob/master/check/progress.go"
click node_result_snapshot "https://github.com/beck-8/subs-check/blob/master/save/results.go"
click node_save_orchestrator "https://github.com/beck-8/subs-check/blob/master/save/save.go"
click node_storage_backends "https://github.com/beck-8/subs-check/tree/master/save/method"
click node_export_cache "https://github.com/beck-8/subs-check/blob/master/export/export.go"
click node_substore_client "https://github.com/beck-8/subs-check/blob/master/utils/substore.go"
click node_notification "https://github.com/beck-8/subs-check/blob/master/utils/notify.go"

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_application,node_configuration,node_notification,node_web_client toneBlue
class node_subscription_fetch,node_deduplication,node_availability,node_media_checks,node_filtering,node_speed_test,node_progress,node_remote_storage toneAmber
class node_webserver,node_export_cache,node_substore_client toneMint
class node_result_snapshot,node_save_orchestrator,node_storage_backends toneRose
class node_operator,node_substore_service,node_subscription_sources,node_proxy_nodes toneIndigo
```

## Components

### Runtime and Control

- [Application](https://github.com/beck-8/subs-check/blob/master/app/app.go): `app/app.go`
- [Configuration](https://github.com/beck-8/subs-check/blob/master/config/config.go): `config/config.go`
- [Notifications](https://github.com/beck-8/subs-check/blob/master/utils/notify.go): `utils/notify.go`

### Subscription Inspection

- [Subscription Fetch](https://github.com/beck-8/subs-check/blob/master/proxy/get.go): `proxy/get.go`
- [Node Deduplication](https://github.com/beck-8/subs-check/blob/master/proxy/dedup.go): `proxy/dedup.go`
- [Availability Checks](https://github.com/beck-8/subs-check/blob/master/check/check.go): `check/check.go`
- [Media Unlock Checks](https://github.com/beck-8/subs-check/tree/master/check/platform): `check/platform`
- [Node Filtering](https://github.com/beck-8/subs-check/blob/master/check/filter.go): `check/filter.go`
- [Speed Testing](https://github.com/beck-8/subs-check/blob/master/check/platform/speed.go): `check/platform/speed.go`
- [Run Progress](https://github.com/beck-8/subs-check/blob/master/check/progress.go): `check/progress.go`

### Web and Export

- [Web Server](https://github.com/beck-8/subs-check/blob/master/app/server.go): `app/server.go`
- [Export Cache](https://github.com/beck-8/subs-check/blob/master/export/export.go): `export/export.go`
- [Sub-Store Client](https://github.com/beck-8/subs-check/blob/master/utils/substore.go): `utils/substore.go`

### Results and Storage

- [Results Snapshot](https://github.com/beck-8/subs-check/blob/master/save/results.go): `save/results.go`
- [Save Results](https://github.com/beck-8/subs-check/blob/master/save/save.go): `save/save.go`
- [Storage Backends](https://github.com/beck-8/subs-check/tree/master/save/method): `save/method`

### Other components

- **Operator**
- **Sub-Store Service**
- **Subscription Sources**
- **Proxy Nodes**
- **Web Client**
- **Remote Storage**

## Connections

- Operator → Application: starts
- Application → Configuration: loads (evidence: `app/app.go`)
- Application → Web Server: starts
- Application → Availability Checks: triggers (evidence: `app/app.go`)
- Web Client → Web Server: requests (evidence: `README.md`)
- Web Server → Availability Checks: triggers checks (evidence: `app/server.go`)
- Web Server → Export Cache: manages exports (evidence: `app/server.go`)
- Subscription Sources → Subscription Fetch: provides subscriptions (evidence: `README.md`)
- Subscription Fetch → Availability Checks: provides nodes (evidence: `check/check.go`)
- Availability Checks → Media Unlock Checks: checks unlocks (evidence: `check/check.go`)
- Availability Checks → Node Filtering: filters nodes (evidence: `check/check.go`)
- Availability Checks → Speed Testing: tests speed (evidence: `check/check.go`)
- Availability Checks → Run Progress: updates counters (evidence: `check/progress.go`)
- Proxy Nodes → Availability Checks: receives tests
- Application → Save Results: saves results (evidence: `app/app.go`)
- Save Results → Results Snapshot: writes snapshot (evidence: `save/save.go`)
- Save Results → Storage Backends: writes files (evidence: `save/save.go`)
- Save Results → Sub-Store Client: updates subscription (evidence: `save/save.go`)
- Sub-Store Client → Sub-Store Service: calls API (evidence: `utils/substore.go`)
- Save Results → Export Cache: refreshes exports (evidence: `save/save.go`)
- Export Cache → Sub-Store Service: fetches conversions (evidence: `export/export.go`)
- Storage Backends → Remote Storage: uploads results (evidence: `README.md`)
- Application → Notifications: sends notices (evidence: `app/app.go`)
