# mudabs/digitalbonebox architecture

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

- Interactive diagram: https://gitdiagram.com/mudabs/digitalbonebox
- Repository: https://github.com/mudabs/digitalbonebox

## Overview

DigitalBoneBox is a browser-based anatomy study tool backed by an Express API. A student selects a boneset, bone, or subbone; the UI fetches its data and displays images, descriptions, and annotations. Other documented capabilities include search, self-quizzing, navigation, and a scene workspace for arranging images and annotations. The graph preserves those distinct product areas and the legacy-content import layer. Several UI/API connections are supported by the source index or README rather than complete excerpts, so uncertain links are omitted.

Main entry points: [`templates/js/main.js`](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/main.js) (UI Startup), [`templates/js/dropdowns.js`](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/dropdowns.js) (Bone Selection), [`templates/js/api.js`](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/api.js) (API Client), [`boneset-api/server.js`](https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/server.js) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_study["Study UI"]
  node_app["UI Startup<br/>[main.js]"]
  node_selection["Bone Selection<br/>[dropdowns.js]"]
  node_viewer["Image Viewer<br/>[imageDisplay.js]"]
  node_textanno["Text Annotations"]
  node_coloranno["Color Overlays"]
  node_quiz["Self Quiz<br/>[quiz.js]"]
  node_search["Search<br/>[search.js]"]
  node_navigation["Navigation<br/>[navigation.js]"]
  node_sidebar["Sidebar<br/>[sidebar.js]"]
  node_clientapi["API Client<br/>[api.js]"]
end

subgraph group_content["Content API"]
  node_server["Express API<br/>[server.js]"]
  node_imagecatalog["Image Catalog<br/>[images.js]"]
  node_sceneroutes["Scene API<br/>[scenes.js]"]
  node_legacyimages["Legacy Image Import<br/>[legacyImport.js]"]
  node_legacyannotations["Legacy Annotation Import"]
  node_scenejson[("Scene Store<br/>[scenes.js]")]
end

subgraph group_scenes["Scene Workspace"]
  node_sceneui["Scene Editor UI<br/>[scenes.js]"]
  node_scenecanvas["Scene Canvas<br/>[sceneCanvas.js]"]
  node_sceneanno["Scene Annotations"]
  node_scenelinks["Scene Links<br/>[sceneLinks.js]"]
end

subgraph group_assets["Anatomy Data"]
  node_anatomydata[("Anatomy Assets")]
end

node_student(("Student"))

node_student -->|"uses"| node_app
node_app -->|"fetches data"| node_clientapi
node_app -->|"initializes"| node_selection
node_app -->|"initializes"| node_quiz
node_app -->|"initializes"| node_search
node_app -->|"sets up"| node_navigation
node_app -->|"initializes"| node_sidebar
node_selection -->|"fetches bone data"| node_clientapi
node_selection -->|"loads images"| node_viewer
node_selection -->|"clears annotations"| node_textanno
node_selection -->|"loads scene links"| node_scenelinks
node_viewer -->|"renders"| node_textanno
node_viewer -->|"renders"| node_coloranno
node_quiz -->|"fetches quiz data"| node_clientapi
node_quiz -->|"uses overlays"| node_coloranno
node_search -->|"requests results"| node_clientapi
node_sceneui -->|"renders"| node_scenecanvas
node_sceneui -->|"uses"| node_sceneanno
node_sceneui -->|"uses"| node_scenelinks
node_clientapi -->|"requests API"| node_server
node_server -->|"routes images"| node_imagecatalog
node_server -->|"mounts scenes"| node_sceneroutes
node_server -->|"reads content"| node_anatomydata
node_imagecatalog -->|"catalogs images"| node_anatomydata
node_sceneroutes -->|"reads and writes"| node_scenejson
node_sceneroutes -->|"imports bone images"| node_legacyimages
node_sceneroutes -.->|"imports annotations"| node_legacyannotations

click node_app "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/main.js"
click node_selection "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/dropdowns.js"
click node_viewer "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/imageDisplay.js"
click node_textanno "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/annotationOverlay.js"
click node_coloranno "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/coloredRegionsOverlay.js"
click node_quiz "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/quiz.js"
click node_search "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/search.js"
click node_navigation "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/navigation.js"
click node_sidebar "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/sidebar.js"
click node_sceneui "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/scenes.js"
click node_scenecanvas "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/sceneCanvas.js"
click node_sceneanno "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/sceneAnnotations.js"
click node_scenelinks "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/sceneLinks.js"
click node_clientapi "https://github.com/mudabs/digitalbonebox/blob/main/templates/js/api.js"
click node_server "https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/server.js"
click node_imagecatalog "https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/images.js"
click node_sceneroutes "https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/scenes.js"
click node_legacyimages "https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/legacyImport.js"
click node_legacyannotations "https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/legacyAnnotations.js"
click node_scenejson "https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/scenes.js"
click node_anatomydata "https://github.com/mudabs/digitalbonebox/tree/main/boneset-api/data"

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_selection,node_viewer,node_textanno,node_coloranno,node_quiz,node_search,node_navigation,node_sidebar,node_clientapi toneBlue
class node_server,node_imagecatalog,node_sceneroutes,node_legacyimages,node_legacyannotations,node_scenejson toneAmber
class node_sceneui,node_scenecanvas,node_sceneanno,node_scenelinks toneMint
class node_anatomydata toneRose
class node_student toneIndigo
```

## Components

### Study UI

- [UI Startup](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/main.js): `templates/js/main.js`
- [Bone Selection](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/dropdowns.js): `templates/js/dropdowns.js`
- [Image Viewer](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/imageDisplay.js): `templates/js/imageDisplay.js`
- [Text Annotations](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/annotationOverlay.js): `templates/js/annotationOverlay.js`
- [Color Overlays](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/coloredRegionsOverlay.js): `templates/js/coloredRegionsOverlay.js`
- [Self Quiz](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/quiz.js): `templates/js/quiz.js`
- [Search](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/search.js): `templates/js/search.js`
- [Navigation](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/navigation.js): `templates/js/navigation.js`
- [Sidebar](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/sidebar.js): `templates/js/sidebar.js`
- [API Client](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/api.js): `templates/js/api.js`

### Content API

- [Express API](https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/server.js): `boneset-api/server.js`
- [Image Catalog](https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/images.js): `boneset-api/images.js`
- [Scene API](https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/scenes.js): `boneset-api/scenes.js`
- [Legacy Image Import](https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/legacyImport.js): `boneset-api/legacyImport.js`
- [Legacy Annotation Import](https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/legacyAnnotations.js): `boneset-api/legacyAnnotations.js`
- [Scene Store](https://github.com/mudabs/digitalbonebox/blob/main/boneset-api/scenes.js): `boneset-api/scenes.js`

### Scene Workspace

- [Scene Editor UI](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/scenes.js): `templates/js/scenes.js`
- [Scene Canvas](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/sceneCanvas.js): `templates/js/sceneCanvas.js`
- [Scene Annotations](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/sceneAnnotations.js): `templates/js/sceneAnnotations.js`
- [Scene Links](https://github.com/mudabs/digitalbonebox/blob/main/templates/js/sceneLinks.js): `templates/js/sceneLinks.js`

### Anatomy Data

- [Anatomy Assets](https://github.com/mudabs/digitalbonebox/tree/main/boneset-api/data): `boneset-api/data`

### Other components

- **Student**

## Connections

- Student → UI Startup: uses (evidence: `README.md`)
- UI Startup → API Client: fetches data (evidence: `templates/js/main.js`)
- UI Startup → Bone Selection: initializes (evidence: `templates/js/main.js`)
- UI Startup → Self Quiz: initializes (evidence: `templates/js/main.js`)
- UI Startup → Search: initializes (evidence: `templates/js/main.js`)
- UI Startup → Navigation: sets up (evidence: `templates/js/main.js`)
- UI Startup → Sidebar: initializes (evidence: `templates/js/main.js`)
- Bone Selection → API Client: fetches bone data (evidence: `templates/js/dropdowns.js`)
- Bone Selection → Image Viewer: loads images (evidence: `templates/js/dropdowns.js`)
- Bone Selection → Text Annotations: clears annotations (evidence: `templates/js/dropdowns.js`)
- Bone Selection → Scene Links: loads scene links (evidence: `templates/js/dropdowns.js`)
- Image Viewer → Text Annotations: renders (evidence: `templates/js/imageDisplay.js`)
- Image Viewer → Color Overlays: renders (evidence: `templates/js/imageDisplay.js`)
- Self Quiz → API Client: fetches quiz data (evidence: `templates/js/quiz.js`)
- Self Quiz → Color Overlays: uses overlays (evidence: `templates/js/quiz.js`)
- Search → API Client: requests results (evidence: `templates/js/search.js`)
- Scene Editor UI → Scene Canvas: renders (evidence: `templates/js/scenes.js`)
- Scene Editor UI → Scene Annotations: uses (evidence: `templates/js/scenes.js`)
- Scene Editor UI → Scene Links: uses (evidence: `templates/js/scenes.js`)
- API Client → Express API: requests API (evidence: `templates/js/api.js`)
- Express API → Image Catalog: routes images (evidence: `boneset-api/server.js`)
- Express API → Scene API: mounts scenes (evidence: `boneset-api/server.js`)
- Express API → Anatomy Assets: reads content (evidence: `boneset-api/server.js`)
- Image Catalog → Anatomy Assets: catalogs images (evidence: `boneset-api/images.js`)
- Scene API → Scene Store: reads and writes (evidence: `boneset-api/scenes.js`)
- Scene API → Legacy Image Import: imports bone images (evidence: `boneset-api/scenes.js`)
- Scene API → Legacy Annotation Import: imports annotations (evidence: `boneset-api/scenes.js`)
