fix(afternote): 종류 축 타입 2종 통폐합 + 서버 category 값 정합 — AfternoteCategory 흡수, 홈 탭 3종 400 해소 #689

📜 Overview (Required)

애프터노트 한 건의 종류를 나타내는 축이 타입 셋으로 갈라져 있고, 그 타입들이 담은 값도 서버 계약과 어긋나 있다. 둘은 같은 코드 지점에서 만나므로 함께 정리한다 — AfternoteCategory 를 없애면 그것이 들고 있던 서버 파라미터 값(navKey)을 새 자리에 다시 쓰게 되는데, 그 값이 지금 틀렸다.

① 타입이 셋

서버 원문은 category: String 이고 변환은 MappingUtils.categoryToAfternoteType 한 곳이다. 같은 축인데 타입이 둘이라 변수 이름도 타입마다 갈리고, 어느 것인지 이름으로 판별되지 않는다.

이 갈라짐이 #622 의 뿌리였다 — 도메인 모델에 종류가 들어 있는데도 서비스명 문자열로 카테고리를 되짚는 AfternoteServiceCatalog.serviceTypeFor 가 살아남아, 직접 입력 서비스의 아이콘이 전부 소셜 네트워크로 붙었다.

② 값이 서버와 불일치

서버 AfternoteCategoryType 전문은 이것뿐이다.

public enum AfternoteCategoryType {
    SOCIAL,
    GALLERY,
    PLAYLIST
}

목록 조회 파라미터(AfternoteController 의 @RequestParam(required = false) AfternoteCategoryType category)와 생성 바디(AfternoteCreateRequest.category) 둘 다 이 enum 타입이라 값이 어긋나면 400 이다. 서버 GlobalExceptionHandler 는 MethodArgumentTypeMismatchException 을 400 "요청 파라미터 형식이 올바르지 않습니다." 로, HttpMessageNotReadableException 을 400 "잘못된 요청 형식입니다. JSON 데이터를 확인해주세요." 로 돌려준다.

홈 카테고리 탭 6개 중 3개가 400 이다. AfternoteHomeViewModel 이 AfternoteCategory.navKey 를 그대로 category 쿼리로 싣는다.

생성 경로도 같다. InputToRequest.kt:37 이 비즈니스 생성 바디에 category = "BUSINESS" 를 실어 보내 역직렬화가 깨진다. 추억 노트 생성만 EditorCategory.MEMORIAL.serverValue = "PLAYLIST" 로 맞게 나간다.

같은 값을 네 곳이 다르게 표현하는 것이 원인이다.

그중 ReceiverAfternoteListItemDtoToDomain 의 KDoc 은 서버가 3값이라는 것을 이미 정확히 적어 두고 있었다 — "서버 카테고리 enum(SOCIAL/GALLERY/PLAYLIST)을 (…) 정규화한다". 수신자 목록 변환만 서버 계약을 지키고 있었고, 홈 필터와 에디터가 5값을 보내고 있었다.

📌 Child Issue(Optional)

No response

📍 Note (Optional)

• AfternoteCategory.ALL 은 도메인 enum 에 넣을 수 없다 — "전체" 필터 전용 값이다. 선택값을 AfternoteType?(null = 전체)로 두거나 화면 쪽에서 래핑하는 안이 유력하나 사용처 전수 조사 뒤 확정한다.
• 서버 파라미터 변환은 data 계층으로 내린다. 지금은 presentation(navKey)이 서버 문자열을 들고 있는데, 응답 변환이 이미 MappingUtils 한 곳에 있으므로 요청 쪽도 같은 자리에 두면 값이 한 군데서만 관리된다.
• 비즈니스는 서버 enum 확장이 선행되어야 실제로 동작한다 — Afternote-BE#110. 그때까지는 400 을 내지 않도록 FE 쪽에서 미지원 카테고리를 다루는 방식(탭 비노출 등)을 정한다.
• 재산 처리(ESTATE)도 서버 미지원이다. AfternoteHomeEntry.kt:59 가 "placeholder 카테고리. 서버 미지원이라 리스트에 노출되지 않으므로 도달 시 무시" 로 적어 두었는데 정작 홈 탭에는 노출되어 400 을 낸다. 화면 구현은 금융 카테고리 명칭·enum·입력 및 저장 계약을 확정한다 #491, 명칭은 확정 전이다.
• EditorCategory 는 이 이슈에서 제외한다 — PR refactor(afternote): 에디터 폼 상태·갱신 통로 재설계 — 카테고리별 sealed 분리 (closes 675) [base: develop] #682(refactor(afternote): 에디터 폼 상태·갱신 통로 재설계 — EditorFormState 카테고리별 sealed 분리 + updateForm 개별 콜백화 #675) 가 그것을 CategoryForm sealed 의 판별자로 승격시키는 중이라 지금 손대면 정면 충돌한다. 별도 이슈에서 refactor(afternote): 에디터 폼 상태·갱신 통로 재설계 — 카테고리별 sealed 분리 (closes 675) [base: develop] #682 머지 후 처리한다.
• 이름 정정은 fix(afternote): 목록 아이콘이 category 대신 서비스명 문자열로 결정 — 직접 입력 서비스는 전부 소셜네트워크 아이콘 #622 에서 끝났다. AfternoteServiceType 은 값이 애프터노트의 종류인데 이름은 서비스의 종류로 읽혀 실체와 어긋나 있었고(도입 커밋 3a005dd5 부터 그랬다), AfternoteType 으로 개명했다. categoryToServiceType·getIconResForServiceType 도 함께 정리됐다.
• AfternoteService(서비스 카탈로그)·AfternoteServiceDisplay(서비스 표시 묶음)는 실제로 서비스를 다루므로 이 정리 대상이 아니다.
• 값 불일치는 fix(afternote): 카테고리 축 5값이 서버 enum 3값과 불일치 — 홈 탭 3종 필터·비즈니스 생성이 400 #694 로 따로 등재했다가 이 이슈에 흡수했다(fix(afternote): 카테고리 축 5값이 서버 enum 3값과 불일치 — 홈 탭 3종 필터·비즈니스 생성이 400 #694 close). 갈라짐의 출발점은 feat(afternote): EditorCategory 에 BUSINESS·ESTATE 카테고리 추가 — 디자인과 코드 정합 #195(EditorCategory 에 BUSINESS·ESTATE 추가 — 디자인과 코드 정합)로, 시안 정합으로 FE 만 5값이 되고 서버는 3값 그대로였다.