134 feat: 복수 전공, 편입생 예외 처리 추가 #147

pp8817 · 2026-01-09T14:24:18Z

ISSUE #134

변경 사항

졸업 요건 조회 시 복수전공 케이스 처리 로직 추가
졸업 요건 데이터 부재 시
- 전공 유형(SINGLE / DUAL)
- 주전공 / 복수전공 ID
  를 MDC에 기록하고 Sentry 태그로 승격
편입생(Transfer Student) 졸업 요건 미지원 케이스 명시적 예외 처리
GraduationService 내 졸업 요건 조회 흐름을 메서드 단위로 분리하여 책임 정리

변경 의도

복수전공 학생의 졸업 요건 계산을 명확히 지원
졸업 요건 데이터 누락 이슈 발생 시 원인 추적 가능성 강화
전공 케이스별 분기 로직의 가독성과 유지보수성 개선

영향 범위

졸업 요건 조회 API
오류 발생 시 로그 / Sentry 이벤트 메타데이터
기존 단일 전공 동작은 유지

참고 사항

P1: 꼭 반영해주세요 (Request changes)
P2: 적극적으로 고려해주세요 (Request changes)
P3: 웬만하면 반영해 주세요 (Comment)
P4: 반영해도 좋고 넘어가도 좋습니다 (Approve)
P5: 그냥 사소한 의견입니다 (Approve)

🔗 Related Issue

Closes #134

- 편입생 판별법: 학법 앞 2자리, 입학년도 뒷 2자리 비교

gemini-code-assist · 2026-01-09T14:24:40Z

Summary of Changes

Hello @pp8817, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

이 Pull Request는 졸업 요건 조회 시스템의 견고성과 확장성을 크게 개선합니다. 복수전공 학생들의 졸업 요건 계산을 정확하게 지원하고, 편입생에 대한 명시적인 예외 처리를 통해 현재 지원 범위를 명확히 합니다. 또한, 졸업 요건 데이터 누락과 같은 중요한 오류 발생 시 상세한 진단 정보를 제공하여 문제 해결 시간을 단축하고, 서비스 코드의 구조를 개선하여 향후 기능 추가 및 유지보수를 용이하게 합니다.

Highlights

복수전공 졸업 요건 처리 로직 추가: 복수전공 학생의 졸업 요건 조회 시, 주전공과 복수전공의 요건을 병합하여 처리하는 로직이 추가되었습니다. 주전공의 전선/일선 과목은 제외하고 복수전공 요건과 합산하여 계산합니다.
편입생 졸업 요건 미지원 예외 처리: 편입생의 경우 현재 졸업 요건 조회를 지원하지 않으므로, 편입생 여부를 학번과 입학년도를 통해 판단하여 명시적인 예외를 발생시키도록 처리했습니다. 추후 편입생 졸업 요건 지원 시 해당 로직은 제거될 예정입니다.
졸업 요건 데이터 부재 시 MDC 및 Sentry 태그 강화: 졸업 요건 데이터가 존재하지 않을 경우, 학생 코드, 입학년도, 주전공/복수전공 ID, 전공 유형(단일/복수) 등의 상세 정보를 MDC(Mapped Diagnostic Context)에 기록하고, 이를 Sentry 이벤트의 태그로 승격시켜 문제 발생 시 원인 추적을 용이하게 했습니다.
GraduationService 책임 분리 및 가독성 개선: GraduationService 내 졸업 요건 조회 흐름을 validateTransferStudent, resolvePrimaryMajorId, resolveAreaProgress, getSingleMajorProgressOrThrow, getDualMajorProgressOrThrow, throwGraduationRequirementNotFound 등의 메서드 단위로 분리하여 각 메서드의 책임을 명확히 하고 코드의 가독성과 유지보수성을 향상시켰습니다.
MDC 컨텍스트 자동 정리 필터 추가: 요청 처리 후 MDC 컨텍스트가 자동으로 정리되도록 MdcCleanupFilter를 추가하여 잠재적인 메모리 누수나 잘못된 로그 정보 주입을 방지했습니다.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	`/gemini review`	Performs a code review for the current pull request in its current state.
Pull Request Summary	`/gemini summary`	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	`/gemini help`	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

gemini-code-assist

Code Review

이 pull request는 복수 전공 및 편입생에 대한 졸업 요건 조회 로직을 개선하고, 관련 예외 처리 및 로깅을 강화하는 훌륭한 변경입니다. 특히 GraduationService를 여러 책임 단위의 메서드로 분리하여 코드 가독성과 유지보수성을 크게 향상했습니다. 또한 MdcCleanupFilter를 추가하여 MDC 컨텍스트를 안정적으로 관리하도록 개선한 점도 좋습니다. 몇 가지 코드 명확성과 일관성을 더 높일 수 있는 부분을 제안합니다.

gemini-code-assist · 2026-01-09T14:26:42Z

src/main/java/com/chukchuk/haksa/domain/graduation/service/GraduationService.java

+        try {
+            return graduationQueryRepository.getDualMajorAreaProgress(
+                    studentId, primaryMajorId, secondaryMajorId, admissionYear
+            );
+        } catch (CommonException e) {
+            if (ErrorCode.GRADUATION_REQUIREMENTS_DATA_NOT_FOUND.code().equals(e.getCode())) {
+                throwGraduationRequirementNotFound(
+                        student,
+                        primaryMajorId,
+                        secondaryMajorId,
+                        admissionYear
+                );
+            }
+            throw e;
+        }


getDualMajorProgressOrThrow 메서드 내 catch 블록의 구조가 다소 혼란을 줄 수 있습니다. throwGraduationRequirementNotFound 메서드는 항상 예외를 던지지만, 반환 타입이 void이기 때문에 코드 흐름을 파악하기 어렵습니다. 이로 인해 if 블록 다음에 오는 throw e;가 어떤 조건에서 실행되는지 즉시 이해하기 힘듭니다.

코드의 명확성을 높이기 위해 throwGraduationRequirementNotFound 메서드가 예외 객체를 생성하여 반환하고(newGraduationRequirementNotFoundException 등으로 이름 변경), 호출하는 쪽에서 throw 하도록 수정하는 것을 제안합니다. 이렇게 하면 제어 흐름이 명확해지고, 메서드의 역할(예외 생성)이 이름에 더 잘 드러나 유지보수성이 향상됩니다.

아래는 getDualMajorProgressOrThrow 메서드에 대한 제안이며, throwGraduationRequirementNotFound 메서드와 getSingleMajorProgressOrThrow의 호출 부분도 함께 수정되어야 합니다.

Suggested change

try {

return graduationQueryRepository.getDualMajorAreaProgress(

studentId, primaryMajorId, secondaryMajorId, admissionYear

);

} catch (CommonException e) {

if (ErrorCode.GRADUATION_REQUIREMENTS_DATA_NOT_FOUND.code().equals(e.getCode())) {

throwGraduationRequirementNotFound(

student,

primaryMajorId,

secondaryMajorId,

admissionYear

);

}

throw e;

}

try {

return graduationQueryRepository.getDualMajorAreaProgress(

studentId, primaryMajorId, secondaryMajorId, admissionYear

);

} catch (CommonException e) {

if (ErrorCode.GRADUATION_REQUIREMENTS_DATA_NOT_FOUND.code().equals(e.getCode())) {

throw newGraduationRequirementNotFoundException(

student,

primaryMajorId,

secondaryMajorId,

admissionYear

);

}

throw e;

}

gemini-code-assist · 2026-01-09T14:26:42Z

src/main/java/com/chukchuk/haksa/domain/graduation/service/GraduationService.java

+    private List<AreaProgressDto> getSingleMajorProgressOrThrow(
+            Student student,
+            UUID studentId,
+            Long departmentId,


getSingleMajorProgressOrThrow 메서드의 파라미터 이름인 departmentId를 primaryMajorId로 변경하는 것을 제안합니다. 이 메서드를 호출하는 resolveAreaProgress에서 primaryMajorId를 전달하고 있으며, 다른 메서드들(getDualMajorProgressOrThrow 등)에서도 일관되게 primaryMajorId라는 이름을 사용하고 있어 코드의 통일성과 가독성을 높일 수 있습니다.

Suggested change

Long departmentId,

Long primaryMajorId,

gemini-code-assist · 2026-01-09T14:26:42Z

src/main/java/com/chukchuk/haksa/domain/graduation/service/GraduationService.java

+
+    /**
+     * 졸업 요건 부재 예외 처리 메서드
+     * MDC 정리는 GlobalExceptionHandler에서 수행됨


Javadoc 주석에 "MDC 정리는 GlobalExceptionHandler에서 수행됨"이라고 명시되어 있지만, 이번 변경으로 추가된 MdcCleanupFilter가 실제 MDC 정리 작업을 수행합니다. 주석의 내용이 현재 구현과 일치하지 않으므로, MdcCleanupFilter에서 처리된다는 내용으로 수정하거나, 구체적인 구현을 명시하기보다 "요청 처리 마지막에 정리됨"과 같이 좀 더 일반적인 내용으로 변경하는 것이 좋겠습니다.

Suggested change

* MDC 정리는 GlobalExceptionHandler에서 수행됨

* MDC는 요청 처리 마지막에 MdcCleanupFilter에 의해 정리됨

gemini-code-assist · 2026-01-09T14:26:42Z

src/main/java/com/chukchuk/haksa/global/exception/code/ErrorCode.java

    STUDENT_NOT_FOUND("S01", "해당 학생이 존재하지 않습니다.", HttpStatus.NOT_FOUND),
    INVALID_TARGET_GPA("S02", "유효하지 않은 목표 학점입니다.", HttpStatus.BAD_REQUEST),
    STUDENT_ID_REQUIRED("S03", "Student ID는 필수입니다.", HttpStatus.BAD_REQUEST),
+    TRANSFER_STUDENT_UNSUPPORTED("T13", "편입생 학적 정보는 현재 지원되지 않습니다.", HttpStatus.UNPROCESSABLE_ENTITY),


TRANSFER_STUDENT_UNSUPPORTED 오류 코드의 prefix가 T로 시작하여 토큰 관련 오류(Token)와 혼동될 수 있습니다. 학생(Student) 관련 오류 코드들은 S prefix를 사용하고 있으므로, 일관성을 위해 S04와 같이 S prefix를 사용하는 코드로 변경하는 것을 권장합니다. 이는 오류 코드를 관리하고 식별하는 데 도움이 됩니다.

Suggested change

TRANSFER_STUDENT_UNSUPPORTED("T13", "편입생 학적 정보는 현재 지원되지 않습니다.", HttpStatus.UNPROCESSABLE_ENTITY),

TRANSFER_STUDENT_UNSUPPORTED("S04", "편입생 학적 정보는 현재 지원되지 않습니다.", HttpStatus.UNPROCESSABLE_ENTITY),

hoooonshub

일단 피드백은 남겼는데 바로 approve는 해둘게!!

hoooonshub · 2026-01-12T23:54:49Z

src/main/java/com/chukchuk/haksa/domain/graduation/repository/GraduationQueryRepository.java

+        if (primaryFiltered.isEmpty()) {
+            throw new CommonException(ErrorCode.GRADUATION_REQUIREMENTS_DATA_NOT_FOUND);
+        }
+
+        // 복수전공 졸업 요건 조회
        List<AreaRequirementDto> dualMajorReqs = getDualMajorRequirementsWithCache(primaryMajorId, secondaryMajorId, admissionYear);

+        // 복수 전공 졸업 요건 데이터 부재 시 404 예외 처리
+        if (dualMajorReqs == null || dualMajorReqs.isEmpty()) {
+            throw new CommonException(ErrorCode.GRADUATION_REQUIREMENTS_DATA_NOT_FOUND);
+        }
+


여기서 주전공이랑 복수전공이랑 예외 똑같이 놔두면 이슈에서 작성해준 '복수전공 정보 누락인 422 예외'는 못 던지는거 아니야? 여기서는 다른 상황이야?

이슈에 있는 복수전공 정보 누락 422 예외는 운영 서버에만 적용되는 사항입니다.
dev에는 복수전공에 대한 처리가 되어 있기 때문에, 졸업 요건 분석 로직에서
단일 전공, 복수 전공 각각의 경우로 예외 처리를 나누지 않고, 동일한 예외 처리를 한 후

졸업 요건 부재 예외 처리 메서드인 GraduationService.throwGraduationRequirementNotFound에서 단일/복수 전공 별 분기 처리를 통해 MDC 값을 다르게 주입하여 판별 가능하도록 했습니다.

hoooonshub · 2026-01-12T23:55:45Z

src/main/java/com/chukchuk/haksa/global/exception/code/ErrorCode.java

+    // 졸업 요건 관련
+    GRADUATION_REQUIREMENTS_NOT_FOUND("G01", "졸업 요건 정보를 찾을 수 없습니다.", HttpStatus.NOT_FOUND),
+    GRADUATION_REQUIREMENTS_DATA_NOT_FOUND("G02", "사용자에게 맞는 졸업 요건 데이터가 존재하지 않습니다.", HttpStatus.NOT_FOUND),
+


혹시 요거 두 개가 의미적으로 어떤 차이가 있어? 똑같아보여서 의미 크게 다르지 않으면 합치는 게 낫지 않을까 싶어. 헷갈리는 거 같아

기존에 사용하던게 G01인데, 혹시 몰라서 유지하긴 했어요
이제 사용 안하는 G01을 제거하겠습니다

hoooonshub · 2026-01-12T23:56:38Z

src/main/java/com/chukchuk/haksa/global/exception/code/ErrorCode.java

    STUDENT_NOT_FOUND("S01", "해당 학생이 존재하지 않습니다.", HttpStatus.NOT_FOUND),
    INVALID_TARGET_GPA("S02", "유효하지 않은 목표 학점입니다.", HttpStatus.BAD_REQUEST),
    STUDENT_ID_REQUIRED("S03", "Student ID는 필수입니다.", HttpStatus.BAD_REQUEST),
+    TRANSFER_STUDENT_UNSUPPORTED("T13", "편입생 학적 정보는 현재 지원되지 않습니다.", HttpStatus.UNPROCESSABLE_ENTITY),


제미나이 피드백처럼 T13으로 둔 이유가 있어? 학생 예외면 S로 두는 게 더 직관적이 않을까 싶은데, 어떻게 생각해?

저도 그 피드백을 받고 S로 두는게 더 좋을것 같긴 한데, 클라이언트에서 처리한 다음이라서 마음대로 바꿨다가 문제 생길 것 같아서 우선 건드리지는 않았어요.
프론트 쪽과 소통한 후 문제가 없다면 S04 정도로 변경하는게 좋아보입니다!

pp8817 added 7 commits January 9, 2026 13:55

134 feat: 예외 처리에 필요한 ErrorCode 추가

e473e34

134 feat: 졸업 요건 부재 시 404 예외 처리

6667d24

134 feat: 경우를 대비한 방어 코드 추가

2ffa569

134 feat: 에외 Sentry 전송 시 MDC에 단일/복수 전공 정보 추가

570b80d

134 feat: 요청 종료 시 MDC 정리 필터 추가로 로그 컨텍스트 누수 방지

5737698

134 feat: 편입생 예외 처리 추가

53fa6ea

- 편입생 판별법: 학법 앞 2자리, 입학년도 뒷 2자리 비교

134 refactor: 졸업 요건 조회 로직을 메서드 단위로 분리

1825451

pp8817 requested a review from hoooonshub as a code owner January 9, 2026 14:24

pp8817 self-assigned this Jan 9, 2026

pp8817 added the ✨ Feature 기능 개발 label Jan 9, 2026

gemini-code-assist bot reviewed Jan 9, 2026

View reviewed changes

hoooonshub approved these changes Jan 12, 2026

View reviewed changes

pp8817 merged commit 108c6f3 into dev Jan 13, 2026
4 checks passed

pp8817 deleted the feat/134-2 branch January 13, 2026 07:55

	* MDC 정리는 GlobalExceptionHandler에서 수행됨
	* MDC는 요청 처리 마지막에 MdcCleanupFilter에 의해 정리됨

	TRANSFER_STUDENT_UNSUPPORTED("T13", "편입생 학적 정보는 현재 지원되지 않습니다.", HttpStatus.UNPROCESSABLE_ENTITY),
	TRANSFER_STUDENT_UNSUPPORTED("S04", "편입생 학적 정보는 현재 지원되지 않습니다.", HttpStatus.UNPROCESSABLE_ENTITY),

134 feat: 복수 전공, 편입생 예외 처리 추가 #147

134 feat: 복수 전공, 편입생 예외 처리 추가 #147

Conversation

pp8817 commented Jan 9, 2026 • edited by github-actions bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

참고 사항

🔗 Related Issue

Uh oh!

gemini-code-assist bot commented Jan 9, 2026

Summary of Changes

Highlights

Footnotes

Uh oh!

gemini-code-assist bot left a comment

Choose a reason for hiding this comment

Code Review

Uh oh!

gemini-code-assist bot Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

gemini-code-assist bot Jan 9, 2026

Choose a reason for hiding this comment

Uh oh!

hoooonshub left a comment

Choose a reason for hiding this comment

Uh oh!

hoooonshub Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

pp8817 Jan 13, 2026

Choose a reason for hiding this comment

Uh oh!

hoooonshub Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

pp8817 Jan 13, 2026

Choose a reason for hiding this comment

Uh oh!

hoooonshub Jan 12, 2026

Choose a reason for hiding this comment

Uh oh!

pp8817 Jan 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

pp8817 commented Jan 9, 2026 •

edited by github-actions bot

Loading