# raad-meryan/cubesat architecture

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

- Interactive diagram: https://gitdiagram.com/raad-meryan/cubesat
- Repository: https://github.com/raad-meryan/cubesat

## Overview

This is a React dashboard for monitoring a spacecraft-like system: it presents live sensor, subsystem, power, thermal, beacon and image-capture information. The main workflow is loading the dashboard, polling sensor and memory endpoints, and displaying readings in panels and charts; snapshot views fetch image listings or the latest snapshot. The sampled code shows those calls and several rendering relationships. Other panel behavior is represented at subsystem level where only the source index or dashboard imports were available.

Main entry points: [`src/components/Dashboard/DashboardLayout.js`](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/DashboardLayout.js) (Dashboard layout), [`src/services/api.js`](https://github.com/raad-meryan/cubesat/blob/master/src/services/api.js) (API client), [`src/components/Dashboard/BeaconPulse.jsx`](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/BeaconPulse.jsx) (Beacon pulse), [`src/components/Dashboard/BeaconPulseGraph.jsx`](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/BeaconPulseGraph.jsx) (Beacon history graph)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard UI"]
  node_app["App entry<br/>[App.js]"]
  node_layout["Dashboard layout<br/>[DashboardLayout.js]"]
  node_panel["Panel container<br/>[Panel.jsx]"]
end

subgraph group_telemetry["Telemetry Displays"]
  node_sensor_views["Sensor and status panels"]
  node_altitude["Altitude panel<br/>[AltitudePanel.jsx]"]
  node_orientation["Orientation visualizer"]
  node_uptime["Uptime chart<br/>[UptimeChart.jsx]"]
  node_thermal_heatmap["Thermal heatmap"]
  node_thermal_graph["Thermal graph"]
  node_temperature_views["Temperature views"]
  node_power_views["Power graphs<br/>[PowerLineGraph.jsx]"]
end

subgraph group_capture["Beacon and Images"]
  node_beacon["Beacon pulse<br/>[BeaconPulse.jsx]"]
  node_beacon_graph["Beacon history graph"]
  node_beacon_config["Beacon timing constants"]
  node_capture_controls["Capture controls"]
  node_snapshot_gallery["Snapshot gallery"]
  node_latest_snapshot["Latest snapshot view"]
end

subgraph group_services["Data Access"]
  node_api["API client<br/>[api.js]"]
end

node_user(("Dashboard user"))
node_backend["Dashboard backend"]

node_user -->|"opens"| node_app
node_app -->|"renders"| node_layout
node_layout -->|"wraps views"| node_panel
node_layout -->|"renders"| node_sensor_views
node_layout -->|"renders"| node_altitude
node_layout -->|"passes orientation"| node_orientation
node_layout -->|"passes uptime"| node_uptime
node_layout -->|"passes pixels"| node_thermal_heatmap
node_layout -->|"passes thermal stats"| node_thermal_graph
node_layout -->|"passes temperature"| node_temperature_views
node_layout -->|"renders"| node_power_views
node_layout -->|"renders"| node_beacon
node_layout -->|"renders"| node_beacon_graph
node_layout -->|"opens on request"| node_capture_controls
node_layout -->|"renders control"| node_snapshot_gallery
node_layout -->|"renders"| node_latest_snapshot
node_layout -->|"fetches sensor and memory data"| node_api
node_beacon -->|"uses timing"| node_beacon_config
node_beacon_graph -->|"uses timing"| node_beacon_config
node_snapshot_gallery -->|"fetches snapshots"| node_api
node_latest_snapshot -->|"fetches latest"| node_api
node_api -->|"requests data"| node_backend
node_beacon -->|"polls beacon"| node_backend
node_beacon_graph -->|"polls beacon"| node_backend

click node_app "https://github.com/raad-meryan/cubesat/blob/master/src/App.js"
click node_layout "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/DashboardLayout.js"
click node_panel "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/Panel.jsx"
click node_sensor_views "https://github.com/raad-meryan/cubesat/tree/master/src/components/Dashboard"
click node_altitude "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/AltitudePanel.jsx"
click node_orientation "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/OrientationVisualizer.jsx"
click node_uptime "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/UptimeChart.jsx"
click node_thermal_heatmap "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/ThermalHeatmapPanel.jsx"
click node_thermal_graph "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/ThermalGraphPanel.jsx"
click node_temperature_views "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/TemperatureStatsPanel.jsx"
click node_power_views "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/PowerLineGraph.jsx"
click node_beacon "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/BeaconPulse.jsx"
click node_beacon_graph "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/BeaconPulseGraph.jsx"
click node_beacon_config "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/beacon-constants.js"
click node_capture_controls "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/ScheduleCaptureModal.jsx"
click node_snapshot_gallery "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/SnapshotGallery.jsx"
click node_latest_snapshot "https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/LastSnapshotModal.jsx"
click node_api "https://github.com/raad-meryan/cubesat/blob/master/src/services/api.js"

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_app,node_layout,node_panel,node_user toneBlue
class node_sensor_views,node_altitude,node_orientation,node_uptime,node_thermal_heatmap,node_thermal_graph,node_temperature_views,node_power_views toneAmber
class node_beacon,node_beacon_graph,node_beacon_config,node_capture_controls,node_snapshot_gallery,node_latest_snapshot toneMint
class node_api toneRose
class node_backend toneIndigo
```

## Components

### Dashboard UI

- [App entry](https://github.com/raad-meryan/cubesat/blob/master/src/App.js): `src/App.js`
- [Dashboard layout](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/DashboardLayout.js): `src/components/Dashboard/DashboardLayout.js`
- [Panel container](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/Panel.jsx): `src/components/Dashboard/Panel.jsx`

### Telemetry Displays

- [Sensor and status panels](https://github.com/raad-meryan/cubesat/tree/master/src/components/Dashboard): `src/components/Dashboard`
- [Altitude panel](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/AltitudePanel.jsx): `src/components/Dashboard/AltitudePanel.jsx`
- [Orientation visualizer](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/OrientationVisualizer.jsx): `src/components/Dashboard/OrientationVisualizer.jsx`
- [Uptime chart](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/UptimeChart.jsx): `src/components/Dashboard/UptimeChart.jsx`
- [Thermal heatmap](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/ThermalHeatmapPanel.jsx): `src/components/Dashboard/ThermalHeatmapPanel.jsx`
- [Thermal graph](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/ThermalGraphPanel.jsx): `src/components/Dashboard/ThermalGraphPanel.jsx`
- [Temperature views](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/TemperatureStatsPanel.jsx): `src/components/Dashboard/TemperatureStatsPanel.jsx`
- [Power graphs](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/PowerLineGraph.jsx): `src/components/Dashboard/PowerLineGraph.jsx`

### Beacon and Images

- [Beacon pulse](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/BeaconPulse.jsx): `src/components/Dashboard/BeaconPulse.jsx`
- [Beacon history graph](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/BeaconPulseGraph.jsx): `src/components/Dashboard/BeaconPulseGraph.jsx`
- [Beacon timing constants](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/beacon-constants.js): `src/components/Dashboard/beacon-constants.js`
- [Capture controls](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/ScheduleCaptureModal.jsx): `src/components/Dashboard/ScheduleCaptureModal.jsx`
- [Snapshot gallery](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/SnapshotGallery.jsx): `src/components/Dashboard/SnapshotGallery.jsx`
- [Latest snapshot view](https://github.com/raad-meryan/cubesat/blob/master/src/components/Dashboard/LastSnapshotModal.jsx): `src/components/Dashboard/LastSnapshotModal.jsx`

### Data Access

- [API client](https://github.com/raad-meryan/cubesat/blob/master/src/services/api.js): `src/services/api.js`

### Other components

- **Dashboard user**
- **Dashboard backend**

## Connections

- Dashboard user → App entry: opens
- App entry → Dashboard layout: renders (evidence: `src/App.js`)
- Dashboard layout → Panel container: wraps views (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Sensor and status panels: renders (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Altitude panel: renders (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Orientation visualizer: passes orientation (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Uptime chart: passes uptime (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Thermal heatmap: passes pixels (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Thermal graph: passes thermal stats (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Temperature views: passes temperature (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Power graphs: renders (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Beacon pulse: renders (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Beacon history graph: renders (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Capture controls: opens on request (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Snapshot gallery: renders control (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → Latest snapshot view: renders (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Dashboard layout → API client: fetches sensor and memory data (evidence: `src/components/Dashboard/DashboardLayout.js`)
- Beacon pulse → Beacon timing constants: uses timing (evidence: `src/components/Dashboard/BeaconPulse.jsx`)
- Beacon history graph → Beacon timing constants: uses timing (evidence: `src/components/Dashboard/BeaconPulseGraph.jsx`)
- Snapshot gallery → API client: fetches snapshots (evidence: `src/components/Dashboard/SnapshotGallery.jsx`)
- Latest snapshot view → API client: fetches latest (evidence: `src/components/Dashboard/LastSnapshotModal.jsx`)
- API client → Dashboard backend: requests data (evidence: `src/services/api.js`)
- Beacon pulse → Dashboard backend: polls beacon (evidence: `src/components/Dashboard/BeaconPulse.jsx`)
- Beacon history graph → Dashboard backend: polls beacon (evidence: `src/components/Dashboard/BeaconPulseGraph.jsx`)
