Skip to content

feat(koth): 참가자 접속 URL 추가 및 채점 통신·계약 보완 - #57

Merged
jiwonnii merged 6 commits into
mainfrom
feat/koth-challenge-url
Sep 10, 2026
Merged

jiwonnii merged 6 commits into
mainfrom
feat/koth-challenge-url

Conversation

@jiwonnii

@jiwonnii jiwonnii commented Sep 6, 2026 •

Copy link
Copy Markdown
Collaborator

KOTH 조회 응답에 참가자 접속 주소를 추가하고 채점 통신과 중복 수집 처리를 보완합니다. 같은 구간의 동시 수집 중 늦게 실패한 요청이 완료 상태를 덮어써 점수를 두 번 지급하던 문제와, data가 누락된 응답이 전체 채점 배치를 중단하던 문제를 수정합니다.

변경 사항

  • 선택 입력 가능한 challenge_url 필드와 0005 마이그레이션을 추가합니다. 목록·동아리 상세·내 진행 응답에 주소를 포함하며, 미등록·삭제 시 null을 반환합니다. HTTP(S) 주소의 포트·경로·쿼리를 보존하고 내부 채점 주소와 인증 정보는 노출하지 않습니다.
  • 채점 요청은 HTTP(S) 최종 주소로만 통신하며 리다이렉트를 따라가지 않습니다. 기존 쿼리와 요청 구간을 올바르게 결합하고, IPv6 기본·명시 포트 및 연결 생성 오류를 처리합니다. 출제자 checker도 리다이렉트를 실패로 처리합니다.
  • 완료된 채점 구간은 동시 요청의 늦은 실패가 덮어쓰지 못하도록 DB 갱신 조건을 제한합니다. 이미 반영됐다면 뒤늦은 요청은 추가 지급 없이 종료합니다. 성공 후 실패·실패 후 성공·동시 성공의 순서를 고정해 검증합니다.
  • 점수 응답의 data 필드를 필수로 검사합니다. 누락 시 실패 기록·설정된 재시도·다음 문제 수집을 수행하며, 정상 data: null 응답은 계속 허용합니다.
  • PR feat(koth): add KOTH platform APIs #20·#55에서 요청한 KOTH 오류코드 5개와 HTTP 상태를 공통 계약에 등록합니다. PR #6의 429·30초 제한이 문제 서버의 참가자 세션/IP 정책임을 템플릿에 명시합니다.
  • #29가 병합된 최신 main (ab21db8)을 포함하며 PR 기준은 main입니다.

검증

  • 2026-09-10, PostgreSQL 16에서 최신 main을 포함한 전체 테스트 347개 통과.
  • 이번 회귀 테스트 5개 추가. 수정 전 3개가 실패했고 수정 후 5개 모두 통과했습니다. 동시 채점 이후 재시도에서도 40점이 40점으로 유지되고, 최초 완료 결과·시각·오류 상태가 보존됩니다.
  • 실제 로컬 HTTP 서버로 data 누락 실패 기록, 정상 null로 재시도 복구, 재시도 소진 후 다음 문제 수집을 검증했습니다. 관련 HTTP·IPv6·새 회귀 테스트 18개 통과.
  • 세 API의 URL 미등록·등록·삭제·내부 정보 미노출, HTTP(S) 입력 검증 및 기존 migration 회귀 검사 통과.
  • 실제 로컬 서버로 301/302/303/307/308 거부, 내부 인증 토큰 미전달, 기존 쿼리·구간 결합 및 checker 동작 검증.
  • Django 시스템 검사, makemigrations --check --dry-run, flake8 핵심 오류 검사, git diff --check 통과.
  • 최종 커밋 7102106의 GitHub CI 및 상태 검사 6개 모두 통과.

적용

  • 배포 시 python manage.py migrate를 실행하고 확정된 참가자 접속 주소를 Django 관리자에서 등록합니다.
  • 프론트는 status === "ACTIVE"이고 URL이 있을 때 접속 버튼을 활성화합니다.
  • 내부 score_api_url에는 리다이렉트 없는 최종 HTTP(S) 채점 주소를 등록합니다. 상세 규칙은 docs/koth-challenge-url.md에 있습니다.

API 명세

@jongcoding

Copy link
Copy Markdown
Contributor

접속 주소가 목록, 상세, 내 진행 상태에 내려오는 것 확인했습니다
주소를 비우면 null로 반환하고, 등록한 포트와 경로 및 쿼리도 그대로 유지됩니다
별도 PostgreSQL에서 기존 앱 테스트 254개가 모두 통과했습니다
추가로 관리자 폼에서 주소 입력, 500자 제한, 주소 삭제, 기존 데이터가 있는 DB의 마이그레이션도 확인했습니다
이번 URL 추가에서 별도로 수정할 기능 문제는 찾지 못했습니다
다만 현재는 #55 브랜치를 기준으로 해서 CI가 실행되지 않은 상태입니다
#55를 먼저 합친 뒤 #57의 기준을 main으로 맞추고, 최신 main과 합친 상태에서 CI가 실제로 실행되고 통과하는지 확인 부탁드립니다
배포할 때 마이그레이션 적용과 실제 참가자 접속 주소 등록도 챙겨주세요
프론트에서 ACTIVE 상태이면서 주소가 있을 때 접속 버튼을 켜는 작업은 별도 연결이 필요합니다

@jiwonnii
jiwonnii changed the base branch from feat/koth-leaderboard to main September 7, 2026 12:34
@jiwonnii jiwonnii changed the title feat: KOTH 참가자 접속 URL 필드 추가 feat(koth): 참가자 접속 URL 추가 및 채점 통신·계약 보완 Sep 10, 2026

@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 수정본 확인했습니다

이번 PR은 확인한 변경 범위에서 머지를 막을 기능 문제는 없어서 머지 진행하셔도 될 것 같습니다

접속 주소 등록·삭제와 기존 데이터 이관, 같은 구간 중복 채점과 실패 후 재시도까지 확인했습니다
KOTH 원본 34개와 추가 검증 9개 모두 통과했고 최신 CI도 6개 성공했습니다

다만 하네스용 KOTH 명세에는 새 접속 주소 필드가 빠져 있어서 목록·상세·내 팀 응답 예시는 최신화 부탁드립니다
이건 머지를 막을 건은 아니고 별도 문서 수정으로 진행하시면 됩니다

배포할 때 migration 적용과 실제 접속 주소 등록은 챙겨주세요
프론트 버튼과 실제 출제 서버 연동은 별도 확인이 필요합니다
전체 347개 로컬 실행은 중도 종료했고, 이번 의견은 완료한 위 43개 검증과 최신 CI 기준입니다

@jiwonnii
jiwonnii merged commit c0714f1 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