# hanneskleb/dartscounter architecture

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

- Interactive diagram: https://gitdiagram.com/hanneskleb/dartscounter
- Repository: https://github.com/hanneskleb/dartscounter

## Overview

DartsCounter is a darts-scoring project with a browser game UI and a Spring/OpenCV backend for camera scanning and dart detection. The visible UI code loads saved game data, displays scores, and supports manual dartboard interaction; the backend exposes camera and detection controls. Separate Java and Python files implement camera-geometry triangulation examples, but no sampled code connects them to the backend or scoring UI. The README gives no further capability details, and unsampled page wiring is not inferred.

Main entry points: [`DartsCounter_frontend/script.js`](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/script.js) (Score UI), [`DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ServiceController.java`](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ServiceController.java) (Service API), [`DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/CameraScanner.java`](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/CameraScanner.java) (Camera Scan), [`DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ArrowDetection.java`](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ArrowDetection.java) (Arrow Detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game_ui["Game UI"]
  node_player_setup["Player Setup<br/>[player.html]"]
  node_game_selection["Game Selection<br/>[allGames.html]"]
  node_game_modes["Game Modes"]
  node_score_ui["Score UI<br/>[script.js]"]
  node_game_data["Saved Game Data<br/>[game.json]"]
  node_settings["Settings<br/>[settings.html]"]
  node_statistics["Statistics<br/>[stats.html]"]
end

subgraph group_camera_backend["Camera Backend"]
  node_service_api["Service API"]
  node_camera_scan["Camera Scan<br/>[CameraScanner.java]"]
  node_arrow_detection["Arrow Detection"]
  node_data_api["Data API"]
  node_score_communication["Score Mapping"]
  node_opencv_config["OpenCV Loader<br/>[OpenCVConfig.java]"]
end

subgraph group_geometry["Geometry Prototypes"]
  node_java_geometry["Java Triangulation<br/>[dartTracking.java]"]
  node_python_geometry["Python Triangulation<br/>[dart_tracking.py]"]
end

subgraph group_hardware["Printed Hardware"]
  node_cad_design["Camera Mount Models<br/>[DartsCounter.scad]"]
end

node_camera_devices(("Cameras"))

node_score_ui -->|"loads JSON"| node_game_data
node_score_ui -->|"navigates to"| node_game_modes
node_service_api -->|"scans cameras"| node_camera_scan
node_service_api -->|"starts detection"| node_arrow_detection
node_camera_scan -->|"probes"| node_camera_devices
node_arrow_detection -->|"captures frames"| node_camera_devices

click node_player_setup "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/mainPages/player.html"
click node_game_selection "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/mainPages/allGames.html"
click node_game_modes "https://github.com/hanneskleb/dartscounter/tree/main/DartsCounter_frontend/gameModes"
click node_score_ui "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/script.js"
click node_game_data "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/saves/games/game.json"
click node_settings "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/mainPages/settings.html"
click node_statistics "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/mainPages/stats.html"
click node_service_api "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ServiceController.java"
click node_camera_scan "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/CameraScanner.java"
click node_arrow_detection "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ArrowDetection.java"
click node_data_api "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/DataController.java"
click node_score_communication "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ScoreCommunication.java"
click node_opencv_config "https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/OpenCVConfig.java"
click node_java_geometry "https://github.com/hanneskleb/dartscounter/blob/main/dartTracking.java"
click node_python_geometry "https://github.com/hanneskleb/dartscounter/blob/main/dart_tracking.py"
click node_cad_design "https://github.com/hanneskleb/dartscounter/blob/main/3D-models/DartsCounter.scad"

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_player_setup,node_game_selection,node_game_modes,node_score_ui,node_game_data,node_settings,node_statistics toneBlue
class node_service_api,node_camera_scan,node_arrow_detection,node_data_api,node_score_communication,node_opencv_config toneAmber
class node_java_geometry,node_python_geometry toneMint
class node_cad_design toneRose
class node_camera_devices toneIndigo
```

## Components

### Game UI

- [Player Setup](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/mainPages/player.html): `DartsCounter_frontend/mainPages/player.html`
- [Game Selection](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/mainPages/allGames.html): `DartsCounter_frontend/mainPages/allGames.html`
- [Game Modes](https://github.com/hanneskleb/dartscounter/tree/main/DartsCounter_frontend/gameModes): `DartsCounter_frontend/gameModes`
- [Score UI](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/script.js): `DartsCounter_frontend/script.js`
- [Saved Game Data](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/saves/games/game.json): `DartsCounter_frontend/saves/games/game.json`
- [Settings](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/mainPages/settings.html): `DartsCounter_frontend/mainPages/settings.html`
- [Statistics](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_frontend/mainPages/stats.html): `DartsCounter_frontend/mainPages/stats.html`

### Camera Backend

- [Service API](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ServiceController.java): `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ServiceController.java`
- [Camera Scan](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/CameraScanner.java): `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/CameraScanner.java`
- [Arrow Detection](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ArrowDetection.java): `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ArrowDetection.java`
- [Data API](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/DataController.java): `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/DataController.java`
- [Score Mapping](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ScoreCommunication.java): `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ScoreCommunication.java`
- [OpenCV Loader](https://github.com/hanneskleb/dartscounter/blob/main/DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/OpenCVConfig.java): `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/OpenCVConfig.java`

### Geometry Prototypes

- [Java Triangulation](https://github.com/hanneskleb/dartscounter/blob/main/dartTracking.java): `dartTracking.java`
- [Python Triangulation](https://github.com/hanneskleb/dartscounter/blob/main/dart_tracking.py): `dart_tracking.py`

### Printed Hardware

- [Camera Mount Models](https://github.com/hanneskleb/dartscounter/blob/main/3D-models/DartsCounter.scad): `3D-models/DartsCounter.scad`

### Other components

- **Cameras**

## Connections

- Score UI → Saved Game Data: loads JSON (evidence: `DartsCounter_frontend/script.js`)
- Score UI → Game Modes: navigates to (evidence: `DartsCounter_frontend/script.js`)
- Service API → Camera Scan: scans cameras (evidence: `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ServiceController.java`)
- Service API → Arrow Detection: starts detection (evidence: `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ServiceController.java`)
- Camera Scan → Cameras: probes (evidence: `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/CameraScanner.java`)
- Arrow Detection → Cameras: captures frames (evidence: `DartsCounter_backend/src/main/java/com/DartsCounter/DartsCounter_backend/ArrowDetection.java`)
