[maple-helper - 7] 메이플 헬퍼 v2 리팩토링 계획

꾸준히 운영해 온 **메이플 헬퍼(Maple Helper)**를 v2로 업그레이드하려고 한다.

1년 전에 만든 코드라 지금 기준에서 보면 여러 부분이 눈에 밟혔다. 그래서 기능을 추가하기 전에, 앞으로 개발 속도를 떨어뜨릴 구조부터 먼저 정리하기로 했다.

v2 목표

v2에서 하려는 목표를 세웠다.

• 기존 코드 리팩토링
• “최초의 대적자 패링 연습장” 신규 서비스 개발
• “재획 기록” 기능 추가

지금 코드에서 가장 문제라고 느낀 건 “기능 추가/유지보수”가 점점 어려워지는 구조라는 점이다.

• 로직과 UI가 뒤섞여 있음
• 개발 컨벤션이 애매하거나 통일되지 않음
• 폴더 구조가 명확하지 않음
• API 요청 / 데이터 가공 / 뷰 렌더링이 한 파일에 몰려 있음

한 번에 다 뜯어고치고 싶었지만, 그건 리팩토링이라기보다 재개발에 가깝다. 그래서 이번에는 발목을 잡는 부분부터 개선하는 방향으로 간다.

이번 리팩토링 범위

1) 폴더 구조 & 네이밍 컨벤션 통일

관리 비용을 줄이기 위한 목적으로 개선한다.

• 컴포넌트 폴더는 반드시 소문자로 시작
• pages, features, components, hooks 구조 정리
• 파일 네이밍 룰 통일

2) API 요청 로직 개선

데이터 흐름을 단순하게 만들기 위해 “요청/가공/표현”을 분리한다.

• API 요청 로직 분리
• 요청 로직은 요청만
• 데이터 가공은 가공만
• 응답 스키마에 맞게 데이터 정리 로직 분리
• API 라우터 응답 포맷 통일