← 프로젝트 목록

캐시닥 for hospital

병원 이벤트 등록, 검수, 상담, 환불, 통계를 관리하는 CMS(admin, master)와 여러 지점을 관리하는 MSO 어드민입니다. 운영 화면을 유지하면서 7종의 스타일링 기술과 UI 라이브러리가 혼재한 CMS를 Tailwind 중심으로 점진 전환하고, 이를 받칠 사내 디자인 시스템을 만들었습니다. MSO에서는 지점별 데이터를 다루는 프론트엔드와 일부 백엔드 기능도 개발했습니다.

  • 7종이 섞인 CMS 스타일링을 운영을 멈추지 않고 Tailwind로 옮겨 운영 어드민 100%, 병원 어드민 80%를 전환했습니다.
  • 작업 중인 화면을 피해 자동으로 전환하는 절차와 진행 현황 대시보드를 만들었습니다.
  • MSO의 지점별 상담, 환불, 통계 기능을 개발해 상용 배포했습니다.
기간
2025.12 ~ 진행 중
역할
MSO 핵심 기능 개발, 스타일링 통합과 디자인 시스템 도입 주도
소속
전능아이티
기술
ReactNext.jsTypeScriptTailwind v4ExpressStorybookGitHub Actionsnpm

혼재한 스타일링 기술과 UI 라이브러리의 점진 전환

7종이 혼재한 CMS의 스타일링 기준을 Tailwind로 정하고, 운영 화면을 단위로 나눠 전환했습니다.

배경과 문제

Panda CSS, react-bootstrap, SCSS, styled-components, Emotion, stitches, MUI까지 7종의 스타일링 기술과 UI 라이브러리가 섞여 있었습니다. 페이지마다 쓰는 라이브러리도 디자인도 달라, 새 화면을 만들 때 무엇을 기준으로 삼아야 할지 정해지지 않았고 같은 수정도 페이지마다 다르게 해야 했습니다.

판단과 구현

팀이 정한 Tailwind를 CMS 전체의 단일 스타일링 기준으로 삼았습니다. 운영 중인 화면을 한 번에 갈아엎지 않고, 기존 디자인은 Tailwind로 그대로 옮기는 것을 원칙으로 화면 단위로 전환했습니다.

전환을 주도하기 위해 Tailwind 전환 지표와 아직 전환되지 않은 화면을 보여 주는 마이그레이션 맵을 만들어 팀과 공유했습니다. 여러 화면에서 반복되는 버튼, 입력, 표 같은 요소는 Tailwind 위에서 같은 모양을 내도록 공통 컴포넌트 기준이 필요해, 디자인 시스템을 함께 만들어 보조로 썼습니다.

결과와 검증

master의 최종 전환에서는 CCDS와 bootstrap 제거, 토큰과 CSS 레이어 변경 이후 56개 화면의 개발 및 운영 빌드 계산 스타일을 비교했습니다. 요소 단위로 실제 적용된 스타일을 확인했고, 비교한 화면 상태에서 남은 차이는 줄 높이 0.0001px의 반올림 수준이었습니다. hover, focus, 반응형 구간, 모달과 키보드 조작은 별도의 브라우저 비교와 팀 프리뷰 검수로 확인했습니다.

당시 대시보드 기준으로 운영 어드민 100%, 병원 어드민 80%를 전환했습니다. 전환한 화면은 이후 Tailwind로만 유지보수해, AI 코딩 도구가 화면마다 다른 스타일링 방식을 섞어 쓰는 일이 없어졌습니다.

전환 비율은 그 시점 대시보드의 분류 기준과 화면 범위에 따른 값이며, 공용 패키지까지 모든 레거시 의존성이 사라졌다는 뜻은 아닙니다.

스타일링 기준
이전Panda CSSreact-bootstrapSCSSstyled-componentsEmotionstitchesMUI
→
이후Tailwind공통 컴포넌트운영 어드민 100%병원 어드민 80%

반복 가능한 전환 절차와 진행 현황 집계

전환 대상 선정, 코드 변경, 검증과 PR 생성을 반복하도록 구성했습니다. 진행 현황은 파일을 같은 규칙으로 분류하는 대시보드로 확인했습니다.

배경과 문제

여러 개발자가 작업 중인 화면을 동시에 전환하면 충돌이 생길 수 있었습니다. 완료한 화면과 남은 화면을 사람이 검색해 확인하는 방식도 브랜치와 담당자에 따라 기준이 달랐습니다.

팀에서는 스타일 전환에 별도 작업 시간을 쓰기보다 다른 기능 이슈를 우선 처리해야 한다고 판단했습니다. 수동 전환에 필요한 리소스가 커 우선순위를 높이기 어려웠기 때문에, 기능 개발을 진행하는 동안 전환 작업도 병행할 수 있도록 반복 작업을 자동화했습니다.

자동 전환 절차

매일 낮 12시에 GitHub에서 최근 2주간 활동한 브랜치와 수정 중인 화면을 확인했습니다. 작업 중인 화면은 제외하고, 수정이 없던 화면 중 변경 범위가 작은 것부터 Tailwind와 CCDS로 전환하도록 했습니다.

변경 후에는 Chrome MCP로 상용 화면과 동작을 비교했습니다. 디자인 시스템 적용으로 의도한 변경과 기존 디자인을 유지해야 하는 부분을 구분하고, 의도하지 않은 차이는 수정 후 재검증했습니다. 디자인이 달라진 부분은 따로 정리해 PR 검토자가 확인하도록 했습니다. 이후 팀원이 Vercel 프리뷰에서 검수하고 배포했습니다.

대시보드 구현과 집계 오류 수정

서버에서 GitHub tarball을 스트림으로 받아 대상 앱의 .tsx, .jsx를 분석하고, className과 스타일 import를 기준으로 Tailwind, 혼용, 레거시 파일을 분류했습니다. 응답은 30분 캐시하고 강제 스캔만 캐시를 우회하도록 구성했습니다.

운영 중 전환을 끝낸 파일이 혼용으로 표시되거나, 레거시 사용처가 실제보다 적게 나오는 문제가 있었습니다. className 정규식이 표현식 밖의 코드까지 읽던 부분은 중괄호 깊이를 확인하는 파서로 바꿨습니다. className 없이 MUI sx만 쓰는 파일과, 사내 패키지 래퍼를 통해 stitches를 쓰는 파일도 집계하도록 범위를 보완했습니다.

결과

자동 전환 절차와 대시보드를 기준으로 남은 작업을 공유하고, 다른 기능 이슈를 처리하면서 스타일 전환도 병행할 수 있게 했습니다. 분류 기준별 사례는 자체 점검 스크립트로 고정했습니다.

파일 분류는 코드 수준의 근사라서, 화면이 같은지는 계산 스타일 비교와 브라우저 검증으로 따로 확인했습니다.

Tailwind 전환을 받친 디자인 시스템, CCDS에서 CADS까지

Tailwind로 옮기는 화면들이 같은 모양을 내도록 CCDS를 만들고, 이후 디자인팀 명세에 맞춘 CADS로 점진적으로 이전했습니다.

배경과 문제

Tailwind로 화면을 옮기다 보면 버튼, 입력, 표처럼 반복되는 요소를 화면마다 다시 만들게 되고, 같은 요소가 조금씩 다르게 보일 수 있었습니다. 전환한 화면들이 같은 기준을 따르게 할 공통 컴포넌트가 필요했습니다.

CCDS 구축과 운영

기존 운영 화면을 공통화하기 위해 AI로 최근 자주 사용된 디자인을 추리고 그 값들을 정리해 CCDS(Cashdoc CMS Design System)를 만들었습니다. 당시에는 레거시 환경과의 스타일 충돌을 고려해 별도 환경에서 패키지를 개발하고 npm 공개 패키지로 배포했습니다.

PR 태그에 따라 버전을 갱신하고 컴포넌트 스크린샷을 JSDoc에 넣는 절차도 만들었습니다. 새로 합류한 개발자가 Storybook을 따로 찾아보는 작업에 더해, 코드에 마우스를 올려 컴포넌트 모습을 확인할 수 있게 했습니다. 이후 새 페이지에는 CCDS를 사용하도록 팀에 제안했습니다.

CADS로 전환한 이유와 방식

기존 운영 화면을 CCDS로 정리한 뒤 디자인팀의 새 명세가 나왔습니다. 디자인팀 명세에 맞는 CADS로 통합하기로 했지만, CCDS가 이미 여러 화면에 적용돼 있어 패키지 업데이트만으로 일괄 변경하기는 어려웠습니다.

레거시 의존성을 정리해 가는 시점에 CADS를 모노레포 내부 패키지로 추가하고 CCDS와 공존시키며 이전했습니다. cads-* 토큰과 컴포넌트로 새 명세를 구현하고, 폼과 날짜 선택처럼 기존 동작을 유지해야 하는 부분은 접근성과 사용 흐름을 함께 확인했습니다.

결과

Tailwind로 옮긴 화면들이 공통 컴포넌트를 기준으로 같은 모양을 내게 했고, 디자인 개편 뒤에도 운영 화면을 멈추지 않고 새 명세로 옮겼습니다.

전환 방식
패키지 업데이트로 일괄 변경여러 화면에 적용된 CCDS
→
공존하며 이전CADS를 모노레포 내부 패키지로CCDS와 공존운영 어드민 100%병원 어드민 80%
VS Code에서 FileUpload 컴포넌트에 마우스를 올리면 JSDoc 설명과 참고사진이 함께 뜨는 모습
VS Code에서 CCDS 컴포넌트에 마우스를 올린 모습

여러 지점을 관리하는 MSO 운영 기능 개발

배경과 문제

병원 네트워크에서는 지점 하나의 데이터만 다루는 관리자 화면과 달리 그룹과 지점의 범위를 구분해야 했습니다. 로그인한 계정이 어떤 지점을 관리할 수 있는지와 포인트, 상담, 환불, 통계를 같은 기준으로 연결해야 했습니다.

판단과 구현

MSO 운영 및 병원 어드민의 통합 로그인과 지점 필터, 대시보드, 알림톡과 알림 설정을 개발했습니다. 상담, 환불, 통계, 개인정보와 서브 계정, 예약 현황 API 등에도 참여했습니다. 프론트엔드 화면뿐 아니라 필요한 API와 스키마 작업을 함께 다뤘습니다.

그룹과 지점별 포인트 차감, KST와 PV 집계 같은 운영 기준을 검증하고 정책을 정리했습니다. 이벤트 생성과 검수 기능도 지점 범위를 반영하도록 연결했습니다.

결과

기능 구현 후 QA를 거쳐 즉시결제를 포함한 상용 배포까지 진행했습니다. 지점별로 조회하고 처리해야 하는 데이터를 구분하면서 병원 네트워크의 상담, 환불, 통계 업무를 한 운영 흐름으로 구성했습니다.