Skip to content

보드 문제 접근 상태 통합 및 보상·멱등성 처리 개선 - #29

Merged
jiwonnii merged 15 commits into
mainfrom
fix-board-challenge-rewards
Sep 10, 2026
Merged

jiwonnii merged 15 commits into
mainfrom
fix-board-challenge-rewards

Conversation

@jiwonnii

@jiwonnii jiwonnii commented Aug 27, 2026 •

Copy link
Copy Markdown
Collaborator

문제 개방 상태를 TeamChallengeAccess로 통합하고, 정답 제출 시 보드 완료 상태·동적 점수·마일리지·추가 주사위를 일관되게 반영합니다. 보드 요청 키와 최초 응답을 DB에 함께 저장해 Redis 장애나 요청 프로세스 종료 후 재시도에도 중복 처리되지 않도록 합니다.

변경 사항

  • 문제 상세 조회, 플래그 제출, 인스턴스 생성에서 동일한 접근 레코드를 검사합니다.
  • 기존 OpenedChallenge를 이관하며, 기존 보드 접근 기록이 있어도 Solve의 완료 상태·시각을 반영합니다. 기존 접근 ID·개방 시각·출처 칸은 보존합니다.
  • 보드 메타데이터가 누락되면 데이터 변경 전에 문제 ID와 함께 이관을 중단합니다. 기록을 삭제하거나 건너뛰지 않고, 검증된 보드 정보를 보완한 뒤 재시도합니다. 절차는 docs/pr29-data-migration.md에 있습니다.
  • 정답 처리 후 동적 점수와 팀 점수를 다시 계산하고, 반영된 team_score와 mileage를 응답합니다. 문제 풀이 마일리지는 상 120 / 중 60 / 하 30입니다.
  • 개방 후 15분 이내이고 현재 칸의 활성 문제를 푼 경우에만 추가 주사위를 지급합니다. 실제 지급 결과를 응답과 Solve 기록에 동일하게 남깁니다.
  • 초기 주사위는 3개입니다. 3개 미만이면 기존 충전 시각을 유지하고, 3개에 도달하면 충전을 멈춥니다. 만료된 충전을 보상 판단 전에 반영합니다.
  • 추가 주사위 카드의 사용 검사와 지급 사이에 자동 충전으로 3개가 차면 409 CHANCE_CARD_WRONG_TIMING을 반환하고 카드를 보존합니다. 실제 주사위가 지급된 경우에만 카드 사용을 저장합니다.
  • 정답 제출과 룰렛의 잠금 순서를 보드 상태 → 팀으로 통일하고, 동시 점수 갱신의 팀 잠금은 UUID 순으로 획득합니다.
  • Idempotency-Key 선점, 본문 충돌 검사, DB 기반 최초 응답 재생을 적용합니다. 보드 API의 키는 최대 255자이며, 초과하면 캐시 조회·DB 저장 전에 400 INVALID_REQUEST를 반환합니다.
  • PR #14의 보안 리뷰를 반영해 데모 계정 두 개의 비밀번호를 Django 정책으로 검증합니다. 검증 실패 시 seed 전체를 롤백해 기존 보드와 계정을 보존합니다.

검증

  • 키 길이 회귀 테스트 2개 통과: 255자 키의 성공과 캐시 초기화 후 DB 응답 재생, 256·4096자 거부와 무변경 상태 및 키 수정 후 정상 처리.
  • 2026-09-10, 최신 main을 포함한 PR 코드로 별도 PostgreSQL 16 DB에서 전체 테스트 327개 통과
  • feat(koth): 참가자 접속 URL 추가 및 채점 통신·계약 보완 #57 수정본과 합친 상태에서도 PostgreSQL 전체 테스트 342개 통과
  • 최신 커밋 20ad403의 GitHub CI 및 상태 검사 6개 모두 통과
  • 충전 0→1, 1→2의 기존 타이머 유지, 2→3의 충전 종료와 실제 추가 주사위 지급 결과 검증
  • 카드 충전 경계 회귀 테스트 6개 통과: 충전 직전·정확한 시각·직후, 검사와 지급 사이 충전, 여유가 남는 경우 실제 지급, 거부 후 주사위 사용·동일 키 재시도, 캐시 초기화 후 성공 응답 재생. 수정 전에는 2개 테스트가 실패했고 수정 후 모두 통과했습니다.
  • 기존 접근 기록 유무 × 풀이 여부 4가지 이관 및 이관 후 열린 문제 목록 조회 검증
  • 보드 정보 누락 시 무변경 중단, 정보 보완 후 재시도 검증
  • 여러 팀의 동시 정답 제출, 같은 팀의 정답 제출·룰렛 동시 요청 검증
  • DB 커밋 직전·직후 요청 프로세스 강제 종료 후 새 프로세스에서 같은 키 재시도 검증
  • 비밀번호 정책 거부 시 seed 롤백과 정상 데모 로그인 회귀 테스트 통과
  • Django 시스템 검사, makemigrations --check --dry-run, git diff --check 통과

운영 DB의 보드 정보 누락 여부는 배포 시 사전 조회해야 합니다. Scheduler 연동과 프론트 마이페이지 연결은 이 PR의 리뷰에서 분리한 후속 작업입니다.

@jongcoding

Copy link
Copy Markdown
Contributor

멱등성 부분:
여기 멱등성은 아직 머지하면 안 될 것 같아요
view 처리가 끝나 DB에 반영된 뒤 Redis에 응답을 저장해서, cache.set 실패나 서버 종료가 생기면 DB 변경만 남습니다
실제로 첫 주사위 요청의 Redis 저장을 실패시키고 같은 키로 재시도했더니 DiceRoll이 2건 생기고 주사위도 2번 차감됐어요
현재 LocMem 동시 요청 테스트로는 이 경우를 못 잡습니다
이슈 32대로 요청 키와 본문 해시와 처리 상태와 최초 응답을 DB에 저장하고 Redis 초기화와 저장 실패와 서버 재시작 테스트까지 넣어주세요

동적 점수 부분:
현재 main의 랭킹과 리더보드는 Challenge.current_score를 읽는데, 이 제출 흐름은 Solve와 마일리지만 저장하고 current_score를 다시 계산하지 않아요
합본 테스트에서 첫 solve 뒤 current_score가 1000으로 남았고 현재 계산식의 기대값은 998이었습니다
challenge.score를 earned_score로 저장하는 부분도 current_score가 감소한 뒤에는 틀어질 수 있어요
이슈 30을 최신 랭킹 구조에 맞게 고치고 정답 제출부터 랭킹 조회까지 한 테스트로 확인해주세요

마일리지 부분:
문제 풀이 마일리지 값을 먼저 확정해야 할 것 같아요
여기서는 30·60·120인데 API 공통은 100·50, 제출 명세는 100, 마이페이지와 마일리지 내역은 50으로 되어 있습니다
코드만 바꾸면 다른 화면이 다시 어긋나니 지급표 하나를 확정한 뒤 문서와 테스트까지 같이 맞춰주세요

응답 필드 부분:
플래그 제출 성공 응답 명세에는 반영 후 team_score와 mileage가 있는데 현재 두 필드가 빠져 있어요
team_score는 최신 랭킹 계산과 같은 기준으로 계산하고 mileage는 DB 반영 후 값을 다시 읽어서 반환해주세요
프론트 계약 테스트도 같이 추가하면 될 것 같습니다

@jiwonnii jiwonnii changed the title fix: integrate board challenge rewards and idempotency 보드 문제 보상·동적 점수 및 멱등성 처리 개선 Sep 3, 2026
@jiwonnii jiwonnii changed the title 보드 문제 보상·동적 점수 및 멱등성 처리 개선 보드 문제 접근 상태 통합 및 보상·멱등성 처리 개선 Sep 3, 2026
@jongcoding

Copy link
Copy Markdown
Contributor

DB 기반 멱등성, 동적 점수 재계산, team_score와 mileage 응답이 반영된 것과 최신 CI 통과까지 확인
마일리지 120 60 30도 최신 노션 지급표와 맞아유

남은 부분은 두 가지인듯

추가 주사위 부분~~
노션 제출 명세는 15분 이내이면서 현재 방금 도착한 최신 칸인 경우에만 추가 주사위를 지급하도록 되어 있는데, 현재 코드는 시간만 확인하고 있어
현재 보드 위치와 활성 문제가 제출한 문제에 해당하는지까지 같이 확인해야 할 것 같음
보드 상태를 잠근 상태에서 지급 여부를 판단하고, 실제 지급 결과가 응답과 Solve 기록에도 동일하게 들어가도록 맞춰주십쇼

동시 정답 처리 부분~~
현재는 자기 팀 마일리지를 먼저 갱신한 뒤 다른 팀들의 동적 점수까지 갱신
서로 다른 문제에 정답이 동시에 들어오면 요청마다 팀 행을 잠그는 순서가 달라져 교착이 생길 가능성이 있을 듯??
이 부분은 코드상 우려라 동시성 테스트로 확인이 필요함..! 팀 행 잠금 순서를 통일하고, 여러 팀이 서로 다른 문제를 동시에 풀어도 정답 처리와 점수 갱신이 정상적으로 끝나는지 확인!!

@jongcoding

Copy link
Copy Markdown
Contributor
  1. 기존 데이터 이전 시 풀이 완료 상태가 빠집니다
    기존에 문제 개방 기록과 정답 기록이 있는데 보드 쪽 개방 기록도 이미 있으면, 마이그레이션에서 해당 항목을 건너뛰고 있습니다
    이전 스키마에 데이터를 넣고 확인해보니, 이미 푼 문제인데도 OPENED로 남고 완료 시각도 비어 있었습니다
    보드 개방 기록이 없던 경우는 CLEARED로 정상 이전됐습니다
    이 상태면 보드에서는 안 푼 문제로 보이는데, 다시 제출하면 이미 푼 문제라고 나올 수 있습니다
    기존 보드 기록이 있더라도 Solve를 확인해서 완료 상태와 완료 시각을 맞춰주세요
    기존 기록이 있는 경우와 없는 경우 둘 다 마이그레이션 테스트에 추가 부탁드립니다
    해당 코드

  2. 정답 제출과 룰렛의 잠금 순서도 맞춰야 합니다
    정답 제출은 보드 상태를 먼저 잠그고 팀을 잠그는데, 룰렛은 팀을 먼저 잠그고 보드 상태를 잠그고 있습니다
    같은 팀에서 두 처리가 겹치면 서로 상대가 잡은 잠금을 기다리다가 한쪽 요청이 실패할 수 있습니다
    이전에 열어둔 문제도 제출할 수 있어서, 현재 룰렛 칸에 있더라도 정답 제출과 겹칠 수 있습니다
    이번에 추가한 동시 제출 테스트는 통과했지만, 정답 제출과 룰렛이 겹치는 경우까지 확인하는 테스트는 아닙니다
    이 부분은 코드에서 잠금 순서가 다른 걸 확인한 것이고, 실제 교착 오류를 재현한 것은 아닙니다
    룰렛도 같은 잠금 순서로 맞추고, 정답 제출과 보드 조작이 겹치는 경우를 테스트에 추가 부탁드립니다
    정답 제출 코드 · 룰렛 코드
    위 두 부분 수정하고 테스트 추가해주시면 다시 확인하겠습니다

@jongcoding jongcoding left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jiwonnii 수정본이랑 프론트·스케줄러 연결까지 다시 봤습니다

이전에 말씀드린 완료 기록 이관과 룰렛 잠금 순서는 수정 확인했어요
실제 화면에서도 문제 선택 → 정답 제출 → 점수·마일리지 반영까지 정상 동작했습니다
15분 지난 문제도 제출됐고, 마일리지는 받되 추가 주사위는 안 받는 것까지 확인했습니다

다만 아래 두 부분은 보완 부탁드립니다

충전 타이머

주사위 0개에 충전이 진행 중인 상태에서 현재 문제를 처음 풀면, 주사위는 1개가 되는데 충전 타이머가 없어집니다
화면뿐 아니라 DB의 충전 예정 시각도 null로 바뀌는 걸 확인했어요

정답으로 1개 받았다고 충전까지 멈추면 안 되고, 3개가 될 때까지는 기존 충전이 계속돼야 합니다
최신 노션도 3개 미만이면 진행 중인 타이머를 유지하는 걸로 되어 있어요
지금 공통 지급 함수는 주사위가 0보다 커지면 타이머를 지우고 있어서 풀이 보상에도 그대로 적용됩니다

0→1, 1→2에서는 기존 충전 시각이 유지되고 2→3에서만 멈추는 테스트까지 부탁드립니다
문제의 15분 보상 조건이랑 주사위 충전 타이머는 구분해서 봐주세요

노션 기준 · 해당 코드

기존 데이터 이관 후 목록 조회

옛 문제 개방 기록은 있는데 해당 문제의 BoardChallenge가 없는 경우도 확인이 필요합니다
이 상태로 이관하면 마이그레이션은 끝나지만, 열린 문제 목록에서 보드 정보를 바로 읽다가 예외가 발생합니다
로컬 PostgreSQL에서 이관 후 목록 서비스를 호출해 확인했고, 보드 정보를 추가한 경우는 정상 조회됐어요

운영 이관 대상에 이런 데이터가 있는지는 아직 확인하지 못했습니다
누락 여부를 확인하고 보드 정보를 보완하거나, 이관 전에 누락을 알려주고 중단하는 기준을 정해주세요
개방 기록을 그냥 건너뛰거나 지우지는 말고, 이관 후 목록 조회까지 테스트에 포함 부탁드립니다

목록 조회 코드

별도로 남은 연동 작업

  • 인스턴스 조회·생성은 정상 로그인 상태에서도 401이 나왔습니다
    백엔드가 참가자 토큰을 Scheduler로 그대로 보내고, 생성 본문도 아직 단일 컨테이너 방식이라 현재 서비스 인증·릴리스 계약과 맞지 않습니다
    이건 이번 수정의 신규 문제로 보지는 않고, #26 기반 #52와 연결해서 확인할 부분입니다
  • 마이페이지 풀이 기록은 API가 데이터를 내려주는데 프론트에서 아직 연결하지 않은 상태라 프론트 후속 작업으로 분리하면 됩니다

이 연동 작업을 전부 PR 29에서 고쳐달라는 뜻은 아닙니다
우선 위의 충전 타이머와 이관 후 목록 조회를 보완해주시면 될 것 같아요

검토 기준은 PR 29 e3870a8, 프론트 main 1f2ce01, Scheduler dev 801beab입니다
로컬 앱끼리 연결한 결과이고 Scheduler 아래 Broker·Runtime은 대체 구현이라 실제 문제 컨테이너 실행까지 확인한 것은 아닙니다

@jongcoding jongcoding left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jiwonnii 수정본 다시 봤습니다

전에 말씀드린 충전 타이머 유지랑 보드 정보 누락 시 이관 중단은 해결 확인했어요
로컬 PostgreSQL에서 전체 테스트 319개도 통과했습니다

다만 추가 주사위 카드 쪽에 한 군데만 더 봐주세요

주사위 2개에서 카드 사용 검사를 통과한 다음, 실제 지급 전에 자동 충전 시각이 되면 충전으로 3개가 찹니다
그러면 카드로 받는 주사위는 0개인데 카드는 사용 처리되고 응답도 성공으로 내려와요

로컬 API 처리와 DB 저장까지 확인했고, 카드 지급은 0개인데 사용 시각이 남는 걸 확인했습니다
추가 회귀 테스트 9개 중 이 케이스 1개가 실패했어요

지급 함수에서 돌려주는 실제 지급량을 카드 처리 쪽에서 확인하지 않고 있습니다
검사와 지급을 같은 시각 기준으로 처리하거나, 실제 지급이 없으면 카드를 남겨주시면 됩니다

충전 직전, 사용 검사와 지급 사이에 충전되는 경우, 충전 직후까지 테스트 추가 부탁드립니다
보드 잠금이 있어도 같은 요청 안에서 시간이 지나는 건 막지 못해서 이 부분은 따로 봐주셔야 해요

카드 사용 처리 부분

운영 배포 전 보드 정보 누락 사전 조회는 작성해주신 문서대로 확인 부탁드립니다

검토 기준은 c52c808이고, 이번에는 백엔드와 DB까지만 확인했습니다

@jongcoding jongcoding left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jiwonnii 수정본 확인했습니다

전에 말씀드린 주사위 충전 시점이 겹치면 보상 없이 카드만 소모되는 문제는 해결됐습니다
카드가 그대로 남고 다음 상태 조회에서 주사위도 정상 충전되는 것까지 확인했습니다

전체 테스트 327개랑 별도로 확인한 회귀 테스트 9개 모두 통과했고 CI도 6개 전부 성공했습니다
이번 PR은 추가 수정 요청 없이 머지 진행하셔도 될 것 같습니다

운영 배포 전에는 문서에 적어둔 보드 정보 누락 데이터 조회만 꼭 확인 부탁드립니다
프론트랑 스케줄러 실제 연동은 이번 검토에 포함되지 않았으니 별도로 확인하면 됩니다

@jiwonnii
jiwonnii merged commit ab21db8 into main Sep 10, 2026
6 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.

2 participants