Skip to content

feat(application): 우편번호 기반 발급 fallback 및 임시저장 원서 조회 추가 #399 - #457

Merged
kusuri12-09 merged 3 commits into
developfrom
feat/399-postal-fallback-draft-query
Oct 21, 2026
Merged

kusuri12-09 merged 3 commits into
developfrom
feat/399-postal-fallback-draft-query

Conversation

@kusuri12-09

Copy link
Copy Markdown
Member

Summary

  • 지원자 주소 검색 결과가 없으면 원서 우편번호의 대표 좌표로 거리를 계산해 수험번호 발급을 계속합니다.
  • GET /api/application/v11/applicants로 본인의 DRAFT 원서를 성적을 포함해 조회합니다.

Related Issue

Scope

  • In scope: 원서 우편번호 전달, 대표 좌표 조회 fallback, DRAFT 원서 조회 API, 관련 회귀 테스트
  • Out of scope: 카카오 장애 대응, 우편번호 좌표 데이터 갱신, 수험번호 정렬 정책 변경, 제출 원서 조회

Implementation

  • 주소 검색이 정상 응답의 빈 결과일 때만 postal_code_locations를 조회합니다. 대표 좌표를 기존 카카오 경로 요청의 출발지로 사용하며 기존 번호와 정렬 정책을 유지합니다.
  • 원서 요약 조회·관리자 모델·거리 포트까지 우편번호를 전달합니다. 주소 검색 성공 시 기존 좌표를 사용합니다.
  • 새 GET은 인증된 학생 본인의 계정으로 원서를 읽고 저장 입력값을 중첩 JSON으로 반환합니다. 미작성 값, 날짜 형식, 학기 순서와 기존 enum 값을 유지합니다.
  • DRAFT 외 상태는 APPLICATION_NOT_READABLE(400), 원서 없음은 APPLICANT_NOT_FOUND(404)입니다.
  • 조회는 읽기 전용이며 성적 재계산, 저장, 접수 기간 제한을 수행하지 않습니다. 기존 PATCH 응답은 유지합니다.

Testing

  • Unit tests
  • Integration tests
  • Manual verification
  • 우편번호 fallback 관련 Bazel 테스트 5개 대상 통과: 대표 좌표 사용, 검색 성공 시 대체 조회 생략, 기존 오류 유지, 우편번호 전달 및 발급 순서·기존 번호 보존을 확인했습니다.
  • 원서 조회 관련 application-adapter-in:test, application-application:test의 테스트 92개 통과. 부분 입력·성적·날짜 직렬화, 미인증·비학생·타인 원서 조회 차단, 모든 비DRAFT 상태 거부 및 조회 부작용 없음을 확인했습니다.
  • application-bootstrap:main 빌드 및 git diff --check 통과.
  • 실제 배포 환경과 실제 카카오 API 호출은 미검증입니다. 카카오 응답은 테스트 HTTP 서버로 검증했습니다.

Deployment Notes

  • Feature flag: 없음.
  • Migration required: 신규 마이그레이션 없음. #451의 V021 및 우편번호 대표 좌표 적재가 필요합니다.
  • Rollout considerations: 우편번호 누락·미등록 또는 카카오 통신·경로 오류는 기존 오류를 유지합니다. 조회 API는 DRAFT 상태만 허용합니다.

Checklist

  • Matches product/tech requirements
  • Backward compatibility considered
  • Docs updated if applicable

@coderabbitai

coderabbitai Bot commented Oct 20, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are limited based on label configuration.

🏷️ Required labels (at least one): 1
  • ready-for-review
🚫 Excluded labels (none allowed): 2
  • wip
  • do-not-review

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration
  • Configuration used: Repository: EntryDSM/entrydsm-platform/.coderabbit.yaml
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: b68546db-b2cc-40c3-a344-cf350685fe09

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@kusuri12-09
kusuri12-09 merged commit c45c601 into develop Oct 21, 2026
2 checks passed
@kusuri12-09
kusuri12-09 deleted the feat/399-postal-fallback-draft-query branch October 21, 2026 02:48
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