Skip to content

feat: 수능 여론 투표 API와 첫 질문들 - #52

Merged
MinjoonCho merged 1 commit into
mainfrom
feat/opinion-polls
Nov 16, 2026
Merged

MinjoonCho merged 1 commit into
mainfrom
feat/opinion-polls

Conversation

@MinjoonCho

Copy link
Copy Markdown
Contributor

변경

수능 여론 투표 API를 추가합니다. 로그인 없이 질문마다 한 번 고르고, 고른 뒤에 전국·지역별 결과를 봅니다.

공개 API

  • GET /api/public/polls: 열린 질문, 3일 안에 열릴 질문(투표는 열린 뒤), 닫힌 지 10일 안 된 질문. 내가 고른 답과 결과가 같이 옵니다.
  • POST /api/public/polls/{id}/votes {optionId, geoCountry?, geoRegion?}: 한 표를 넣고 결과를 돌려받습니다. 이미 고른 질문이면 처음 고른 답 그대로 결과만 옵니다.
  • 회원은 회원 번호, 아니면 손님 쿠키(chak_guest_id)로 한 사람을 구분합니다. 쿠키가 없으면 새로 만들어 줍니다(기존 손님 생성 제한 적용).
  • 지역은 기존 방문 기록과 같은 위치 헤더(없으면 본문 값)로 시·도 이름만 저장합니다. IP는 저장하지 않고, IP당 시간당 300표 제한에만 씁니다.
  • 결과는 고른 사람과 닫힌 질문에만 줍니다. 지역별 결과는 10표 이상 모인 시·도만 담습니다.
  • 결과 집계는 질문마다 5초 동안 기억합니다(수능 당일 저녁 대비). 방금 넣은 표는 바로 더해서 보여 줍니다.

운영 콘솔 API

  • GET /api/admin/polls, POST /api/admin/polls, PATCH /api/admin/polls/{id}(숨기기, 여는/닫는 시각)

처음 넣는 질문 (V20 마이그레이션)

묶음 여는 시각 (KST) 질문
D-2 11/17 00:00 ~ 11/19 08:40 제일 걱정되는 과목, 전날 몇 시에 잘지
D-1 11/18 00:00 ~ 11/19 08:40 도시락 메뉴, 끝나고 제일 먼저 할 일
수능 당일 11/19 16:40 (4교시 종료 뒤) 국어·수학·영어·탐구 체감 난이도, 제일 어려웠던 과목, 지금 기분, 저녁 메뉴
수능 끝 11/20 00:00 이번 주에 꼭 할 것, 머리 어떻게 할지

테스트

  • PollApiTest: 비회원 투표·쿠키 발급, 중복 투표, 투표 전 결과 숨김, 지역 최소 표 수, 열리기 전/마감 후 거절, 숨기기, 다른 질문의 선택지 거절, 운영자만 관리
  • MigrationTest: 수능 당일 질문이 07:40 UTC(16:40 KST)에 열리고 선택지 65개가 들어가는지
  • 전체 339개 통과

- 로그인 없이 질문마다 한 번 고르는 투표. 회원은 회원 번호, 아니면 손님 쿠키로 한 사람을 구분하고 IP는 저장하지 않는다
- 고른 뒤에만 결과(전국, 10표 이상 모인 시·도별)를 돌려주고, 닫힌 질문은 누구나 결과를 본다
- 결과 집계는 질문마다 5초씩 기억해 수능 당일 저녁처럼 몰릴 때 DB를 지킨다. 방금 넣은 표는 바로 더해 보여 준다
- 운영 콘솔용 목록·만들기·숨기기/마감 API
- D-2, D-1, 수능 당일(16:40 KST에 열림), 수능 다음 날 질문 13개를 마이그레이션으로 넣는다
@MinjoonCho
MinjoonCho merged commit eaae085 into main Nov 16, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant