Skip to content

#647 [Fix] 클래스 이미지 URL·커스텀 배틀 카테고리 태그·리포트 다음 걸음 중복 수정 - #648

Merged
si-zero merged 1 commit into
devfrom
fix/#647
Nov 19, 2026
Merged

si-zero merged 1 commit into
devfrom
fix/#647

Conversation

@si-zero

@si-zero si-zero commented Nov 19, 2026

Copy link
Copy Markdown
Member

#️⃣ 연관된 이슈

📝 작업 내용

클래스 QA에서 나온 이미지·태그·리포트 문구 문제 중 백엔드에서 바로 고칠 수 있는 부분을 수정했습니다.

✨ Feat

내용 파일
클래스 응답 이미지(배틀 썸네일·철학자·아바타)를 URL로 바꾸는 공용 컴포넌트 추가 ClassImageUrlResolver.java
토론 응답 philosopher.imageUrl, 주제 버전 옵션 philosopherImageUrl 추가 (기존 키 필드는 유지) ClassDebateResponse.java, ClassTopicVersionResponse.java, ClassTopicConverter.java, ClassDebateSessionService.java
커스텀 배틀 생성 시 주제 카테고리를 카테고리 태그로 연결 (예: #사회, 없으면 태그 생성) ClassCustomBattleFactory.java, TagRepository.java
기존 커스텀 배틀 카테고리 태그 백필 SQL + 롤백 V20261119_01__custom_battles_category_tags.sql, V20261119_rollback__custom_battles_category_tags.sql

♻️ Refactor

내용 파일
ClassTopicConverter를 정적 유틸에서 빈으로 변경 (이미지 URL 주입용) ClassTopicConverter.java, ClassTopicDraftService.java

🐛 Fix

내용 파일
클래스 명단 아바타가 User.characterUrl 그대로 나가던 문제 → 캐릭터 타입으로 이미지 URL 생성 (명단은 프로필 일괄 조회) ClassMemberServiceImpl.java, ClassMemberConverter.java, UserProfileRepository.java
클래스 목록·상세·참여 코드 확인 썸네일이 저장 키 그대로 나가던 문제 → URL 변환 ClassroomConverter.java, ClassroomServiceImpl.java, ClassMemberServiceImpl.java
개인 리포트 다음 생각할 걸음에 이미 한 주장이 다시 나오던 문제 → 프롬프트 규칙 7 추가 ClassReportPrompts.java
명세 갱신 docs/api-specs/class-api.md

📌 공유 사항

  1. 운영 DB에 V20261119_01__custom_battles_category_tags.sql을 실행해야 기존 커스텀 배틀에도 태그가 붙습니다. 멱등이라 재실행해도 안전합니다. 로컬 Postgres가 꺼져 있어 SQL은 실제 DB에서 실행해 보지 못했습니다.
  2. 커스텀 배틀 배경 이미지는 운영 환경변수 CLASS_CUSTOM_BATTLE_THUMBNAIL_URL이 비어 있으면 null입니다. 운영 값 설정 여부 확인이 필요합니다.
  3. 프론트는 철학자 이미지를 imageKey로 직접 찾지 말고 imageUrl/philosopherImageUrl을 쓰면 됩니다. 이후에도 칸트 얼굴이 다르면 S3 images/philosophers/kant.png 파일 문제입니다.
  4. 이번 범위에서 뺀 것: 내보내기 후 멤버 수(memberCount는 좌석 기준이라 기획 확인 필요), 참여 오류 문구(서버는 이미 404 CLASS_404_CODE / 409 CLASS_409_CLOSED로 구분), 화면 레이아웃 이슈.
  5. 카테고리 태그가 커스텀 배틀에 연결되면, 어드민에서 해당 태그 삭제 시 "사용 중" 검사에 걸립니다.

✅ 체크리스트

  • Reviewer에 팀원들을 선택했나요?
  • Assignees에 본인을 선택했나요?
  • 컨벤션에 맞는 Type을 선택했나요?
  • Development에 이슈를 연동했나요?
  • Merge 하려는 브랜치가 올바르게 설정되어 있나요?
  • 컨벤션을 지키고 있나요?
  • 로컬에서 실행했을 때 에러가 발생하지 않나요?
  • 팀원들에게 PR 링크 공유를 했나요?

📸 스크린샷

  • 전체 테스트 664건 통과 (클래스 227건 포함)

💬 리뷰 요구사항

  1. 카테고리 태그가 없을 때 새로 만드는 방식이 괜찮은지 의견 부탁드립니다.

@si-zero si-zero added the 🐛 Fix (버그 수정) 버그를 수정할 때 사용합니다. label Nov 19, 2026
@si-zero si-zero self-assigned this Nov 19, 2026
@si-zero
si-zero merged commit 7966cda into dev Nov 19, 2026
1 check passed
@si-zero
si-zero deleted the fix/#647 branch November 19, 2026 01:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🐛 Fix (버그 수정) 버그를 수정할 때 사용합니다.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

🐛 Fix: 클래스 QA 이미지 URL·커스텀 배틀 태그·리포트 다음 걸음 중복 수정

1 participant