# undefined777-afk/qsite-hacks-2026 architecture

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

- Interactive diagram: https://gitdiagram.com/undefined777-afk/qsite-hacks-2026
- Repository: https://github.com/undefined777-afk/qsite-hacks-2026

## Overview

The repository presents two open-challenge tracks. Its computational product routes quantum-circuit operations onto a constrained hardware graph, then supports validation, scoring, and visualization; the scientific track is represented by research notebooks and a write-up. The computational routing internals are grounded in sampled source. Scientific capabilities and the visualization web artifact are inferred only from filenames and the README, so their internal wiring is not shown.

Main entry points: [`computation/solution.py`](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/solution.py) (Beam-search router), [`computation/starter_kit/hardware.py`](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/hardware.py) (Hardware topology), [`computation/starter_kit/benchmarks.py`](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/benchmarks.py) (Circuit benchmarks), [`computation/starter_kit/baseline_routing.py`](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/baseline_routing.py) (Baseline router)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["Circuit Routing"]
  node_benchmarks["Circuit benchmarks<br/>[benchmarks.py]"]
  node_hardware["Hardware topology<br/>[hardware.py]"]
  node_router["Beam-search router<br/>[solution.py]"]
  node_baseline["Baseline router"]
end

subgraph group_evaluation["Evaluation &amp; Visualization"]
  node_scorer["Validate and score<br/>[scorer.py]"]
  node_visualizer["Routing visualization<br/>[visualize.py]"]
  node_visualization_app["Visualization artifact<br/>[index.html]"]
  node_visualization_data["Visualization data<br/>[data.json]"]
  node_computational_report["Computational write-up<br/>[writeup.md]"]
end

subgraph group_science["Scientific Track"]
  node_order_parameters["Order-parameter method"]
  node_supervised_qml["Supervised QML"]
  node_scientific_report["Scientific write-up"]
end

node_engineer(("Circuit author"))

node_engineer -->|"provides circuit"| node_router
node_engineer -->|"selects topology"| node_hardware
node_benchmarks -->|"supplies circuits"| node_router
node_hardware -->|"supplies graph"| node_router
node_router -->|"routed output"| node_scorer
node_router -->|"routed output"| node_visualizer
node_hardware -->|"supplies graph"| node_baseline
node_benchmarks -->|"supplies circuits"| node_baseline
node_visualization_data -->|"provides data"| node_visualization_app
node_order_parameters -.->|"documents research"| node_scientific_report
node_supervised_qml -.->|"documents research"| node_scientific_report

click node_benchmarks "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/benchmarks.py"
click node_hardware "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/hardware.py"
click node_router "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/solution.py"
click node_baseline "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/baseline_routing.py"
click node_scorer "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/scorer.py"
click node_visualizer "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/visualize.py"
click node_visualization_app "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/visualize/index.html"
click node_visualization_data "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/visualize/data.json"
click node_computational_report "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/writeup.md"
click node_order_parameters "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/scientific/QSITE_Scientific_Track_Order_Parameters_Method.ipynb"
click node_supervised_qml "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/scientific/QSITE_Scientific_Track_Supervised_QML%20(1).ipynb"
click node_scientific_report "https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/scientific/QSITE%20Write%20Up%20Scientific%20Track.pdf"

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_benchmarks,node_hardware,node_router,node_baseline toneBlue
class node_scorer,node_visualizer,node_visualization_app,node_visualization_data,node_computational_report toneAmber
class node_order_parameters,node_supervised_qml,node_scientific_report toneMint
class node_engineer toneIndigo
```

## Components

### Circuit Routing

- [Circuit benchmarks](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/benchmarks.py): `computation/starter_kit/benchmarks.py`
- [Hardware topology](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/hardware.py): `computation/starter_kit/hardware.py`
- [Beam-search router](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/solution.py): `computation/solution.py`
- [Baseline router](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/baseline_routing.py): `computation/starter_kit/baseline_routing.py`

### Evaluation & Visualization

- [Validate and score](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/scorer.py): `computation/starter_kit/scorer.py`
- [Routing visualization](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/starter_kit/visualize.py): `computation/starter_kit/visualize.py`
- [Visualization artifact](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/visualize/index.html): `computation/visualize/index.html`
- [Visualization data](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/visualize/data.json): `computation/visualize/data.json`
- [Computational write-up](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/computation/writeup.md): `computation/writeup.md`

### Scientific Track

- [Order-parameter method](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/scientific/QSITE_Scientific_Track_Order_Parameters_Method.ipynb): `scientific/QSITE_Scientific_Track_Order_Parameters_Method.ipynb`
- [Supervised QML](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/scientific/QSITE_Scientific_Track_Supervised_QML%20(1).ipynb): `scientific/QSITE_Scientific_Track_Supervised_QML (1).ipynb`
- [Scientific write-up](https://github.com/undefined777-afk/qsite-hacks-2026/blob/main/scientific/QSITE%20Write%20Up%20Scientific%20Track.pdf): `scientific/QSITE Write Up Scientific Track.pdf`

### Other components

- **Circuit author**

## Connections

- Circuit author → Beam-search router: provides circuit
- Circuit author → Hardware topology: selects topology
- Circuit benchmarks → Beam-search router: supplies circuits
- Hardware topology → Beam-search router: supplies graph
- Beam-search router → Validate and score: routed output
- Beam-search router → Routing visualization: routed output
- Hardware topology → Baseline router: supplies graph
- Circuit benchmarks → Baseline router: supplies circuits
- Visualization data → Visualization artifact: provides data
- Order-parameter method → Scientific write-up: documents research
- Supervised QML → Scientific write-up: documents research