Week#1

Week#1-Step#1

• 상품 조회

  • 상품 목록을 조회하는 기능
  • HTTP 메서드: GET
  • 엔드포인트: /api/products

• 상품 추가

  • 새로운 상품을 추가하는 기능
  • HTTP 메서드: POST
  • 엔드포인트: /api/products

• 상품 수정

  • 기존 상품 정보를 수정하는 기능
  • HTTP 메서드: PUT
  • 엔드포인트: /api/products/{id}

• 상품 삭제

  • 특정 ID를 가진 상품을 삭제하는 기능
  • HTTP 메서드: DELETE
  • 엔드포인트: /api/products/{id}

Week#1-Step#2

step1 - 조회, 추가, 수정, 삭제 API

• 상품 조회

  • 상품 목록을 조회하는 기능
  • HTTP 메서드: GET
  • 엔드포인트: /api/products

• 상품 추가

  • 새로운 상품을 추가하는 기능
  • HTTP 메서드: POST
  • 엔드포인트: /api/products

• 상품 수정

  • 기존 상품 정보를 수정하는 기능
  • HTTP 메서드: PUT
  • 엔드포인트: /api/products/{id}

• 상품 삭제

  • 특정 ID를 가진 상품을 삭제하는 기능
  • HTTP 메서드: DELETE
  • 엔드포인트: /api/products/{id}

step2 - 관리자 화면

• 상품 목록 화면

  • 상품 목록을 화면에 표시하는 기능
  • HTML 페이지: templates/products.html
  • 접속 방법 : localhost:8080/products
  • 상품 목록과 오른쪽 상단의 상품 추가 버튼
  • 각 상품 우측 상품 수정 버튼과 상품 삭제 버튼

• 상품 추가 화면

  • 새로운 상품을 추가하는 화면
  • HTML 페이지: templates/product_form.html
  • 폼을 통해 상품 정보를 입력받아 추가

• 상품 수정 화면

  • 기존 상품 정보를 수정하는 화면
  • HTML 페이지: templates/product_edit_form.html
  • 폼을 통해 상품 정보를 입력받아 수정

• AJAX를 통한 비동기 처리

  • 상품 추가, 수정, 삭제 시 페이지 새로고침 없이 비동기로 처리
  • fetch API를 사용하여 서버와 통신

Week#1-Step#3

step3 - JDBC 적용 및 리팩토링

기능 요구 사항

• JDBC를 사용하여 데이터를 H2 데이터베이스에 저장하고 관리한다.
• 상품 정보를 데이터베이스에 저장하고 조회, 수정, 삭제하는 기능을 구현한다.

구현 목록

• 데이터베이스 테이블 생성
  • Product 테이블 생성
• JDBC DAO 구현
  • ProductDao 클래스 구현
• 컨트롤러 리팩토링
  • 기존의 HashMap 대신 데이터베이스를 사용하도록 ProductController 수정
• 상품 추가/수정 시 DB 처리
  • 상품 추가 및 수정 시 데이터베이스에 반영하도록 로직 수정
• 상품 조회 시 DB 사용
  • 상품 조회 시 데이터베이스에서 정보 조회
• 상품 삭제 시 DB 사용
  • 상품 삭제 시 데이터베이스에서 정보 삭제

Week2

Week#2-Step#1

step1 - 유효성 검사 및 예외처리

기능 구현

1. 상품 추가, 수정 시 유효성 검사
   • 상품 이름은 공백 포함 최대 15자까지 입력 가능
   • 가능한 특수 문자: ( ), [ ], +, -, &, /, _
   • "카카오"가 포함된 문구는 담당 MD와 협의한 경우에만 사용 가능

Week#2-Step#2

로그인 및 회원가입

• email, password 를 통한 회원가입
• 유저 정보를 기반으로 한 로그인

토큰 발급

• 로그인이 완료된다면 토큰 제공 (bearer 방식 -> JWT 사용)

Week#2-Step#3

위시리스트 추가

• 유저 아이디로 식별 가능해야 함

Week3

Week#3-Step#1

기존 코드 리팩토링

• 엔티티, 레포지토리 작성
• 그에 맞게 서비스 수정
• Dao 삭제

Week#3-Step#2

spring-gift-jpa

step1 - JPA 적용

1. 기존 코드 리팩토링
   • 엔티티, 레포지토리 작성
   • 그에 맞게 서비스 수정
   • Dao 삭제

step2 - 엔티티 모델링

1. 엔티티 연관 관계 설정
   • Wish 엔티티가 User, Product 참조하도록 함
   • user_id, product_id를 FK로 가지도록 설정

Week#3-Step#3

과제 진행 요구 사항

상품과 위시 리스트 보기에 페이지네이션을 구현한다.

• 대부분의 게시판은 모든 게시글을 한 번에 표시하지 않고 여러 페이지로 나누어 표시한다. 정렬 방법을 설정하여 보고 싶은 정보의 우선 순위를 정할 수도 있다.
• 페이지네이션은 원하는 정렬 방법, 페이지 크기 및 페이지에 따라 정보를 전달하는 방법이다.

프로그래밍 요구 사항

힌트

이를 직접 구현할 수도 있지만, 스프링 데이터는 **Pageable**이라는 객체를 제공하여 쉽게 구현할 수 있다. 또한 List, Slice, Page 등 다양한 반환 타입을 제공한다.

Week#4

Week#4-Step#1

기능 요구 사항

상품 정보에 카테고리를 추가한다. 상품과 카테고리 모델 간의 관계를 고려하여 설계하고 구현한다.

• 카테고리는 1차 카테고리만 있으며 2차 카테고리는 고려하지 않는다.
• 카테고리는 수정할 수 있다.
• 관리자 화면에서 상품을 추가할 때 카테고리를 지정할 수 있다.
• 카테고리의 예시는 아래와 같다.
  • 교환권, 상품권, 뷰티, 패션, 식품, 리빙/도서, 레저/스포츠, 아티스트/캐릭터, 유아동/반려, 디지털/가전, 카카오프렌즈, 트렌드 선물, 백화점

아래 예시와 같이 HTTP 메시지를 주고받도록 구현한다.

Request

GET /api/categories HTTP/1.1

Response

HTTP/1.1 200
Content-Type: application/json

{
“id”: 91,
“name”: “교환권”,
“color”: “#6c95d1”,
“imageUrl”: “https://gift-s.kakaocdn.net/dn/gift/images/m640/dimm_theme.png”,
“description”: “”
}

프로그래밍 요구 사항

• 구현한 기능에 대해 적절한 테스트 전략을 생각하고 작성한다.
• 카테고리를 추가하는 문제이다. 1차카테고리를 지정하고, 수정할 수 있으며, 관리자 화면에서 지정할 수 있어야 한다.

Week#4-Step#2

step 2 - 옵션 추가

옵션 추가

• 옵션 구현
  • 각 상품의 옵션별 잔여 수량 저장 api구현

Week#4-Step#3,4

step 3,4 차감 기능 구현

• 동시성 제어 필요

Week#5

Week#5-Step#1

기능 요구 사항

카카오 로그인을 통해 인가 코드를 받고, 인가 코드를 사용해 토큰을 받은 후 향후 카카오 API 사용을 준비한다.

• 카카오계정 로그인을 통해 인증 코드를 받는다.
• 토큰 받기를 읽고 액세스 토큰을 추출한다.
• 앱 키, 인가 코드가 절대 유출되지 않도록 한다.
• (선택) 인가 코드를 받는 방법이 불편한 경우 카카오 로그인 화면을 구현한다.

실제 카카오 로그인은 아래 그림과 같이 진행된다.

하지만 지금과 같이 클라이언트가 없는 상황에서는 아래와 같은 방법으로 인가 코드를 획득한다.

1. 내 애플리케이션 > 앱 설정 > 앱 키로 이동하여 REST API 키를 복사한다.
2. https://kauth.kakao.com/oauth/authorize?scope=talk_message&response_type=code&redirect_uri=http://localhost:8080&client_id=**`{REST_API_KEY}`**에 접속하여 카카오톡 메시지 전송에 동의한다.
3. http://localhost:8080/?code=**`{AUTHORIZATION_CODE}`**에서 인가 코드를 추출한다.

애플리케이션 등록

카카오 플랫폼 서비스를 이용하여 개발한 애플리케이션은 이름, 아이콘, 상품명, 서비스명, 회사명, 로고, 심벌 등에 카카오의 상표를 사용할 수 없으므로(제17조(상표 사용 시 의무 사항)), 아래 항목들에 "카카오"사용 불가하다

• 앱 이름:
• 회사명:
• 카테고리:

토큰 요청

토큰 받기에 따르면 아래와 같이 **RequestEntity**를 만들 수 있다.

var url = "https://kauth.kakao.com/oauth/token";
var headers = new HttpHeaders();
headers.add(HttpHeaders.CONTENT_TYPE, MediaType.APPLICATION_FORM_URLENCODED_VALUE);
var body = new LinkedMultiValueMap<String, String>();
body.add("grant_type", "authorization_code");
body.add("client_id", properties.clientId());
body.add("redirect_uri", properties.redirectUri());
body.add("code", authorizationCode);
var request = new RequestEntity<>(body, headers, HttpMethod.POST, URI.create(url));

오류 처리

• 레퍼런스를 참고하여 발생할 수 있는 다양한 오류를 처리한다.
• RestTemplate을 사용하는 경우 Spring RestTemplate Error Handling를 참고한다.

HTTP Client

• REST Clients
• 사용할 클라이언트를 선택할 때 어떤 기준을 사용해야 할까?
• 클라이언트 인스턴스를 효과적으로 생성/관리하는 방법은 무엇인가?

더 적절한 테스트 방법이 있을까?

• 요청을 보내고 응답을 파싱하는 부분만 테스트하려면 어떻게 해야 할까?
• 비즈니스 로직에 연결할 때 단위/통합 테스트는 어떻게 할까?

API 호출에 문제가 발생하면 어떻게 할까?

• 응답 시간이 길면 어떻게 할까? 몇 초가 적당할까?
• 오류 코드는 어떻게 처리해야 할까?
• 응답 값을 파싱할 때 문제가 발생하면 어떻게 할까?

Week#5-Step#2

기능 요구 사항

카카오톡 메시지 API를 사용하여 주문하기 기능을 구현한다.

• 주문할 때 수령인에게 보낼 메시지를 작성할 수 있다.
• 상품 옵션과 해당 수량을 선택하여 주문하면 해당 상품 옵션의 수량이 차감된다.
• 해당 상품이 위시 리스트에 있는 경우 위시 리스트에서 삭제한다.
• 나에게 보내기를 읽고 주문 내역을 카카오톡 메시지로 전송한다.
  • 메시지는 메시지 템플릿의 기본 템플릿이나 사용자 정의 템플릿을 사용하여 자유롭게 작성한다.

아래 예시와 같이 HTTP 메시지를 주고받도록 구현한다.

Request

POST /api/orders HTTP/1.1
Authorization: Bearer {token}
Content-Type: application/json

{
    "optionId": 1,
    "quantity": 2,
    "message": "Please handle this order with care."
}

Response

HTTP/1.1 201 Created
Content-Type: application/json

{
    "id": 1,
    "optionId": 1,
    "quantity": 2,
    "orderDateTime": "2024-07-21T10:00:00",
    "message": "Please handle this order with care."
}

실제 카카오톡 메시지는 아래와 같이 전송된다. 하지만 이번 미션에서는 수신자가 나이기 때문에 카카오톡 친구 목록 가져오기는 생략한다.

주문하기 API를 만드는 문제다.

이전에 계획한대로, Order 엔티티와 그 외 레이어들 만들고

거기에 User 와 ProductOption 을 다대일로 연관지어서 구현하면 될 것 같다.

# spring-gift-order

## step 1 - 카카오 로그인

- **카카오 로그인 구현**
    - [x] 기존 로그인은 일단 그대로 유지
    - [x] http://localhost:8080/oauth/kakao 에 접속 시, 로그인 페이지로 리다이렉트
    - [x] 해당 페이지에서 로그인 완료 시, 인가 코드를 http://localhost:8080/oauth/kakao/callback 으로 전달
    - [x] 인가 코드 추출 후, 해당 코드를 통해 access token 발급

- **추가 기능**
    - [x] 카카오 로그인 시, 유저 정보를 통해 서비스의 User에도 등록하여 로그인 처리 되도록 함

## step 2 - 주문하기

- **주문하기 기능 구현**
  - [ ] `Order` 엔티티, Dto, 레포지토리, 서비스, 컨트롤러 구현
  - [ ] 상품 옵션과 수량을 선택하여 주문 시, 해당 상품 옵션의 수량 차감
  - [ ] 해당 상품이 위시 리스트에 있는 경우 위시 리스트에서 삭제
  
- **카카오톡 메시지 API 호출**
  - [ ] `access token`을 검증하여 카카오톡 메시지 전송 API 호출