Skip to content

Collaboration and conflicts ​

A shared map can be open in several places at once — and sooner or later two people edit the same one. killBottleneck holds one rule for that moment: nothing is ever silently overwritten. Every save carries the version of the map it started from; if the map on the server has moved on in the meantime, the server rejects the save and leaves the decision to you.

The gentle banner: "Someone else has changed this map" ​

In the background, the app occasionally asks the server whether the map has changed — it asks only for the time of the last change, downloading and overwriting nothing. When it spots a foreign change, a gentle banner appears above the map — "Someone else has changed this map in the meantime." — with a Load current version button. Nothing reloads by itself; your drafted work stays yours until you decide.

The banner only notifies — it reloads nothing and leaves your drafted work alone.

An honest footnote: the check runs about once a minute and only while the map window is visible — so the banner may not appear immediately. Nothing rests on it, though: even if it never showed, the server stops any silent overwrite at save time.

Status changes merge silently ​

Two kinds of foreign change deserve no conflict: a status flip on goals and an automation rule's edit. Typically an automation finishes and marks a goal done — the map moves "under your hands" in exactly the scenario automations exist for. When the foreign change is only a status shift (no rename, no move, no added or deleted node), the app quietly adopts it and reports "An automation completed a goal in the meantime — the map is up to date." If you flipped the same goal yourself in the meantime, your choice wins. A change made by a map rule merges just as quietly: "A rule updated the map in the meantime — you have the latest version." Anything else is a real collision and belongs in front of a human — in the dialog below.

The conflict dialog: three options ​

When incompatible edits meet, the "This map was changed in the meantime" dialog opens. Nothing is discarded without your say:

  • Download backup (JSON) — your drafted version is saved to a file. It decides nothing; it is the safety net that lets you press either of the other two calmly.
  • Keep my changes — your version is saved. This knowingly overwrites the other person's edits — which is why the dialog says so plainly, no fine print.
  • Load current version — discards the edits drafted in this window and loads the map as it stands on the server.
The conflict dialog — nothing is discarded or overwritten without your choice.

After Keep my changes the app confirms "Your version has been saved."; if the map changed again in the meantime, it says "Saving failed — the map may have changed again. Please try once more." and the dialog stays.

The conflict does not have to come from a colleague, by the way: having the same map open in two windows, or on your computer and your phone at once, is enough. The remedy is the same.

Limits

  • The banner shows only while the window is visible and no sooner than about a minute — the certainty comes from the server at save time.
  • Only statuses and rule edits merge silently; a rename, a move or a new node from a colleague always ends up in the dialog.
  • The dialog has no “merge”: it is your version or the server's. The JSON backup is there so you can carry your work over by hand.

Open source under the MIT license · © Tengo s.r.o.