Skip to content

Latest commit

 

History

History
282 lines (252 loc) · 17.8 KB

README.md

File metadata and controls

282 lines (252 loc) · 17.8 KB
Raw

MUT Books

  • Mut Books 는 eBook 마켓과 eBook리더로 이루어진 서비스입니다.

🔗 Mutbooks 바로가기

📍Stack

Stack
BackEnd
Build Tool
Database
Infra
FrontEnd
Etc

📍ERD

📍Features

회원

  • 회원가입
    • 가입 완료시 축하메일 발송
      • Gmail SMTP 메일 발송
    • 가입 완료시 자동 로그인 처리 (참고)
  • 로그인/로그아웃
    • Spring Security 사용
    • 로그인: /member/login
    • 로그아웃: /member/logout
  • 내 프로필 조회
    • 회원 기본정보 조회(아이디, 이메일, 작가명)
  • 회원 기본정보 수정
    • 이메일, 작가명 수정 가능
    • 수정 완료 후, 세션값(MemberContext) 강제 수정
  • 비밀번호 변경
    • 현재 비밀번호, 새 비밀번호, 새 비밀번호 확인 입력폼 유효성 검증
  • 아이디 찾기
    • 이메일 로 아이디 찾기
    • 결과 페이지에서 아이디 확인 가능
  • 비밀번호 찾기
    • 아이디 + 이메일 로 비밀번호 찾기
    • 해당 계정의 이메일로 임시 비밀번호 발급 -> 발급된 임시 비밀번호로 계정 비밀번호 수정 처리(DB 반영)
      • 임시 비밀번호: UUID 10자리 랜덤

글

  • 글 작성
    • Toast UI Editor 적용하여 내용 입력
    • 마크다운 원문, 렌더링 결과(HTML) 모두 DB에 저장(참고)
  • 글 리스트 조회
    • 번호, 제목, 해시태그, 작성자, 작성날짜, 수정날짜 표시
    • QueryDSL 이용
      1. 내 글 모두 조회
        • 메뉴바 "내 글" 클릭 -> 1번 페이지로 이동
      2. 해시태그(키워드)와 관련된 내 글 모두 조회
        • 1번 페이지의 게시글 "해시태그" 클릭 -> 2번 페이지로 이동
  • 글 상세조회
    • 제목, 내용, 해시태그 표시
    • Toast UI Viewer 적용하여 내용 출력
  • 글 수정
    • 제목, 내용, 해시태그 수정 가능
    • Toast UI Editor 적용하여 내용 입력
    • 수정 완료시 현재시간으로 수정날짜 변경
  • 글 삭제
    • 글 삭제시 관련 해시태그도 자동 삭제 처리

도서(상품)

  • 도서 등록/수정/삭제 기능은 작가 회원만 이용O(수정/삭제는 본인만 가능)
  • 도서 리스트/상세조회 기능은 모두 이용O
  • 도서 등록
    • 글 해시태그를 선택하면 내 글 중 해당 해시태그가 붙은 모든 글을 자동으로 1개의 상품으로 등록
    • [폼] 상품명, 설명, 권장 판매가, 글 해시태그 키워드(id), 도서 해시태그 키워드
      • 설명 부분에 ToastUI Editor 적용X
      • 글 해시태그 키워드는 1개만 선택 가능
      • 여러 개의 도서 해시태그 키워드 등록 가능
      • 해시태그 키워드 & 관련 게시글 개수 표시
        • QueryDSL 이용
        • 다른 엔티티의 여러 컬럼 값을 select 하기 때문에, List로 반환 불가 → PostKeywordDto를 정의해 List 반환(참고)
    • 등록 완료시 도서 상세 페이지로 리다이렉트
  • 도서 수정
    • 글 키워드 수정 X
    • 상품명, 가격, 설명, 도서 해시태그 수정 O
    • 수정 완료시 도서 상세페이지로 리다이렉트
  • 도서 상세조회
    • [UI] 상품 랜덤 이미지, 상품명, 작가명, 등록일자, 판매가, 설명, 도서 해시태그 키워드 표시
      • 랜덤 이미지 표시 Unsplash 사용(참고)
      • 설명 부분에 ToastUI Editor Viwer 적용X
    • [UI] 작가 본인에게만 수정, 삭제 버튼 표시
    • 미리보기 구현X
  • 도서 리스트
    • [UI] 모든 상품 정보(상품 랜덤 이미지, 상품명, 등록 일자, 작가명, 판매가, 해시태그) 최신순 리스팅
      • 랜덤 이미지 표시 Unsplash 사용
    • 상품명 클릭시 해당 상품 상세조회 페이지로 이동
    • 장바구니 버튼 표시
  • 도서 삭제
    • 삭제 버튼 클릭시 confirm 창으로 삭제 여부를 한 번 더 체크
    • 삭제 완료시 상품 리스트로 리다이렉트

장바구니

  • 장바구니 기능은 로그인한 회원만 이용O
  • 품목 리스트
    • 메뉴바의 장바구니 메뉴를 클릭해 장바구니 페이지로 이동
    • [UI] 상품 정보(상품 랜덤 이미지, 상품명, 작가명, 등록일자, 가격) 표시
      • 랜덤 이미지 표시 Unsplash 사용
      • 장바구니에 담긴 상품이 없을 때는 상품 없음 안내 문구 표시
    • [UI] 전체 선택 체크박스, 품목 개별 체크박스, 품목 삭제 개별 버튼, 주문하기 버튼 표시
      • Javascript 로 전체 선택 체크박스와 개별 체크박스 연동
    • 이미지 클릭시 해당 상품 상세조회 페이지로 이동
  • 품목 추가
    • 도서 목록 페이지의 각 상품의 장바구니 버튼을 클릭해 장바구니에 품목 추가
    • 회원은 같은 상품 1개만 장바구니에 추가 가능(계속 담아도 최대 수량 = 1개)
    • 품목 추가 완료시 품목 리스트 페이지로 리다이렉트
  • 품목 삭제
    • 품목 삭제 버튼 클릭시 confirm 으로 확인 후 삭제
    • 품목 삭제 완료시 품목 리스트 페이지로 리다이렉트

주문/결제

  • 주문/결제 기능은 로그인한 회원만 이용O
  • 주문 리스트/상세조회/취소/결제/환불 처리는 주문자 본인 것만 가능
  • 주문 생성
    • 장바구니 페이지에서 주문할 품목을 선택 → 주문하기 버튼을 클릭 → 주문 생성(단일 주문 미지원)
      • 선택한 cartItemId 들을 String 으로 만들어 주문 생성 폼 발송
      • ‘,’ 기준으로 분리한 CartItemIds String[] → List 으로 변환(참고)
  • 주문 리스트
    • 회원 본인의 주문 내역 최신순 리스팅
    • [UI] 주문일자, 주문 상태, 주문 품목들 정보(상품 랜덤 이미지, 상품명, 가격) 표시
  • 주문 상세
    • [UI] 주문 상품 정보(상품 랜덤 이미지, 상품명, 가격), 주문 정보(회원 id, 총 상품수, 총 상품금액), 결제 정보(총 상품금액, 캐시 사용금액, pg 결제 금액), 환불 규정 표시
    • 접근 방식 2가지
      1. 장바구니 페이지에서 주문하기 버튼 클릭
      2. 주문내역 페이지에서 상세보기 버튼 클릭
    • 주문 완료 상태
      • [UI] 보유 예치금, 사용할 예치금 입력폼 표시
      • [UI] 주문 취소 버튼, 결제 하기 버튼 표시
    • 결제 완료 상태
      • [UI] 환불요청 버튼 표시
      • [UI] 표시
    • 취소 완료/환불 완료 상태
      • 정보 외에 아무것도 표시X
  • 주문 취소
    • 주문 완료 상태일 때만 주문 취소 요청 가능
    • 해당 주문 건에 포함된 주문 품목 전체 취소 방식 지원
    • 취소 완료시 주문 내역 페이지로 리다이렉트
  • 결제 처리
    • 주문 상세페이지에서 결제 버튼 클릭시 결제 요청(주문 생성후 미결제상태일 때만 요청 가능, 취소/환불 시 요청 불가)
    • Toss Payments 연동(참고)
    • 3가지 결제 방식 지원(1과 2, 3 방식으로 처리)
      • 예치금 전액 결제(PG 결제 skip)
      • Toss Payments 카드 전액 결제(예치금 충전 기록 보존)
      • 예치금 + Toss Payments 카드 결제(혼합 방식)
  • 환불 처리
    • 주문 전체 환불 방식 지원(부분 환불 미지원)
    • 환불 규정: 결제 완료 후 10분 이내 & 도서 열람 하지 않았을 경우(1개라도 환불 규정에 어긋나면 환불 불가)
    • 3가지 환불 방식 지원(1과 2,3 방식으로 처리)
      1. 예치금 전액 환불
      2. Toss Payments 카드 전액 환불(예치금 환불 기록 보존)
      3. 예치금 환불 + Toss Payments 카드 환불(혼합 방식)
    • 환불 완료시 MyBook 에서 구매 상품 삭제

관리자

  • username 이 admin 인 회원 1명을 관리자(authLevel 7)로 지정
  • 관리자 홈
    • 관리자 권한을 가진 회원만 관리자 페이지 접속 가능

정산

  • 정산 데이터 생성폼

    • select box 년, 월 선택 후 폼 전송(참고)
    • 정산데이터 생성, 조회 2가지 폼 전송 처리

  • 정산 데이터 생성

    • 관리자가 월 단위로 정산 데이터 생성
    • 정산 데이터 생성 완료 후, 정산 데이터 리스트 페이지로 리다이렉트

    1. select box로 년/월을 선택 후 정산 데이터 수동 생성

      1. 현재 날짜가 선택한 년/월의 정산 데이터를 생성가능한 날짜인지 검증
        • 2022년 9월 정산 데이터는 2022년 10월 15일 새벽 4시 이후 생성 가능
        • LocalDateTime → String 으로 출력(참고)
      2. 정산 데이터를 생성할 날짜 범위 구하기
        • Calendar 를 이용해 해당 년, 월의 말일 구하기(참고)
        • LocalDateTime 하루의 시작, 종료시각 구하기(참고)
      3. 해당 날짜 범위의 주문 품목(OrderItem) 데이터 조회
      4. 주문 품목 데이터(OrderItem) -> 정산 데이터(RebateOrderItem) 변환
      5. 정산 데이터 생성 및 DB에 저장

    2. Spring Batch + Scheduler 를 이용한 정산 데이터 자동 생성

      Spring Batch 개념 정리

      • 매달 15일 오전 4시 0분 0초에 저번 달(1일~말일)의 정산 데이터를 생성하는 배치 실행
        • Spring Batch
          1. spring-batch 의존성 추가(build.gradle), batch 설정 추가(application.yml)
          2. 앱에 @EnableBatchProcessing 추가
          3. 저번 달(1일~말일)의 정산 데이터를 생성 Job, Step 추가
            • Chunk size 100 으로 지정(참고)
        • Scheduler
          • Spring-boot Framework Scheduler(내장 스케쥴러)의 @EnableScheduling, @Scheduled 를 이용
            • 장애가 발생하여 배치가 15일 오전 4시에 실행되지 못할 경우를 고려하여 매일 오전 4시에 배치가 실행되도록 함(장애가 발생하면 해당 JobParameter 로 배치 다시 실행)
              • @Scheduled(cron = "0 0 4 15 * *") : 매달 15일 오전 4시 0분 0초 실행
              • @Scheduled(cron = "0 0 4 * * *") : 매일 오전 4시 0분 0초 실행
            • JobParameters 에 year, month 값을 담아 JobLauncher로 Job 실행
              • JobParameter 에서는 날짜 → String 으로 변환하여 사용(참고)

  • 정산 데이터 리스트

    • [UI] 정산번호, 품목번호, 상품명, 결제일시, 결제금액, PG 수수료, 도매가, 환불일시, 환불금액, 판매자, 예상정산금액, 정산 예치금 내역번호, 비고 표시
    • 정산 상태에 따른 정산 완료/환불 완료 표시, 건별 정산 신청 버튼 표시
    • 2가지 방식
      • 전체 정산 데이터 리스트 조회
      • year, month 에 해당하는 월별 정산 데이터 리스트 조회

  • 정산 처리

    • 전액 환불건, 정산 완료건은 정산 불가
    • 예상 정산 금액 = 도매가 - PG 수수료
      • PG 수수료는 0원으로 가정
      • 판매자 : MUT Books = 5 : 5 로 정산 → 도매가 = 판매가 * 0.5
    • 관리자는 각 월의 15일에 지난달 정산액을 작가(회원)들에게 송금하여 정산 처리
      • 판매자에게 예치금으로 정산금액 지급
    • 정산 완료 후, 전체 정산 데이터 리스트 페이지로 리다이렉트
    1. 전체 정산(선택 방식)
      • 여러 개의 정산 건을 선택하여 한번에 정산 처리
    2. 건별 정산(단건 방식)

출금

  • 로그인한 회원만 출금 기능 사용 가능
  • 신청 완료/출금 완료/취소 완료 3가지 상태

  • MemberExtra 엔티티 추가

    • 은행명, 계좌번호 컬럼
    • 대상 테이블(member_extra)에 외래 키가 있는 경우 일대일 양방향(참고)
      • memberExtra 엔티티에 @OneToOne 설정
      • member 엔티티에 @OneToOne(mappedBy=”member”) 설정

  • 출금 계좌 관리

    • [UI] 출금 계좌 정보(은행명, 계좌 번호), 출금 계좌 등록 버튼 표시
    • 내 프로필 > 출금계좌 관리 접속

  • 출금 계좌 등록

    • 출금 계좌 정보(은행명, 계좌 번호) 입력 후, 등록
    • 등록 완료시 출금 계좌 관리 페이지로 리다이렉트

  • 출금 신청폼

    • [UI] 출금 계좌 정보(은행명, 계좌번호), 캐시 잔액 표시
    • Form : price
      • 전액 checkbox 선택 시 자동 값 입력, 최소/최대 입력값 제한
    • 내 프로필 > 출금신청 or 내 프로필 > 출금계좌 관리 > 출금 신청 접속
    • 출금 계좌 정보가 존재하지 않으면, 출금계좌 관리 페이지로 리다이렉트

  • 출금 신청(사용자 기능)

    • 작가 회원이 정산받은 금액 or 본인이 충전한 금액
    • 최소 출금 신청 금액 = 1,000원
    • 최대 출금 금액 = 본인이 보유한 예치금

  • 출금 신청 내역 리스트

    • [UI] 은행명, 계좌번호, 금액, 신청 일시, 출금 일시, 취소 일시, 처리 상태
    1. 사용자 기능
      • 본인의 출금 신청 내역을 최신순으로 조회
    2. 관리자 기능
      • 모든 회원의 출금 신청 내역을 최신순으로 조회
      • *신청 완료 상태 건을 맨 위로 리스팅

  • 출금 처리(관리자 기능)

    • 관리자 출금 신청 내역 페이지에서 건별로 출금 처리 요청
    • 출금 수수료 없다고 가정

  • 출금 신청 취소

    • 출금 취소 사유: 사용자 요청/관리자 요청(2가지)
      • enum, converter 관리
    1. 사용자 기능
      • 본인의 출금 신청 건만 취소 가능
    2. 관리자 기능
      • 모든 회원의 출금 신청 건에 대해 취소 가능