# eislab-cps/d7065e architecture

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

- Interactive diagram: https://gitdiagram.com/eislab-cps/d7065e
- Repository: https://github.com/eislab-cps/d7065e

## Overview

This repository contains two cooperating products: BuildingSim serves building data, visualization, and live state; Occupancy Simulator models people moving through that building and publishes their positions and room occupancy back to BuildingSim. The main workflow is to load floor plans, configure and advance the occupancy simulation, then publish updates for BuildingSim’s viewer. The graph also retains BuildingSim’s session, equipment, editing, and visualization capabilities and the occupancy console’s controls and monitoring views. Several handler and UI connections are documented by route registration or imports; unsampled implementation details are not asserted.

Main entry points: [`occupancysim/ui/src/App.svelte`](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/App.svelte) (Occupancy console), [`buildingsim/pkg/server/server.go`](https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/server/server.go) (HTTP API), [`occupancysim/internal/sim/sim.go`](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/sim.go) (Simulation engine), [`occupancysim/main.go`](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/main.go) (Simulator runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_building["BuildingSim"]
  node_building_cli["Server CLI<br/>[main.go]"]
  node_building_api["HTTP API<br/>[server.go]"]
  node_handlers["API handlers"]
  node_validation["Validation<br/>[validation.go]"]
  node_memory[("Building state<br/>[memory.go]")]
  node_websocket["Live updates<br/>[hub.go]"]
  node_routing["Pathfinding<br/>[dijkstra.go]"]
  node_building_model["Building models<br/>[building.go]"]
  node_viewer["Building viewer"]
end

subgraph group_occupancy["Occupancy engine"]
  node_occupancy_main["Simulator runtime<br/>[main.go]"]
  node_occupancy_api["Control API<br/>[server.go]"]
  node_sim_core["Simulation engine<br/>[sim.go]"]
  node_planning["Daily plans<br/>[plan.go]"]
  node_sim_graph["Walk graph<br/>[graph.go]"]
  node_rooms["Room model<br/>[rooms.go]"]
  node_parameters["Simulation config<br/>[config.go]"]
  node_publisher["State publisher<br/>[publisher.go]"]
end

subgraph group_console["Occupancy console"]
  node_occupancy_ui["Occupancy console<br/>[App.svelte]"]
  node_ui_api["Browser API<br/>[api.js]"]
  node_parameters_ui["Parameter controls<br/>[Parameters.svelte]"]
  node_dashboard["Monitoring views<br/>[Chart.svelte]"]
  node_clock_ui["Clock controls<br/>[Clock.svelte]"]
  node_room_ui["Room view<br/>[Rooms.svelte]"]
  node_lecture_ui["Lecture view<br/>[Lectures.svelte]"]
  node_people_ui["People view<br/>[People.svelte]"]
end

subgraph group_shared["Shared interfaces"]
  node_buildsim_client["BuildSim client<br/>[client.go]"]
end

node_operator(("Operator"))
node_browser(("Browser user"))
node_buildsim_service{{"BuildSim service"}}

node_operator -->|"starts server"| node_building_cli
node_building_cli -->|"starts"| node_building_api
node_building_api -->|"routes requests"| node_handlers
node_building_api -->|"initializes"| node_memory
node_building_api -->|"initializes"| node_websocket
node_building_api -->|"uses"| node_routing
node_handlers -.->|"reads and writes"| node_memory
node_validation -->|"validates against"| node_memory
node_handlers -->|"broadcasts updates"| node_websocket
node_building_api -.->|"serves"| node_viewer
node_browser -.->|"uses"| node_viewer
node_occupancy_main -->|"loads floor plans"| node_buildsim_client
node_occupancy_main -->|"creates and advances"| node_sim_core
node_occupancy_main -->|"starts"| node_publisher
node_occupancy_main -.->|"serves"| node_occupancy_api
node_buildsim_client -->|"reads floor data"| node_buildsim_service
node_publisher -.->|"publishes updates"| node_buildsim_client
node_publisher -.->|"sends occupancy"| node_buildsim_service
node_sim_core -.->|"uses plans"| node_planning
node_sim_core -.->|"uses walk graph"| node_sim_graph
node_sim_core -.->|"tracks rooms"| node_rooms
node_sim_core -.->|"uses parameters"| node_parameters
node_browser -->|"uses"| node_occupancy_ui
node_occupancy_ui -->|"subscribes"| node_ui_api
node_occupancy_ui -->|"renders"| node_parameters_ui
node_occupancy_ui -->|"renders"| node_clock_ui
node_occupancy_ui -->|"renders"| node_dashboard
node_occupancy_ui -->|"renders"| node_room_ui
node_occupancy_ui -->|"renders"| node_lecture_ui
node_occupancy_ui -->|"renders"| node_people_ui
node_ui_api -->|"calls endpoints"| node_occupancy_api
node_parameters_ui -->|"loads and saves"| node_ui_api
node_occupancy_api -->|"controls and reports"| node_sim_core

click node_building_cli "https://github.com/eislab-cps/d7065e/blob/main/buildingsim/cmd/main.go"
click node_building_api "https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/server/server.go"
click node_handlers "https://github.com/eislab-cps/d7065e/tree/main/buildingsim/pkg/server/handlers"
click node_validation "https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/server/handlers/validation.go"
click node_memory "https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/store/memory.go"
click node_websocket "https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/server/websocket/hub.go"
click node_routing "https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/graph/dijkstra.go"
click node_building_model "https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/model/building.go"
click node_viewer "https://github.com/eislab-cps/d7065e/tree/main/buildingsim/web/modern/src"
click node_occupancy_main "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/main.go"
click node_occupancy_api "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/api/server.go"
click node_sim_core "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/sim.go"
click node_planning "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/plan.go"
click node_sim_graph "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/graph.go"
click node_rooms "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/rooms.go"
click node_parameters "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/config.go"
click node_buildsim_client "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/buildsim/client.go"
click node_publisher "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/buildsim/publisher.go"
click node_occupancy_ui "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/App.svelte"
click node_ui_api "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/api.js"
click node_parameters_ui "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Parameters.svelte"
click node_dashboard "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Chart.svelte"
click node_clock_ui "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Clock.svelte"
click node_room_ui "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Rooms.svelte"
click node_lecture_ui "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Lectures.svelte"
click node_people_ui "https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/People.svelte"

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_building_cli,node_building_api,node_handlers,node_validation,node_memory,node_websocket,node_routing,node_building_model,node_viewer,node_browser toneBlue
class node_occupancy_main,node_occupancy_api,node_sim_core,node_planning,node_sim_graph,node_rooms,node_parameters,node_publisher toneAmber
class node_occupancy_ui,node_ui_api,node_parameters_ui,node_dashboard,node_clock_ui,node_room_ui,node_lecture_ui,node_people_ui toneMint
class node_buildsim_client toneRose
class node_operator,node_buildsim_service toneIndigo
```

## Components

### BuildingSim

- [Server CLI](https://github.com/eislab-cps/d7065e/blob/main/buildingsim/cmd/main.go): `buildingsim/cmd/main.go`
- [HTTP API](https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/server/server.go): `buildingsim/pkg/server/server.go`
- [API handlers](https://github.com/eislab-cps/d7065e/tree/main/buildingsim/pkg/server/handlers): `buildingsim/pkg/server/handlers`
- [Validation](https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/server/handlers/validation.go): `buildingsim/pkg/server/handlers/validation.go`
- [Building state](https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/store/memory.go): `buildingsim/pkg/store/memory.go`
- [Live updates](https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/server/websocket/hub.go): `buildingsim/pkg/server/websocket/hub.go`
- [Pathfinding](https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/graph/dijkstra.go): `buildingsim/pkg/graph/dijkstra.go`
- [Building models](https://github.com/eislab-cps/d7065e/blob/main/buildingsim/pkg/model/building.go): `buildingsim/pkg/model/building.go`
- [Building viewer](https://github.com/eislab-cps/d7065e/tree/main/buildingsim/web/modern/src): `buildingsim/web/modern/src`

### Occupancy engine

- [Simulator runtime](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/main.go): `occupancysim/main.go`
- [Control API](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/api/server.go): `occupancysim/internal/api/server.go`
- [Simulation engine](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/sim.go): `occupancysim/internal/sim/sim.go`
- [Daily plans](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/plan.go): `occupancysim/internal/sim/plan.go`
- [Walk graph](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/graph.go): `occupancysim/internal/sim/graph.go`
- [Room model](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/rooms.go): `occupancysim/internal/sim/rooms.go`
- [Simulation config](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/sim/config.go): `occupancysim/internal/sim/config.go`
- [State publisher](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/buildsim/publisher.go): `occupancysim/internal/buildsim/publisher.go`

### Occupancy console

- [Occupancy console](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/App.svelte): `occupancysim/ui/src/App.svelte`
- [Browser API](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/api.js): `occupancysim/ui/src/lib/api.js`
- [Parameter controls](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Parameters.svelte): `occupancysim/ui/src/lib/Parameters.svelte`
- [Monitoring views](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Chart.svelte): `occupancysim/ui/src/lib/Chart.svelte`
- [Clock controls](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Clock.svelte): `occupancysim/ui/src/lib/Clock.svelte`
- [Room view](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Rooms.svelte): `occupancysim/ui/src/lib/Rooms.svelte`
- [Lecture view](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/Lectures.svelte): `occupancysim/ui/src/lib/Lectures.svelte`
- [People view](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/ui/src/lib/People.svelte): `occupancysim/ui/src/lib/People.svelte`

### Shared interfaces

- [BuildSim client](https://github.com/eislab-cps/d7065e/blob/main/occupancysim/internal/buildsim/client.go): `occupancysim/internal/buildsim/client.go`

### Other components

- **Operator**
- **Browser user**
- **BuildSim service**

## Connections

- Operator → Server CLI: starts server (evidence: `buildingsim/cmd/main.go`)
- Server CLI → HTTP API: starts (evidence: `buildingsim/cmd/main.go`)
- HTTP API → API handlers: routes requests (evidence: `buildingsim/pkg/server/server.go`)
- HTTP API → Building state: initializes (evidence: `buildingsim/pkg/server/server.go`)
- HTTP API → Live updates: initializes (evidence: `buildingsim/pkg/server/server.go`)
- HTTP API → Pathfinding: uses (evidence: `buildingsim/pkg/server/server.go`)
- API handlers → Building state: reads and writes
- Validation → Building state: validates against (evidence: `buildingsim/pkg/server/handlers/validation.go`)
- API handlers → Live updates: broadcasts updates (evidence: `buildingsim/pkg/server/handlers/coverage.go`)
- HTTP API → Building viewer: serves
- Browser user → Building viewer: uses
- Simulator runtime → BuildSim client: loads floor plans (evidence: `occupancysim/main.go`)
- Simulator runtime → Simulation engine: creates and advances (evidence: `occupancysim/main.go`)
- Simulator runtime → State publisher: starts (evidence: `occupancysim/main.go`)
- Simulator runtime → Control API: serves
- BuildSim client → BuildSim service: reads floor data (evidence: `occupancysim/internal/buildsim/client.go`)
- State publisher → BuildSim client: publishes updates
- State publisher → BuildSim service: sends occupancy (evidence: `README.md`)
- Simulation engine → Daily plans: uses plans
- Simulation engine → Walk graph: uses walk graph
- Simulation engine → Room model: tracks rooms
- Simulation engine → Simulation config: uses parameters
- Browser user → Occupancy console: uses (evidence: `occupancysim/ui/src/App.svelte`)
- Occupancy console → Browser API: subscribes (evidence: `occupancysim/ui/src/App.svelte`)
- Occupancy console → Parameter controls: renders (evidence: `occupancysim/ui/src/App.svelte`)
- Occupancy console → Clock controls: renders (evidence: `occupancysim/ui/src/App.svelte`)
- Occupancy console → Monitoring views: renders (evidence: `occupancysim/ui/src/App.svelte`)
- Occupancy console → Room view: renders (evidence: `occupancysim/ui/src/App.svelte`)
- Occupancy console → Lecture view: renders (evidence: `occupancysim/ui/src/App.svelte`)
- Occupancy console → People view: renders (evidence: `occupancysim/ui/src/App.svelte`)
- Browser API → Control API: calls endpoints (evidence: `occupancysim/ui/src/lib/api.js`)
- Parameter controls → Browser API: loads and saves (evidence: `occupancysim/ui/src/lib/Parameters.svelte`)
- Control API → Simulation engine: controls and reports (evidence: `occupancysim/internal/api/server.go`)
