Add UI to restore previous versions of a tracing

app/assets/javascripts/admin/admin_rest_api.js

@@ -529,10 +529,11 @@ export function createExplorational(
 
 export async function getTracingForAnnotations(
   annotation: APIAnnotationType,
+  version?: number,
 ): Promise<HybridServerTracingType> {
   const [_skeleton, _volume] = await Promise.all([
-    getTracingForAnnotationType(annotation, "skeleton"),
-    getTracingForAnnotationType(annotation, "volume"),
+    getTracingForAnnotationType(annotation, "skeleton", version),
+    getTracingForAnnotationType(annotation, "volume", version),
   ]);
 
   const skeleton = ((_skeleton: any): ?ServerSkeletonTracingType);
@@ -547,14 +548,18 @@ export async function getTracingForAnnotations(
 export async function getTracingForAnnotationType(
   annotation: APIAnnotationType,
   tracingType: "skeleton" | "volume",
+  version?: number,
 ): Promise<?ServerTracingType> {
   const tracingId = annotation.tracing[tracingType];
   if (!tracingId) {
     return null;
   }
+  const possibleVersionString = version != null ? `&version=${version}` : "";
   const tracingArrayBuffer = await doWithToken(token =>
     Request.receiveArraybuffer(
-      `${annotation.dataStore.url}/data/tracings/${tracingType}/${tracingId}?token=${token}`,
+      `${
+        annotation.dataStore.url
+      }/data/tracings/${tracingType}/${tracingId}?token=${token}${possibleVersionString}`,
       { headers: { Accept: "application/x-protobuf" } },
     ),
   );
@@ -565,6 +570,18 @@ export async function getTracingForAnnotationType(
   return tracing;
 }
 
+export function getUpdateActionLog(
+  dataStoreUrl: string,
+  tracingId: string,
+  tracingType: "skeleton" | "volume",
+): Promise<*> {
+  return doWithToken(token =>
+    Request.receiveJSON(
+      `${dataStoreUrl}/data/tracings/${tracingType}/${tracingId}/updateActionLog?token=${token}`,
+    ),
+  );
+}
+
 // ### Datasets
 export async function getDatasets(): Promise<Array<APIMaybeUnimportedDatasetType>> {
   const datasets = await Request.receiveJSON("/api/datasets");

app/assets/javascripts/messages.js

@@ -21,7 +21,8 @@ In order to restore the current window, a reload is necessary.`,
   "save.leave_page_unfinished":
     "WARNING: You have unsaved progress that may be lost when hitting OK. Please click cancel, wait until the progress is saved and the save button displays a checkmark before leaving the page..",
   "save.failed": "Failed to save tracing. Retrying.",
-  "undo.no_undo": "There is no action that could be undone.",
+  "undo.no_undo":
+    "There is no action that could be undone. However, if you want to restore an earlier version of this tracing, use the 'Restore Older Version' functionality in the dropdown next to the 'Save' button.",
   "undo.no_redo": "There is no action that could be redone.",
   "download.wait": "Please wait...",
   "download.close_window": "You may close this window after the download has started.",

app/assets/javascripts/oxalis/api/api_latest.js

@@ -412,10 +412,11 @@ class TracingApi {
     newTracingType: TracingTypeTracingType,
     newAnnotationId: string,
     newControlMode: ControlModeType,
+    version?: number,
   ) {
     Store.dispatch(restartSagaAction());
     UrlManager.reset();
-    await Model.fetch(newTracingType, newAnnotationId, newControlMode, false);
+    await Model.fetch(newTracingType, newAnnotationId, newControlMode, false, version);
     Store.dispatch(discardSaveQueuesAction());
     Store.dispatch(wkReadyAction());
     UrlManager.updateUnthrottled();

app/assets/javascripts/oxalis/model.js

@@ -31,12 +31,14 @@ export class OxalisModel {
     annotationIdOrDatasetName: string,
     controlMode: ControlModeType,
     initialFetch: boolean,
+    version?: number,
   ) {
     const initializationInformation = await initialize(
       tracingType,
       annotationIdOrDatasetName,
       controlMode,
       initialFetch,
+      version,
     );
     if (initializationInformation) {
       // Only executed on initial fetch

app/assets/javascripts/oxalis/model/actions/annotation_actions.js

@@ -22,6 +22,11 @@ type SetAnnotationDescriptionActionType = {
   description: string,
 };
 
+type SetAnnotationAllowUpdateActionType = {
+  type: "SET_ANNOTATION_ALLOW_UPDATE",
+  allowUpdate: boolean,
+};
+
 type SetUserBoundingBoxType = {
   type: "SET_USER_BOUNDING_BOX",
   userBoundingBox: ?BoundingBoxType,
@@ -32,6 +37,7 @@ export type AnnotationActionTypes =
   | SetAnnotationNameActionType
   | SetAnnotationPubliceActionType
   | SetAnnotationDescriptionActionType
+  | SetAnnotationAllowUpdateActionType
   | SetUserBoundingBoxType;
 
 export const initializeAnnotationAction = (
@@ -58,6 +64,13 @@ export const setAnnotationDescriptionAction = (
   description,
 });
 
+export const setAnnotationAllowUpdateAction = (
+  allowUpdate: boolean,
+): SetAnnotationAllowUpdateActionType => ({
+  type: "SET_ANNOTATION_ALLOW_UPDATE",
+  allowUpdate,
+});
+
 // Strictly speaking this is no annotation action but a tracing action, as the boundingBox is saved with
 // the tracing, hence no ANNOTATION in the action type.
 export const setUserBoundingBoxAction = (

app/assets/javascripts/oxalis/model/actions/ui_actions.js

@@ -6,11 +6,21 @@ type SetDropzoneModalVisibilityActionType = {
   visible: boolean,
 };
 
-export type UiActionType = SetDropzoneModalVisibilityActionType;
+type SetVersionRestoreModeActionType = {
+  type: "SET_VERSION_RESTORE_MODE_ACTION_TYPE",
+  active: boolean,
+};
+
+export type UiActionType = SetDropzoneModalVisibilityActionType | SetVersionRestoreModeActionType;
 
 export const setDropzoneModalVisibilityAction = (
   visible: boolean,
 ): SetDropzoneModalVisibilityActionType => ({
   type: "SET_DROPZONE_MODAL_VISIBILITY_ACTION_TYPE",
   visible,
 });
+
+export const setVersionRestoreModeAction = (active: boolean): SetVersionRestoreModeActionType => ({
+  type: "SET_VERSION_RESTORE_MODE_ACTION_TYPE",
+  active,
+});

app/assets/javascripts/oxalis/model/reducers/annotation_reducer.js

@@ -1,7 +1,7 @@
 // @flow
 
 import update from "immutability-helper";
-import { updateKey, type StateShape1 } from "oxalis/model/helpers/deep_update";
+import { updateKey, updateKey2, type StateShape1 } from "oxalis/model/helpers/deep_update";
 import type { OxalisState } from "oxalis/store";
 import type { ActionType } from "oxalis/model/actions/actions";
 import { convertServerAnnotationToFrontendAnnotation } from "oxalis/model/reducers/reducer_helpers";
@@ -36,6 +36,11 @@ function AnnotationReducer(state: OxalisState, action: ActionType): OxalisState
       });
     }
 
+    case "SET_ANNOTATION_ALLOW_UPDATE": {
+      const { allowUpdate } = action;
+      return updateKey2(state, "tracing", "restrictions", { allowUpdate });
+    }
+
     case "SET_USER_BOUNDING_BOX": {
       const updaterObject = {
         userBoundingBox: {

app/assets/javascripts/oxalis/model/reducers/ui_reducer.js

@@ -14,6 +14,14 @@ function UiReducer(state: OxalisState, action: ActionType): OxalisState {
       });
     }
 
+    case "SET_VERSION_RESTORE_MODE_ACTION_TYPE": {
+      return update(state, {
+        uiInformation: {
+          isVersionRestoreActive: { $set: action.active },
+        },
+      });
+    }
+
     default:
       return state;
   }