Skip to content

#651 [Fix] 삭제된 클래스·나간 멤버의 AI 리포트·토론 생성 중단 - #652

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

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

Conversation

@si-zero

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

Copy link
Copy Markdown
Member

#️⃣ 연관된 이슈

📝 작업 내용

마감 뒤 클래스가 삭제됐거나 멤버가 나가기·내보내기 된 경우에도 리포트와 AI 토론 주장이 생성·저장되던 문제를 막습니다. 아무도 볼 수 없는 결과에 AI 비용이 나가지 않게 합니다 (PRD F16, 18절).

✨ Feat

내용 파일
리포트 상태 CANCELED 추가 (재시도 대상 아님, 조회 시 NOT_ELIGIBLE) ClassReportStatus.java, ClassReport.java, ClassResultServiceImpl.java
status 제약이 있는 DB 용 SQL + 롤백 V20261119_02__class_reports_status_canceled.sql, V20261119_rollback__class_reports_status_canceled.sql

🐛 Fix

내용 파일
생성 전: 클래스 삭제·멤버 비활성이면 AI 호출 없이 CANCELED ClassReportSnapshotService.java (prepare)
생성 중 삭제: 토큰 비용은 기록하고 결과는 게시하지 않음. 실패·멈춤 복구 경로도 재시도 대신 CANCELED ClassReportSnapshotService.java (complete·fail·recoverStale)
AI 토론 주장 생성 중 클래스가 삭제되면 주장 저장 안 함 (비용은 기록) ClassDebateSessionService.java
ClassBattleType의 오래된 "2차 범위" 주석 정리 ClassBattleType.java
명세 갱신 docs/api-specs/class-api.md

📌 공유 사항

  1. 운영 DB 에 V20261119_02__class_reports_status_canceled.sql 실행을 권장합니다. 마이그레이션 SQL 로 만든 테이블은 제약이 없어 아무 변화가 없고, Hibernate 로 만든 테이블에 제약이 있으면 CANCELED 를 허용하도록 다시 만듭니다. 멱등입니다.
  2. 클래스 인사이트는 클래스가 삭제됐을 때만 건너뛰고, 멤버가 나간 경우에는 그대로 만듭니다.
  3. 생성 중 삭제된 경우 AI 호출은 이미 끝났으므로 ai_jobs 는 SUCCEEDED 로 두어 토큰 비용을 남깁니다.

✅ 체크리스트

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

📸 스크린샷

  • 전체 테스트 668건 통과. 통합 테스트 4건 추가: 삭제된 클래스의 대기 리포트 CANCELED(AI 호출 0회), 내보낸 멤버 리포트만 CANCELED·인사이트는 생성, 리포트 생성 중 삭제 시 미게시·비용 기록, 토론 주장 생성 중 삭제 시 미저장·비용 기록

💬 리뷰 요구사항

  1. 생성 중 삭제된 경우 ai_jobs 를 SUCCEEDED 로 두는 방식이 비용 집계 기준과 맞는지 의견 부탁드립니다.

@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 linked an issue Nov 19, 2026 that may be closed by this pull request
5 tasks
@si-zero
si-zero merged commit 3a1a3ff into dev Nov 19, 2026
1 check passed
@si-zero
si-zero deleted the fix/#651 branch November 19, 2026 02:31
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: 삭제된 클래스·나간 멤버의 AI 리포트·토론 생성 중단

1 participant