🎁선물하기 펀딩 서비스 (11.13 ~ 12.15)

사용자가 등록한 상품에 대해 다른 사용자들이 펀딩개념으로 자금을 모을 수 있는 서비스 입니다.

프로젝트 기능 및 설계

[회원가입 & 로그인]

⭐회원가입

• 자체 회원가입
• 소셜로그인 (OAuth) : 카카오, 네이버

⭐로그인 (JWT + Redis)

• JWT의 보안강화를 위해 Refresh Token을 Redis에 저장하는 방식으로 구현.
• AccessToken 만료시 Refresh Token으로 Access Token 재발급.

[회원 관련 기능]

⭐회원 정보 조회

• 본인의 회원 정보와 등록한 상품 & 상품의 펀딩 정보(배송이 완료된 펀딩 제외) 확인 가능.

⭐회원 정보 수정

• 회원정보 수정 가능.

⭐사용자 검색

• 이메일을 통해 사용자 검색 -> ES 이용한 구현

[친구 관련 기능]

⭐친구 추가 요청

• 자신에게 요청을 보낼 수 없음.
• 이미 요청 보낸 사용자에게 보낼 수 없음.
• 이미 친구인 사람에게 보낼 수 없음.
• A -> B에게 요청 보냈을 때 WAIT 상태라면 B -> A에게도 요청 보낼 수 없음. ex) A(id 1) -> B(id 2)에게 친구 요청 시
  • 친구 목록 테이블에 1 2 등록일시 WAIT 1 레코드 생성. //todo A->B요청과 B->A요청이 동시에 일어났을 때 동시성 이슈 해결

⭐친구/친구요청 목록 조회

• QueryParam으로 FriendState를 받아 ACCEPT이면 친구 목록, WAIT이면 요청 목록을 보여줌.

⭐친구요청 수락/거절

• 친구 요청을 수락하면 요청자, 대상자 모두 업데이트. ex) 1 2 등록일시 WAIT 1 레코드에서 B가 요청 수락시 WAIT -> ACCEPT로 바뀜. B의 친구목록을 조회할 때 A가 떠야하므로 2 1 등록일시 ACCEPT null 이런 형태의 레코드 함께 삽입.
• 로그인 한 사용자만이 자신의 요청을 업데이트 할 수 있어야함.
• 거절하면(REJECT) 스켸줄러를 이용해 하루에 한 번씩 거절된 레코드 조회 후 삭제.

⭐친구의 펀딩 상품 조회

• 친구 아이디로 해당 사용자가 등록한 펀딩 상품 중 펀딩이 진행되고 있는(ONGOING)항목에 대해 보여줌.
• 친구상태(FriendState)가 ACCEPT인 친구만 볼 수 있음.

[상품]

⭐전체 상품 목록 조회

• 상품 테이블에 저장된 상품 정보를 랭킹 순으로 조회

⭐ 상품 검색

• ES를 이용해 상품 조회

[펀딩]

⭐ 펀딩 상품 등록

• 펀딩을 진행할 자신의 상품으로 등록.
• 상품 등록 시 펀딩 진행 기간은 1년으로 자동 지정.

⭐ 펀딩 상품 등록 취소

• 마감일 이전에 펀딩자가 진행 중이던 펀딩을 취소한 경우
• 등록한 상품 중에서 진행되고 있던 펀딩에 대해 취소 가능
• 펀딩 금액이 쌓였다면 자기 지갑으로 펀딩 금액만큼 반환됨.
• 친구가 조회할 때 더 이상 해당 펀딩자의 펀딩 진행 상품으로 조회되지 않음.

⭐ 펀딩 금액 달성

• 펀딩 금액 달성 시 더 이상 다른 사용자의 후원 불가 및 다른 친구에게 노출 안 됨.
• 펀딩이 완료된 상품은 펀딩 상품 등록 취소 불가(== 자신의 지갑으로 금액 반환 불가).
• 달성 및 주소 확인 메일 전송 후 1일 뒤 지정한 주소로 상품 배송. (이때까진 배송상태 DeliveryState.WAIT)
• 배송 후 펀딩자의 펀딩 상품 목록에서 숨겨짐.(funding_state = delivery_success)

⭐ 펀딩 금액 미달성

• 마감일 임박 3일 전부터 안내 메일 발송.
• 마감일 도래 시 펀딩 상품 목록에서 숨겨짐.
• 마감일까지 펀딩이 완료되지 않았다면 펀딩자의 지갑으로 펀딩 금액만큼 반환.

[후원]

⭐ 후원하기

• 상대방이 등록해놓은 펀딩 상품에 대해 후원할 금액을 입력해서 지갑에서 금액 감소 후 후원완료.
• 지갑의 돈은 펀딩 금액보다 커야함. (작을 시 미리 충전해서 사용) -> 동시성 이슈 해결문제
• 친구인 사용자여야함.
• 펀딩 상품이 친구에게 등록돼있어야 하고 펀딩 진행 중이어야 함.
• 펀딩 상품의 후원 총액보다 많이 후원할 수 없음.
• 후원하고 해당 펀딩 상품의 후원 총액(total)도 증가

⭐ 후원취소

• 후원 진행 후 1시간 이내의 건에 대해서만 취소 가능.
• 취소 후 후원자의 지갑으로 금액 반환.
• 후원한 상품에도 취소 금액만큼 펀딩 총액 감소.

[거래]

⭐ 지갑에 총액 변동시마다 거래 상세 내역 저장

• 후원 : transactionType = USE
• 후원 취소 : transactionType = CANCEL
• 펀딩 취소 : transactionType = REFUND

[결제]

⭐ 내 지갑으로 금액 충전

• 결제 금액만큼 금액 충천. 포트원 API - 카카오페이 테스트 결제 시스템 사용

ERD

Trouble Shooting

[Trouble Shooting docs](https://github.com/soeun135/GiftFunding/blob/main/doc/TROUBLE_SHOOTING.md

Tech Stack

• Programming
• Framework
• Database
• security
• search engine
• Cache & Concurrency
• 
• Configuration Management