feat(reports): 관리자 회의록 재요약 엔드포인트

[yuchem2]

개요

회의록 요약을 다시 생성하는 관리자 전용 엔드포인트 POST /reports/:id/resummarize 를 추가합니다. 요약이 실패한 회의록 재시도 + 이미 성공한 회의록을 새 프롬프트로 재요약(A/B) 하는 용도입니다.

인증

• 회원/계정 개념이 없는 제품이라 단일 운영자 시크릿(Bearer 토큰) 으로 보호.
• Authorization: Bearer <ADMIN_API_TOKEN> 헤더를 AdminGuard 가 검증.
• ADMIN_API_TOKEN 미설정 시 엔드포인트 자동 비활성(403) → 무방비 노출 방지. 토큰 불일치는 401.

동작

• 대상: summaryStatus !== 'pending' (done + failed 모두). 진행 중(pending)이면 409.
• 저장된 transcript + chat 을 SummarizerPort 로 재요약 → 기존 summary 교체.
• 중간 pending 을 거치지 않고 done/failed 로 직접 전이 → 재요약 도중 크래시가 나도 회의록이 영구 pending 으로 갇히지 않음.
• 응답: 재요약된 ReportDetailResponse.

테스트

TDD red(066f644) → green(b4f9590). 백엔드 652개 unit + reports e2e green, lint/build OK.

운영 활성화

• GitHub Secret ADMIN_API_TOKEN 등록 (미설정이면 운영에서 403 으로 안전).
• 로컬은 apps/backend/.env 에 ADMIN_API_TOKEN 설정

[gemini-code-assist]

Code Review

This pull request introduces an administrator endpoint (POST /reports/:id/resummarize) to allow re-summarizing meeting reports, secured by a single admin API token and an AdminGuard using constant-time comparison. It updates the domain model (MeetingReport and PipelineState) to support direct transitions to done or failed states without an intermediate pending state, preventing permanent pending locks. The review feedback highlights a critical issue in the error handling of the resummarize service method: catching summarizer errors without rethrowing them leads to an incorrect 200 OK response on failure, and a failed re-summarization attempt on an already successful report would inappropriately downgrade its status to failed.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

1. 에러 전파 누락 및 HTTP 응답 일관성 문제\n현재 resummarize 메서드는 요약기(summarizer.summarize) 호출 중 에러가 발생하면 이를 catch하여 내부적으로 실패 상태만 기록하고 에러를 다시 던지지(throw) 않습니다. 이로 인해 관리자가 재요약 API(POST /reports/:id/resummarize)를 호출했을 때, 실제로는 요약에 실패했음에도 HTTP 200 OK 응답과 함께 실패 상태의 리포트 본문이 반환됩니다. 동기식 HTTP 요청-응답 사이클에서는 실패 시 적절한 5xx 에러(예: 500 Internal Server Error)를 반환하도록 에러를 상위 레이어로 전파하는 것이 올바릅니다.\n\n### 2. 기존 성공 데이터의 불필요한 상태 격하(Downgrade) 위험\n이미 성공적으로 요약이 완료된(done) 회의록을 대상으로 재요약을 시도하다가 일시적인 LLM 장애 등으로 실패할 경우, 기존의 성공적인 요약본이 보존되더라도 상태가 failed로 변경되어 사용자 화면에서 "요약 실패"로 표시되는 심각한 UX 퇴행이 발생할 수 있습니다. 기존 상태가 done이었던 경우에는 상태를 failed로 격하하지 않고 기존의 성공 상태를 유지하도록 에러만 던지고 DB 저장을 건너뛰는 것이 안전합니다.\n\n참고: 이 변경을 적용하면 관련 유닛 테스트(재요약 Summarizer 가 throw 하면...)도 예외 발생을 기대하도록 수정되어야 합니다.

    } catch (err) {\n      const message = err instanceof Error ? err.message : String(err);\n      // 기존 상태가 이미 'done'인 경우, 일시적 요약 실패로 인해 기존 성공 상태를 'failed'로 격하하지 않도록 보호합니다.\n      if (report.pipeline.summaryStatus === 'failed') {\n        report.markResummaryFailed(message, this.deps.clock.now());\n        await this.deps.repository.save(report);\n      }\n      throw err;\n    }

[yuchem2]

맞는 요청이기 때문에 반영하도록 하겠음

[yuchem2]

/gemini review

[gemini-code-assist]

Code Review

This pull request introduces an administrative endpoint (POST /reports/:id/resummarize) to allow re-summarizing meeting reports using saved transcripts and chat logs, secured by an AdminGuard using a single ADMIN_API_TOKEN. The feedback focuses on two main areas: first, ensuring that resummarization is only permitted when the STT stage has successfully completed (sttStatus === 'done') to prevent empty inputs to the LLM; second, addressing a potential timing attack vulnerability in safeTokenEqual by hashing both tokens before comparison to avoid leaking token length information.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.