Repository navigation
[Feat/#187] 아카이빙 관련 링크를 행사 연결로 전환 - #191
Merged
Merged
Conversation
|
Important
This repository does not receive automatic reviews because it has fewer than 10 stars.
|
github-actions
Bot
requested review from
jjunh33,
leegain1,
tnals0924 and
xeoxxn
October 29, 2026 07:04
sangrae2325
force-pushed
the
feat/#187-archive-related-target
branch
from
October 29, 2026 08:24
66e385b to
7df969b
Compare
tnals0924
approved these changes
Oct 31, 2026
sangrae2325
force-pushed
the
feat/#187-archive-related-target
branch
from
November 2, 2026 08:51
bcd5f09 to
7a87f6b
Compare
This was referenced Nov 2, 2026
sangrae2325
added a commit
that referenced
this pull request
Nov 4, 2026
* feat: 홈 배너 분류와 노출 상태 추가 운영진 목록이 배너를 제휴와 그 밖으로 나눠 보여주고 필터를 거는데, 그 분류를 저장할 곳이 없었다. banner_type을 더한다. 이미지와는 무관한 값이다. 어떤 이미지를 쓸지는 image_file_id가 혼자 정하고 프리셋도 직접 업로드와 같이 files에 올려 식별자로 가리킨다. 랜딩 타입과도 다른 축이라 둘 중 어느 쪽에서도 파생할 수 없어 컬럼으로 둔다. 명세 초안은 유형이 5값인데 목록 필터는 2값이라 어긋나 있었다. 지금 화면이 제휴와 그 밖만 나누므로 2값으로 맞춘다. 노출 상태는 저장하지 않는다. LockerPeriodStatus처럼 노출 기간과 현재 시각으로 조회 시점에 판정한다. * feat: 홈 배너 운영진 조회 포트와 서비스 추가 노출이 끝나지 않은 배너는 전체를, 끝난 배너는 종료 일시 최신순 페이지를 돌려준다. 노출 중 목록은 순서를 드래그로 바꾸므로 페이지로 자르지 않는다. 노출 중과 노출 예정을 가르는 판정은 HomeBanner.calculateStatus에만 둔다. SQL은 끝났는지만 보고 구분은 도메인이 한다 — 같은 규칙이 두 곳에 있으면 어긋난다. 분류 필터는 IN에 빈 목록을 넘길 수 없어 findPublishedSlice와 같이 boolean 플래그로 끈다. HomeErrorCode는 internal 모듈의 첫 에러 코드다. * feat: 공지·행사 단건의 nullable 조회 추가 배너 상세가 연결된 공지·행사의 제목을 함께 내리는데, 기존 getById는 없으면 던지고 getPublishedEvent는 미게시 행사를 없는 것으로 본다. 그대로 쓰면 연결 대상이 지워졌거나 아직 공개 전인 배너는 상세가 통째로 404가 되어 고칠 수조차 없다. EventService.getByIdOrNull은 #187(PR #191)이 아카이빙의 연결 행사를 위해 더하는 것과 같은 메서드다. 이름을 맞춰 두면 그쪽이 머지될 때 한쪽만 지우면 된다. * feat: 홈 배너 운영진 조회 API 추가 노출 중 목록, 지난 배너 목록, 상세 셋이다. 탭마다 계약이 달라 엔드포인트를 나눴다 — 노출 중은 순서를 드래그로 바꿔 전체가 필요하고 지난 배너는 쌓이므로 페이지가 필요하다. 하나로 두면 statuses는 노출 중에서만, page·size는 지난 배너에서만 쓰여 파라미터 절반이 스코프에 따라 무의미해진다. 연결 공지·행사는 linkedTarget 하나로 합쳤다. 무엇인지는 landingType이 정하므로 항상 둘 중 하나가 null인 필드를 두 개 두지 않는다. 필터는 @ModelAttribute로 받는다. @RequestParam으로 enum을 받으면 잘못된 문자열에 500이 나간다. 목록은 now를 한 번만 읽어 전체에 넘긴다. 행마다 읽으면 한 응답 안에서 상태가 엇갈린다. * feat: 배너 상세에 등록 일시 추가 상세 화면이 등록일을 보여주는데 HomeBanner가 createdAt을 들고 있지 않았다. 컬럼은 BaseTimeEntity에 이미 있어 매핑만 더하면 된다. * refactor: 배너 분류 필터의 빈 목록 플레이스홀더 제거 빈 목록을 IN에 넘기면 깨진다고 보고 자리를 채우는 상수를 뒀는데 사실이 아니었다. StudentTransferStatusJpaRepository.search가 빈 목록을 그대로 넘기고 플래그로 끄며 운영에서 돌고 있다. 실제 MySQL로 확인했다. 플래그 극성도 그 선례에 맞춘다. filterAllTypes(참=필터 끔)는 조건문과 합쳐져 이중 부정이 됐다. filterByType(참=필터 켬)으로 뒤집는다. "아무 분류도 아님"을 뜻하던 상수가 GENERAL을 담고 있어, 쓰기 API가 재사용하면 조용히 GENERAL 필터가 될 위험도 있었다. * docs: 배너 상세의 미공개 행사 설명 정정 * refactor: 배너 분류를 카테고리로 변경 * fix: 홈 배너 카테고리 마이그레이션 버전을 V33에서 V34로 조정 * fix: 운영진 배너 목록의 노출 상태를 한 시각으로 판정하도록 수정 * refactor: 운영진 배너 조회 리뷰 반영 * docs: 배너 카테고리 마이그레이션 주석의 버전 번호 정정 * fix: 배너 카테고리 마이그레이션 버전을 V34에서 V35로 조정 * chore: 홈 배너 카테고리 마이그레이션 버전을 V44로 조정
sangrae2325
added a commit
that referenced
this pull request
Nov 4, 2026
* feat: 홈 배너 분류와 노출 상태 추가 운영진 목록이 배너를 제휴와 그 밖으로 나눠 보여주고 필터를 거는데, 그 분류를 저장할 곳이 없었다. banner_type을 더한다. 이미지와는 무관한 값이다. 어떤 이미지를 쓸지는 image_file_id가 혼자 정하고 프리셋도 직접 업로드와 같이 files에 올려 식별자로 가리킨다. 랜딩 타입과도 다른 축이라 둘 중 어느 쪽에서도 파생할 수 없어 컬럼으로 둔다. 명세 초안은 유형이 5값인데 목록 필터는 2값이라 어긋나 있었다. 지금 화면이 제휴와 그 밖만 나누므로 2값으로 맞춘다. 노출 상태는 저장하지 않는다. LockerPeriodStatus처럼 노출 기간과 현재 시각으로 조회 시점에 판정한다. * feat: 홈 배너 운영진 조회 포트와 서비스 추가 노출이 끝나지 않은 배너는 전체를, 끝난 배너는 종료 일시 최신순 페이지를 돌려준다. 노출 중 목록은 순서를 드래그로 바꾸므로 페이지로 자르지 않는다. 노출 중과 노출 예정을 가르는 판정은 HomeBanner.calculateStatus에만 둔다. SQL은 끝났는지만 보고 구분은 도메인이 한다 — 같은 규칙이 두 곳에 있으면 어긋난다. 분류 필터는 IN에 빈 목록을 넘길 수 없어 findPublishedSlice와 같이 boolean 플래그로 끈다. HomeErrorCode는 internal 모듈의 첫 에러 코드다. * feat: 공지·행사 단건의 nullable 조회 추가 배너 상세가 연결된 공지·행사의 제목을 함께 내리는데, 기존 getById는 없으면 던지고 getPublishedEvent는 미게시 행사를 없는 것으로 본다. 그대로 쓰면 연결 대상이 지워졌거나 아직 공개 전인 배너는 상세가 통째로 404가 되어 고칠 수조차 없다. EventService.getByIdOrNull은 #187(PR #191)이 아카이빙의 연결 행사를 위해 더하는 것과 같은 메서드다. 이름을 맞춰 두면 그쪽이 머지될 때 한쪽만 지우면 된다. * feat: 홈 배너 운영진 조회 API 추가 노출 중 목록, 지난 배너 목록, 상세 셋이다. 탭마다 계약이 달라 엔드포인트를 나눴다 — 노출 중은 순서를 드래그로 바꿔 전체가 필요하고 지난 배너는 쌓이므로 페이지가 필요하다. 하나로 두면 statuses는 노출 중에서만, page·size는 지난 배너에서만 쓰여 파라미터 절반이 스코프에 따라 무의미해진다. 연결 공지·행사는 linkedTarget 하나로 합쳤다. 무엇인지는 landingType이 정하므로 항상 둘 중 하나가 null인 필드를 두 개 두지 않는다. 필터는 @ModelAttribute로 받는다. @RequestParam으로 enum을 받으면 잘못된 문자열에 500이 나간다. 목록은 now를 한 번만 읽어 전체에 넘긴다. 행마다 읽으면 한 응답 안에서 상태가 엇갈린다. * feat: 배너 상세에 등록 일시 추가 상세 화면이 등록일을 보여주는데 HomeBanner가 createdAt을 들고 있지 않았다. 컬럼은 BaseTimeEntity에 이미 있어 매핑만 더하면 된다. * refactor: 배너 분류 필터의 빈 목록 플레이스홀더 제거 빈 목록을 IN에 넘기면 깨진다고 보고 자리를 채우는 상수를 뒀는데 사실이 아니었다. StudentTransferStatusJpaRepository.search가 빈 목록을 그대로 넘기고 플래그로 끄며 운영에서 돌고 있다. 실제 MySQL로 확인했다. 플래그 극성도 그 선례에 맞춘다. filterAllTypes(참=필터 끔)는 조건문과 합쳐져 이중 부정이 됐다. filterByType(참=필터 켬)으로 뒤집는다. "아무 분류도 아님"을 뜻하던 상수가 GENERAL을 담고 있어, 쓰기 API가 재사용하면 조용히 GENERAL 필터가 될 위험도 있었다. * docs: 배너 상세의 미공개 행사 설명 정정 * feat: 홈 배너 쓰기 도메인과 검증 추가 * feat: 홈 배너 저장 포트 추가 * feat: 홈 배너 운영진 쓰기 서비스 추가 * feat: 홈 배너 운영진 쓰기 API 추가 * refactor: 배너 분류를 카테고리로 변경 * refactor: 파일 업로드 정책을 Map에서 exhaustive switch로 변경 * refactor: 배너 쓰기를 카테고리 기반으로 변경 * fix: 홈 배너 카테고리 마이그레이션 버전을 V33에서 V34로 조정 * fix: 운영진 배너 목록의 노출 상태를 한 시각으로 판정하도록 수정 * refactor: 운영진 배너 조회 리뷰 반영 * fix: 배너 순서 변경에서 노출이 끝난 배너를 건너뛰도록 수정 * refactor: 배너 쓰기 리뷰 반영 * docs: 배너 카테고리 마이그레이션 주석의 버전 번호 정정 * fix: 배너 카테고리 마이그레이션 버전을 V34에서 V35로 조정 * chore: 홈 배너 카테고리 마이그레이션 버전을 V44로 조정
sangrae2325
added a commit
that referenced
this pull request
Nov 5, 2026
* feat: 홈 배너 분류와 노출 상태 추가 운영진 목록이 배너를 제휴와 그 밖으로 나눠 보여주고 필터를 거는데, 그 분류를 저장할 곳이 없었다. banner_type을 더한다. 이미지와는 무관한 값이다. 어떤 이미지를 쓸지는 image_file_id가 혼자 정하고 프리셋도 직접 업로드와 같이 files에 올려 식별자로 가리킨다. 랜딩 타입과도 다른 축이라 둘 중 어느 쪽에서도 파생할 수 없어 컬럼으로 둔다. 명세 초안은 유형이 5값인데 목록 필터는 2값이라 어긋나 있었다. 지금 화면이 제휴와 그 밖만 나누므로 2값으로 맞춘다. 노출 상태는 저장하지 않는다. LockerPeriodStatus처럼 노출 기간과 현재 시각으로 조회 시점에 판정한다. * feat: 홈 배너 운영진 조회 포트와 서비스 추가 노출이 끝나지 않은 배너는 전체를, 끝난 배너는 종료 일시 최신순 페이지를 돌려준다. 노출 중 목록은 순서를 드래그로 바꾸므로 페이지로 자르지 않는다. 노출 중과 노출 예정을 가르는 판정은 HomeBanner.calculateStatus에만 둔다. SQL은 끝났는지만 보고 구분은 도메인이 한다 — 같은 규칙이 두 곳에 있으면 어긋난다. 분류 필터는 IN에 빈 목록을 넘길 수 없어 findPublishedSlice와 같이 boolean 플래그로 끈다. HomeErrorCode는 internal 모듈의 첫 에러 코드다. * feat: 공지·행사 단건의 nullable 조회 추가 배너 상세가 연결된 공지·행사의 제목을 함께 내리는데, 기존 getById는 없으면 던지고 getPublishedEvent는 미게시 행사를 없는 것으로 본다. 그대로 쓰면 연결 대상이 지워졌거나 아직 공개 전인 배너는 상세가 통째로 404가 되어 고칠 수조차 없다. EventService.getByIdOrNull은 #187(PR #191)이 아카이빙의 연결 행사를 위해 더하는 것과 같은 메서드다. 이름을 맞춰 두면 그쪽이 머지될 때 한쪽만 지우면 된다. * feat: 홈 배너 운영진 조회 API 추가 노출 중 목록, 지난 배너 목록, 상세 셋이다. 탭마다 계약이 달라 엔드포인트를 나눴다 — 노출 중은 순서를 드래그로 바꿔 전체가 필요하고 지난 배너는 쌓이므로 페이지가 필요하다. 하나로 두면 statuses는 노출 중에서만, page·size는 지난 배너에서만 쓰여 파라미터 절반이 스코프에 따라 무의미해진다. 연결 공지·행사는 linkedTarget 하나로 합쳤다. 무엇인지는 landingType이 정하므로 항상 둘 중 하나가 null인 필드를 두 개 두지 않는다. 필터는 @ModelAttribute로 받는다. @RequestParam으로 enum을 받으면 잘못된 문자열에 500이 나간다. 목록은 now를 한 번만 읽어 전체에 넘긴다. 행마다 읽으면 한 응답 안에서 상태가 엇갈린다. * feat: 배너 상세에 등록 일시 추가 상세 화면이 등록일을 보여주는데 HomeBanner가 createdAt을 들고 있지 않았다. 컬럼은 BaseTimeEntity에 이미 있어 매핑만 더하면 된다. * refactor: 배너 분류 필터의 빈 목록 플레이스홀더 제거 빈 목록을 IN에 넘기면 깨진다고 보고 자리를 채우는 상수를 뒀는데 사실이 아니었다. StudentTransferStatusJpaRepository.search가 빈 목록을 그대로 넘기고 플래그로 끄며 운영에서 돌고 있다. 실제 MySQL로 확인했다. 플래그 극성도 그 선례에 맞춘다. filterAllTypes(참=필터 끔)는 조건문과 합쳐져 이중 부정이 됐다. filterByType(참=필터 켬)으로 뒤집는다. "아무 분류도 아님"을 뜻하던 상수가 GENERAL을 담고 있어, 쓰기 API가 재사용하면 조용히 GENERAL 필터가 될 위험도 있었다. * docs: 배너 상세의 미공개 행사 설명 정정 * feat: 홈 배너 쓰기 도메인과 검증 추가 * feat: 홈 배너 저장 포트 추가 * feat: 홈 배너 운영진 쓰기 서비스 추가 * feat: 홈 배너 운영진 쓰기 API 추가 * refactor: 배너 분류를 카테고리로 변경 * refactor: 파일 업로드 정책을 Map에서 exhaustive switch로 변경 * refactor: 배너 쓰기를 카테고리 기반으로 변경 * fix: 홈 배너 카테고리 마이그레이션 버전을 V33에서 V34로 조정 * fix: 운영진 배너 목록의 노출 상태를 한 시각으로 판정하도록 수정 * refactor: 운영진 배너 조회 리뷰 반영 * fix: 배너 순서 변경에서 노출이 끝난 배너를 건너뛰도록 수정 * refactor: 배너 쓰기 리뷰 반영 * docs: 배너 카테고리 마이그레이션 주석의 버전 번호 정정 * fix: 배너 카테고리 마이그레이션 버전을 V34에서 V35로 조정 * feat: 신청 가능한 행사·사물함 회차 전체 조회 추가 * feat: 홈 신청 섹션 설정 포트와 서비스 추가 * feat: 홈 신청 섹션 운영진 API 추가 * fix: 신청 섹션 순서 변경에서 같은 대상이 두 번 오면 거부 * fix: 신청 섹션 설정 저장에서 같은 대상 경합을 409로 막음 * refactor: 신청 끝나지 않은 사물함 회차 조회를 기존 쿼리에 합침 * refactor: 홈 신청 섹션 후보 조회를 운영진 서비스로 옮김 * refactor: 신청 섹션 저장의 제약 위반 변환을 한 곳으로 모음
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
#️⃣연관된 이슈
🎯 해결하려는 문제가 무엇인가요?
아카이빙에 붙는 관련 링크를 행사 참조로 바꿉니다. 관리자 화면이 드롭다운에서 행사를 고르면, 학생 앱 상세에서 눌러 그 행사로 이동할 수 있게 합니다.
❓ 왜 해결해야 하나요?
지금은
archive_related_links가 제목+URL 자유 링크를 여러 개 담습니다. 이 모양으로는 세 가지가 안 됩니다.StorageUrlBuilder는 파일 전용)⭐ 어떻게 해결했나요?
커밋 3개로 나눴고 각각 단독으로 컴파일됩니다.
1. 행사 단건 조회 경로 —
EventService.getByIdOrNull을 더합니다. 저장소에는 이미 같은 모양(EventRepository.findById)이 있고 서비스만 안 내보내고 있었습니다.기존
getPublishedEvent를 못 쓰는 이유가 둘입니다. 미게시 행사를 못 가져와 **운영진 화면에서도null**이 되고,EventDetail은 질문 목록·신청자 수까지 묶은 무거운 읽기 모델이라 제목 하나 쓰자고 끌어올 게 아닙니다.이름은
find~가 아니라getByIdOrNull입니다. 저장소 관행이find~는Optional인데 여기는Optional을 벗기기로 해서, 이름이 null 반환을 직접 드러내게 뒀습니다.2. 스키마·도메인 전환(V28) —
related_event_id하나를 더하고archive_related_links를 DROP합니다.ArchiveRelatedLink도메인·엔티티·리포지토리를 지웁니다.연결 대상이 행사뿐이라 컬럼 하나로 끝납니다. 종류를 함께 저장하는 다형 참조(
type+id)도, 그 짝을 묶는 VO도 필요 없습니다.related_event_id가NULL이면 연결 없음, 값이 있으면 연결 — 상태가 둘뿐이라 "둘 다 있거나 둘 다 없어야 한다" 같은 불변식 자체가 생기지 않습니다.3. 연결 행사 응답 — 관리자·학생 앱 상세에
relatedEvent를 담습니다. 제목은 조회할 때마다 원본에서 가져오므로 행사명을 고쳐도 항상 최신입니다. 아카이빙과 행사는 같은 모듈의 서로 다른 도메인이라 서비스끼리 부르지 않고api의 UseCase가 조합합니다(architecture.md6-1절).🧩 이 PR의 한계 & 트레이드오프
!event.isPublished())이고 나머지는 javadoc입니다.app-api와admin-api는 서로를 모르고, 공유하려면common-api가 event 도메인을 알아야 합니다 — #141에서Layout·LockerPeriodParams복제를 같은 이유로 승인하신 선례를 따랐습니다. 학생 앱은 미게시 행사를 숨기고 운영진은 보여주므로 앞으로 더 갈릴 자리이기도 합니다FileService를 직접 부릅니다.fileService직접 호출은 #40부터 있던 모양이고 저장소 전체가 같아서(AdminLockerSectionController등) 범위 밖으로 뒀는데, UseCase가 생기면서 비대칭이 새로 보이는 자리입니다ArchiveServiceImpl.getArchive에 레거시@Transactional(readOnly = true)가 남아 있습니다. 이 PR이 본문을 고치는 바로 그 메서드라 diff 바로 위에 찍힙니다. [Docs/#157] 조회 메서드 readOnly 트랜잭션 컨벤션 제거 #158 이후 새 코드에는 붙이지 않았고(EventService.getByIdOrNull), 기존 것은 #136에서 "이번 PR 범위가 아니라 그대로 두셔도 된다"고 하신 기준에 따라 남겨뒀습니다relatedEvent: null입니다. 끊어진 참조는 운영진이 그 아카이빙을 다시 저장할 때 정리되고, 지워진 행사로 가는 링크는 쓸모가 없어 구분할 값이 없다고 봤습니다AGENTS.md원칙에 따랐습니다⛓️ 기존 기능에 미치는 영향
relatedLinks: [{title, url}]→relatedEvent: {eventId, title}. 앱이 아직 아카이빙 API를 붙이지 않고 목업으로만 그리고 있어 조율 비용이 없습니다EventService에 메서드가 하나 늘어납니다. 기존 메서드 동작은 그대로입니다.NoticeService는 건드리지 않습니다archive_related_links가 사라집니다. 이 PR 전에는 관리자 API로 넣을 수단이 없어 손으로 넣은 행만 있을 수 있습니다EventService.getByIdOrNull은 미게시 행사도 돌려줍니다. 감추는 일은 부르는 쪽이Event.isPublished()로 합니다. 관리자 행사 등록·조회·수정 API 추가 #135·#137이AdminEventService를 만들면 이 메서드가 그쪽으로 옮겨갈 수 있습니다🔀 Edge Case & 실패 시나리오
relatedEvent가nullrelatedEvent가null(아카이빙은 정상 조회)null, 관리자는 제목을 보여준다📋 검토한 대안과 선택 이유
type+id)로 두기: 처음엔 그렇게 만들었다가 접었습니다. 팀에서 연결 대상은 행사면 충분하다고 정리돼서, 컬럼 하나로 줄이고 enum·VO·NoticeService변경을 전부 걷어냈습니다. 나중에 공지도 필요해지면related_target_type을 더하고 기존 행을 백필하면 됩니다archive_related_links에event_id를 더해 재활용하기:title·url이NOT NULL인데 행사에는 URL이 없고,display_order는 한 건만 쓰면 의미가 없어집니다. 조회할 때 테이블을 한 번 더 읽어야 하는 것도 있고요common-api로 합치기: #141에서 같은 종류의 중복을 복제로 두기로 하신 판단을 따랐습니다💬 리뷰 포인트
[c]archive_related_linksDROP 전에 행 수를 확인해야 합니다. 저장소 첫DROP TABLE이고 되돌릴 수 없습니다. 연결은 행사 한 건이면 충분하다고 정해서 옮기는 백필을 두지 않았는데, dev에 행이 있으면 적용 전에 손으로 옮겨야 합니다[c]V28 번호와 머지 순서 — [Feat/#185] 아카이빙 목록·상세 조회 관리자 API 추가 #188(V27) 다음입니다.outOfOrder가 꺼져 있어서 선행 PR이 밀리면 이 번호도 같이 밀립니다[a]두 모듈의 UseCase·record 복제를 그대로 둘지 봐주세요. 한 줄(미게시 행사 처리)이 이미 갈려 있어 앞으로 더 달라질 자리라고 봤습니다로컬에서 Docker로 MySQL 8을 띄워 마이그레이션 21개를 순서대로 적용하고
ddl-auto: validate까지 통과하는 것을 확인했습니다 — 엔티티 삭제와DROP TABLE이 어긋나면 기동이 막히는 변경이라 직접 돌려봤습니다.