feat(ai): Ask Chat 대화권 과금 정책 추가

[1Seob]

📝 요약(Summary)

• Ask Chat 사용을 위한 무료/유료 대화권 지갑을 추가하고, 질문 전송 시 대화권 부족 여부를 검증하도록 했습니다.
• 답변 생성 성공 시에만 대화권 차감을 확정하고, 실패 시 예약 차감을 환불하도록 처리했습니다.
• 크리스탈 30개로 Ask Chat 대화권 10회를 충전하는 API와 로그 기반 추적 구조를 추가했습니다.
• Ask Chat 세션 생성은 누적 답변 20개 이상인 사용자만 가능하도록 제한했습니다.

주요 변경사항

• 대화권 지갑/로그

  • ask_chat_wallets, ask_chat_wallet_logs 테이블 추가
  • 무료/유료 대화권 잔액, 로그 사유, 처리 상태, idempotency key 저장
  • 기존 사용자 대상 초기 무료 대화권 백필 migration 추가

• 무료 지급/충전

  • 회원가입 및 테스트 유저 생성 시 Ask Chat 무료 대화권 3회 지급
  • POST /ask-chat/turns/charge 추가
  • 30 크리스탈 차감 후 유료 대화권 10회 충전
  • 크리스탈 로그와 Ask Chat 대화권 로그를 함께 기록

• 질문 전송 차감 정책

  • 질문 전송 전 사용 가능한 대화권이 없으면 ASK_CHAT_TURN_BALANCE_INSUFFICIENT 반환
  • 답변 생성 성공 시 예약 로그를 확정 처리
  • 답변 생성 실패 시 대화권 환불 및 환불 로그 기록
  • 실패 응답은 채팅 메시지가 아닌 answerGeneration 필드로 전달

• 사용 조건

  • POST /ask-chat/sessions 호출 시 누적 답변 20개 이상인지 검증
  • 답변 수가 부족하면 ASK_CHAT_NOT_ENOUGH_ANSWERS 반환
  • 질문 전송 API에서는 동일 검증을 반복하지 않음

• 프롬프트/설정

  • Ask Chat 답변 프롬프트 v2 설정 적용
  • 답변 생성 max token 설정 보강

• 테스트

  • 대화권 지갑 repository 테스트 추가
  • 무료 지급, 충전, 예약/확정/환불 서비스 테스트 추가
  • 질문 전송 및 세션 생성 정책 테스트 보강
  • 컨트롤러 응답 계약 테스트 보강

검증

• .\gradlew.bat compileJava
• .\gradlew.bat test --tests "com.devkor.ifive.nadab.domain.askchat.application.AskChatSessionServiceTest" --tests "com.devkor.ifive.nadab.domain.askchat.api.AskChatSessionControllerTest"
• git diff --check

🔗 Related Issue

• Closes:

💬 공유사항

✅ PR Checklist

PR이 다음 요구 사항을 충족하는지 확인하세요.

• PR 제목을 커밋 메시지 컨벤션에 맞게 작성했습니다.

[coldsunn]

LGTM!