How eislab-cps/d7065e works
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: App.svelte Occupancy console · server.go HTTP API · sim.go Simulation engine · main.go Simulator runtime
Components 29
BuildingSim
- Server CLI
buildingsim/cmd/main.go - HTTP API
buildingsim/pkg/server/server.go - API handlers
buildingsim/pkg/server/handlers - Validation
buildingsim/pkg/server/handlers/validation.go - Building state
buildingsim/pkg/store/memory.go - Live updates
buildingsim/pkg/server/websocket/hub.go - Pathfinding
buildingsim/pkg/graph/dijkstra.go - Building models
buildingsim/pkg/model/building.go - Building viewer
buildingsim/web/modern/src
Occupancy engine
- Simulator runtime
occupancysim/main.go - Control API
occupancysim/internal/api/server.go - Simulation engine
occupancysim/internal/sim/sim.go - Daily plans
occupancysim/internal/sim/plan.go - Walk graph
occupancysim/internal/sim/graph.go - Room model
occupancysim/internal/sim/rooms.go - Simulation config
occupancysim/internal/sim/config.go - State publisher
occupancysim/internal/buildsim/publisher.go
Occupancy console
- Occupancy console
occupancysim/ui/src/App.svelte - Browser API
occupancysim/ui/src/lib/api.js - Parameter controls
occupancysim/ui/src/lib/Parameters.svelte - Monitoring views
occupancysim/ui/src/lib/Chart.svelte - Clock controls
occupancysim/ui/src/lib/Clock.svelte - Room view
occupancysim/ui/src/lib/Rooms.svelte - Lecture view
occupancysim/ui/src/lib/Lectures.svelte - People view
occupancysim/ui/src/lib/People.svelte
Shared interfaces
- BuildSim client
occupancysim/internal/buildsim/client.go
Other components
- Operator
- Browser user
- BuildSim service
Connections 33
- Operator → Server CLI: starts server
buildingsim/cmd/main.go - Server CLI → HTTP API: starts
buildingsim/cmd/main.go - HTTP API → API handlers: routes requests
buildingsim/pkg/server/server.go - HTTP API → Building state: initializes
buildingsim/pkg/server/server.go - HTTP API → Live updates: initializes
buildingsim/pkg/server/server.go - HTTP API → Pathfinding: uses
buildingsim/pkg/server/server.go - API handlers → Building state: reads and writes
- Validation → Building state: validates against
buildingsim/pkg/server/handlers/validation.go - API handlers → Live updates: broadcasts updates
buildingsim/pkg/server/handlers/coverage.go - HTTP API → Building viewer: serves
- Browser user → Building viewer: uses
- Simulator runtime → BuildSim client: loads floor plans
occupancysim/main.go - Simulator runtime → Simulation engine: creates and advances
occupancysim/main.go - Simulator runtime → State publisher: starts
occupancysim/main.go - Simulator runtime → Control API: serves
- BuildSim client → BuildSim service: reads floor data
occupancysim/internal/buildsim/client.go - State publisher → BuildSim client: publishes updates
- State publisher → BuildSim service: sends occupancy
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
occupancysim/ui/src/App.svelte - Occupancy console → Browser API: subscribes
occupancysim/ui/src/App.svelte - Occupancy console → Parameter controls: renders
occupancysim/ui/src/App.svelte - Occupancy console → Clock controls: renders
occupancysim/ui/src/App.svelte - Occupancy console → Monitoring views: renders
occupancysim/ui/src/App.svelte - Occupancy console → Room view: renders
occupancysim/ui/src/App.svelte - Occupancy console → Lecture view: renders
occupancysim/ui/src/App.svelte - Occupancy console → People view: renders
occupancysim/ui/src/App.svelte - Browser API → Control API: calls endpoints
occupancysim/ui/src/lib/api.js - Parameter controls → Browser API: loads and saves
occupancysim/ui/src/lib/Parameters.svelte - Control API → Simulation engine: controls and reports
occupancysim/internal/api/server.go