어떤 프로젝트인가요?
N-GLIS는 서울아산병원의 유전체 검사·분석 결과를 관리하고 시각화하는 의료 시스템입니다. 검사 의뢰부터 시퀀싱 품질(QC) 확인, 변이 분석·판독, 유전체 지식 베이스까지 유전체 검사의 전 과정을 한 시스템에서 다룹니다.
세부 내용
QScore heatmap 렌더링 시간 97% 단축
어떤 고민이 있었는가
- QScore heatmap이 SVG 노드를 22만 개 이상 그려, 필터를 바꿀 때마다 화면이 멈췄고 심할 때는 탭이 '앗, 이런!' 오류 화면으로 종료됐습니다.
어떻게 해결했는가
- Illumina 품질 기준을 확인해 보니 Q-score 42단계까지 세밀할 필요는 없었습니다. 이에 d3.bin()으로 Illumina 표준에 맞춰 7개 구간으로 나눠 사이클마다 각 구간의 비율을 집계했습니다. 품질 판정 기준인 'Q30 이상 비율'(정확도 99.9% 이상)도 그대로 유지됐습니다.
결과
- SVG 노드 22만 개 이상 → 2,226개(99%↓), 렌더링 1.2초 → 0.04초. 화면이 멈추거나 탭이 종료되던 현상이 사라졌습니다.
새로고침해도 작업 맥락이 남는 상태 설계
어떤 고민이 있었는가
- 화면 상태만 맡길 라이브러리로 코드가 적은 Zustand도 고려했지만, 선택한 프로젝트·샘플·필터를 새로고침 뒤에도 안전하게 되살리는 설정(redux-persist)과 상태 추적 도구가 갖춰진 Redux Toolkit을 택했습니다.
- 여러 패널과 차트가 같은 프로젝트·샘플 데이터를 써야 해서, 받은 API 응답을 Redux에 넣어 공유하고 새로고침에도 남게 했습니다. 그러자 같은 데이터가 React Query 캐시와 Redux 두 곳에 생겨, 어느 쪽이 최신인지 헷갈렸습니다. 선택한 프로젝트 · 샘플 · 목록 필터는 새로고침 후에도 유지돼야 했지만, 이동 경로(breadcrumb) 같은 휘발성 상태까지 남으면 잘못된 화면이 나타났습니다.
어떻게 해결했는가
- Start: 화면 조작으로 Redux 상태가 바뀐다 — 선택한 프로젝트 · 샘플 · 목록 필터, 그리고 이동 경로(breadcrumb).
- 리듀서가 blacklist(sequencingBreadCrumb)에 있으면 Redux store에만 두고, 아니면 Redux Persist가 브라우저 저장소(localStorage)에도 쓴다.
- 새로고침하면 REHYDRATE가 저장된 상태를 읽고, autoMergeLevel2가 초기 상태 위에 두 단계 깊이로 병합한다. breadcrumb은 초기값으로 시작한다.
- 차트 5종은 데이터 식별자를 "URL 파라미터 ?? Redux 선택값" 순서로 해석해, 런 상세(URL)와 분석 화면(선택값) 두 곳에서 같은 구현을 쓴다.
- API 응답은 React Query 캐시에만 두고, Redux에는 선택한 프로젝트·샘플의 ID와 목록 필터만 남겼습니다. 화면은 Redux의 ID로 React Query에서 데이터를 꺼내 쓰므로, 같은 데이터가 두 곳에 생기지 않았습니다.
- 새로고침 때 남기지 않을 이동 경로(breadcrumb)는 저장에서 뺐습니다. 저장된 상태를 되살릴 때는 필드 단위로 합쳐, 나중에 추가한 필드도 기본값이 유지되게 했습니다(redux-persist autoMergeLevel2). 타입 지정된 RootState · AppDispatch도 함께 정리해 모든 화면이 같은 훅을 사용하도록 했습니다.
결과
- 같은 데이터의 중복 저장이 사라지고 상태의 출처가 하나로 정리됐으며, 새로고침해도 작업 맥락이 유지됩니다. 어느 쪽이 최신 데이터인지 헷갈리는 일도 없어졌습니다.
세계 1위 유전체 장비 기업 Illumina 분석 차트 5종 구현
어떤 고민이 있었는가
- ECharts·MUI X Charts는 정해진 차트 유형에 데이터를 넣는 방식이라, 타일을 판 위 실제 자리에 놓거나 색 기준을 끌어서 바꾸는 화면은 만들기 어려웠습니다. 그래서 도형과 동작을 직접 그릴 수 있는 D3를 골랐습니다.
- 차트 5종 중 Flow Cell 차트가 가장 어려웠습니다. Flow Cell은 DNA를 읽는 유리판이고, 이 차트는 판을 나눈 타일 288개의 품질을 실제 자리에 색으로 칠해 보여 줍니다.
- 지표마다 값의 크기가 0.4부터 16,544까지 달라, 색 기준 하나로는 차이가 보이지 않았습니다.
- 장비가 일부 타일을 읽지 못하면 그 자리가 비어 판 모양이 무너졌습니다.
어떻게 해결했는가
- 타일 번호와 측정값을 받는다(예: 11101).
- 전체 타일 목록과 맞춰 빠진 타일은 값 0으로 채운다.
- 타일 번호의 자릿수로 면·열·구역을 읽어 판 위 자리를 정하고, 뒷면은 앞면 오른쪽에 놓는다.
- 지표의 최솟값~최댓값을 7단계로 나눈 경계 숫자를 컬러바 아래에 표시하고, 그 숫자대로 타일을 칠한다.
- 컬러바를 좌우로 끌면 경계 숫자 7개가 값 크기에 맞는 감도로 함께 밀리고, 모든 타일을 다시 칠한다.
- 타일 번호에 위치가 담겨 있어, 자릿수를 나눠 판 위 자리를 계산했습니다. 예를 들어 11101은 앞면·1열·1구역·1번 타일입니다.
- 읽지 못한 타일은 전체 타일 목록과 맞춰 보고 값 0으로 채워 빈자리를 없앴습니다.
- 색 기준은 지표마다 최솟값부터 최댓값까지를 7단계로 나눠 정하고, 그 경계 숫자를 컬러바 아래에 표시했습니다.
- 컬러바를 d3.drag로 좌우로 끌면 경계 숫자가 함께 밀리고, 타일 색이 그 숫자대로 다시 칠해집니다. 값이 작은 지표는 잘게, 큰 지표는 크게 밀리도록 끄는 감도를 값 크기에 맞췄습니다.
결과
- 검사자가 Illumina 분석 프로그램과 같은 모양으로 타일 288개의 품질을 한눈에 확인합니다.
- 빠진 타일이 있어도 판 모양이 유지되고, 값 차이가 작은 지표도 색으로 구분됩니다.
서비스 화면

