📝 PeriodStats intValue 변환 의도 주석 추가

[s26059-maker]

배경

AI 모듈 감사 과정에서 CLAUDE.md 서술과 실제 코드가 어긋난 지점들을 발견해
문서를 실제 동작 기준으로 정정했습니다. CLAUDE.md는 .gitignore 대상이라
이 PR에 실제로 포함되는 변경은 FeedbackService 주석 3줄뿐입니다.

변경

FeedbackService의 .intValue() 호출 3곳에 의도를 명시하는 주석 추가.
리포지토리 count 결과(Long)를 PeriodStats 필드 타입(Integer)에 맞추는
정상 변환인데, 불필요한 narrowing으로 오해할 소지가 있어서 남겨둡니다.
(백로그에 있던 "PeriodStats Integer→Long 패치"는 Integer 유지로 확정)

함께 정리한 것 (로컬 CLAUDE.md, 커밋 안 됨)

• 8절 로드맵: "AI 문제 생성 실패 fallback 로직이 최우선 구현 과제"로
  적혀 있었으나 실제로는 이미 구현 완료 상태였음 → 정정
• 8.6절 신설: 생성 실패가 예외가 아니라 GenerationItem.failure 레코드로
  전파되는 실제 구조 서술
• AI 모듈 예외 3종(ai/port/ 위치) 정리.
  InstantFeedbackFailedException만 SubmissionService가 흡수해
  GlobalExceptionHandler 매핑이 없다는 차이 명시
• 타임아웃/시도 횟수 현행화, 익명 닉네임 토글 서술 추가

백로그에 추가한 항목

1. ai.exec.timeout-ms 범위 검증 누락 (다른 두 곳만 폴백 적용됨)
2. 즉시 피드백 동기 호출 구조 — 11월 통합 테스트 때 실측 후 비동기화 판단
3. 제출 단위 vs 사용자 단위 익명 모델 충돌 @지우
4. NicknameService 내부 폴백이 "AI 실패 → 503" 계약을 무력화 @서하

3·4번은 답변 주시면 후속 처리하겠습니다.