개요

팀: Team04 | 개발에 빠진 닭

기간: 2025-04-28 ~ 2025-05-08

---

목표

“기술적 기반 마련 및 개발 환경 구축을 통해 핵심 사용자 플로우의 MVP와 사용자에게 가치를 제공하는 주요 기능을 개발 및 배포 가능한 상태로 완성합니다.”

핵심 사용자 플로우를 MVP 형태로 구현하여 기술적 기반을 마련합니다. 개발 환경 구축 및 핵심 아키텍처 설계를 완료하여 주요 기능들을 성공적으로 배포합니다. 주요 기능은 사용자에게 서비스를 제공하는 최소 기능 단위를 뜻하며, 기술 스택 검증 및 주요 의존성 해결을 통해 개발 가능한 상태로 만듭니다.

---

요구사항 명세

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

---

기능

• 회원가입
  • 이메일, 비밀번호, 닉네임, 생년월일을 기입하여 회원가입 진행. 이메일 중복확인 및 인증 절차가 포함됨.
  • Spring Secutiry + JWT 인증 포함
  • 비밀번호는 8~30자, 영소문자+숫자+특수기호 포함해야 됨
  • 비밀번호 암호화 저장
  • 닉네임은 중복 불가능
• 로그인
  • 화면의 상단 메뉴바 우측에서 로그인할 수 있음
  • 로그인 시 이메일, 비밀번호 필요
  • JWT(refresh, access) 발급
• 회원 정보
  • 상단 메뉴에서 아이콘을 눌러 내 정보를 조회 가능
  • 내 정보는 닉네임, 이메일, 생년월일 확인 가능
  • 우측 상단에 있는 수정 버튼을 눌러 닉네임과 하단에 하이드 되어 있던 비밀번호 변경 필드가 보임
• 비밀번호 초기화 / 이메일 인증
  • 첫번째 화면에는 이메일 입력 필드와 인증 코드 입력 필드가 있음. 이메일 입력을 해 이메일 발송 버튼을 눌러 인증 코드를 확인 후 기입
  • 인증 코드 입력 대기 시간은 5분
  • 두번째 화면에는 새 비밀번호 필드와 새 비밀번호 확인 필드가 있음. 두 필드가 똑같은 새 비밀번호로 작성될 시 비밀번호 초기화 성공 및 로그인 화면으로 이동
• 메인 화면
  • 키워드 기반으로 AI가 내용 요약한 ‘포스트’가 썸네일, 제목, 내용 일부를 포함한 채로 10개가 실시간으로 보임. 클릭 시 포스트 화면으로 이동
  • 포스트 하단에는 ‘인기 뉴스’(네이버 뉴스)와 ‘인기 유튜뷰’가 있어, 각각 5개씩 키워드에 관련되어 인기가 높은 순서대로 좌측에서 우측으로 표시됨
• 실시간 키워드
  • 메인 화면, 포스트 화면, 키워드 화면, 인기 유튜브 화면, 인기 뉴스 화면의 우측에 메뉴바로 존재
  • 실시간으로 인기 있는 키워드 10개가 내림차순으로 보임. 키워드 하나를 클릭 시 키워드 화면으로 이동
• 키워드 화면
  • 해당 키워드로 짜여진 ai 포스트들 출력
  • 페이지네이션 적용
• 포스트 화면
  • 상단에 제목과 썸네일, 내용 전체가 나옴
  • 포스트 내용 하단에는 댓글 UI가 있음
  • 댓글 UI 하단에는 해당 포스트의 출처(네이버 뉴스, 유튜브)가 5개씩 존재. 클릭 시 해당 출처의 URL에 접속 및 이동
• 댓글
  • 포스트 화면에서 댓글 목록을 조회
  • 로그인한 사용자 대상 댓글 작성, 수정, 삭제
  • 로그인한 사용자 대상 댓글 좋아요/좋아요 취소
• 인기 뉴스 화면
  • 키워드와 연관된 네이버 뉴스들을 보여줌
  • 링크를 클릭할 시 해당 네이버 뉴스 url로 이동
  • 페이지네이션 적용
• 인기 유튜브 화면
  • 키워드와 연관된 유튜브 비디오들을 보여줌
  • 링크를 클릭할 시 해당 유튜브 비디오 url로 이동
  • 페이지네이션 적용
• 스케줄러
  • 1시간 단위 실행
  • 키워드 수집 → 키워드로 네이버 뉴스 및 유튜브영상 검색 → 신규성 평가 → AI LLM 기반 포스트 생성
• 모니터링 시스템

---

QA 통합 테스트

• 테스트 전략은 기획 단계에서 정의한 API 요구사항 명세서를 기반으로 수동 QA 형태로 진행되었습니다.
• 모든 API에 대해 예상 입력/출력, 에러 응답 등을 시나리오로 정리하고, 테스트 결과를 수동으로 기록하여 이상 동작을 검증했습니다.
• QA 진행 도구로는 내부 Notion 템플릿()을 활용했습니다.

결과

API 결과

총 25개 중 24개 정상 작동 확인 → 96% 완성

QA 결과

구현 완료된 기능

• 회원가입
  • 이메일, 비밀번호, 닉네임, 생년월일을 기입하여 회원가입 진행.
  • 이메일 중복확인 및 인증/검증 절차 구현
  • 비밀번호는 8~20자, 영소문자+숫자+특수기호 포함해야 됨
  • 비밀번호 암호화 저장(해싱처리)
  • 닉네임은 중복 불가능(2~10자)
• 로그인
  • 화면의 상단 메뉴바 우측에서 로그인할 수 있음
  • 로그인 시 이메일, 비밀번호 필요
  • JWT(refresh, access) 발급(Cookie)
  • refresh 토큰을 기준으로 access 토큰 제발급
• 보안
  • Spring Secutiry + JWT 인증 포함
  • Spring Security 설정
  • JwtFilter 설정
• 회원 정보
  • 상단 메뉴에서 아이콘을 눌러 내 정보를 조회 가능
  • 내 정보는 닉네임, 이메일, 생년월일 확인 가능
• 메인 화면
  • 키워드 기반으로 AI가 내용 요약한 ‘포스트’가 썸네일, 제목, 내용 일부를 포함한 채로 10개가 실시간으로 보임. 클릭 시 포스트 화면으로 이동
  • 포스트 하단에는 ‘인기 뉴스’(네이버 뉴스)와 ‘인기 유튜브’가 있어, 각각 5개씩 키워드에 관련되어 인기가 높은 순서대로 좌측에서 우측으로 표시됨
• 실시간 키워드
  • 메인 화면, 포스트 화면, 키워드 화면, 인기 유튜브 화면, 인기 뉴스 화면의 우측에 메뉴바로 존재
  • 구글 트렌드 RSS 기반 인기 키워드 추출 → Spring Batch로 1시간 단위 지속
  • 추출된 키워드를 인기 기반 필터링
  • 실시간으로 인기 있는 키워드 10개가 내림차순으로 보임. 키워드 하나를 클릭 시 키워드 화면으로 이동
• 키워드 화면
  • 해당 키워드로 짜여진 ai 포스트들 출력
  • 출력되는 포스트를 정렬 (최신순 / 이름순)
  • 보여지는 포스트와 연관된 출처(유튜브/네이버 뉴스) 리스트 5개 조회
  • 페이지네이션 적용
• 포스트 화면
  • 상단에 제목과 썸네일, 내용 전체가 나옴
  • 포스트 내용 하단 댓글 기능
  • 댓글 UI 하단에는 해당 포스트의 출처(네이버 뉴스, 유튜브)가 5개씩 존재. 클릭 시 해당 출처의 URL에 접속 및 이동
• 댓글
  • 포스트 화면 하단에서서 댓글 목록을 조회
  • 로그인한 사용자 대상 댓글 작성, 수정, 삭제
  • 로그인한 사용자 대상 댓글 좋아요/좋아요 취소
• 인기 뉴스 화면
  • 키워드와 연관된 네이버 뉴스들을 보여줌
  • 페이지네이션 적용
• 인기 유튜브 화면
  • 키워드와 연관된 유튜브 비디오들을 보여줌
  • 페이지네이션 적용
• 스케줄러
  • 1시간 단위 실행
  • 키워드 수집 → 키워드로 네이버 뉴스 및 유튜브영상 검색 → 네이버 뉴스 중 하나로 임시 포스트 생성
• 배포
  • 개발 및 메인 브랜치 PR시 자동 배포 프로세스
  • 개발 서버와 운영 서버 분리해 배포
  • 운영 서버의 DB를 RDS에 연결

---

백로그

미구현

• 메인 화면
  • 키워드 기반으로 AI가 ‘포스트’를 내용을 요약해 작성
• 스케줄러
  • 키워드 신규성 평가 로직
  • 네이버 뉴스 중 하나로 임시 저장된 포스트를 AI LLM Generated 포스트로 변경
• 모니터링
  • 모니터링 개발 및 배포 서버 적용
  • 서버 로그 모니터링 (신규)
• 회원기능
  • 회원 정보 수정
  • 우측 상단에 있는 수정 버튼을 눌러 닉네임과 하단에 하이드 되어 있던 비밀번호 변경 필드가 보임
  • 회원 탈퇴(sort delete 필요)
• 비밀번호 초기화
  • 첫번째 화면에는 이메일 입력 필드와 인증 코드 입력 필드가 있음. 이메일 입력을 해 이메일 발송 버튼을 눌러 인증 코드를 확인 후 기입
  • 인증 코드 입력 대기 시간은 5분
  • 두번째 화면에는 새 비밀번호 필드와 새 비밀번호 확인 필드가 있음. 두 필드가 똑같은 새 비밀번호로 작성될 시 비밀번호 초기화 성공 및 로그인 화면으로 이동

개선 사항

• 공통(기술)
  • 서버 시간대 기준을 UTC로 통일
• 알림 시스템 구축
  • 외부 API(유튜브 등)의 호출 제한 한도 대응 알림 시스템 구축
  • AI LLM 토큰 사용량 대응 알림 시스템 구축
• 실시간 키워드에 해당하는 인기 포스트 조회(GET /posts/top) 오류 해결

---

회고

✅ 잘한 점

• 우선순위 기반 일정 계획 수립 및 스프린트 초반 목표 명확화가 잘 되어 필수 기능이 먼저 구현됨.
• 팀원 간 협업을 통해 수동 QA를 수행했고, 총 25개 API 중 24개가 정상 작동함을 확인하여 기능 완성도를 검증함.
• 주요 기능 개발에 집중하여, 회원 기능과 스케줄러를 제외한 대부분의 핵심 기능을 일주일 내에 구현 완료함.

🤔 아쉬운 점

• 회원 기능과 스케줄러 잡 구현이 지연됨 → 예상치 못한 오류와 디테일이 부족한 기획이 원인으로 보임.
• QA가 수동으로만 이뤄져 반복성이나 자동화 면에서 부족함.

🔧 개선할 점

• 다음 스프린트에는 남은 기능을 우선적으로 마무리하고, 자동화된 테스트 도입을 고려해 QA 효율을 높이자.

---