Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
161 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
05af503
#659 [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
9 changes: 8 additions & 1 deletion docs/api-specs/class-api.md
Original file line number Diff line number Diff line change
Expand Up @@ -1190,7 +1190,14 @@ AI가 주제 후보를 제안하면 운영자가 하나를 고르거나 직접
- `insightText`: 200자 이하다.
- `evidence`: 인사이트가 근거로 삼은 공개 글 1~5건이다.
- `highlights`: 운영자에게 추천하는 대표 의견 최대 2건이다. 작성자 정보는 넣지 않는다.
- 의견 작성자가 3명 미만이면 `LIMITED`다.
- `LIMITED`면 `insightText`가 "아직 요약할 의견이 충분하지 않아요"이고 `evidence`가 빈 배열이다. 다음 경우에 `LIMITED`가 된다.
- 의견 작성자가 3명 미만이다.
- 이유를 읽을 수 있는 글을 쓴 사람이 3명 미만이다. "ㅋㅋㅋ", "몰라요 그냥요", "asdfasdf", 같은 글자·숫자 반복처럼 이유가 없는 글은 세지 않는다.
- AI가 무관한 글, 의미 없는 입력, 조롱 글을 빼고 나니 작성자가 3명 미만이다.
- `evidence`와 `highlights`에는 비속어가 든 글, 이유가 없는 글, AI가 부적절하다고 판단한 글(무관한 글, 실명을 부르거나 조롱하는 글)을 넣지 않는다.
- `highlights`가 2건보다 적으면 최신 공개 의견으로 채운다. 이때도 같은 기준으로 거른다.
- 그래서 `LIMITED`여도 `highlights`가 비어 있지 않을 수 있다.
- 인사이트는 `gpt-5.4-mini`로 만든다. 서버 환경변수 `OPENAI_INSIGHT_MODEL`로 바꿀 수 있다. 개인 리포트는 기존 모델을 그대로 쓴다.
- 생성에 실패하면 `FAILED`이고 `retryable`이 true다.
- 운영자가 아니면 403 `CLASS_403_OWNER`다.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@
import com.swyp.picke.domain.classroom.service.report.ClassReportSnapshotService;
import com.swyp.picke.domain.classroom.service.report.ClassResultStats;
import com.swyp.picke.domain.classroom.service.report.ClassResultStatsCalculator;
import com.swyp.picke.domain.classroom.service.report.InsightPostRules;
import com.swyp.picke.domain.classroom.service.report.MemberFeedbackInput;
import com.swyp.picke.domain.classroom.service.report.ReportContent;
import com.swyp.picke.domain.perspective.entity.Perspective;
Expand Down Expand Up @@ -306,14 +307,17 @@ private ClassInsightResponse toInsight(Long classId, ClassReport summary, boolea
evidence, highlights);
}

/** 하이라이트가 2건 미만이면 최신 공개 의견으로 채운다 (AI 호출 없음) */
/** 하이라이트가 2건 미만이면 최신 공개 의견으로 채운다 (AI 호출 없음). 비속어·이유 없는 글은 고르지 않는다 (#657) */
private void backfillHighlights(List<ClassInsightResponse.PublicPost> highlights, Long classId) {
if (highlights.size() >= HIGHLIGHT_MAX) {
return;
}
List<Perspective> recent = perspectiveRepository.findByClassroomIdAndStatusOrderByCreatedAtAsc(classId, PerspectiveStatus.PUBLISHED);
for (int i = recent.size() - 1; i >= 0 && highlights.size() < HIGHLIGHT_MAX; i--) {
Perspective p = recent.get(i);
if (!InsightPostRules.isSelectable(p.getContent())) {
continue;
}
boolean exists = highlights.stream().anyMatch(h ->
MemberFeedbackInput.SOURCE_PERSPECTIVE.equals(h.sourceType()) && Objects.equals(h.id(), p.getId()));
if (!exists) {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,10 @@ public class ClassReportAiClient {
@Value("${openai.debate.model:gpt-5.4-mini}")
private String debateModel;

/** 클래스 인사이트만 쓰는 모델. 클래스당 1번이라 비용 부담이 작고, 부적절한 글 제외·요약 품질 차이가 커서 따로 둔다 (#657) */
@Value("${openai.insight.model:gpt-5.4-mini}")
private String insightModel;

/** 파싱된 JSON 본문과 토큰 사용량 */
public record AiChatResult(Map<String, Object> json, String rawContent, Integer inputTokens, Integer outputTokens) {
}
Expand All @@ -52,6 +56,10 @@ public String getDebateModel() {
return debateModel;
}

public String getInsightModel() {
return insightModel;
}

public AiChatResult chatJson(String systemPrompt, String userPrompt, int maxOutputTokens) {
return chatJson(model, systemPrompt, userPrompt, maxOutputTokens);
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@

import java.util.ArrayList;
import java.util.LinkedHashMap;
import java.util.HashSet;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Map;
Expand Down Expand Up @@ -127,12 +128,31 @@ public Map<String, Object> validateMemberFeedback(Map<String, Object> json, Memb
}

public Map<String, Object> validateClassInsight(Map<String, Object> json, ClassInsightInput input) {
if ("INSUFFICIENT".equalsIgnoreCase(ReportContent.str(json, "analysis_status"))) {
return limitedClassInsight(input); // 모든 글이 의미 없는 입력이라 요약하지 않음 (#657)
}
String insightText = requireText(json, "insight_text", INSIGHT_TEXT_MAX);
// AI 가 스스로 부적절하다고 표시한 글은 근거·대표 의견에서 뺀다 (#657)
Set<String> excluded = new HashSet<>();
for (String id : ReportContent.stringList(json, "excluded_ids")) {
excluded.add(id.trim());
}

// AI 제외와 서버 기준을 모두 거친 글의 작성자가 3명 미만이면, AI 요약은 믿지 않고 의견 부족 템플릿으로 바꾼다.
// 의미 없는 글만 있는 반에서 AI 가 없는 주장을 지어내는 경우를 막는다 (#657, PRD §14 작성자 3명 기준)
long usableAuthors = input.posts().stream()
.filter(post -> !excluded.contains(post.sourceId()) && InsightPostRules.isSelectable(post.content()))
.map(ClassInsightInput.PublicPost::authorNo)
.distinct()
.count();
if (usableAuthors < ClassReportSnapshotService.INSIGHT_MIN_AUTHORS) {
log.info("[ClassReport] insight limited usable_authors={}", usableAuthors);
return limitedClassInsight(input);
}
List<String> evidenceIds = new ArrayList<>();
for (String id : ReportContent.stringList(json, "evidence_ids")) {
String trimmed = id.trim();
if (input.findPost(trimmed) != null && !evidenceIds.contains(trimmed) && evidenceIds.size() < INSIGHT_EVIDENCE_MAX) {
if (!excluded.contains(trimmed) && selectable(input, trimmed) && !evidenceIds.contains(trimmed) && evidenceIds.size() < INSIGHT_EVIDENCE_MAX) {
evidenceIds.add(trimmed);
}
}
Expand All @@ -142,7 +162,7 @@ public Map<String, Object> validateClassInsight(Map<String, Object> json, ClassI
List<String> highlightIds = new ArrayList<>();
for (String id : ReportContent.stringList(json, "highlight_ids")) {
String trimmed = id.trim();
if (input.findPost(trimmed) != null && !highlightIds.contains(trimmed) && highlightIds.size() < INSIGHT_HIGHLIGHT_MAX) {
if (!excluded.contains(trimmed) && selectable(input, trimmed) && !highlightIds.contains(trimmed) && highlightIds.size() < INSIGHT_HIGHLIGHT_MAX) {
highlightIds.add(trimmed);
}
}
Expand All @@ -157,6 +177,19 @@ public Map<String, Object> validateClassInsight(Map<String, Object> json, ClassI
return insight;
}

/** 입력에 있는 글이면서 운영자 화면에 근거·대표 의견으로 보여줄 수 있는 글인지 (비속어·이유 없는 글 제외, #657) */
private static boolean selectable(ClassInsightInput input, String sourceId) {
ClassInsightInput.PublicPost post = input.findPost(sourceId);
if (post == null) {
return false;
}
if (!InsightPostRules.isSelectable(post.content())) {
log.warn("[ClassReport] insight post dropped source_id={} reason=NOT_SELECTABLE", sourceId);
return false;
}
return true;
}

// ===== 템플릿 (AI 호출 없음) =====

/** 글 없이 투표만 했을 때의 서버 템플릿 (엣지 케이스 PRD 3.3 Case B). 사고 과정 분석은 하지 않고 선택 기록만 보여준다 */
Expand Down Expand Up @@ -232,6 +265,14 @@ private static List<Map<String, Object>> midChoices(List<ClassMidVoteInfo> choic
return list;
}

/** AI 가 요약할 글이 없다고 판단했을 때의 템플릿. 입력 범위는 그대로 기록한다 */
static Map<String, Object> limitedClassInsight(ClassInsightInput input) {
Map<String, Object> insight = limitedClassInsight();
insight.put("coverage", input.coverage());
insight.put("excluded_count", input.excludedCount());
return insight;
}

/** 유효 공개 글 작성자 3명 미만일 때의 템플릿 (PRD §14 개인정보와 소수 의견) */
public static Map<String, Object> limitedClassInsight() {
Map<String, Object> insight = new LinkedHashMap<>();
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -81,7 +81,7 @@ public void generate(Long reportId, LocalDateTime now) {
ClassReportPrompts.MEMBER_FEEDBACK_MAX_OUTPUT_TOKENS);
validated = validator.validateMemberFeedback(result.json(), prepared.memberInput());
} else {
result = aiClient.chatJson(ClassReportPrompts.CLASS_INSIGHT_SYSTEM,
result = aiClient.chatJson(aiClient.getInsightModel(), ClassReportPrompts.CLASS_INSIGHT_SYSTEM,
ClassReportPrompts.classInsightUser(prepared.insightInput()),
ClassReportPrompts.CLASS_INSIGHT_MAX_OUTPUT_TOKENS);
validated = validator.validateClassInsight(result.json(), prepared.insightInput());
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ private ClassReportPrompts() {
"strength": {"title": "20자 이하", "body": "120자 이하"} 또는 null,
"next_focus": {"title": "20자 이하", "body": "120자 이하"} 또는 null,
"next_question": "100자 이하",
"evidence_refs": [{"field": "judgment_basis 또는 strength 또는 next_focus", "source_id": "p:12 또는 c:34", "quote": "원문 구절"}],
"evidence_refs": [{"field": "judgment_basis 또는 strength 또는 next_focus", "source_id": "p:12 또는 c:34 또는 d:5", "quote": "원문 구절"}],
"analysis_status": "SUFFICIENT 또는 LIMITED"
}
규칙 4 에 해당하면 위 형식 대신 {"analysis_status": "INSUFFICIENT"} 만 출력합니다.
Expand All @@ -48,10 +48,24 @@ private ClassReportPrompts() {
1. 숫자(참여율·비율·인원)는 [집계] 에 있는 값만 그대로 쓰고 새로 계산하거나 추정하지 않습니다. 빈도를 단정하는 "많이 나온 의견" 대신 "눈에 띈 의견" 으로 표현합니다.
2. 이름·개별 참여자의 변화·비공개 내용을 쓰지 않습니다. 특정 작성자를 지목하지 않습니다.
3. evidence_ids 는 [공개 의견] 의 source_id 만 1~5개 씁니다. highlight_ids 는 운영자에게 추천할 대표 의견 1개와 다른 관점의 의견 1개(없으면 생략)로 최대 2개이며 역시 [공개 의견] 의 source_id 만 씁니다.
4. 의견에 등급·우열을 매기지 않습니다. "~했어요" 체로 씁니다.
5. 주제와 무관한 글, 비속어·공격적 표현이 들어간 글은 evidence_ids·highlight_ids 로 고르지 않고 요약에도 쓰지 않습니다.
4. 의견에 등급·우열을 매기지 않습니다.
5. 먼저 [공개 의견] 을 하나씩 보고 아래에 해당하는 글의 source_id 를 모두 excluded_ids 에 적습니다. excluded_ids 에 적은 글은 evidence_ids·highlight_ids 로 고르지 않고 요약에도 쓰지 않습니다.
- 주제와 무관한 글 (예: 급식, 장난, 웃음만 있는 글)
- 의미 없는 입력 (예: "ㅋㅋㅋㅋ", "ㅎㅎ", "asdf", "ㅁㄴㅇㄹ", "qwerasdf", 같은 글자나 숫자 반복, 아무 말이나 적은 글)
- 이유 없이 입장만 말한 글 (예: "몰라요", "그냥요", "당연히 안 되지")
- 비속어(***)·비하·조롱이 들어간 글 (예: "바보냐", "ㅋㅋ 그래서 그런 거지")
- 다른 참여자의 이름(예: "민수야", "지은이 말처럼")을 부르거나 특정 사람을 겨냥한 글
고를 글이 부족하면 개수를 줄입니다. 개수를 채우려고 excluded_ids 의 글을 고르지 않습니다.
6. insight_text 는 2~3문장으로, 운영자가 수업을 되짚는 데 도움이 되도록 씁니다.
- 배틀 제목이나 주제를 다시 설명하지 않습니다. "AI가 쓴 과제를 인정해야 하는지에 대해" 처럼 주제로 시작하지 말고 "찬성 쪽은 ~" 처럼 바로 내용으로 들어갑니다.
- 양쪽이 각각 어떤 기준으로 판단했는지 씁니다. 한쪽 입장만 있으면 그 안에서 나온 서로 다른 이유를 씁니다.
- 댓글로 오간 반박이 있으면 어떤 논점이 맞섰는지 씁니다.
- [집계] 에서 사전→사후 인원이 바뀐 선택지가 있으면 "찬성 3명 → 4명" 처럼 집계 숫자 그대로 한 번 씁니다. 누가 바꿨는지, 모두 바꿨는지는 추정하지 않습니다.
7. 모든 문장을 "~했어요", "~였어요" 처럼 "~요" 로 끝냅니다. "~습니다", "~다" 로 끝내지 않습니다.
8. excluded_ids 를 빼고 나면 요약할 글이 하나도 없으면 다른 내용을 만들지 않고 {"analysis_status": "INSUFFICIENT"} 만 출력합니다. 의미 없는 글로 요약을 지어내지 않습니다.
출력은 아래 형식의 JSON 객체 하나만 씁니다. 다른 텍스트를 붙이지 않습니다.
{
"excluded_ids": ["p:3"],
"insight_text": "200자 이하",
"evidence_ids": ["p:1", "c:2"],
"highlight_ids": ["p:1"]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ public class ClassReportSnapshotService {
static final int INSIGHT_INPUT_MAX_CHARS = 12_000;
static final int INSIGHT_POST_MAX_COUNT = 60;
static final int INSIGHT_POSTS_PER_AUTHOR = 2;
static final int INSIGHT_MIN_AUTHORS = 3;
public static final int INSIGHT_MIN_AUTHORS = 3;
static final int PARENT_CONTEXT_MAX_CHARS = 200;

public static final String KEY_CUTOFF_AT = "cutoff_at";
Expand Down Expand Up @@ -166,7 +166,7 @@ private AiJob startJob(ClassReport report, AiJobType type, LocalDateTime now) {
.classroom(classroom)
.member(member)
.build()));
job.start(aiClient.getModel(), now);
job.start(type == AiJobType.CLASS_INSIGHT ? aiClient.getInsightModel() : aiClient.getModel(), now);
report.startGenerating(job);
return job;
}
Expand All @@ -187,6 +187,8 @@ public void complete(Long reportId, Long jobId, Map<String, Object> validated, C
report.limit(validated, now); // AI 가 분석할 이유가 없다고 판단해 서버 템플릿으로 대체한 경우
} else if (report.getType() == ClassReportType.MEMBER_FEEDBACK) {
report.complete(validated, now);
} else if ("LIMITED".equals(validated.get("analysis_status"))) {
report.limit(withInsight(report.getContent(), validated), now); // 요약할 글이 없어 템플릿으로 대체 (#657)
} else {
report.complete(withInsight(report.getContent(), validated), now);
}
Expand Down Expand Up @@ -348,6 +350,7 @@ private List<MemberFeedbackInput.Statement> debateReplies(Long classId, ClassMem

/**
* 인사이트 입력: 공개 의견·댓글을 작성자별 최신 2건으로 추리고 입장을 번갈아 섞어 최대 60건, 12,000자.
* 이유를 읽을 수 없는 짧은 글은 넣지 않는다 ({@link InsightPostRules#hasReason}).
* 작성자는 익명 번호로만 표기한다 (PRD §14). 한 작성자가 같은 내용을 반복한 글은 처음 것만 남긴다 (RP-10).
*/
public ClassInsightInput buildInsightInput(Classroom classroom, Map<String, Object> snapshot) {
Expand All @@ -362,6 +365,9 @@ record Raw(Long userId, LocalDateTime createdAt, ClassInsightInput.PublicPost po
}
List<Raw> raws = new ArrayList<>();
for (Perspective p : perspectiveRepository.findByClassroomIdAndStatusOrderByCreatedAtAsc(classId, PerspectiveStatus.PUBLISHED)) {
if (!InsightPostRules.hasReason(p.getContent())) {
continue; // 이유를 읽을 수 없는 글은 요약할 내용이 없고 작성자 수에도 넣지 않는다 (#657)
}
raws.add(new Raw(p.getUser().getId(), p.getCreatedAt(), new ClassInsightInput.PublicPost(
MemberFeedbackInput.sourceId(MemberFeedbackInput.SOURCE_PERSPECTIVE, p.getId()),
MemberFeedbackInput.SOURCE_PERSPECTIVE, p.getId(), 0,
Expand All @@ -370,7 +376,7 @@ record Raw(Long userId, LocalDateTime createdAt, ClassInsightInput.PublicPost po
}
for (PerspectiveComment c : perspectiveCommentRepository.findByClassroomIdAndHiddenFalseOrderByCreatedAtAsc(classId)) {
Perspective parent = c.getPerspective();
if (parent == null || parent.getStatus() != PerspectiveStatus.PUBLISHED) {
if (parent == null || parent.getStatus() != PerspectiveStatus.PUBLISHED || !InsightPostRules.hasReason(c.getContent())) {
continue;
}
raws.add(new Raw(c.getUser().getId(), c.getCreatedAt(), new ClassInsightInput.PublicPost(
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
package com.swyp.picke.domain.classroom.service.report;

import java.util.regex.Pattern;

/**
* 클래스 인사이트에 쓸 공개 글 기준 (#657).
* <ul>
* <li>hasReason: 글자·숫자가 {@value #MIN_MEANINGFUL_CHARS}자 이상이고 서로 다른 글자가 {@value #MIN_DISTINCT_CHARS}개 이상인 글만
* AI 입력과 작성자 수에 넣는다. "몰라요 그냥요", "ㅋㅋㅋㅋ", "ㅁㄴㅇㄹ", "asdfasdf", "11111111", "아아아아아아아아" 처럼
* 이유를 읽을 수 없는 글은 요약할 내용이 없다. 자판을 아무렇게나 누른 긴 글("qwerasdf")은 프롬프트에서 제외시킨다</li>
* <li>isSelectable: 근거·대표 의견으로 운영자 화면에 보여줄 수 있는 글. 이유가 있고 비속어가 없어야 한다</li>
* </ul>
* 실명 지목·조롱처럼 서버가 판별하기 어려운 글은 프롬프트로 막는다.
*/
public final class InsightPostRules {

static final int MIN_MEANINGFUL_CHARS = 8;
static final int MIN_DISTINCT_CHARS = 5;

/** 한글 완성형·영문·숫자 외(공백, 문장부호, 이모지, ㅋㅎㅠ 같은 자모)는 글자 수에서 뺀다 */
private static final Pattern NOT_MEANINGFUL = Pattern.compile("[^가-힣A-Za-z0-9]");

private InsightPostRules() {
}

public static boolean hasReason(String content) {
if (content == null) {
return false;
}
String meaningful = NOT_MEANINGFUL.matcher(content).replaceAll("").toLowerCase(java.util.Locale.ROOT);
if (meaningful.length() < MIN_MEANINGFUL_CHARS || meaningful.chars().allMatch(Character::isDigit)) {
return false;
}
return meaningful.chars().distinct().count() >= MIN_DISTINCT_CHARS;
}

/** content 는 원문이어도, 이미 가린 글이어도 된다 */
public static boolean isSelectable(String content) {
return hasReason(content) && !ReportProfanityMasker.mask(content).contains(ReportProfanityMasker.MASK);
}
}
2 changes: 2 additions & 0 deletions src/main/resources/application.yml
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,8 @@ openai:
model: gpt-4o-mini
debate:
model: ${OPENAI_DEBATE_MODEL:gpt-5.4-mini}
insight:
model: ${OPENAI_INSIGHT_MODEL:gpt-5.4-mini}
moderation:
url: https://api.openai.com/v1/moderations
model: omni-moderation-latest
Expand Down
Loading
Loading