관리자 페이지 & 피드백 로직 점검

날짜
영향도보통

Decisions

D1: 피드백 status 필터를 서버 사이드로 전환

  • Context: 기존 Admin 피드백 페이지는 status 필터를 클라이언트에서 처리했으나, 서버 페이지네이션(20건/페이지)과 충돌하여 다른 페이지의 해당 상태 피드백이 누락되는 버그 존재
  • Choice: Identity findAll에 status 쿼리 파라미터 추가, 전체 파이프라인(Identity→Gateway→Frontend) 관통 전달
  • Alternatives: 클라이언트에서 전체 데이터를 한번에 로드 — 데이터 증가 시 비효율
  • Code Paths: services/identity/src/feedback/feedback.service.ts, services/gateway/src/feedback/feedback.controller.ts, frontend/src/app/admin/feedbacks/page.tsx

D2: 서버 응답에 전체 기준 counts 통계 포함

  • Context: Admin 대시보드의 통계(전체/미해결/버그)가 현재 페이지 20건 기준으로 집계되어 부정확
  • Choice: findAll 응답에 counts 필드 추가 — 상태별(OPEN, IN_PROGRESS, ...) + 카테고리별(cat:BUG, cat:GENERAL, ...) 전체 통계를 항상 반환
  • Alternatives: 별도 통계 API — 추가 호출 비용 대비 현 규모에서 불필요
  • Code Paths: services/identity/src/feedback/feedback.service.ts, frontend/src/app/admin/feedbacks/page.tsx

D3: 버그 리포트 스크린샷 JPEG→WebP 전환

  • Context: 스크린샷을 Base64 Data URL로 DB TEXT 컬럼에 저장하므로 용량 최소화 필요
  • Choice: canvas.toDataURL('image/webp', 0.65) — JPEG 대비 25-35% 용량 절감, 동등 이상 화질
  • Alternatives: JPEG 유지하고 품질만 낮춤 — WebP가 같은 품질에서 항상 더 작음
  • Code Paths: frontend/src/components/feedback/BugReportForm.tsx

Patterns

P1: 서버 사이드 필터 + counts 통합 응답

  • Where: services/identity/src/feedback/feedback.service.ts findAll()
  • When to Reuse: 페이지네이션 API에서 필터링 통계를 대시보드에 표시해야 할 때. 별도 통계 API를 만들기보다 목록 API 응답에 counts를 포함하면 추가 호출 없이 처리 가능

Metrics

  • Commits: 8건, Files changed: 17개