Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Delete mutation/tumor/treatment as last step to avoid stale index #444

Merged
merged 3 commits into from
Sep 23, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 20 additions & 6 deletions src/main/webapp/app/pages/curation/review/ReviewPage.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -47,14 +47,18 @@ const ReviewPage: React.FunctionComponent<IReviewPageProps> = (props: IReviewPag
const [editorsToAcceptChangesFrom, setEditorsToAcceptChangesFrom] = useState<string[]>([]);
const [isAcceptingAll, setIsAcceptingAll] = useState(false);

const fetchFirebaseData = () => {
const [isAccepting, setIsAccepting] = useState(false);

const fetchFirebaseData = async () => {
if (!props.firebaseDb) {
return;
}
// Fetch the data when the user enters review mode. We don't use a listener
// because there shouldn't be another user editing the gene when it is being reviewed.
get(ref(props.firebaseDb, firebaseGenePath)).then(snapshot => setGeneData(snapshot.val()));
get(ref(props.firebaseDb, firebaseMetaReviewPath)).then(snapshot => setMetaReview(snapshot.val()));
const geneDataSnapshot = await get(ref(props.firebaseDb, firebaseGenePath));
setGeneData(geneDataSnapshot.val());
const metaReviewSnapshot = await get(ref(props.firebaseDb, firebaseMetaReviewPath));
setMetaReview(metaReviewSnapshot.val());
};

useEffect(() => {
Expand Down Expand Up @@ -105,7 +109,7 @@ const ReviewPage: React.FunctionComponent<IReviewPageProps> = (props: IReviewPag
try {
setIsAcceptingAll(true);
await props.acceptReviewChangeHandler?.(hugoSymbol ?? '', reviewLevels, isGermline, true);
fetchFirebaseData();
await fetchFirebaseData();
} catch (error) {
notifyError(error);
} finally {
Expand Down Expand Up @@ -190,10 +194,20 @@ const ReviewPage: React.FunctionComponent<IReviewPageProps> = (props: IReviewPag
hugoSymbol={hugoSymbol ?? ''}
isGermline={isGermline}
baseReviewLevel={rootReview}
handleAccept={props.acceptReviewChangeHandler}
handleAccept={async (hugoArg, reviewLevelsArg, isGermlineArg, isAcceptAllArg) => {
setIsAccepting(true);
try {
const returnVal = await props.acceptReviewChangeHandler?.(hugoArg, reviewLevelsArg, isGermlineArg, isAcceptAllArg);
if (returnVal?.shouldRefresh) {
await fetchFirebaseData();
}
} finally {
setIsAccepting(false);
}
}}
handleReject={props.rejectReviewChangeHandler}
handleCreateAction={props.createActionHandler}
disableActions={isAcceptingAll}
disableActions={isAcceptingAll || isAccepting}
isRoot={true}
firebase={{
path: getGenePathFromValuePath(hugoSymbol ?? '', rootReview.valuePath, isGermline),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,12 @@ import { FirebaseRepository } from 'app/stores/firebase/firebase-repository';
import _ from 'lodash';
import { Review } from '../../shared/model/firebase/firebase.model';
import { buildHistoryFromReviews } from '../../shared/util/firebase/firebase-history-utils';
import { extractArrayPath, parseFirebaseGenePath } from '../../shared/util/firebase/firebase-path-utils';
import {
extractArrayPath,
FIREBASE_LIST_PATH_TYPE,
getFirebasePathType,
parseFirebaseGenePath,
} from '../../shared/util/firebase/firebase-path-utils';
import {
ReviewLevel,
TumorReviewLevel,
Expand Down Expand Up @@ -95,6 +100,12 @@ export class FirebaseGeneReviewService {
const geneFirebasePath = getFirebaseGenePath(isGermline, hugoSymbol);
const vusFirebasePath = getFirebaseVusPath(isGermline, hugoSymbol);

const itemsToDelete: { [key in FIREBASE_LIST_PATH_TYPE]: { [path in string]: number[] } } = {
[FIREBASE_LIST_PATH_TYPE.MUTATION_LIST]: {},
[FIREBASE_LIST_PATH_TYPE.TUMOR_LIST]: {},
[FIREBASE_LIST_PATH_TYPE.TREATMENT_LIST]: {},
};

let updateObject = {};

const reviewHistory = buildHistoryFromReviews(this.authStore.fullName, reviewLevels);
Expand All @@ -115,17 +126,15 @@ export class FirebaseGeneReviewService {
} else if (isDeleteReview(reviewLevel)) {
const { firebaseArrayPath, deleteIndex } = extractArrayPath(reviewLevel.valuePath);
const firebasePath = geneFirebasePath + '/' + firebaseArrayPath;
const firebasePathType = getFirebasePathType(firebaseArrayPath + '/' + deleteIndex);
if (firebasePathType !== undefined) {
const innerMap = itemsToDelete[firebasePathType];
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is innerMap used?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I use it on the next line, so I don't have to do itemsToDelete[firebasePathType][firebasepath]

innerMap[firebasePath] ? innerMap[firebasePath].push(deleteIndex) : (innerMap[firebasePath] = [deleteIndex]);
}
if (review.demotedToVus) {
const variants = parseAlterationName(reviewLevel.currentVal)[0].alteration.split(', ');
updateObject = { ...updateObject, ...this.firebaseVusService.getVusUpdateObject(vusFirebasePath, variants) };
}
try {
// Todo: We should use multi-location updates for deletions once all our arrays use firebase auto-generated keys
// instead of using sequential number indices.
await this.firebaseRepository.deleteFromArray(firebasePath, [deleteIndex]);
} catch (error) {
throw new SentryError('Failed to accept deletion in review mode', { hugoSymbol, reviewLevel, isGermline });
}
} else if (isCreateReview(reviewLevel) && isAcceptAll) {
const createUpdateObject = await this.getCreateUpdateObject(hugoSymbol, reviewLevel, isGermline, ActionType.ACCEPT);
updateObject = { ...updateObject, ...createUpdateObject };
Expand All @@ -140,7 +149,36 @@ export class FirebaseGeneReviewService {
try {
await this.firebaseRepository.update('/', updateObject);
} catch (error) {
throw new SentryError('Failed to accept changes in review mode', { hugoSymbol, reviewLevels, isGermline, isAcceptAll, updateObject });
throw new SentryError('Failed to accept changes in review mode', {
hugoSymbol,
reviewLevels,
isGermline,
isAcceptAll,
updateObject,
});
}

// We are deleting last because the indices will change after deleting from array.
let hasDeletion = false;
try {
// Todo: We should use multi-location updates for deletions once all our arrays use firebase auto-generated keys
// instead of using sequential number indices.
for (const pathType of [
FIREBASE_LIST_PATH_TYPE.TREATMENT_LIST,
FIREBASE_LIST_PATH_TYPE.TUMOR_LIST,
FIREBASE_LIST_PATH_TYPE.MUTATION_LIST,
]) {
for (const [firebasePath, deleteIndices] of Object.entries(itemsToDelete[pathType])) {
hasDeletion = true;
await this.firebaseRepository.deleteFromArray(firebasePath, deleteIndices);
}
}
// If user accepts a deletion individually, we need to refresh the ReviewPage with the latest data to make sure the indices are up to date.
if (reviewLevels.length === 1 && hasDeletion) {

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why do we only refresh if the length is 1? If a review level corresponds to some change that needs to be reviewed, wouldn't we want to refresh if length > 0?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The only time reviewLevels length is > 1 is when we use the accept all feature. In that case a refresh is not needed because everything should be accepted all together.

return { shouldRefresh: true };
}
} catch (error) {
throw new SentryError('Failed to accept deletions in review mode', { hugoSymbol, reviewLevels, isGermline, itemsToDelete });
}
};

Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,11 @@
import { FB_COLLECTION } from 'app/config/constants/firebase';
import { buildFirebaseGenePath, extractArrayPath, parseFirebaseGenePath } from './firebase-path-utils';
import {
buildFirebaseGenePath,
extractArrayPath,
FIREBASE_LIST_PATH_TYPE,
getFirebasePathType,
parseFirebaseGenePath,
} from './firebase-path-utils';

describe('FirebasePathUtils', () => {
describe('parseFirebaseGenePath', () => {
Expand Down Expand Up @@ -41,4 +47,15 @@ describe('FirebasePathUtils', () => {
expect(extractArrayPath(path)).toEqual({ firebaseArrayPath, deleteIndex });
});
});

describe('getFirebasePathType', () => {
test.each([
{ path: 'mutations/0', pathType: FIREBASE_LIST_PATH_TYPE.MUTATION_LIST },
{ path: 'mutations/0/tumors/0', pathType: FIREBASE_LIST_PATH_TYPE.TUMOR_LIST },
{ path: 'mutations/0/tumors/23/TIs/0/treatments/4', pathType: FIREBASE_LIST_PATH_TYPE.TREATMENT_LIST },
{ path: 'mutations/0/mutation_effect', pathType: undefined },
])('should return correct path type', ({ path, pathType }) => {
expect(getFirebasePathType(path)).toEqual(pathType);
});
});
});
17 changes: 17 additions & 0 deletions src/main/webapp/app/shared/util/firebase/firebase-path-utils.ts
Original file line number Diff line number Diff line change
Expand Up @@ -42,3 +42,20 @@ export const extractArrayPath = (valuePath: string) => {
const firebaseArrayPath = pathParts.join('/');
return { firebaseArrayPath, deleteIndex };
};

export enum FIREBASE_LIST_PATH_TYPE {
MUTATION_LIST,
TUMOR_LIST,
TREATMENT_LIST,
}
export const getFirebasePathType = (path: string) => {
if (/mutations\/\d+$/i.test(path)) {
return FIREBASE_LIST_PATH_TYPE.MUTATION_LIST;
}
if (/tumors\/\d+$/i.test(path)) {
return FIREBASE_LIST_PATH_TYPE.TUMOR_LIST;
}
if (/TIs\/\d+\/treatments\/\d+$/i.test(path)) {
return FIREBASE_LIST_PATH_TYPE.TREATMENT_LIST;
}
};