[yeondon125]

개요 💡

어드민 지원자 목록에서 컬럼 헤더를 클릭하면 해당 컬럼 기준으로 전체 지원자를 정렬하도록 하였습니다. 목록은 10건씩 페이지 단위로 받아오므로 정렬은 서버(themoment-team/hellogsm-server-26#454)에서 하고, 프론트는 헤더 UI와 정렬 파라미터 전달을 맡습니다. stage 서버 OpenAPI에 sortBy, sortDirection이 반영된 것을 확인하였습니다.

작업내용 ⌨️

API·타입

• packages/types에 OneseoSortBy, SortDirection 타입을 추가하였습니다.
• getSearchedOneseoList URL·쿼리 키와 useGetOneseoList에 sortBy, sortDirection을 추가하였습니다. 값이 없으면 파라미터를 생략합니다.

URL 동기화

• #557의 변환 함수를 확장하여 정렬 상태를 sort(OneseoSortBy), order(asc | desc)로 저장합니다. 예: /?sort=NAME&order=desc
• 잘못된 sort는 정렬 없음, order가 없거나 잘못되면 오름차순으로 봅니다. SSR 초기 조회도 같은 정렬로 받아옵니다.

헤더

• 클릭 토글을 getNextSort로 분리하였습니다. 정렬되지 않은 컬럼은 오름차순 → 내림차순 → 해제 순으로 바뀌고, 다른 컬럼을 누르면 이전 정렬은 해제되고 새 컬럼을 오름차순으로 정렬합니다. 단위 테스트 3개를 추가하였습니다.
• ApplicantTH를 컬럼 목록 기반으로 바꾸고 헤더 텍스트를 <button>으로 감싸 키보드로 조작할 수 있게 하였습니다. th에는 aria-sort를 지정하고, 아이콘은 기본 ↕(흐리게) / ▲ / ▼로 표시합니다.
• 서류 제출 여부·입학 동의서 제출 여부의 ? 툴팁은 정렬 버튼 밖에 두어, 툴팁을 보거나 눌러도 정렬되지 않습니다. 툴팁마다 있던 hover 상태는 HeaderTooltip으로 옮겼습니다.
• 정렬이 바뀌면 1페이지로 이동합니다. 필터 초기화와 탭 이동은 정렬을 유지합니다.

관련 이슈 🚨

• close [task] 어드민 지원자 목록 컬럼 헤더 클릭 정렬 추가 #558
• 선행: [task] 어드민 지원자 목록의 필터·검색·정렬·페이지 상태를 URL 쿼리와 동기화 #557, [oneseo] 원서 검색 API에 정렬 파라미터 추가 hellogsm-server-26#454

리뷰 요청사항 👀

• mock API + dev 서버 + Playwright로 토글 순서, 다른 컬럼 클릭, 툴팁 클릭 시 정렬 유지, 키보드 Enter, 정렬 + 검색어 조합, 다른 화면에서 뒤로 가기, URL 직접 입력 시 요청 파라미터와 aria-sort를 확인하였습니다.
• 실제 정렬 결과(이름·학교명 가나다순, 점수 미입력 맨 뒤, YES/NO 컬럼 페이지 이동 시 중복·누락 없음)는 mock으로 확인할 수 없어 stage에서 확인이 필요합니다.
• 필터 초기화에서 정렬도 해제해야 할지 의견 부탁드립니다. 정렬은 필터가 아니라고 보고 유지하였습니다.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
hellogsm-client-26	Ready	Preview	Oct 20, 2026 8:37am UTC
hellogsm-client-26-admin	Ready	Preview	Oct 20, 2026 8:37am UTC

[pr-agent-demo]

• Overview: 어드민 지원자 목록에서 컬럼 헤더 클릭 시 서버 정렬(sortBy, sortDirection)을 지원하는 PR입니다. 헤더 UI, URL 상태 동기화, API 파라미터 전달, 정렬 토글 로직과 테스트를 추가했습니다.
• Intent: 지원자 목록의 정렬 UX를 개선하고, 정렬 상태를 URL에 반영해 공유·뒤로가기·SSR에서도 동일한 결과를 유지하려는 목적입니다.
• Risk: 중간. 서버 정렬 계약, URL 파싱/SSR 일관성, 쿼리 캐시 키 변경, 페이지 리셋/필터 유지 정책, 헤더 접근성 및 툴립 동작을 중점적으로 확인해야 합니다. 실제 정렬 정확성은 stage 환경 검증이 필요합니다.

---

0 inline comment(s)