Connect by JBRH Open Connect

three.js and the Live Office

three.js is the WebGL library behind the Live Office, an optional full-screen 3D view of a business's Employees at work. It is vendored at release r169 and loaded only when someone opens the Live Office. Nothing in the scene decides what anyone is doing. Poses come from work records, and a stale feed stops the animation rather than inventing activity.

Status
Reference What this means
Audience
both, developer
Last verified
Product version
6.3.2

What it is#

three.js is an open-source JavaScript 3D library started by Ricardo Cabello (mrdoob) in 2010. It wraps WebGL with scenes, cameras, meshes, materials, lights and loaders.

Connect vendors release r169 (0.169.0) as published, because it ships as one module with no imports. Later releases split the build. A few post-processing add-ons for ambient occlusion come from the same package.

Category
3D graphics (WebGL)
Version
r169 (0.169.0), vendored with sha256
Files
webapp/vendor/three/three.module.min.js, webapp/vendor/three/addons/
Official site
threejs.org

Where Connect uses it#

Place in ConnectWhat it does there
webapp/src/features/office/scene.js, environment.js, camera.js, people.js: the Live Office
office/model.jsTurns work items into poses; a stale feed stops them
webapp/office/ASSETS.mdThe 3D assets and their CC0 provenance

How it connects#

  1. A person switches to Live Office (Alt+Shift+O)
  2. The office modules and three.js load on demand
  3. The feed delivers work items and presence from the server
  4. model.js maps them to poses; nothing is invented
  5. three.js renders the floor, or the floor-plan or list view on weaker devices

Benefits and limits#

What it gives Connect:

  • A legible picture of who is doing what, built from the same records as the Classic view.
  • Lazy loading keeps its weight off every other screen.
  • A floor-plan and list presentation of the same data for devices or people who do not want 3D.

Where it stops, and what Connect does about it:

  • WebGL needs a capable GPU. Low-end phones use the lighter views.
  • 3D is not accessible on its own. The list view carries the same information for assistive technology.
  • Pinned at r169. An upgrade means re-vendoring and re-checking the add-ons.

Security and privacy#

  • The scene shows only what the person's session may read. It is a view of server data.
  • The vendored files are checksummed and unmodified, with the upstream licence file kept beside them.
  • Assets are CC0 with recorded provenance.

Licence, cost and versions#

QuestionAnswer
LicenceMIT (webapp/vendor/three/LICENSE)
CostNone
Versionr169 (0.169.0)
CompatibilityWebGL 2 in current browsers

Troubleshooting#

Live Office is blank
WebGL is unavailable or blocked. Switch to the floor-plan or list view.
Everyone stands still
The feed is stale, which is intended: presence becomes Unknown rather than 'On task'.
Slow on a laptop
Lower the quality setting, or use the floor-plan view.

Official references#

Questions#

Does the Live Office show what people are really doing?

It shows what the records say: work items and presence with freshness. If the feed is stale it says so instead of animating.

Is the 3D view required?

No. Classic or Live Office is a per-person, per-device choice, and both read the same backend.