professional-work

04

대학 심사 플랫폼 — 공통 UI와 협업 기반

논문 심사 어드민의 프론트엔드 전반을 맡아 공통 UI와 API 기반을 만들었습니다. 학생과 교수 플랫폼에서는 다른 개발자 한 명과 이 기반을 활용하고, 일정 배정의 피드백, 겹치는 일정과 PDF 표시를 보완했습니다.

preview
어드민과 사용자 플랫폼이 공통 UI를 활용하는 설명용 도식 / Illustrative diagram of shared UI across admin and user platforms

심사 업무를 여러 화면으로 옮기기

대학 심사 플랫폼은 학생과 교수가 논문 심사를 신청하고 일정, 결과, 제출 문서를 확인하는 서비스입니다. 저는 관리자 프론트엔드 전반을 맡았고, 학생과 교수용 플랫폼에서는 다른 개발자 한 명과 함께 작업했습니다.

관리자 화면에는 비슷한 필터와 표, 입력 폼이 반복됐습니다. 그렇다고 모든 화면을 같은 방식으로 처리할 수는 없었습니다. 심사 상태에 따라 보여줄 내용이 달랐고, 일정을 편집하는 중인지 배정이 확정된 것인지도 구분해야 했습니다.

폼, 필터, 테이블, 페이지네이션을 공통으로 구성하고 OpenAPI로 생성한 타입과 클라이언트를 연결했습니다. 그 위에 학생과 교수, 심사 관리와 일정 배정 화면을 만들었습니다. 배정을 적용한 뒤에는 체크 상태와 피드백을 바로 갱신해, 방금 처리한 결과를 화면에서 확인할 수 있도록 보완했습니다.

다음 개발자도 함께 쓸 수 있는 기반

학생과 교수용 플랫폼을 만들 때는 별도의 화면 디자인이 없었습니다. 대학 디자인 기준을 참고하고 어드민에서 만든 주요 컴포넌트를 활용해 UI 기반을 마련했습니다. 새로 합류한 개발자도 이 기반에서 작업할 수 있도록 온보딩을 지원했습니다.

공통 기반 위에서 일정 표현도 다듬었습니다. 월간 화면과 주간 화면이 같은 스케줄러 상태를 사용하도록 통합하고, 연쇄적으로 겹치는 일정을 한 그룹으로 묶었습니다. 시작 시각 순으로 읽으면서 그룹의 가장 늦은 종료 시각을 추적해, 앞선 일정과 이어서 겹치는 경우도 함께 처리했습니다.

어드민의 주요 컴포넌트를 사용자 플랫폼으로 가져온 경험을 통해, 공통 UI는 만드는 사람 한 명의 편의만을 위한 것이 아니라는 점을 돌아보게 됐습니다. 다른 개발자와 같은 기준으로 기능을 더할 수 있었고, 제 경험상 온보딩에도 도움이 됐습니다.

공통 코드 밖에서 해결해야 했던 문서 표시

공통 컴포넌트를 써도 실행 환경의 차이는 남았습니다. 어드민에서는 PDF의 한국어, 중국어, 일본어 문자가 깨지는 문제에 대응해 react-pdf를 도입하고 필요한 PDF.js 자산을 직접 서빙했습니다. 사용자 플랫폼의 iOS에서는 페이지를 필요한 범위만 렌더링하는 가상화를 적용해 PDF 표시 문제를 보완했습니다.

처리한 결과가 화면에도 남도록

공통 UI만큼 데이터가 들어오고 바뀌는 규칙도 중요했습니다. 관리자 목록의 URL 검색 조건과 페이지네이션을 스키마로 검증하고, API의 enum과 선택적 필드를 화면에서 사용할 값으로 정리했습니다. 일정 배정에서는 이미 배정된 항목의 선택을 막고, 적용 후 관련 캐시와 체크 상태를 갱신했습니다. 같은 표를 쓰더라도 조회 조건과 다음 행동은 업무 규칙에 맞아야 했습니다.

채팅에서는 목록, 메시지와 미확인 수가 서로 다른 갱신 경로를 거쳤습니다. TanStack Query의 캐시 키와 갱신 범위를 정리하고 WebSocket 이벤트, polling과 무효화 debounce를 연결했습니다. 사용자 플랫폼의 채팅과 알림은 공통 플로팅 윈도우로 정리하고, 읽음 처리와 알림 대상 이동도 보완했습니다. 모바일 PASS 인증은 callback과 앱 복귀 fallback까지 연결해 외부 인증 화면 이후의 흐름을 다뤘습니다.

농산물 이커머스에서도 반복 목록과 업무별 정책을 다뤘습니다. 지금 두 경험을 함께 읽으면, 다른 업무와 개발자도 같은 규칙으로 작업할 수 있는지를 공통화의 기준으로 보게 됩니다. 두 프로젝트를 비교하며 지금 갖게 된 생각입니다. 대학 안에서 어드민의 컴포넌트를 사용자 플랫폼에 활용한 것은 실제 작업으로 이어진 연결입니다.

어드민 전반을 맡되 기존 구현과 다른 개발자의 변경을 함께 다뤘습니다.