[GMSS-128] feat: 대화 종료와 감정 카드 생성

[soyeonLee126]

작업 개요

• 대화를 끝내고 감정 카드를 만드는 경로입니다. 카드는 이 앱의 최종 산출물이고, 서버가 클라이언트가 보낸
  emotion(캐릭터)과 summary(요약)를 받아 본문(자연스러운 요약)을 만듭니다.

• 감정은 메시지를 보낼 때마다 증분으로 누적해두고 종료 시점에는 argmax만 합니다.

• 감정 집계가 발화별 점수의 합이라 증분화해도 배치 분류와 결과가 완전히 같습니다(발화 수로 나누는 건 표시용 확신도라 argmax는 안 바뀝니다).

• 종료 시점에 발화 N개를 한꺼번에 분류하지 않아 카드 생성 대기가 짧아집니다.

• 종료와 카드 생성은 한 유즈케이스로 묶지 않았습니다. 종료는 되돌릴 수 없어서, 종료는 성공했고 카드만 실패한
  상태를 화면이 들고 재시도해야 합니다.

base 브랜치

이 PR은 feature/chat-messaging(#14) 위에 쌓여 있습니다. #14가 머지되면 base가 develop으로 전환됩니다.
카드 작업만 보이도록 따로 열었습니다.

작업 유형

• feat: 새 기능
• fix: 버그 수정
• refactor: 리팩토링 (동작 변경 없음)
• build: 빌드/의존성 설정
• chore: 기타 (문서, 설정 등)
• test: 테스트 추가/수정

변경 사항

감정 누적을 ConversationSession 에 편입

• ConversationSession 이 이미 "서버에 확정된 USER 발화만 파생 상태에 미러링한다"는 순서를 강제하고
  있어서, 감정 누적기도 같은 자리에 넣었습니다. 화면은 세션 하나만 의존한 채로 남습니다.
• ConversationEmotionAccumulator: 압축본과 같은 append(싼 적재) / classifyPending(모델 실행)
  으로 나눴습니다. 전송 응답이 온디바이스 추론을 기다리지 않고 화면에 붙습니다.
• 방에 재진입할 때는 발화를 큐에 넣기만 합니다. 분류는 첫 전송이나 카드 생성 시점에 몰아서 돕니다.
• 분류에 실패한 발화는 그 자리에서 멈추고 다음에 다시 시도합니다. 같은 자리에서 두 번 실패하면
  건너뜁니다.
• 상태 잠금과 분류 잠금을 분리해, 분류가 도는 동안에도 새 발화를 받습니다.

종료 흐름 상태를 EndFlow 로 통합

• isEnded/isFinishing/showEndConfirm/card/endedButCardFailed 조합 32가지 중 6가지만 합법이라, 화면과 ViewModel 이 유효 조합을 매번 다시 계산해야 했습니다.
• sealed interface 한 축으로 모아 불가능한 상태를 타입에서 없앴습니다.

NotStarted -> Confirming -> Ending -> CreatingCard -> CardReady(card)
                                                   -> CardFailedRetryable
                                                   -> CardFailedFinal

• 화면 분기가 exhaustive when 이라 단계를 추가하면 컴파일 에러로 알려줍니다.
• 재시도해도 결과가 같은 실패는 CardNotRetryableException(AlreadyExists / NoSummary / NoEmotion)으로 묶어 CardFailedFinal 로 보냅니다.

종료·카드 API

• POST /api/conversations/{id}/end, POST /api/cards 연동
• 카드 API 의 emotion 은 모델 6감정이 아니라 캐릭터 6종입니다(JOY/ANGER/ANXIETY/GRUMPY/WARM/QUIRKY).
  도메인 PRICKLY 가 서버 GRUMPY 에 대응하고, 서버 문자열 매핑은 EmotionTypeMapping 한 곳에 모았습니다
• 종료 응답은 ApiResponse<Unit> 으로 받습니다.
• ApiErrorCodes: 서버 error.code 로 판별합니다. CONVERSATION_ALREADY_ENDED 는 멱등 성공으로
  접고(응답이 유실된 뒤 재시도해도 복구됩니다), CARD_ALREADY_EXISTS 는 도메인 예외로 구분합니다.

온디바이스 실패 격리를 공용 헬퍼로

요약 저장소가 들고 있던 failSafe 를 domain/common 으로 옮겼습니다.

관련 이슈

• 없음

관련 작업 (Notion)

• GMSS-128

스크린샷 / 동작 화면

체크리스트

• base 브랜치가 설정되어 있다 ([GMSS-124] feat: 대화 컨텍스트 압축본 전송 및 채팅 메시지·대댓글 연동 #14 머지 후 develop 으로 전환)
• 로컬 빌드 및 실행을 확인했다
• 커밋 메시지가 컨벤션(feat:, fix: 등)을 따른다
• 불필요한 로그/주석/디버그 코드를 제거했다
• 리뷰어가 이해할 수 있도록 설명을 작성했다

테스트

• :app:assembleDebug, 단위 테스트 90개, detekt 전부 통과입니다.
• 상태 기계 테스트(ChatRoomEndFlowTest) 9개를 새로 넣었습니다.
• 누적기의 잠금 분리도 테스트로 고정했습니다. 잠금을 하나로 합치면 분류가_도는_동안에도_새_발화를_받는다
  가 타임아웃으로 깨집니다.

[seunghee17]

문제가 없어보여 merge 합니다! 고생하셨습니다!