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.
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.
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.
Related
- Team and roles — sharing a map and who may edit what
- The canvas — the saving state and the other tools
- The map and goals — the overview of the whole map

