개요

• 기간: 2025년 5월 9일(금) - 5월 20일(화)
• 목표: 우선순위 높음의 기능 완성
• 팀 구성: 백엔드 6인, 프론트 1인

스코프

스프린트 IN / OUT

우선순위	기능	포함 여부	비고
높음	실시간 포스트 조회 API 오류 해결	IN	GET /posts/top API
높음	LLM 기반 포스트 생성	IN	여러 AI 비교 도입
높음	회원 정보 수정 및 비밀번호 초기화	IN	-
높음	회원 탈퇴	IN	soft delete 적용
높음	키워드 검색	IN	FE 주도
높음	관리자 권한 기능	IN	RBAC
중간	댓글 및 포스트 신고 기능	IN	FE-신고 버튼 / BE-API 추가
중간	관리자 – 회원·댓글·포스트·신고 관리	IN	통합 Admin API
중간	스케줄러 로직 및 안정성 강화	IN	신규성 평가 로직 추가 및 Job Context 검토
중간	로그 모니터링 대시보드	IN	Grafana + Prometheus + Sentry 검토
낮음	포스트·출처 노출 순위 설정	OUT	차기 검토
낮음	외부 API 호출 제한 알림 시스템	OUT	차기 검토

상세 작업 목록

Epic	우선순위	설명	담당자	SP
백로그	높음	실시간 포스트 조회(GET /posts/top) 오류 해결	이태경	8
	높음	서버 시간대 기준을 UTC로 통일	이태경	4
	중간	스케줄러 - 키워드 신규성 평가 로직	윤상민	16
	중간	스케줄러 안정성 강화	이화영	16
	낮음	flyway migration 적용 확인	이화영	8
AI 기능	높음	키워드 기반으로 AI가 포스트를 내용을 요약해 작성	이태경, 김하연, 윤상민	24
회원 기능	높음	회원 정보 수정	윤상민	8
	높음	로그인 비밀번호 변경/초기화	김경래	8
	높음	회원 탈퇴(soft delete 필요)	김하연	16
검색 기능	높음	키워드 검색 기능	FE님	0(FE)
신고 기능	중간	댓글 신고 기능	이하은	4
	중간	포스트 신고 기능	이하은	4
관리자 기능	높음	관리자 권한 기능	이화영, 김경래, 김하연, 이태경, 이하은	8
	중간	관리자 - 회원 관리	이하은	4
	중간	관리자 - 댓글 신고 관리	이하은	4
	중간	관리자 - 포스트 관리	이하은	4
	중간	관리자 - 포스트 신고 관리	이하은	4
모니터링	중간	모니터링 개발 및 배포 서버 적용	김경래	16
	중간	서버 로그 모니터링	이화영	16

Story Point(SP) 합계 ≈ 172 ( 팀 기준 6명 × 5일 × 하루 6시간 = 180±10 내외 → 적정)

사용자 스토리

상세 작업 목록 기반 스토리 생성

사용자 구분	Epic	User Story
사용자	백로그	사용자는, 오류 없이 실시간 인기 포스트를 조회하여 최신 이슈를 놓치지 않을 수 있다.
	AI 기능	사용자는, 키워드별 뉴스를 AI가 요약한 포스트로 읽어서 핵심만 빠르게 파악할 수 있다.
	검색 기능	사용자는, 검색창에 키워드를 입력하면 관련된(또는 유사성이 높은) 포스트 및 연관 출처가 리스트로 표시되어 한눈에 최신 정보를 확인할 수 있다.
	회원 기능	로그인한 회원은, 내 프로필 정보(닉네임)을 수정하여 최신 상태로 유지할 수 있다.
		로그인한 회원은, 비밀번호를 잊었을 때 이메일로 초기화 링크를 받아 재설정할 수 있다.
		로그인한 회원은, 계정을 탈퇴(soft delete)할 수 있고 데이터는 즉시 암호화 및 숨김 처리된다.
	신고 기능	로그인한 회원은, 부적절한 댓글을 신고하여 커뮤니티 질을 지킬 수 있다.
		로그인한 회원은, 허위 정보 포스트를 신고하여 운영자의 검토를 요청할 수 있다.
	관리자 기능	관리자는, 관리자 대시보드에 접근하여 운영 기능을 사용할 수 있다.
		관리자는, 회원 목록을 조회하고 블랙/탈퇴 처리로 관리할 수 있다.
		관리자는, 댓글 신고 목록을 보고 블랙/기각 처리를 하여 커뮤니티 질을 지킬 수 있다.
		관리자는, 포스트 신고 목록을 조회하고 삭제 처리하여 허위 컨텐츠를 제거할 수 있다.
개발자	백로그	개발자는, 애플리케이션 · DB · API 응답의 시간대를 UTC로 통일하여 TZ 헷갈림을 방지할 수 있다.
		개발자는, 키워드 신규성 평가 로직을 Batch에 포함하여 중복된 포스트 생성과 자원낭비를 방지할 수 있다.
		개발자는, 스케줄러 중단 시작/재시도 및 알림 로직을 보강하여 장애 발생 시 빠르게 복구할 수 있다.
		개발자는, flyway migration 이력을 CI에서 검증하여 스키마 불일치를 사전에 방지할 수 있다.
	AI 기능	개발자는, 두 가지 이상의 LLM(Gemini, OpenAI, 클로드) 결과를 비교하여 더 나은 모델을 선정할 수 있다.
	관리자 기능	개발자는, RBAC 기반으로 역할별 API를 제어하여 권한 오용을 차단할 수 있다.
	모니터링	개발자는, Grafana 대시보드에서 API TPS/에러율/응답시간을 실시간 시각화하여 이상 직후를 즉시 파악할 수 있다.
		개발자는, 로그 대시보드에서 오류 로그를 쉽게 확인하고 빠르게 문제를 해결할 수 있다.

UX/UI 흐름

FigJam 링크: [https://www.figma.com/board/T9dM5oVh1Gox1FVbHDyriL/개빠닭?node-id=0-1&t=C0XgNWHPw076Q9sj-1](https://www.figma.com/board/T9dM5oVh1Gox1FVbHDyriL/%EA%B0%9C%EB%B9%A0%EB%8B%AD?node-id=0-1&t=C0XgNWHPw076Q9sj-1)

• 2차 스프린트 핵심 화면
  1. 회원 정보 (수정 및 탈퇴)
  2. 키워드 검색 컴포넌트 추가
  3. 신고 팝업 - 사유 선택 & 제출
  4. 관리자 페이지 (회원/포스트/댓글 신고 관리)

API 명세

[제목 없음](https://www.notion.so/1f13550b7b558077bd42c2c6295b16ad?pvs=21)

테스트 전략

1. 단위(Unit) 테스트

• Service 중심: 비즈니스 로직이 집중된 계층
• 외부 의존성은 Mock 처리

2. 통합(Integration) 테스트

• 실제 Bean과 임베디드 H2 데이터베이스 환경을 통해 검증
• Controller E2E 테스트 중심
• Query 검증이 필요한 경우 Respository 테스트도 포함

3. Code Coverage

• Line Coverage > 70% 이상
• Branch Coverage > 50% 이상
• CI 파이프라인 연동

QA 통합 테스트 시나리오

노션 템플릿:

• 실제 사용자 플로우를 고려한 시나리오 테스트로 확장
  • 예: 회원 가입 → 인증 → 키워드 구독 → 트렌드 확인 등의 일련의 행동 흐름
• 특히, 유저 동시성 및 API 호출 경쟁 상황 등 실제 서비스 환경에서의 Edge Case도 포함

목적: 기능별 API가 아닌 사용자 관점의 플로우 기반 QA 체계를 구축하여 실질적인 버그를 사전에 방지

[제목 없음](https://www.notion.so/1f13550b7b5580008145f8e192c02a5b?pvs=21)

결과

Definition of Done (DoD)

• 로그/시스템 모니터링 대시보드
• 모든 Story → Unit & Integration 테스트 통과
• QA 통합 시나리오 Pass율 100%
• 테스트 커버리지 기준 통과(라인 70%, 분기 50%)
• Swagger 문서 최신화 및 JSON 추출
• 배포 Tag v2.0.0

회고

• 👍 잘한 점

• 🤔 아쉬운 점

• 🔧 개선할 점

• 🚀 다음 액션

Next Actions

• Hourly Keyword/Post Cache (Redis, CDN)
• 모니터링에서 대시보드/패널 추가
• Keyword에 priority STANDARD, REALTIME 을 구분 → 스케줄러 주기 분리
• S2S PoC