Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
163 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
448f134
#657 [Fix] 클래스 인사이트 근거·대표 의견 필터와 프롬프트 보강
si-zero Nov 19, 2026
3ba1da2
#661 [Fix] 클래스 인사이트 의견 부족 문구 명세 8장 기준으로 통일
si-zero Nov 19, 2026
f2fdb4a
#665 [Feat] 운영자 미참여 클래스에서 운영자 본인이 보는 명단에 운영자 표시
si-zero Nov 19, 2026
145f97e
#667 [Merge] main 변경사항 병합
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
14 changes: 10 additions & 4 deletions docs/api-specs/class-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -600,20 +600,26 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접

### 5.3 클래스 명단
- `GET /api/v1/classes/{classId}/members`
- 운영자 행이 먼저 오고, 이후 참여 순이다.
- 운영자 행이 먼저 오고, 이후 참여 순이다 (운영자, 참여자1, 참여자2 …).
- 운영자가 참여하지 않는 클래스(`ownerParticipates=false`)는 보는 사람에 따라 다르다.
- 운영자 본인이 보면 맨 위에 운영자 줄이 붙는다: `memberId` 0, `me` true, `participating` false, 이름은 운영자 닉네임, `joinedAt`은 클래스 생성 시각.
- 참여자가 보면 운영자 줄 없이 참여자만 나온다.
- 미참여 운영자 줄은 표시 이름이 없어서 이름 수정(5.4)은 403이다. 앱은 `participating`이 false면 연필 버튼을 숨긴다.
- 미참여 운영자 줄은 좌석(`memberCount`)·명단 인원(`activeMemberCount`)·결과 통계에 들어가지 않는다.
- 표시 이름·역할·아바타만 내려가고 계정 식별자는 내려가지 않는다.

```json
{
"statusCode": 200,
"data": [
{ "memberId": 10, "displayName": "김선생", "role": "OWNER", "characterUrl": "https://...", "me": true, "joinedAt": "2026-10-21T10:00:00" },
{ "memberId": 11, "displayName": "김학생", "role": "MEMBER", "characterUrl": "https://...", "me": false, "joinedAt": "2026-10-21T11:00:00" }
{ "memberId": 10, "displayName": "김선생", "role": "OWNER", "characterUrl": "https://...", "me": true, "joinedAt": "2026-10-21T10:00:00", "participating": true },
{ "memberId": 11, "displayName": "김학생", "role": "MEMBER", "characterUrl": "https://...", "me": false, "joinedAt": "2026-10-21T11:00:00", "participating": true }
]
}
```

- `memberId`: 내보내기(5.6)에 쓴다.
- `memberId`: 내보내기(5.6)에 쓴다. 미참여 운영자 줄은 0이다(내보내기 대상 아님).
- `participating`: 토론에 참여하는 사람이면 true다. 운영자에게만 보이는 미참여 운영자 줄만 false다.
- `characterUrl`: 회원 캐릭터 이미지 URL이다. 프로필이 없으면 null이다.
- `me`: 조회한 사람 본인이면 true다 (이름 수정 버튼 노출용).
- 권한이 없으면 403 `CLASS_403_MEMBER`다.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,16 @@

import com.swyp.picke.domain.classroom.dto.response.ClassMemberResponse;
import com.swyp.picke.domain.classroom.entity.ClassMember;
import com.swyp.picke.domain.classroom.entity.Classroom;
import com.swyp.picke.domain.classroom.enums.ClassMemberRole;
import com.swyp.picke.domain.user.entity.User;
import java.util.Objects;

public final class ClassMemberConverter {

/** 미참여 운영자 줄의 memberId. 실제 멤버십 ID 는 1부터라 겹치지 않는다 */
public static final long NON_PARTICIPATING_OWNER_MEMBER_ID = 0L;

private ClassMemberConverter() {
}

Expand All @@ -19,7 +24,27 @@ public static ClassMemberResponse toResponse(ClassMember member, Long viewerId,
member.getRole(),
avatarUrl,
Objects.equals(user.getId(), viewerId),
member.getJoinedAt()
member.getJoinedAt(),
true
);
}

/**
* 참여하지 않는 운영자(ownerParticipates = false)는 멤버 행이 없지만, 운영자 본인이 명단을 볼 때는 맨 위에 보여준다 (#665).
* 앱이 memberId 를 필수 값으로 읽어서 null 대신 {@link #NON_PARTICIPATING_OWNER_MEMBER_ID} 를 쓴다.
* 좌석·명단 인원·결과 통계에는 들어가지 않는다.
*/
public static ClassMemberResponse toNonParticipatingOwner(Classroom classroom, String avatarUrl) {
User owner = classroom.getOwner();
String nickname = owner.getNickname() == null || owner.getNickname().isBlank() ? "운영자" : owner.getNickname().strip();
return new ClassMemberResponse(
NON_PARTICIPATING_OWNER_MEMBER_ID,
nickname,
ClassMemberRole.OWNER,
avatarUrl,
true,
classroom.getCreatedAt(),
false
);
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,12 @@
/** 명단 화면(S12)용. 계정 식별자(userId·태그)는 내려가지 않고 클래스 안의 표시 이름만 보인다. */
@Schema(description = "클래스 멤버")
public record ClassMemberResponse(
@Schema(description = "멤버십 ID (내보내기 등 멤버 단위 작업에 쓴다)") Long memberId,
@Schema(description = "멤버십 ID (내보내기 등 멤버 단위 작업에 쓴다). 참여하지 않는 운영자 줄은 0") long memberId,
@Schema(description = "클래스 안에서 보이는 이름") String displayName,
@Schema(description = "역할 (OWNER / MEMBER)") ClassMemberRole role,
@Schema(description = "아바타 이미지 URL") String characterUrl,
@Schema(description = "조회한 사람 본인이면 true (연필 버튼 노출용)") boolean me,
@Schema(description = "참여 시각") LocalDateTime joinedAt
@Schema(description = "참여 시각. 참여하지 않는 운영자 줄은 클래스 생성 시각") LocalDateTime joinedAt,
@Schema(description = "토론에 참여하는 사람이면 true. 운영자 본인에게만 보이는 미참여 운영자 줄은 false") boolean participating
) {
}
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,7 @@
import com.swyp.picke.global.common.exception.ErrorCode;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import java.util.Map;
Expand Down Expand Up @@ -140,13 +141,25 @@ public List<ClassMemberResponse> getMembers(Long userId, Long classId) {
throw new CustomException(ErrorCode.CLASS_MEMBER_ONLY);
}
List<ClassMember> members = classMemberRepository.findActiveMembers(classId);
Map<Long, CharacterType> characters = userProfileRepository.findAllByUserIdIn(
members.stream().map(m -> m.getUser().getId()).toList()).stream()
Long ownerId = classroom.getOwner().getId();
// 미참여 운영자 줄은 운영자 본인에게만 보인다. 참여자 명단에는 참여자만 나온다 (#665)
boolean addOwnerRow = Objects.equals(ownerId, userId)
&& members.stream().noneMatch(m -> Objects.equals(m.getUser().getId(), ownerId));
List<Long> userIds = new ArrayList<>(members.stream().map(m -> m.getUser().getId()).toList());
if (addOwnerRow) {
userIds.add(ownerId);
}
Map<Long, CharacterType> characters = userProfileRepository.findAllByUserIdIn(userIds).stream()
.collect(Collectors.toMap(p -> p.getUser().getId(), UserProfile::getCharacterType, (a, b) -> a));
return members.stream()
.map(m -> ClassMemberConverter.toResponse(m, userId,
imageUrls.avatar(characters.get(m.getUser().getId()))))
.toList();

List<ClassMemberResponse> result = new ArrayList<>();
if (addOwnerRow) {
result.add(ClassMemberConverter.toNonParticipatingOwner(classroom,
imageUrls.avatar(characters.get(ownerId))));
}
members.forEach(m -> result.add(ClassMemberConverter.toResponse(m, userId,
imageUrls.avatar(characters.get(m.getUser().getId())))));
return result;
}

@Override
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -469,6 +469,117 @@ void removeActiveMember_keepsSeat_butActiveMemberCountDrops() throws Exception {
.andExpect(jsonPath("$.data.activeMemberCount").value(2));
}

@Test
@DisplayName("운영자 참여: 생성 1/1 → 2명 참여 3/3 → 무활동 나가기 2/2 → 활동 후 나가기 2/1")
void counts_ownerParticipates() throws Exception {
assertCountsFlow(true);
}

@Test
@DisplayName("운영자 미참여: 생성 0/0 → 2명 참여 2/2 → 무활동 나가기 1/1 → 활동 후 나가기 1/0")
void counts_ownerNotParticipates() throws Exception {
assertCountsFlow(false);
}

/** memberCount(사용 좌석) / activeMemberCount(명단) 를 상세·목록·참여 확인·명단 API 에서 모두 확인한다 */
private void assertCountsFlow(boolean ownerParticipates) throws Exception {
int o = ownerParticipates ? 1 : 0;
ClassInfo cls = createClass(ownerParticipates);
assertCounts(cls, o, o);

User quiet = newUser("조용학생");
User active = newUser("활동학생");
join(tokenOf(quiet), cls.inviteCode, "조용학생").andExpect(status().isOk())
.andExpect(jsonPath("$.data.memberCount").value(o + 1))
.andExpect(jsonPath("$.data.activeMemberCount").value(o + 1));
join(tokenOf(active), cls.inviteCode, "활동학생").andExpect(status().isOk());
assertCounts(cls, o + 2, o + 2);

// 활동 없이 나가면 좌석도 돌려준다
mockMvc.perform(delete("/api/v1/classes/" + cls.classId + "/members/me")
.header("Authorization", "Bearer " + tokenOf(quiet)))
.andExpect(status().isOk());
assertCounts(cls, o + 1, o + 1);

// 사전투표 후 나가면 좌석은 남고 명단만 줄어든다
userBattleRepository.save(UserBattle.builder().user(active).battle(battle)
.classroom(classroomRepository.findById(cls.classId).orElseThrow())
.step(UserBattleStep.TTS_LISTENING).build());
mockMvc.perform(delete("/api/v1/classes/" + cls.classId + "/members/me")
.header("Authorization", "Bearer " + tokenOf(active)))
.andExpect(status().isOk());
assertCounts(cls, o + 1, o);
}

@Test
@DisplayName("운영자 참여: 명단은 운영자, 참여자1, 참여자2 순서 (#665)")
void members_ownerFirst_participating() throws Exception {
assertOwnerFirst(true);
}

@Test
@DisplayName("운영자 미참여: 운영자가 보면 맨 위에 운영자 줄(memberId 0, participating false), 참여자가 보면 참여자만 (#665)")
void members_ownerFirst_notParticipating() throws Exception {
assertOwnerFirst(false);
}

private void assertOwnerFirst(boolean participates) throws Exception {
ClassInfo cls = createClass(participates);
User first = newUser("참여자1");
User second = newUser("참여자2");
join(tokenOf(first), cls.inviteCode, "참여자1").andExpect(status().isOk());
join(tokenOf(second), cls.inviteCode, "참여자2").andExpect(status().isOk());

// 운영자가 보면 항상 운영자, 참여자1, 참여자2
mockMvc.perform(get("/api/v1/classes/" + cls.classId + "/members").header("Authorization", "Bearer " + ownerToken))
.andExpect(status().isOk())
.andExpect(jsonPath("$.data", hasSize(3)))
.andExpect(jsonPath("$.data[0].role").value("OWNER"))
.andExpect(jsonPath("$.data[0].displayName").value("선생님"))
.andExpect(jsonPath("$.data[0].me").value(true))
.andExpect(jsonPath("$.data[0].participating").value(participates))
.andExpect(participates
? jsonPath("$.data[0].memberId").value(memberIdOf(cls.classId, owner))
: jsonPath("$.data[0].memberId").value(0))
.andExpect(jsonPath("$.data[1].displayName").value("참여자1"))
.andExpect(jsonPath("$.data[1].participating").value(true))
.andExpect(jsonPath("$.data[2].displayName").value("참여자2"));

// 참여자가 보면: 운영자 참여 시 운영자 포함 3명, 미참여 시 참여자 2명만
if (participates) {
mockMvc.perform(get("/api/v1/classes/" + cls.classId + "/members").header("Authorization", "Bearer " + tokenOf(first)))
.andExpect(jsonPath("$.data", hasSize(3)))
.andExpect(jsonPath("$.data[0].role").value("OWNER"))
.andExpect(jsonPath("$.data[0].me").value(false))
.andExpect(jsonPath("$.data[1].me").value(true));
} else {
mockMvc.perform(get("/api/v1/classes/" + cls.classId + "/members").header("Authorization", "Bearer " + tokenOf(first)))
.andExpect(jsonPath("$.data", hasSize(2)))
.andExpect(jsonPath("$.data[0].displayName").value("참여자1"))
.andExpect(jsonPath("$.data[0].me").value(true))
.andExpect(jsonPath("$.data[1].displayName").value("참여자2"))
.andExpect(jsonPath("$.data[?(@.role == 'OWNER')]", hasSize(0)));
}

// 멤버 수는 그대로 (미참여 운영자 포함 여부는 기획 확인 대기)
mockMvc.perform(get("/api/v1/classes/" + cls.classId).header("Authorization", "Bearer " + ownerToken))
.andExpect(jsonPath("$.data.activeMemberCount").value(participates ? 3 : 2));
}

private void assertCounts(ClassInfo cls, int seats, int activeMembers) throws Exception {
mockMvc.perform(get("/api/v1/classes/" + cls.classId).header("Authorization", "Bearer " + ownerToken))
.andExpect(status().isOk())
.andExpect(jsonPath("$.data.memberCount").value(seats))
.andExpect(jsonPath("$.data.activeMemberCount").value(activeMembers));
mockMvc.perform(get("/api/v1/classes").header("Authorization", "Bearer " + ownerToken))
.andExpect(jsonPath("$.data[0].memberCount").value(seats))
.andExpect(jsonPath("$.data[0].activeMemberCount").value(activeMembers));
preview(tokenOf(newUser("확인학생")), cls.inviteCode)
.andExpect(status().isOk())
.andExpect(jsonPath("$.data.memberCount").value(seats))
.andExpect(jsonPath("$.data.activeMemberCount").value(activeMembers));
}

// ===== 헬퍼 =====

private record ClassInfo(long classId, String inviteCode) {
Expand Down
Loading