refactor(afternote): 저장 흐름 예외 3종을 AfternoteFailure sealed 루트로 압축 (#934 4-B) [base: develop]

[1hyok]

#934 의 4-B 단계. 1·2단계는 #1051, 4-A(수신자)는 #1054 — 세 PR 이 다 머지되면 이슈를 닫는다. 파일이 겹치지 않아 머지 순서 제약은 없다.

무엇을

AfternoteAuthoringValidationException 과, UseCase 파일에 얹혀 있던 MemorialVideoSaveException·MemorialPhotoSaveException → AfternoteFailure 루트 아래 AuthoringValidation·MediaSave 둘로.

sealed class AfternoteFailure(message: String?, cause: Throwable?) : Exception(message, cause) {
    class AuthoringValidation(val kind: AfternoteAuthoringValidationKind) : AfternoteFailure(...)
    class MediaSave(val media: MediaKind, cause: Throwable) : AfternoteFailure(...)
}

매체별로 타입을 나눌 이유가 없었다 — 화면은 둘을 갈라 보지 않고 handleSaveFailure 의 generic 폴백으로 같이 처리하며, 갈라 보던 코드도 없다. 매체는 MediaKind 필드로 구분한다(#938 이 도입한 enum).

이슈 본문이 못박은 두 제약을 지켰다

• cause 보존 — 원본 예외를 cause 로 나르는 게 계약이고 ResolveMemorialMediaForSaveUseCaseTest 가 단언한다.
• data class 금지 — 생성된 equals/hashCode 가 선언 프로퍼티만 덮어 cause 를 무시한다. 일반 class 로 뒀다.

묶기만 하지 않았다

handleSaveFailure 의 when 이 else -> null 로 뭉개고 있어 sealed 이득이 0 이었다. 루트로 좁혀 MediaSave 가 "검증 실패 아님(null)"으로 명시되게 했고, 실패 유형이 늘면 그 자리가 컴파일 에러로 잡힌다. 그 null 이 곧 "텔레메트리 기록 대상" 이라 분류를 빠뜨리면 조용히 기록에서 빠진다.

판단해서 정한 것

message 를 진단 문구(영문)로 통일했다. 기존 한국어 문구("영상 업로드에 실패했습니다.")는 화면에 닿지 않는 값이다 — handleSaveFailure 가 검증 실패가 아닌 실패를 전부 afternote_editor_save_failed_generic 리소스로 폴백시키므로, 이 문구는 Crashlytics 에만 남는다. 나머지 도메인 예외의 정책(표시 문구는 리소스, message 는 진단)과 맞췄다.

AfternoteAuthoringValidationKind 는 값이 하나(RECEIVERS_REQUIRED)뿐이지만 유지했다 — 서버 코드 475 에 대응하는 도메인 어휘라 AuthoringValidation 자체를 없애면 그 번역 지점이 사라진다.

검증

게이트	결과
:app:compileDebugUnitTestKotlin	green
:app:compileDebugAndroidTestKotlin (#949 신설)	green
전 모듈 ktlintCheck	green
:feature:afternote:domain · :data · :presentation testDebugUnitTest	green

시각 검증 해당 없음 — 리소스·Compose 변경 0. baseline 사이클 미실행.

리뷰어에게

• AfternoteValidationException(presentation, 던지는 곳 0건)은 건드리지 않았다 — [fix] #603 미사용 비동기 검증 경로 제거 #880 이 그 예외와 짝인 AfternoteValidationError.GALLERY_RECEIVERS_REQUIRED 및 string 리소스까지 함께 지운다. 여기서 손대면 충돌한다.
• [refactor] #601 저장 검증과 에디터 오류 상태 통합 #831 과 겹칠 수 있다 — 그 PR 이 Memorial{Photo,Video}SaveException 을 새 when 분기로 소비하기 시작하고 AfternoteEditorErrorTest 가 두 예외를 직접 생성한다. 다만 [refactor] #601 저장 검증과 에디터 오류 상태 통합 #831 은 feat/601 스택 위(develop 대비 뒤처짐)라 이 PR 을 막지 않는다. 그쪽이 리베이스할 때 MediaSave(media) 로 맞추면 된다.