Skip to content

Theseus field route authoring ​

Approved: 17 September 2026 (#157)

On the map picker screen, Wantok staff add and connect graph nodes, then save weighted edges through T5 field APIs (POST /theseus/floor/:id/graph).

This amends the desktop graph. It does not replace the web Pixi editor.

No operator-actions row.

Tools ​

Confirm stays the BLE confirm default. Switch to add-node or connect before drawing:

  • Add-node: tap the PNG. Local dx/dy are floor x/y. New nodes use negative temp ids until save.
  • Connect: tap node A, then node B. Skip self and an existing undirected pair. Weight is Euclidean distance, one decimal, matching the web editor.
  • Bare map taps in connect mode do nothing.

Overlay and save ​

Snapshot nodes and edges paint on the InteractiveViewer (circles and lines). No Flame. Floor or location change discards unsaved edits.

Save POSTs the full current floor nodes + edges with Bearer th_…. It does not send deleted_*, calibration, or X-Mobile-Api-Key. A 200 replaces local ids from the payload. Snapshot SHA is the bundle hash of nodes/edges; the next snapshot read sees the new routes.

Non-goals ​

Flame, Pixi rewrite, ruler, delete/drag, multi-floor edges, walk-trace corridors, Gatify, Hansel MAC/holder QR wizard, pathfind, end-user maps, FCM, staff ntfy, safecall-ops, hospital rasters / mar.json.