← 프로젝트 목록

MDLink

2026년 10월 출시한 의사 전용 커뮤니티입니다. 뉴스, 커뮤니티, 학술대회, 구인구직을 제공하는 Web과 운영 CMS의 프론트엔드를 총괄했습니다. 별도로 구축한 MdLinkEvidence에서 조회수 과다 집계와 실제 팝업 노출 이상을 찾아 원인을 조사하고, 집계 구조 수정과 복구 확인으로 연결했습니다. EMR 팝업의 초기 로딩을 줄이고 서비스 구조와 팀 개발 규칙도 정리했습니다.

  • 약 20배 부풀던 학회 조회수를 조회와 방문 기록 API를 나눠 바로잡았습니다.
  • 지표로 끊긴 팝업 노출을 찾아 보고하고, 복구 후 IP 306개 중 254개의 신호 재개를 확인했습니다.
  • EMR 팝업의 JS를 393KB에서 217KB로 줄였습니다.
기간
2026.01 ~ 진행 중
역할
Web 및 CMS 프론트엔드 총괄, 백엔드 개발 보조
팀
프론트엔드 2명, 백엔드 2명, 디자이너 1명, PM 2명
소속
전능아이티
기술
Next.js 16ReactTypeScriptTailwindApollo Client(GraphQL)codegenNestJS API 연동
MDLink 화면 1MDLink 화면 2

조회수 과다 집계를 API 경계 변경으로 수정

콘텐츠를 가져오는 요청과 사용자가 방문한 기록을 분리해, 호출 경로가 늘어날 때 조회수가 함께 부풀어 오르는 구조를 바꿨습니다.

배경과 원인

CMS의 임시 지표 메뉴를 MDLink Evidence라는 별도 서비스로 분리하고 학회, 뉴스, 커뮤니티, EMR, 회원 지표를 적재했습니다. 학회 조회수는 약 20배 과다 집계되고 있었지만 서비스 초기에는 가능한 규모로 보여 바로 인지하지 못했습니다. 다른 EMR 지표와 비교하는 과정에서 이상을 발견했습니다.

뉴스는 상세 진입 때 별도 API로 방문을 기록했지만 학회는 상세 조회 API 안에서 기록까지 처리했습니다. 프리패칭과 서버 렌더링, 반응 버튼, 뉴스 사이드바와 커뮤니티 카드, 크롤러가 콘텐츠를 요청할 때도 조회수가 늘어났습니다.

판단과 구현

화면별 중복 호출만 줄이면 새 진입 경로가 생길 때 같은 문제가 재발할 수 있다고 보고 API 경계를 나눴습니다. 상세 조회 GET에서는 기록 생성을 제거하고, 상세 화면 진입 때 별도 POST로 방문을 기록하도록 구성했습니다. 콘텐츠 ID 변경과 기록 실패를 다루는 테스트도 추가했습니다.

API에서는 크롤러와 서버 요청, 관리자 조회를 제외하고 Redis를 활용해 같은 사람의 10분 내 반복 조회를 제외했습니다. 과거 데이터는 기간 백필로 재적재하고, 재발을 확인하는 이상 검사도 Evidence에 추가했습니다.

결과

콘텐츠 조회 요청이 그대로 방문 수가 되던 결합을 해소하고, 뉴스와 학회에서 방문 기록의 기준을 맞췄습니다. 과거 데이터는 크롤러와 서버 요청을 제외해 재적재했습니다.

반복 조회를 제외한 값도 정확한 고유 사용자 수와는 다릅니다. 브라우저에서 생긴 반응 버튼과 카드 호출을 과거 기록에서 어떻게 제외했는지는 확인 중이라, 과거 데이터 전체가 교정됐다고 보지는 않습니다.

같은 "조회수", 다른 기록 방식
뉴스: 방문 기록
상세 화면 진입
별도 API로 방문 기록
방문만 기록
학회: 콘텐츠 요청 수
상세 조회 API 안에서 기록
프리패칭서버 렌더링반응 버튼뉴스 사이드바커뮤니티 카드크롤러
약 20배 과다 집계

MdLinkEvidence 구축과 팝업 노출 문제 발견

전체 지표로는 이상이라고 단정하기 어려운 하락을 연동처별로 나눠 보고, 한 연동처의 노출이 끊긴 원인을 찾아 복구와 정상화 확인으로 연결했습니다.

구축과 운영

MdLinkEvidence를 별도 사이트로 개설하고, 팝업 지표와 사용자 이용 지표를 게시했습니다. 이 지표를 바탕으로 팝업이 실제로 노출되고 있는지 확인했습니다.

전체 지표만으로 판단하기 어려웠던 하락

출시 3주째에 전체 팝업 노출이 전일 대비 약 40% 감소했습니다. 당시 이상 판단 기준은 전일 노출의 60% 미만이었는데, 이때의 수치는 그보다 조금 높았습니다. 출시 첫 주에도 병원 휴무가 많은 수요일에 비슷한 하락이 있었기 때문에, 이 수치만으로 문제를 확정하기는 어려웠습니다.

조사 과정에서 협력사가 매일 약 100개 병원씩 홍보 대상을 늘리고 있다는 사실을 알게 됐습니다. 사전에 공유받지 못한 정보였고, 협력사의 확대가 다른 연동처의 노출 감소를 가릴 수 있어 스마트닥터 측 지표를 별도로 확인했습니다.

원인 조사와 담당팀의 복구

스마트닥터에서는 팝업이 거슬린다는 병원 문의에 대응하던 고객지원팀이 팝업 해제 버튼을 눌렀습니다. 이 버튼은 전체 고객사의 팝업을 해제하는 마스터 버튼이었고, 모든 병원의 대상 명단이 제거된 상태였습니다. 별도 알림도 없어 명단 제거를 바로 인지하지 못한 상황이었습니다.

지표를 조사해 문제를 찾아 스마트닥터팀에 보고했고, 스마트닥터팀이 병원 명단을 복원했습니다. 복구 후에는 피크 시간대인 오전 8시부터 10시까지 실시간으로 모니터링했습니다.

결과
확인 항목확인한 결과
스마트닥터 노출수별도 집계에서 오전 9시경 이전 트래픽 수준 회복 확인
팝업 조회 신호신호가 끊겼던 서로 다른 IP 306개 중 254개에서 재개, 약 83%

노출수 회복과 IP별 조회 신호를 함께 확인했습니다.

내 역할

지표 조사, 보고, 복구 후 정상화 확인을 맡았습니다. 병원 명단 복원은 스마트닥터팀이 수행했습니다.

306개와 254개는 IP 기준이며 병원 수와는 다릅니다.

EMR 팝업의 초기 로딩 경량화

일반 페이지에 필요한 구성과 팝업에 필요한 구성을 분리하고, 남은 의존성과 폰트까지 순서대로 정리했습니다.

배경과 문제

구형 기기의 EMR 팝업이 열리는 데 10초 이상 걸린다는 보고가 있었습니다. 협력사(Vegas) iframe 안에서 열리는 팝업은 리소스를 받을 때까지 로딩바를 표시하는 구조였습니다. SSR을 ISR로 바꾼 뒤에도 증상이 남아 초기 번들과 리소스 구성을 조사했습니다.

루트 레이아웃에 앱 전체 Provider와 헤더, 푸터가 있어 팝업도 일반 페이지의 의존성을 받고 있었습니다. 헤더를 숨기는 것만으로는 해당 코드가 초기 리소스에서 빠지지 않았고, 전체 가변 폰트 다운로드도 로딩 완료 시점에 영향을 주고 있었습니다.

판단과 구현

일반 페이지 Provider와 헤더, 푸터를 (main) 라우트 그룹으로 옮기고 루트에는 최소 구조만 남겼습니다. 팝업은 TanStack Query와 토큰 동기화 등 필요한 구성만 유지했습니다. 불필요한 auth/me와 GraphQL 호출을 제거하고, 공개 조회의 axios 의존성과 날짜 표시의 dayjs도 정리했습니다. 폰트는 dynamic-subset 방식으로 전환했습니다.

결과

팝업 JS를 393KB에서 217KB로 줄였습니다. 레이아웃 분리 후 239KB, 잔여 의존성 정리 후 217KB였습니다. 날짜와 null 입력, 썸네일 URL 인코딩의 회귀도 확인했습니다.

로컬 프로덕션 빌드의 gzip 실측값입니다. 운영 환경에서 팝업이 열리는 시간의 변화는 따로 측정하지 않았습니다. 폰트 용량은 기록 간 집계 기준을 확인하기 전까지 수치에서 뺐습니다.

팝업 JS (gzip)
−45%393KB → 217KB
변경 전
393KB
레이아웃 분리 후
239KB
의존성 정리 후
217KB

서비스 구조와 팀 개발 체계 정리

협력사 코드에서 신규 서비스에 필요 없는 전제를 제거하고, 팀과 AI가 같은 기준으로 개발하고 검증하도록 작업 규칙을 구성했습니다.

배경과 문제

협력사 커뮤니티 코드를 기반으로 개발을 시작했지만 기존 코드는 멀티 테넌트 구조였습니다. 신규 서비스에는 이 전제가 필요 없었고, 홈과 뉴스, 커뮤니티, 구인구직을 각각 다룰 수 있는 구조가 필요했습니다. 빠르게 바뀌는 코드에서 개발 규칙과 기술부채 처리 이력도 계속 남겨야 했습니다. AI 코딩 도구에 작업을 맡기면 제거한 멀티 테넌트 시절의 코드 패턴을 다시 가져오거나 브랜치와 PR 규칙을 지키지 않았고, 특히 정해 둔 폴더 구조와 아키텍처 규칙을 어기고 엉뚱한 위치에 파일을 만드는 일이 잦았습니다.

판단과 구현

멀티 테넌트 전제를 제거하고 단일 서비스에 맞게 모듈을 분리했습니다. Google과 웹뷰 로그인, 의사 인증, 콘텐츠 접근 제한을 구현하고, 접근 판단과 안내 다이얼로그, 리다이렉트를 나눠 진입 경로별 동작을 정리했습니다. 제한된 콘텐츠는 흰 화면만 보이던 흐름에서 안내와 블러 미리보기를 제공하도록 바꿨습니다.

AI 작업 가이드는 CLAUDE.md를 목차로 두고 용도별 상세 문서를 docs/ai로 나눴습니다. 반복된 실수에 맞춰 작업 유형별 명령과 완료 기준, 유지할 아키텍처 규칙과 폴더 기준, 따라야 할 브랜치와 PR 규칙을 문서로 정했습니다. AI가 초안을 만든 뒤 이 규칙에 비춰 스스로 점검하고 수정하는 절차로 구성했습니다. MdLinkWeb, MdlinkCMSWeb, MdLinkEvidence에 같은 방식으로 적용했습니다.

기술부채는 우선순위와 변경 이유를 기록하며 작은 PR로 정리했습니다. 이후 작업에서도 문서를 통해 왜 코드가 변경됐는지 확인할 수 있게 했습니다. Git Flow 기반 브랜치와 릴리스 규칙과 CI도 문서화해 팀의 병합과 배포 기준을 맞췄습니다.

결과

규칙을 넣은 뒤에는 AI가 파일을 정해진 위치에 만들었고, 잦았던 복수형 폴더 이름도 더 이상 생기지 않았습니다. 주간 기술부채 정리 자동화를 약 5개월 운영했고 PR 19건 중 18건을 머지했습니다. 대표적으로 디자인 시스템 배럴의 tree-shaking을 활성화해 42개 라우트의 첫 로드 JS를 gzip 기준 평균 270KB에서 217KB로 줄였습니다. 인증과 권한 설계, 콘텐츠 통합, 출시 QA도 함께 담당했습니다.

서비스 구조
이전멀티 테넌트 구조
→
이후단일 서비스 구조홈뉴스커뮤니티구인구직
MDLink 학술대회 화면
MDLink 학술대회