feat: 게시글 AI 요약 큐 조회 API 추가

[taejinn]

🔍 개요

• 게시글 AI 요약 작업 상태를 운영자가 확인할 수 있는 Admin read-only API를 추가했습니다.
• 이 PR은 핵심 사용자 기능 범위가 아니라, 테스트/운영 중 요약 실패 케이스를 조회해서 원인을 확인하기 위한 선택적 관측 API입니다.
• 팀에서 Admin 조회 API가 이번 범위에 불필요하다고 판단하면 이 PR은 머지하지 않고 닫아도 됩니다.
• 상태 변경이나 수동 재시도 API는 넣지 않고, 큐 현황과 실패 원인 조회만 제공합니다.

• Refs [공통] 게시글 요약 #2248
• Stacked on feat: 게시글 AI 요약 핵심 기능 추가 #2295

---

🚀 주요 변경 내용

• GET /admin/articles/ai-summaries/overview를 추가했습니다.
  • 상태별 개수: WAIT, PROCESSING, SUCCESS, FAILED, SKIPPED
  • 큐 상태: 즉시 처리 가능 WAIT, 지연 WAIT, 처리 중, lock 만료 PROCESSING, 재시도 가능 FAILED
  • 설정 요약: scheduler delay, batch size, retry window, max retry count
• GET /admin/articles/ai-summaries를 추가했습니다.
  • page, limit, status 필터를 지원합니다.
• GET /admin/articles/ai-summaries/{summaryId}를 추가했습니다.
  • 원문 content, prompt, parsed document text, raw provider body는 노출하지 않습니다.
• 실패 원인은 RATE_LIMIT, NETWORK_TRANSIENT, VALIDATION 등으로 분류하고, API key/Bearer token/URL query/provider body는 마스킹합니다.
• 목록 조회는 projection 기반 native query + countQuery로 구성해 N+1을 피했습니다.

---

💬 참고 사항

• 이 PR은 feat: 게시글 AI 요약 핵심 기능 추가 #2295 이후에 머지되어야 합니다.
• 핵심 요약 노출 기능은 #2295에 있으며, 이 PR은 장애/오류 케이스 확인용 보조 PR입니다.
• Docker daemon 종료로 AdminArticleAiSummaryApiTest의 Testcontainers 실행은 로컬에서 완료하지 못했습니다.
• 다음 테스트를 통과했습니다.
  • ./gradlew test --rerun-tasks --tests 'in.koreatech.koin.unit.domain.community.article.service.summary.*' --tests 'in.koreatech.koin.infrastructure.upstage.client.*Test'
  • git diff --check

---

✅ Checklist

• 코드 스타일 가이드 준수
• 테스트 코드 포함됨
• 보안 및 민감 정보 검증

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b332a10c-ffbb-424d-8c4f-f8aa16a2f47b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/2248-ai-summary-admin-queue

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[taejinn]

요청에 따라 PR을 닫습니다.