Feature/kakao api 적용

[leesanghuu]

변경 사항 요약 (PRD 기준)

1. 식별자 설계 정리

• 투표의 기준 단위를 채팅방(botGroupKey) 으로 명확히 정의
• 세션/임시 키(sessionKey) 및 미사용 식별자 제거

정리 결과

• 투표 식별자: botGroupKey
• 참가자 식별자: botUserKey
• appUserId, sessionKey → 사용하지 않음

모든 투표 생성/조회 로직은 botGroupKey 기준으로 동작하도록 통일

---

2. Vote 도메인 구조 변경

• 채팅방 단위 투표를 명확히 표현하기 위해 Vote 엔티티 확장
• 투표 생명주기 관리를 위해 상태 필드 추가

변경 내용

• botGroupKey 컬럼 추가
• status 컬럼 추가 (ACTIVE, CLOSED)
• 웹 접근을 위한 shareCode 유지

Vote 상태 흐름

• 생성 시: ACTIVE
• @웬디 종료 시: CLOSED

---

3. Participant(참가자) 구조 정리

• 동일 투표 내 중복 참가 방지를 위해 유니크 제약 도입
• 컬럼명 혼선을 제거하고 식별자 명확화

변경 내용

• 참가자 식별 기준: (vote_id, bot_user_key)
• Unique Constraint 적용 UNIQUE (vote_id, bot_user_key)

4. 투표 링크 및 리다이렉트 구조

• 채팅방별로 서로 다른 투표 링크를 제공하기 위해 *백엔드 리다이렉트
• 웹 진입 시 투표 식별과 사용자 식별을 동시에 수행할 수 있도록 설계

1. 카카오 챗봇 메시지에서 투표 링크 제공

   • 사용자 접속 링크 ``https://whend.app/open-vote?botGroupKey={botGroupKey}&botUserKey={botUserKey}`

2. 백엔드 /open-vote 엔드포인트 처리

   • botGroupKey로 현재 활성화된(ACTIVE) 투표 조회
   • 조회된 투표의 shareCode 획득

3. 웹 페이지로 302 리다이렉트

   • https://whendy.netlify.app/{shareCode}?botUserKey={botUserKey}