<aside>

https://docs.google.com/forms/d/e/1FAIpQLSfQ5u0FIwBWnF1MXqDo_3iIuLPzMt5c9a9P9nA2n5NwB333xg/viewform?usp=header

‣

피드백 기록 DB - 홍길동 (복사해서 사용)

</aside>

1조

🗃️ GitHub

https://github.com/team5th-project/pay-system

📽️ 시연 영상

🗒️ 발표 자료

커머스 1기

1. 프로젝트

• 팀명 : 오조의 마법사
  • 개인별 역할
• 프로젝트명 : pay-system
• 프로젝트 소개

본 프로젝트는 PortOne 결제 시스템을 연동한 주문, 결제 처리 백엔드 시스템 구현을 목표로 합니다. (프론트엔드는 Sparta 에서 제공한 부분을 사용했습니다. ) 사용자는 상품을 주문하고 포인트를 사용하여 결제를 진행할 수 있으며, 결제 자체는 PortOne 을 통해 PG 결제창에서 진행됩니다. 또한 결제 실패, 재고 부족 등의 예외 상황에서는 결제 취소 및 포인트 복구 등의 보상 트랜잭션을 수행하여 정합성을 유지합니다. 사용자는 주문 확정 전 환불 요청을 할 수 있고, 환불 처리 시 PortOne 결제 취소 API 를 호출하여 실제로 결제 취소가 이루어집니다. - 요구사항 - 기능 요구사항

    - 주문 및 결제
    사용자는 상품 주문을 생성하고 결제 시 범위내에서 포인트를 사용할 수 있습니다.
    주문 생성 시 결제 대기 상태가 되며, 결제 처리 이후 상태가 변경됩니다. 
    
    - 결제 처리
    사용자는 PortOne 결제창을 호출하여 PG 결제를 진행합니다.
    결제 완료 후 서버에서 paymentId 를 이용해서 결제 상태를 검증합니다.
    승인 금액이 주문 금액과 일치해야 결제가 정상처리됩니다. 
    
    - 주문 완료 처리 
    결제 검증 성공 시 서버에서 재고 차감, 상태 변경, 포인트 적립, 포인트 내역 저장, 멤버십 업데이트 처리를 수행합니다.
    
    - 예외 처리
    결제실패, 승인금액 불일치, 포인트 부족, 재고 부족의 경우 결제가 실패됩니다.
    (이후 같은 주문에 대한 재결제 요청 시 새로 결제 정보가 생성됩니다.)
    내부 오류로 인한 실패 처리 시 포인트 복구, 환불 처리가 이루어집니다. 
    
    - 환불 처리
    결제 취소 API 를 호출하여 결제상태와 주문상태를 환불처리 합니다.
    사용 포인트는 복구되고, 적립 포인트는 차감되며, 멤버십 업데이트 처리가 수행됩니다.
    환불 테이블에 환불 이력이 저장됩니다.
    - 비기능 요구사항
    모든 결제 요청은 멱등성을 보장합니다.
    Webhook 또는 결제 확정 요청 중 중복 요청이 발생해도 동일한 결과를 반환합니다.
    결제 검증은 서버 → PortOne API 를 통해 무조건 재확인 합니다.
    결제 실패, 내부 오류 발생 시 보상 트랜잭션을 통해 정합성을 유지합니다.
- 구현할 기능 정리 :
    - 주문 기능 
    - 주문 생성 API 
    - 주문 상태 관리
    - 결제 기능
    - 결제 시도 record 생성
    - 포인트 처리
    - PortOne 결제창이랑 연동
    - 결제 확정 처리 API
    - WebHook
    - 결제 검증
    - 결제 조회 API
    - 승인 금액 검증
    - 멱등성 처리 (실패 시 취소)
    - 주문 완료 
    - 재고 차감, 포인트 적립, 멤버십 등급 업데이트 
    - 상태 업데이트
    - 포인트 거래 이력 저장
    - 예외처리, 보상처리
    - 결제 실패 처리 
    - 재고 부족시 결제 취소 
    - 포인트를 사용했다면 포인트 복구
    - 환불 기능 
    - 환불 요청 API 
    - 환불 상태 검증
    - PortOne 결제 취소 API 호출 
    - 사용한 포인트 복구
    - 환불 이력 관리
    - 멤버십 등급 업데이트

2. 기획 관련 메모

• Git Convention

• 브랜치명 Feat/#이슈번호-도메인-기능

• 커밋 메시지

특성 시작 대문자, 특성 이후 : (띄어쓰기까지) 하고 메시지 적기 (메시지 내용은 한영 상관 X) ex) Feat: 고양이를 추가했습니다. ex) Fix: 고양이 한 마리 더 데려왔습니다.

• 이슈 convention

이슈 생성 시 만들어둔 컨벤션에 맞춰서 작성

🏝️ Ground Rules & 회의 시간

20시 40분 데일리스크럼

- 자리비우게 되는 경우 프라이빗 채팅에 남기기
- 매니저님 오시는 경우 멘션하겠습니다~~ by 민교님

10:30, 19:30 -> 튜터님이 참여하시는 정기 데일리 스크럼!

🚩 Goals

* 강의 주차
- 모든 팀원이 학습 로드맵에 맞춰 학습하기!

* 프로젝트 주차
- 모든 팀원이 맡은 역할을 다 할 수 있도록 투명하게 상황 공유하기

* 지난 프로젝트의 레슨런 중 내가 이번 프로젝트에 꼭! 적용할 것 1가지
- (이름) : (지난 프로젝트 KPT 중 Try 작성)

💬 오픈 토론 & QnA

* 팀원들이 학습 중 생긴 **의문점이나 토론 주제**를 자유롭게 등록해보세요.
* 매주 한두 개씩 선정하여 **팀 토론**을 진행하면 학습의 깊이가 깊어질거예요.

🚦 Project Rules

• 개발환경

공유 학습 자료 저장소

Code Convention

Github Rules

KPT 회고

주간 학습 회고

마일스톤

발표회 피드백

📢 SA 피드백

3/17 이전
	비즈니스 상 이상거래는 따로 탐지하기 
	(결제금액이 다른 경우는 환불 완료가 아닌 결제 실패로 처리)
	
	주문 생성 이후 일정 시간 이후 Pending 없애기
	오랜시간 pending 상태로 남겨두면 안 됨 (취소 등으로 수정)

	포인트 처리할때도 동시성 문제 처리하기 
	(한 계정에서 동시에 존재하는 포인트를 사용하는 경우)
	(외부 (portone 등) 에서 오류가 났을 때 포인트 복구방법)

	환불 파트도 위에서 찝어줬던 부분 한 번 고쳐보기 

	상품 조회하고 금액 한 번 더 검증 
	(주문 생성할 때 총액) 정상이면 주문 저장 

	webhook 들어오는 시퀀스를 잘 이해해줘야합니당
	portone 으로 들어가는 경우와 아닌 경우를 잘 분리해서 작성 
	
3/18
	
	API 명세서 형식을 CommonResponse 로 맞추기 
	명세서 문서 하나로 합쳐서 튜터님께 보내기 

3/19

	PR 단위 작게하기 (리뷰 하기 쉽게)
	자주 커밋하기
	프론트 관련해서 issue 생기면 바로바로 얘기하기 

3. 비즈니스 로직 플로우차트

Flow chart (현민님 작성)

일반 결제 플로우차트

포인트 결제 플로우차트

환불 플로우차트

주문 생성 시퀀스

결제 시퀀스

4. ERD(1차, 수정예정)

박소영 작성

<aside>

webhook table → 생성 완료

주문과 결제는 선택관계가 아님 : 주문이 생성되면 결제도 무조건 생성됨 (pending 상태로) → 적용 완료

portone 에는 이 때 생성된 결제 아이디 보내기 → 적용 완료

point 의 주문 id 는 nullable 로 설계 (확장성을 위해! ex) 생일용 포인트~) → 정책 결정 중

전액환불 구조니까 위쪽에 주문 총액은 해당 상품의 총 가격 → 결제금액은 포인트 사용 후의 금액 (실제로 포트원에 들어가야하는 금액) → 환불 금액 == 환불금액 : 환불 금액 컬럼이 필요없음

→적용 완료

멤버십 등급 테이블로 설계하기 → 수정중 DB 에다가 정책 설계해주기 → 수정중

</aside>