Skip to content

#653 [Feat] 이용권 코드 PKE+6자리 형식 변경과 계정별 입력 5회 제한 - #654

Merged
si-zero merged 1 commit into
devfrom
feat/#653
Nov 19, 2026
Merged

si-zero merged 1 commit into
devfrom
feat/#653

Conversation

@si-zero

@si-zero si-zero commented Nov 19, 2026

Copy link
Copy Markdown
Member

#️⃣ 연관된 이슈

📝 작업 내용

기획 결정(11/19)에 따라 이용권(텀블벅 리워드) 코드를 PKE + 16진수 6자리(예: PKE05D2E1)로 바꾸고, 짧아진 코드를 추측해 가로채지 못하도록 계정별 입력 5회 제한을 둡니다.

✨ Feat

내용 파일
코드 생성을 PKE + 0-9A-F 6자리로 변경 (표시 형식 = 원문) TicketCodeGenerator.java
계정별 실패 횟수·잠금 저장 (1시간 안에 없는 코드 5회 → 1시간 잠금) TicketCodeAttempt.java, TicketCodeAttemptRepository.java, TicketCodeAttemptGuard.java
코드 확인·등록에 잠금 검사와 실패 기록, 429 TICKET_429_LOCKED ClassTicketServiceImpl.java, ErrorCode.java
테이블 생성 SQL + 롤백 V20261119_03__create_ticket_code_attempts.sql, V20261119_rollback__create_ticket_code_attempts.sql
명세 갱신 (형식·5회 제한·에러 코드) docs/api-specs/class-api.md

📌 공유 사항

  1. 배포 전에 운영 DB 에 V20261119_03 을 먼저 실행해야 합니다. 테이블이 없으면 코드 확인·등록이 500 이 됩니다.
  2. 실패 기록은 호출 쪽 예외로 롤백되지 않도록 별도 트랜잭션(REQUIRES_NEW)으로 저장합니다.
  3. 맞는 코드를 넣어도 실패 횟수는 초기화하지 않습니다. 초기화하면 본인 코드로 횟수를 지우며 계속 추측할 수 있기 때문입니다.
  4. 5번째 실패 응답부터 429 입니다. 잠긴 동안에는 맞는 코드도 막힙니다.
  5. 계정별 제한만 둡니다(기획 결정). 계정을 여러 개 만들면 계정마다 5회씩 시도할 수 있다는 점은 알고 있는 한계입니다.
  6. 이미 발급된 미등록 26자 코드는 배포 후 어드민 재발급(9.5)으로 새 형식으로 바꿉니다. 이전 코드도 등록 자체는 가능합니다(해시 비교라 형식과 무관).
  7. 앱: 코드 입력칸 글자 수·안내 예시를 PKE05D2E1 기준으로, 429 TICKET_429_LOCKED 안내 문구 처리가 필요합니다.

✅ 체크리스트

  • Reviewer에 팀원들을 선택했나요?
  • Assignees에 본인을 선택했나요?
  • 컨벤션에 맞는 Type을 선택했나요?
  • Development에 이슈를 연동했나요?
  • Merge 하려는 브랜치가 올바르게 설정되어 있나요?
  • 컨벤션을 지키고 있나요?
  • 로컬에서 실행했을 때 에러가 발생하지 않나요?
  • 팀원들에게 PR 링크 공유를 했나요?

📸 스크린샷

  • 전체 테스트 667건 통과. 통합 테스트 추가: 5회 실패 시 429·잠긴 동안 맞는 코드도 차단·다른 계정 영향 없음·잠금 해제 후 등록 성공, 맞는 코드로 실패 횟수가 초기화되지 않음

💬 리뷰 요구사항

  1. 5번째 실패를 404 대신 바로 429 로 돌려주는 방식이 앱 화면 흐름과 맞는지 의견 부탁드립니다.

@si-zero si-zero added the ✨ Feat (기능 추가) 새로운 기능을 추가할 때 사용합니다. label Nov 19, 2026
@si-zero si-zero self-assigned this Nov 19, 2026
@si-zero
si-zero merged commit 917c300 into dev Nov 19, 2026
1 check passed
@si-zero
si-zero deleted the feat/#653 branch November 19, 2026 02:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

✨ Feat (기능 추가) 새로운 기능을 추가할 때 사용합니다.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

✨ Feat: 이용권 코드 PKE+6자리 형식 변경과 계정별 입력 5회 제한

1 participant