Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
160 commits
Select commit Hold shift + click to select a range
a3c9a37
#250 [Fix] 투표 비율 계산 기준을 preVoteOption에서 postVoteOption으로 수정 (#252)
HYH0804 May 27, 2026
a38c141
#254 [Refactor] 관점 등록/수정 시 GPT 검수 코드 제거 (#256)
HYH0804 Jun 3, 2026
cee2c5d
#255 [Refactor] VoteStatsResponse OptionStat에 title 필드 추가 (#257)
HYH0804 Jun 3, 2026
53533b8
#258 [Feat] 출석체크 API 추가
si-zero Jun 3, 2026
77db7a1
#260 [Feat] 스웨거 어드민/유저 분리
si-zero Jun 4, 2026
a9d4293
[Feat] 알림기능 (#263)
HYH0804 Jun 11, 2026
b5a681b
#262 [Fix] APNs 자격증명 S3 다운로드 시 임시파일 충돌 오류 수정
HYH0804 Jun 11, 2026
d281fa3
#264 [Fix] AdMob SSV 포인트 미적립 버그 수정
si-zero Jun 11, 2026
968d6a3
#262 merge (#266)
HYH0804 Jun 14, 2026
d041631
[Chore] adMob 크롤링 파일 설정: adMob 크롤링 파일 설정 #269
si-zero Jun 16, 2026
ec25882
#270 [Feat] 설정 파일 추가
si-zero Jun 16, 2026
4c45999
[Chore] JWT필터 설정 #271
si-zero Jun 16, 2026
e0c9c1c
#275 [Fix] AdMob SSV 콜백 파라미터 optional 처리 및 서명 검증 활성화
si-zero Jun 18, 2026
ab2cb78
#277 [Fix] AdMob SSV 콜백 URL 검증 요청 처리 실패
si-zero Jun 18, 2026
04d947c
#279 [Fix] AdMob SSV 엔드포인트 검증 실패 시 항상 200 반환
si-zero Jun 18, 2026
d9ea3b5
#283 [Fix] /me/content-activities voteSide null 반환 버그
si-zero Jun 19, 2026
ec27b01
#285 [Feat] content-activities 응답에 option_title 필드 추가
si-zero Jun 20, 2026
6663e7a
#287 [Fix] AdMob SSV 서명 검증 오류로 인한 포인트 미지급 버그
si-zero Jun 24, 2026
39aca84
#289 [Fix] 오늘의 배틀 개수 변경
si-zero Jul 5, 2026
11e2da1
#293 [Fix] 사전투표 철학자 아이콘 미노출
si-zero Jul 5, 2026
aa449f0
#297 [Fix] 댓글 작성 시각이 9시간 전으로 표시되는 버그
si-zero Jul 6, 2026
3259a1a
#301 [Fix] robots.txt 파일 부재로 AdMob app-ads.txt 크롤링 차단
si-zero Jul 6, 2026
e91819b
#305 [Fix] S3 오디오 조각 재다운로드 시 FileAlreadyExistsException으로 TTS 파이프라인 실패
si-zero Jul 6, 2026
d64d5ca
#309 [Fix] JwtFilter 자체 화이트리스트에 /robots.txt 누락으로 401 발생
si-zero Jul 6, 2026
ff16d85
#316 [Fix] 포인트 정책표 대비 코드 불일치 4건 수정
si-zero Jul 7, 2026
f50c749
Merge branch 'main' into dev
si-zero Jul 7, 2026
d9e28a1
#321 [Feat] 알림 미읽음 여부 확인 API 추가
si-zero Jul 7, 2026
4279341
#313 [Hotfix] Railway 배포 환경 FFmpeg 자동 설치 적용 (#320)
jucheonsu Jul 7, 2026
f77048c
#327 [Fix] 알림 전체 읽음 처리 후 모두 읽음 신호가 전달되지 않던 문제 수정
si-zero Jul 13, 2026
99886f9
#331 [Docs] 출석체크 API 명세서를 실제 코드에 맞춰 갱신
si-zero Jul 13, 2026
087b8c0
#333 [Fix] app-ads.txt가 text/html로 응답되어 AdMob 크롤러가 무시하는 문제 수정
si-zero Jul 13, 2026
d33ff1f
#337 [Feat] 인앱 알림 테스트용 API 추가
si-zero Jul 14, 2026
17f35a4
#341 [Fix] 미문서화/중복 포인트 지급 로직 정리
si-zero Jul 15, 2026
acbe078
관리자 페이지를 새 admin-web(Next.js) 앱으로 리다이렉트 (#346)
Jul 15, 2026
de75bdf
#349 [Feat] admin.web.url env 주입 + 기본값 picke.up.railway.app (#350)
Jul 15, 2026
9493351
#352 [Fix] JwtFilter 화이트리스트 /api/v1/auth 전체 매칭으로 logout 인증 우회, 500 에러 발생
si-zero Jul 16, 2026
00bfcb3
#356 [Feat] 이용약관/개인정보처리방침 페이지 백엔드 서빙
si-zero Jul 20, 2026
99c936d
#361 [Feat] 관리자용 테스트 계정 로컬 로그인 기능 추가
si-zero Jul 24, 2026
f0a837d
#360 [Refactor] 1인 1관점 제한을 해제하고 1인 다수 관점 등록 허용
si-zero Jul 24, 2026
9fb601f
#366 [Feat] 내 콘텐츠 활동 내역(댓글 탭)에 내가 작성한 관점 포함
si-zero Jul 24, 2026
6a1abde
#370 [Fix] 사전투표만 한 기록도 내 배틀 기록에 노출되는 버그
si-zero Jul 24, 2026
80f5b9c
[Feat] 관점 200자 제한 해제 (#375)
si-zero Aug 2, 2026
f9bc278
#378 [Feat] 관리자 예약 푸시알림(제목/소제목/발송시간) 설정 및 자동발송
si-zero Aug 8, 2026
99f4765
#382 [Fix] 내 콘텐츠 활동 댓글 정보 매핑 오류 수정 (#383)
jucheonsu Aug 9, 2026
79cb355
#387 [Refactor] 철학자 태그 제한 및 가치관 육각형 계산 보정 (#388)
jucheonsu Aug 13, 2026
bdbe3b3
#391 [Remove] 미사용 파일 정리 (비활성 CI 워크플로우 + 레거시 admin 프론트)
si-zero Aug 13, 2026
a82c575
#392 [CI/CD] Java CI 파이프라인 브랜치명 오류 및 지속적 빌드 실패 수정
si-zero Aug 13, 2026
70ccc90
#395 [Feat] 관리자용 푸시 알림 발송 테스트 API 추가
si-zero Aug 16, 2026
2e72bf7
#396 [Fix] Android FCM 푸시에 title/body가 실리지 않아 알림이 안 뜨던 문제 수정
si-zero Aug 16, 2026
1fc8488
#401 [Fix] FCM 만료된 디바이스 토큰이 정리되지 않아 반복 발송 실패 로그가 쌓이는 문제 수정
si-zero Aug 17, 2026
a4d3b31
#405 [Feat] 어드민 예약 알림 On/Off 전환 API 추가 및 관리자 알림 API 문서화
si-zero Aug 26, 2026
0b9a374
#407 [Feat] 어드민 유저 검색 API 추가
si-zero Aug 26, 2026
869de77
#409 [Feat] 어드민 공지사항 수정/삭제 API 추가
si-zero Aug 26, 2026
087fea5
#411 [Feat] 어드민 공지 발송 결과 조회 API 추가
si-zero Aug 26, 2026
4bdbdf3
#413 [Feat] 어드민 공지 발송 대상자 수 미리보기 API 추가
si-zero Aug 26, 2026
76e8097
#414 [Feat] 어드민 공지 작성 옵션(카테고리) 조회 API 추가
si-zero Aug 26, 2026
26116e8
#415 [Feat] 어드민 예약 알림 테스트 발송 API 추가
si-zero Aug 26, 2026
4234c29
#423 [Docs] 누락된 마이그레이션 SQL 파일 보완 (#409, #411)
si-zero Aug 30, 2026
7aaa1f4
#421 [Feat] 유저 일별 활동 트래킹(DAU/MAU 기반) 인프라 구축
si-zero Aug 30, 2026
d3b9343
#425 [Feat] 어드민 대시보드 오늘 요약 API 추가
si-zero Sep 1, 2026
2129d35
#427 [Feat] 어드민 대시보드 DAU/MAU 추이 API 추가
si-zero Sep 1, 2026
d8fe672
#429 [Feat] 어드민 대시보드 신규 가입자 추이 API 추가
si-zero Sep 1, 2026
6eea0d4
#431 [Feat] 어드민 대시보드 배틀 참여율 API 추가
si-zero Sep 1, 2026
1e134bc
#433 [Feat] 어드민 대시보드 출석 체크율 API 추가
si-zero Sep 1, 2026
cba91cb
#436 [Feat] 어드민 대시보드 크레딧 지급 현황 API 추가
si-zero Sep 2, 2026
23496d1
#444 [Refactor] AWS S3를 Railway Bucket으로 마이그레이션 (개발 서버)
si-zero Sep 7, 2026
7b0b68f
🐛 Fix: BattleVoteServiceImplTest 시간대 불일치로 15시(UTC) 이후 CI 실패 (#442)
Sep 7, 2026
c99065e
✨ Feat: ad.picke.store 제휴 광고(쿠팡 파트너스·애드픽) 연동 (#443)
Sep 8, 2026
d22f21a
#441 [Fix] 쿠팡 파트너스 ID 환경변수 누락 시 앱 부팅 실패 해소 (#448)
Sep 8, 2026
9745f2e
#441 [Fix] 광고 스웨거 기본 서버를 문서를 연 주소로 바꿈 (#449)
Sep 8, 2026
e5a0422
#441 [Fix] 필수 쿼리 파라미터 누락 시 500 대신 400 응답 (#450)
Sep 8, 2026
c3bd52b
#441 [Feat] 광고 스웨거 탭에 운영 광고 도메인 추가 (#451)
Sep 8, 2026
476b0dd
#441 [Feat] 애드픽 쇼핑·핫딜 상품을 광고 재고로 편입 (#454)
Sep 8, 2026
495f772
#441 [Feat] 애드픽 쇼핑 상품에 더 높은 로테이션 가중치 부여 (#457)
Sep 9, 2026
093278c
AdFit 수익과 비용을 기록해 관리자 ROI를 확인하도록 지원
Sep 10, 2026
73a4214
test: 사용자 광고 API 조회 계약 검증 (#460)
Sep 10, 2026
27e7b79
fix: 사용자 광고에서 설치·가입 캠페인 제외 (#463)
Sep 10, 2026
a612828
feat: AdFit 일별 수익 자동 조회 연결 (#465)
Sep 10, 2026
6891d33
#455 [Feat] 배틀 시나리오 감정 톤 + 철학자 보이스 매핑 인프라
si-zero Sep 10, 2026
291918c
#467 [Feat] 배틀 대본 붙여넣기 파서 (배틀·시나리오 자동 등록)
si-zero Sep 11, 2026
3ed96b8
#469 [Feat] 배틀 대본 파서 대사를 문장 종결부호 단위로 분리
si-zero Sep 11, 2026
8efa2ad
#471 [Feat] 배틀 대본 파서 summary·description·선택지 title 매핑 수정
si-zero Sep 11, 2026
073dfd5
#473 [Feat] 시나리오 선택지에 선택의 시간 설명 텍스트(title) 추가
si-zero Sep 11, 2026
58ce7ad
#475 [Feat] 철학자 보이스 매핑에 이미지 키(image_key) 추가
si-zero Sep 12, 2026
759f746
#477 [Docs] 철학자 보이스 매핑에 실제 이미지 키 반영
si-zero Sep 12, 2026
7a41a14
#479 [Fix] 철학자 보이스 imageKey 응답을 호출 가능한 경로로 변환
si-zero Sep 12, 2026
4cf5227
#481 [Fix] 배틀 옵션 태그 수정 시 유니크 제약 위반(23505) 발생
si-zero Sep 12, 2026
a7b0c3b
#483 [Fix] 로컬 draft→S3 promote가 DB 트랜잭션과 분리되어 orphan 파일/유실 위험
si-zero Sep 12, 2026
e3e5bd8
feat: 애드픽 쇼핑 재고 확대 + AdFit 세션 갱신 + Mixpanel·Sentry 지표 (#487)
Sep 14, 2026
d6566c3
개발 서버도 운영과 같은 관리자 지표 계약을 제공하게 한다
Sep 14, 2026
9ef0aa0
feat: Sentry 전체 관측 데이터와 가입 추이 개발 반영 (#492)
Sep 14, 2026
df9acca
[Fix] Sentry trace metric 시계열 집계 오류 수정 (#494)
Sep 14, 2026
88661ac
feat: Sentry 회원가입 지표를 일별 시계열로 제공 (#496)
Sep 14, 2026
1e01dde
feat: Sentry 사용자 이벤트 전체 집계 (#498)
Sep 14, 2026
8935a92
fix: Sentry 이벤트 전체 조회 복구 (#501)
Sep 14, 2026
724c75e
fix: Sentry 회원가입 사용자 결측값 유지 (#503)
Sep 14, 2026
e1fa37d
fix: Sentry 이벤트 배치 누락 제거 (#505)
Sep 14, 2026
9d43c11
feat: Mixpanel 이벤트 퍼널 이탈율 조회 (#507)
Sep 28, 2026
9a298dc
#509 [Fix] 시나리오 병합 오디오 재생성 시 URL 갱신
si-zero Oct 1, 2026
b9ca424
#513 [Fix] 어드민 시나리오 조회 응답에 노드 연결 정보 추가
si-zero Oct 1, 2026
ce2f45e
#517 [Feat] 배틀 썸네일 AI 후보 생성 API
si-zero Oct 4, 2026
4bb85ab
#519 [Fix] 썸네일 후보를 제목 기반 장면으로 생성하고 안전 필터 거절 구분
si-zero Oct 4, 2026
9d1bb90
#521 [Feat] 썸네일 프롬프트 구조화 및 레퍼런스 이미지 확대
si-zero Oct 14, 2026
a2ba1ca
#524 [Feat] 썸네일 디자인 시스템 팔레트 적용 및 레퍼런스 2장으로 축소
si-zero Oct 19, 2026
1faefbc
#523 [Docs] 클래스 기능 ERD 정의 (#527)
HYH0804 Oct 19, 2026
ec60a31
#528 [Feat] 클래스 엔티티 및 스키마 SQL 정의 (#529)
HYH0804 Oct 19, 2026
4b9f0ce
Fix: 이용권·클래스 PRD 정합성 보완 (본인 재등록, 코드 미리보기, 환불 이용권 마감) (#536)
HYH0804 Oct 19, 2026
27eb7fb
#537 [Feat] 클래스 초대코드 참여 및 멤버 관리 API (#538)
HYH0804 Oct 19, 2026
dabc6e1
#539 [Feat] 클래스 내 배틀 진행 class_id 스코핑 및 일반 배틀 격리 (#540)
HYH0804 Oct 19, 2026
36551e4
#541 [Feat] 클래스 결과·AI 리포트 (개인 피드백·클래스 인사이트) (#542)
HYH0804 Oct 19, 2026
c2ec790
#543 [Feat] 어드민 펀딩 명단 가져오기·이용권 코드 발급·재발급·환불 (#544)
HYH0804 Oct 19, 2026
b7e3037
#545 [Feat] 클래스 커스텀 배틀 AI 주제 제안 및 수정 검증 API
si-zero Oct 21, 2026
03933c0
#547 [Feat] 검증된 주제로 커스텀 배틀 클래스 생성
si-zero Oct 21, 2026
fe3f717
#548 [Feat] 커스텀 배틀 AI 철학자 3라운드 토론
si-zero Oct 21, 2026
e0aee2f
#551 [Feat] 클래스 Picke 배틀 추천 API 및 어드민 배틀 클래스 설정
si-zero Oct 21, 2026
bee8cc6
#553 [Feat] 클래스 참여 코드 확인 API 및 삭제된 클래스 구분
si-zero Oct 21, 2026
da247e3
#555 [Docs] 클래스 API 명세서
si-zero Oct 21, 2026
6c2a2b0
#557 [Fix] 클래스 의견·댓글 좋아요 API 클래스 권한 검사
si-zero Oct 21, 2026
50ec87b
#559 [Fix] 클래스 의견·댓글 신고 API 클래스 권한 검사
si-zero Oct 21, 2026
e821c20
#563 [Feat] AI 철학자 토론 반박 입력 차단 (위협·개인정보)
si-zero Oct 22, 2026
c44e672
#565 [Feat] 이용 종료 후 30일 지난 클래스 원문·AI 대화·리포트 파기
si-zero Oct 22, 2026
1683a90
#567 [Feat] AI 철학자 토론에 대상 수준별 반론 난이도 반영
si-zero Oct 22, 2026
b22072b
#569 [Feat] 클래스 기획 확인 반영 (AI 주장·반박 길이·TTS 청취 필수·필수 의견 삭제 차단)
si-zero Oct 23, 2026
c53e30f
#571 [Feat] 어드민 배틀 목록 수준 노출 및 기존 배틀 수준 초급 일괄 설정
si-zero Oct 23, 2026
179f964
#573 [Fix] 클래스 배틀 테스트 날짜를 KST 기준으로 생성
si-zero Oct 23, 2026
1f63e5c
#575 [Feat] 클래스 멤버 초대코드 노출 및 의견·댓글 작성자 클래스 표시 이름 노출 (#579)
HYH0804 Oct 28, 2026
eea7198
#576 [Feat] 클래스 생성 중복 요청 방지 (#580)
HYH0804 Oct 28, 2026
f2134e1
#577 [Feat] 중간투표 있는 기존 콘텐츠의 클래스 중간투표 수집 및 리포트 반영 (#581)
HYH0804 Oct 28, 2026
1dc6db2
#589 [Feat] 미등록 이용권 등록기한 임박 알림 대상 조회·발송 기록 (#590)
HYH0804 Oct 28, 2026
96e3f4a
#561 [Feat] 텀블벅 후원자 엑셀 연동 및 클래스 이용권 운영 기능 확장 (#562)
jucheonsu Oct 28, 2026
8fa5930
#578 [Feat] 관점·댓글 200자 초과 제한 (#591)
jucheonsu Oct 28, 2026
8dcfcdb
#582 [Feat] 클래스 리포트 내 활동 조회 API 추가 (#592)
jucheonsu Oct 28, 2026
d82439e
#583 [Feat] 홈·배틀 카드 응답 필드 보완 (#593)
jucheonsu Oct 28, 2026
965b3e8
#584 [Feat] 회원 탈퇴 시 클래스·좌석·콘텐츠 처리 (#594)
jucheonsu Oct 28, 2026
57142f3
#585 [Feat] 잘못된 커서·DB 제약 오류를 400/409로 정리 (#595)
jucheonsu Oct 28, 2026
1e2d311
#586 [Feat] 관리자 펀딩 주문·이용권 대시보드 API 확장 (#596)
jucheonsu Oct 28, 2026
4612d98
#587 [Feat] 텀블벅 Start·Run 등록 및 전달 흐름 분리
jucheonsu Oct 28, 2026
517791d
#588 [Refactor] com 패키지 타입 참조를 import로 이동 (#598)
jucheonsu Oct 28, 2026
9770918
#603 [Fix] JwtFilter 계정 상태 검사에서 정상 계정이 401로 막히는 문제 수정
si-zero Nov 2, 2026
2414863
#606 [Fix] 회원 탈퇴·펀딩 변경 이후 깨진 기존 테스트 수정
si-zero Nov 2, 2026
0eb3bf4
#602 [Feat] AI 철학자 반박 프롬프트 고도화 (철학자 프로필·수준별 기준·말풍선)
si-zero Nov 7, 2026
e7f5677
#608 [Feat] AI 주제 제안 실패 사유 응답 추가
si-zero Nov 7, 2026
bb309fb
#610 [Feat] 기획 확정 배틀별 수준 일괄 반영 SQL 추가
si-zero Nov 7, 2026
8145e85
#612 [Fix] 펀딩 다중 수량 발급 이후 깨진 펀딩 테스트와 주문 목록 500 수정
si-zero Nov 7, 2026
7e72bfc
#616 [Fix] 운영 DB에 남은 이전 펀딩 스키마 정리 SQL 추가
si-zero Nov 7, 2026
11ce3d5
#618 [Feat] 배틀 수준 반영 SQL에 운영 배틀 이전 제목 추가
si-zero Nov 7, 2026
8a483fc
#620 [Feat] 기획 답변에 따른 남은 배틀 수준 반영 SQL 추가
si-zero Nov 8, 2026
3278313
#622 [Feat] 어드민 배틀 공개·보관 상태 변경 API
si-zero Nov 8, 2026
ee8b42d
#626 [Feat] 주간 베스트 관점 조회 API (#627)
HYH0804 Nov 8, 2026
66aeb94
#628 [Fix] 개인 AI 리포트 분석 불가 시 실패 대신 PRD 안내 문구로 게시
si-zero Nov 12, 2026
6bc44eb
#630 [Feat] 개인 리포트 분석 제한 규칙·중복 발언 합치기·재시도 API
si-zero Nov 12, 2026
0709553
#632 [Feat] 커스텀 배틀 반박 입력 분류·무의미·인젝션 반려
si-zero Nov 12, 2026
e7d38da
#634 [Feat] 개인 AI 리포트에 커스텀 배틀 토론 반박 반영
si-zero Nov 12, 2026
7aae80e
#636 [Feat] 토론 프롬프트 debate-v5 (비속어·공격 표현·논거 임의 생성 금지, 응답 방향 힌트)
si-zero Nov 12, 2026
0e6d9c4
#640 [Feat] 반박 입력 분류 AI 호출 비용 ai_jobs 기록
si-zero Nov 17, 2026
7966cda
#647 [Fix] 클래스 이미지 URL·커스텀 배틀 카테고리 태그·리포트 다음 걸음 중복 수정
si-zero Nov 19, 2026
fb714ef
#649 [Feat] 클래스 명단 멤버 수와 사용 좌석 수 분리
si-zero Nov 19, 2026
3a1a3ff
#651 [Fix] 삭제된 클래스·나간 멤버의 AI 리포트·토론 생성 중단
si-zero Nov 19, 2026
917c300
#653 [Feat] 이용권 코드 PKE+6자리 형식 변경과 계정별 입력 5회 제한
si-zero Nov 19, 2026
3b2c217
#655 [Merge] dev 변경사항을 main에 반영 (v3.0.4)
si-zero Nov 19, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 21 additions & 8 deletions docs/api-specs/class-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -117,10 +117,11 @@
- 이용 기간은 등록 시점부터 6개월이다.
- 정원은 리워드 티어(5 / 15 / 30석)를 따른다.
- 계정당 사용 중인(ACTIVE) 이용권은 1개다.
- 코드의 공백·하이픈·대소문자는 무시한다.
- 코드 형식은 `PKE` + 16진수 대문자 6자리다 (예: `PKE05D2E1`). 코드의 공백·하이픈·대소문자는 무시한다.
- **입력 5회 제한:** 코드 확인(1.1)과 등록(1.2)에서 없는 코드를 넣은 횟수를 계정별로 센다. 1시간 안에 5번 틀리면 그 응답부터 1시간 동안 429 `TICKET_429_LOCKED`다. 잠긴 동안에는 맞는 코드도 막힌다. 맞는 코드를 넣어도 틀린 횟수는 초기화되지 않는다.

### 1.1 이용권 코드 확인 (미리보기)
- `GET /api/v1/class-tickets/preview?code=PICKE-AB12-CD34`
- `GET /api/v1/class-tickets/preview?code=PKE05D2E1`
- 코드를 소비하지 않고 정원과 등록 기한을 보여준다.

```json
Expand All @@ -137,6 +138,7 @@
|---|---|
| 빈 코드 | 400 `COMMON_400` |
| 없는 코드 | 404 `TICKET_404_CODE` |
| 없는 코드를 1시간 안에 5번 넣음 (5번째부터 1시간) | 429 `TICKET_429_LOCKED` |
| 재발급·환불로 무효화된 코드 | 409 `TICKET_409_REVOKED` |
| 등록 기한 경과 | 409 `TICKET_409_REG_EXP` |
| 다른 계정이 이미 등록 | 409 `TICKET_409_CLAIMED` |
Expand All @@ -146,7 +148,7 @@
- `POST /api/v1/class-tickets/register`

```json
{ "code": "PICKE-AB12-CD34" }
{ "code": "PKE05D2E1" }
```

- 등록하면 즉시 ACTIVE가 되고 6개월 뒤 만료된다.
Expand Down Expand Up @@ -210,7 +212,8 @@

- 정원은 이용권 정원을 그대로 쓴다.
- 초대코드 6자는 서버가 만든다.
- 커스텀 배틀의 썸네일은 환경변수 `CLASS_CUSTOM_BATTLE_THUMBNAIL_URL`의 고정 이미지 1종이다.
- 커스텀 배틀의 썸네일은 환경변수 `CLASS_CUSTOM_BATTLE_THUMBNAIL_URL`의 고정 이미지 1종이다. 값이 비어 있으면 썸네일은 null이다.
- 커스텀 배틀에는 주제 카테고리가 카테고리 태그로 붙는다 (예: `#사회`). 클래스 배틀 상세(6.1)의 `battle.categoryTags`로 내려간다.
- 응답: `ClassDetailResponse` (2.3 참고)
- **중복 요청 방지**: 버튼 연타·네트워크 재전송 대비. 같은 운영자의 생성 요청은 이용권 행 잠금으로 하나씩 처리한다.
- `requestKey`를 보내면: 같은 키·같은 내용이면 새로 만들지 않고 그 클래스를 200으로 돌려준다. 같은 키·다른 내용이면 409 `CLASS_409_REQUEST_KEY`다. 키가 다르면 내용이 같아도 새로 만든다.
Expand Down Expand Up @@ -248,6 +251,7 @@
"battleThumbnailUrl": "https://...",
"battleType": "TTS",
"memberCount": 12,
"activeMemberCount": 11,
"capacity": 30,
"closeAt": "2026-12-31T23:59:59",
"closed": false,
Expand All @@ -257,7 +261,9 @@
}
```

- `memberCount`: 좌석을 차지한 인원이다. 운영자가 참여하면 포함되고, 나갔지만 활동 이력이 있어 좌석을 유지한 멤버도 포함된다.
- `memberCount`: 사용 좌석 수다. 좌석을 차지한 인원으로, 운영자가 참여하면 포함되고 나갔거나 내보내졌지만 활동 이력이 있어 좌석을 유지한 멤버도 포함된다. 정원 판정에 쓰며 남은 자리는 `capacity - memberCount`다.
- `activeMemberCount`: 현재 명단 인원이다. 참여 중인 멤버(참여하는 운영자 포함)만 센다. 화면의 "멤버 N명"은 이 값을 쓴다 (PRD 15절 "참여 4명 / 사용 좌석 5석").
- 두 값은 클래스 상세(2.3)와 참여 코드 확인(5.1), 참여(5.2) 응답에도 같은 뜻으로 들어간다.

### 2.3 클래스 상세
- `GET /api/v1/classes/{classId}`
Expand All @@ -276,6 +282,7 @@
"battleType": "TTS",
"topicVersionId": null,
"memberCount": 12,
"activeMemberCount": 11,
"capacity": 30,
"deadline": "2026-12-31T23:59:59",
"ticketExpiresAt": "2027-04-01T10:00:00",
Expand Down Expand Up @@ -528,7 +535,7 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접
| `draftId`, `versionNo` | 초안 ID, 초안 안의 버전 번호 (1부터) |
| `source` | `CANDIDATE`(AI 후보 선택) / `EDITED`(직접 수정 후 검증 통과) |
| `question`, `description`, `category`, `difficulty`, `createdAt` | |
| `options[]` | `position`(A/B), `label`, `rationale`, `philosopher`, `philosopherName`, `philosopherImageKey` |
| `options[]` | `position`(A/B), `label`, `rationale`, `philosopher`, `philosopherName`, `philosopherImageKey`, `philosopherImageUrl`. 이미지는 `philosopherImageUrl`을 그대로 쓴다 |

---

Expand All @@ -549,6 +556,7 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접
"battleThumbnailUrl": "https://...",
"battleType": "TTS",
"memberCount": 12,
"activeMemberCount": 11,
"capacity": 30,
"closeAt": "2026-12-31T23:59:59"
}
Expand Down Expand Up @@ -606,6 +614,7 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접
```

- `memberId`: 내보내기(5.6)에 쓴다.
- `characterUrl`: 회원 캐릭터 이미지 URL이다. 프로필이 없으면 null이다.
- `me`: 조회한 사람 본인이면 true다 (이름 수정 버튼 노출용).
- 권한이 없으면 403 `CLASS_403_MEMBER`다.

Expand Down Expand Up @@ -952,7 +961,7 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접
"round": 1,
"canReply": true,
"canRetry": false,
"philosopher": { "code": "KANT", "name": "칸트", "typeName": "...", "imageKey": "..." },
"philosopher": { "code": "KANT", "name": "칸트", "typeName": "...", "imageKey": "images/philosophers/kant.png", "imageUrl": "https://..." },
"participantOption": { "optionId": 31, "position": "A", "title": "...", "stance": "..." },
"opponentOption": { "optionId": 32, "position": "B", "title": "...", "stance": "..." },
"messages": [
Expand All @@ -977,6 +986,7 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접
| `FAILED` | AI 주장 생성 실패 | 재시도 버튼 (`canRetry`) |
| `COMPLETED` | 3라운드 종료 | 대화 다시보기 / 사후투표 |

- `philosopher.imageUrl`: 철학자 얼굴 이미지 URL이다. 프론트가 `imageKey`로 이미지를 따로 찾지 말고 이 값을 그대로 쓴다.
- `canReply`: `WAITING_USER`이고 마감 전일 때 true
- `canRetry`: 실패했거나 생성이 오래 멈췄고 마감 전일 때 true
- `content`: 전체 글이다. AI 주장은 말풍선 사이에 줄바꿈이 들어 있다.
Expand All @@ -1003,6 +1013,8 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접
| `LIMITED` | 분석 불가라 템플릿으로 대신함. 개인 리포트는 사유가 `feedback.limitedReason`에 있다 | 개인 리포트: `feedback.headline`·`limitedMessage`·`limitedNotice` (PRD 엣지 케이스 3.3) / 인사이트: "판단의 이유를 살펴볼 글이 아직 충분하지 않아요" |
| `FAILED` | 생성 실패 | "AI 요약을 준비하지 못했어요" |

- 마감 뒤 클래스가 삭제됐거나 멤버가 나가기·내보내기 되면, 아직 만들지 않은 리포트는 AI를 호출하지 않고 건너뛴다(서버 내부 상태 `CANCELED`). 생성 중이었다면 비용만 기록하고 결과는 게시하지 않는다 (PRD F16·18절). 이 리포트는 조회되더라도 `NOT_ELIGIBLE`로 보이며 재시도 대상이 아니다. AI 토론도 생성 중에 클래스가 삭제되면 주장을 저장하지 않는다.

### 8.1 클래스 결과 (정량 통계)
- `GET /api/v1/classes/{classId}/result`

Expand Down Expand Up @@ -1268,7 +1280,7 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접
"ticketId": 3, "fundingOrderId": 1, "orderId": "T-0001",
"supporterName": "홍길동", "supporterEmail": "...", "supporterPhone": "...",
"capacity": 30, "registerBy": "2027-09-01T00:00:00",
"code": "XXXXXX-XXXXX-XXXXX-XXXXX-XXXXX"
"code": "PKE05D2E1"
}
],
"skipped": [ { "fundingOrderId": 2, "orderId": "T-0002", "reason": "ALREADY_ISSUED" } ]
Expand Down Expand Up @@ -1463,6 +1475,7 @@ PRD "등록기한 30일·7일 전 알림은 허용된 연락 수단에서만 발
| 코드 | HTTP | 메시지 |
|---|---|---|
| `TICKET_404_CODE` | 404 | 유효하지 않은 이용권 코드입니다. |
| `TICKET_429_LOCKED` | 429 | 이용권 코드를 5번 잘못 입력해 1시간 동안 입력할 수 없어요. 잠시 후 다시 시도해 주세요. |
| `TICKET_404` | 404 | 등록된 이용권이 없습니다. |
| `TICKET_409_CLAIMED` | 409 | 이미 등록된 이용권 코드입니다. |
| `TICKET_409_REVOKED` | 409 | 재발급되어 더 이상 사용할 수 없는 이용권 코드입니다. |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,14 @@ public final class ClassMemberConverter {
private ClassMemberConverter() {
}

public static ClassMemberResponse toResponse(ClassMember member, Long viewerId) {
/** avatarUrl 은 회원 캐릭터 이미지 URL이다 ({@code ClassImageUrlResolver#avatar}). */
public static ClassMemberResponse toResponse(ClassMember member, Long viewerId, String avatarUrl) {
User user = member.getUser();
return new ClassMemberResponse(
member.getId(),
member.getDisplayName(),
member.getRole(),
user.getCharacterUrl(),
avatarUrl,
Objects.equals(user.getId(), viewerId),
member.getJoinedAt()
);
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,9 @@
package com.swyp.picke.domain.classroom.converter;

import com.swyp.picke.domain.classroom.service.ClassImageUrlResolver;
import lombok.RequiredArgsConstructor;
import org.springframework.stereotype.Component;

import com.swyp.picke.domain.battle.enums.BattleCategory;
import com.swyp.picke.domain.classroom.dto.response.ClassTopicDraftResponse;
import com.swyp.picke.domain.classroom.dto.response.ClassTopicValidationResponse;
Expand All @@ -12,12 +16,14 @@
import java.util.List;
import java.util.Map;

public final class ClassTopicConverter {
/** 철학자 이미지 URL을 함께 내려주기 위해 빈으로 둔다. */
@Component
@RequiredArgsConstructor
public class ClassTopicConverter {

private ClassTopicConverter() {
}
private final ClassImageUrlResolver imageUrls;

public static ClassTopicDraftResponse toDraft(ClassTopicDraft draft, ClassTopicVersion latestVersion) {
public ClassTopicDraftResponse toDraft(ClassTopicDraft draft, ClassTopicVersion latestVersion) {
List<Map<String, Object>> candidates = draft.getCandidates() == null ? List.of() : draft.getCandidates();
return new ClassTopicDraftResponse(
draft.getId(),
Expand All @@ -30,11 +36,11 @@ public static ClassTopicDraftResponse toDraft(ClassTopicDraft draft, ClassTopicV
draft.getBatchNo(),
draft.remainingSuggestions(),
draft.remainingValidations(),
candidates.stream().map(ClassTopicConverter::toCandidate).toList(),
candidates.stream().map(this::toCandidate).toList(),
latestVersion == null ? null : toVersion(latestVersion));
}

public static ClassTopicVersionResponse toVersion(ClassTopicVersion version) {
public ClassTopicVersionResponse toVersion(ClassTopicVersion version) {
return new ClassTopicVersionResponse(
version.getId(),
version.getDraft().getId(),
Expand All @@ -50,7 +56,7 @@ public static ClassTopicVersionResponse toVersion(ClassTopicVersion version) {
version.getCreatedAt());
}

public static ClassTopicValidationResponse toValidation(List<TopicIssue> issues, ClassTopicVersion version,
public ClassTopicValidationResponse toValidation(List<TopicIssue> issues, ClassTopicVersion version,
int remainingValidations) {
return new ClassTopicValidationResponse(
version != null,
Expand All @@ -60,7 +66,7 @@ public static ClassTopicValidationResponse toValidation(List<TopicIssue> issues,
version == null ? null : toVersion(version));
}

private static ClassTopicDraftResponse.Candidate toCandidate(Map<String, Object> map) {
private ClassTopicDraftResponse.Candidate toCandidate(Map<String, Object> map) {
TopicContent content = TopicContent.fromMap(map);
return new ClassTopicDraftResponse.Candidate(
TopicContent.candidateIdOf(map),
Expand All @@ -73,9 +79,10 @@ private static ClassTopicDraftResponse.Candidate toCandidate(Map<String, Object>
option("B", content.optionB().label(), content.optionB().rationale(), content.optionB().philosopher())));
}

private static ClassTopicVersionResponse.Option option(String position, String label, String rationale,
private ClassTopicVersionResponse.Option option(String position, String label, String rationale,
PhilosopherType philosopher) {
return new ClassTopicVersionResponse.Option(
position, label, rationale, philosopher, philosopher.getLabel(), philosopher.getImageKey());
position, label, rationale, philosopher, philosopher.getLabel(), philosopher.getImageKey(),
imageUrls.philosopher(philosopher));
}
}
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
package com.swyp.picke.domain.classroom.converter;

import com.swyp.picke.domain.classroom.service.ClassMemberCounts;

import com.swyp.picke.domain.battle.entity.Battle;
import com.swyp.picke.domain.classroom.dto.response.ClassDetailResponse;
import com.swyp.picke.domain.classroom.dto.response.ClassSummaryResponse;
Expand All @@ -12,18 +14,20 @@ public final class ClassroomConverter {
private ClassroomConverter() {
}

public static ClassSummaryResponse toSummary(Classroom classroom, ClassMemberRole myRole, long memberCount,
LocalDateTime now) {
/** thumbnailUrl 은 저장 키를 URL로 바꾼 값이다 ({@code ClassImageUrlResolver#battleThumbnail}). */
public static ClassSummaryResponse toSummary(Classroom classroom, ClassMemberRole myRole, ClassMemberCounts counts,
LocalDateTime now, String thumbnailUrl) {
Battle battle = classroom.getBattle();
return new ClassSummaryResponse(
classroom.getId(),
classroom.getName(),
myRole,
battle.getId(),
battle.getTitle(),
battle.getThumbnailUrl(),
thumbnailUrl,
classroom.getBattleType(),
memberCount,
counts.seats(),
counts.activeMembers(),
classroom.getCapacity(),
classroom.getEffectiveCloseAt(),
classroom.isClosed(now),
Expand All @@ -32,8 +36,8 @@ public static ClassSummaryResponse toSummary(Classroom classroom, ClassMemberRol
}

/** 초대코드는 공유하기 버튼용으로 운영자·멤버 모두에게 내려간다. */
public static ClassDetailResponse toDetail(Classroom classroom, ClassMemberRole myRole, long memberCount,
LocalDateTime now) {
public static ClassDetailResponse toDetail(Classroom classroom, ClassMemberRole myRole, ClassMemberCounts counts,
LocalDateTime now, String thumbnailUrl) {
Battle battle = classroom.getBattle();
return new ClassDetailResponse(
classroom.getId(),
Expand All @@ -42,10 +46,11 @@ public static ClassDetailResponse toDetail(Classroom classroom, ClassMemberRole
myRole,
classroom.getOwner().getId(),
new ClassDetailResponse.BattleInfo(
battle.getId(), battle.getTitle(), battle.getSummary(), battle.getThumbnailUrl()),
battle.getId(), battle.getTitle(), battle.getSummary(), thumbnailUrl),
classroom.getBattleType(),
classroom.getTopicVersion() == null ? null : classroom.getTopicVersion().getId(),
memberCount,
counts.seats(),
counts.activeMembers(),
classroom.getCapacity(),
classroom.getDeadline(),
classroom.getTicket().getExpiresAt(),
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ public record ClassDebateResponse(
@Schema(description = "반박 최대 글자 수") int replyMaxLength
) {

public record Philosopher(PhilosopherType code, String name, String typeName, String imageKey) {
public record Philosopher(PhilosopherType code, String name, String typeName, String imageKey,
@Schema(description = "철학자 이미지 URL") String imageUrl) {
}

public record Side(Long optionId, @Schema(description = "A / B") String position, String title, String stance) {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,8 @@ public record ClassDetailResponse(
@Schema(description = "배틀 정보") BattleInfo battle,
@Schema(description = "배틀 종류 (TTS / CUSTOM)") ClassBattleType battleType,
@Schema(description = "커스텀 배틀의 주제 버전 ID. TTS 클래스는 null", nullable = true) Long topicVersionId,
@Schema(description = "좌석을 차지한 인원 (운영자 참여 시 포함)") long memberCount,
@Schema(description = "사용 좌석 수. 좌석을 차지한 인원으로, 활동 후 나가거나 내보내진 멤버도 포함한다 (운영자 참여 시 포함)") long memberCount,
@Schema(description = "현재 명단 인원 (참여하는 운영자 포함). 화면의 멤버 수는 이 값을 쓴다") long activeMemberCount,
@Schema(description = "정원") int capacity,
@Schema(description = "운영자가 설정한 마감일. null 이면 마감 없음") LocalDateTime deadline,
@Schema(description = "이용권 종료일") LocalDateTime ticketExpiresAt,
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,8 @@ public record ClassJoinPreviewResponse(
@Schema(description = "배틀 제목") String battleTitle,
@Schema(description = "배틀 썸네일") String battleThumbnailUrl,
@Schema(description = "배틀 종류 (TTS / CUSTOM)") ClassBattleType battleType,
@Schema(description = "좌석을 차지한 인원") long memberCount,
@Schema(description = "사용 좌석 수 (활동 후 나간 멤버 포함). 남은 자리 = capacity - memberCount") long memberCount,
@Schema(description = "현재 명단 인원 (참여하는 운영자 포함)") long activeMemberCount,
@Schema(description = "정원") int capacity,
@Schema(description = "실제 마감 시각 = min(마감일, 이용권 종료일)") LocalDateTime closeAt
) {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,8 @@ public record ClassSummaryResponse(
@Schema(description = "배틀 제목") String battleTitle,
@Schema(description = "배틀 썸네일 URL") String battleThumbnailUrl,
@Schema(description = "배틀 종류 (TTS / CUSTOM)") ClassBattleType battleType,
@Schema(description = "좌석을 차지한 인원 (운영자 참여 시 포함)") long memberCount,
@Schema(description = "사용 좌석 수. 좌석을 차지한 인원으로, 활동 후 나가거나 내보내진 멤버도 포함한다 (운영자 참여 시 포함)") long memberCount,
@Schema(description = "현재 명단 인원 (참여하는 운영자 포함). 화면의 멤버 수는 이 값을 쓴다") long activeMemberCount,
@Schema(description = "정원") int capacity,
@Schema(description = "실제 마감 시각 = min(마감일, 이용권 종료일)") LocalDateTime closeAt,
@Schema(description = "마감 여부") boolean closed,
Expand Down
Loading
Loading