# schadiii/libverse-test-build architecture

> Architecture diagram of the GitHub repository schadiii/libverse-test-build, 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/schadiii/libverse-test-build
- Repository: https://github.com/schadiii/libverse-test-build

## Overview

Libverse is an indoor wayfinding and 360° virtual-tour application. A visitor searches or browses destinations, selects one, reviews a route, then navigates through panorama hotspots or floor maps; floor changes load node data from the local API. The graph preserves the directory, route, map, and tour-viewer branches, plus their spatial-calculation helpers. Backend internals and data-file wiring are not expanded: the available server excerpt contains no implementation details, and the README is empty.

Main entry points: [`Frontend/src/LibverseApp.jsx`](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/LibverseApp.jsx) (Libverse app), [`Frontend/src/LibverseMainHandler.jsx`](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/LibverseMainHandler.jsx) (React mount), [`Frontend/src/hooks/useLibverseFloorData.js`](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/hooks/useLibverseFloorData.js) (Floor data hook), [`Frontend/src/hooks/useLibverseDirectoryData.js`](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/hooks/useLibverseDirectoryData.js) (Directory and routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_main["React mount"]
  node_app["Libverse app<br/>[LibverseApp.jsx]"]
end

subgraph group_wayfinding["Wayfinding"]
  node_floordata["Floor data hook"]
  node_directorydata["Directory and routing"]
  node_directory["Destination directory"]
  node_destination["Route summary"]
end

subgraph group_visualization["Maps and tours"]
  node_floormap["Floor map"]
  node_minimap["Interactive minimap"]
  node_tour["360° tour viewer"]
  node_hotspots["Hotspot calculator"]
  node_minimaputils["Minimap calculations"]
end

subgraph group_services["Data service"]
  node_api["Floor API<br/>[LibverseServer.py]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens app"| node_main
node_main -->|"mounts"| node_app
node_app -->|"loads floor state"| node_floordata
node_app -->|"loads directory data"| node_directorydata
node_app -->|"renders"| node_directory
node_app -->|"renders"| node_destination
node_app -->|"renders"| node_floormap
node_app -.->|"renders"| node_minimap
node_app -->|"renders"| node_tour
node_floordata -->|"fetches floor nodes"| node_api
node_directorydata -->|"gets connections"| node_hotspots
node_tour -->|"calculates hotspots"| node_hotspots
node_minimap -->|"calculates positions"| node_minimaputils

click node_main "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/LibverseMainHandler.jsx"
click node_app "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/LibverseApp.jsx"
click node_floordata "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/hooks/useLibverseFloorData.js"
click node_directorydata "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/hooks/useLibverseDirectoryData.js"
click node_directory "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseDirectory.jsx"
click node_destination "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseDestinationPanel.jsx"
click node_floormap "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseFloorMap.jsx"
click node_minimap "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseMinimap.jsx"
click node_tour "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseTourViewer.jsx"
click node_hotspots "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/utils/LibverseHotspotCalculator.js"
click node_minimaputils "https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/utils/LibverseMinimapUtils.js"
click node_api "https://github.com/schadiii/libverse-test-build/blob/main/Backend/LibverseServer.py"

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_main,node_app toneBlue
class node_floordata,node_directorydata,node_directory,node_destination toneAmber
class node_floormap,node_minimap,node_tour,node_hotspots,node_minimaputils toneMint
class node_api toneRose
class node_visitor toneIndigo
```

## Components

### Application entry

- [React mount](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/LibverseMainHandler.jsx): `Frontend/src/LibverseMainHandler.jsx`
- [Libverse app](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/LibverseApp.jsx): `Frontend/src/LibverseApp.jsx`

### Wayfinding

- [Floor data hook](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/hooks/useLibverseFloorData.js): `Frontend/src/hooks/useLibverseFloorData.js`
- [Directory and routing](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/hooks/useLibverseDirectoryData.js): `Frontend/src/hooks/useLibverseDirectoryData.js`
- [Destination directory](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseDirectory.jsx): `Frontend/src/components/LibverseDirectory.jsx`
- [Route summary](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseDestinationPanel.jsx): `Frontend/src/components/LibverseDestinationPanel.jsx`

### Maps and tours

- [Floor map](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseFloorMap.jsx): `Frontend/src/components/LibverseFloorMap.jsx`
- [Interactive minimap](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseMinimap.jsx): `Frontend/src/components/LibverseMinimap.jsx`
- [360° tour viewer](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/components/LibverseTourViewer.jsx): `Frontend/src/components/LibverseTourViewer.jsx`
- [Hotspot calculator](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/utils/LibverseHotspotCalculator.js): `Frontend/src/utils/LibverseHotspotCalculator.js`
- [Minimap calculations](https://github.com/schadiii/libverse-test-build/blob/main/Frontend/src/utils/LibverseMinimapUtils.js): `Frontend/src/utils/LibverseMinimapUtils.js`

### Data service

- [Floor API](https://github.com/schadiii/libverse-test-build/blob/main/Backend/LibverseServer.py): `Backend/LibverseServer.py`

### Other components

- **Visitor**

## Connections

- Visitor → React mount: opens app (evidence: `Frontend/src/LibverseMainHandler.jsx`)
- React mount → Libverse app: mounts (evidence: `Frontend/src/LibverseMainHandler.jsx`)
- Libverse app → Floor data hook: loads floor state (evidence: `Frontend/src/LibverseApp.jsx`)
- Libverse app → Directory and routing: loads directory data (evidence: `Frontend/src/LibverseApp.jsx`)
- Libverse app → Destination directory: renders (evidence: `Frontend/src/LibverseApp.jsx`)
- Libverse app → Route summary: renders (evidence: `Frontend/src/LibverseApp.jsx`)
- Libverse app → Floor map: renders (evidence: `Frontend/src/LibverseApp.jsx`)
- Libverse app → Interactive minimap: renders
- Libverse app → 360° tour viewer: renders (evidence: `Frontend/src/LibverseApp.jsx`)
- Floor data hook → Floor API: fetches floor nodes (evidence: `Frontend/src/hooks/useLibverseFloorData.js`)
- Directory and routing → Hotspot calculator: gets connections (evidence: `Frontend/src/hooks/useLibverseDirectoryData.js`)
- 360° tour viewer → Hotspot calculator: calculates hotspots (evidence: `Frontend/src/components/LibverseTourViewer.jsx`)
- Interactive minimap → Minimap calculations: calculates positions (evidence: `Frontend/src/components/LibverseMinimap.jsx`)
