👥 회원 API

---

🎫 회원 가입

Request

POST /api/members/register HTTP/1.1
Content-Type: application/json
host: localhost:8080

{
    "email": "admin@email.com",
    "password": "password"
}

Response

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

{
    "token": ""
}

🔑 로그인

Request

POST /api/members/login HTTP/1.1
Content-Type: application/json
host: localhost:8080

{
    "email": "abc@gmail.com",
    "password": "123qwe"
}

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "token": ""
}

📦 상품 API

---

🔎 상품 조회 (전체 상품)

Request

GET /api/products HTTP/1.1

Response

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "id": 1,
        "name": "아이스 카페 아메리카노 T",
        "price": 4500,
        "imageUrl": "https://st.kakaocdn.net/product/api/product/20231010111814_9a667f9eccc943648797925498bdd8a3.jpg"
    },
    {
        "id": 2,
        "name": "(ICE)아메리카노",
        "price": 2000,
        "imageUrl": "https://img1.kakaocdn.net/thumb/C320x320@2x.fwebp.q82/?fname=https%3A%2F%2Fst.kakaocdn.net%2Fproduct%2Fgift%2Fproduct%2F20220622112804_d176787353ab48c690936557eefad11c.jpg"
    }
]

🔎 상품 조회 (특정 상품)

Request

GET /api/products/{productId} HTTP/1.1

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": 1,
    "name": "아이스 카페 아메리카노 T",
    "price": 4500,
    "imageUrl": "https://st.kakaocdn.net/product/api/product/20231010111814_9a667f9eccc943648797925498bdd8a3.jpg"
}

➕ 상품 추가

Request

POST /api/products HTTP/1.1
Content-Type: application/json

{
    "name": "(ICE)아메리카노",
    "price": 2000,
    "imageUrl": "https://img1.kakaocdn.net/thumb/C320x320@2x.fwebp.q82/?fname=https%3A%2F%2Fst.kakaocdn.net%2Fproduct%2Fgift%2Fproduct%2F20220622112804_d176787353ab48c690936557eefad11c.jpg"
}

Response

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

{
    "id": 1,
    "name": "(ICE)아케리카노",
    "price": 2000,
    "imageUrl": "https://img1.kakaocdn.net/thumb/C320x320@2x.fwebp.q82/?fname=https%3A%2F%2Fst.kakaocdn.net%2Fproduct%2Fgift%2Fproduct%2F20220622112804_d176787353ab48c690936557eefad11c.jpg"
}

✏️ 상품 수정

Request

PUT /api/products/{productId} HTTP/1.1
Content-Type: application/json

{
    "name": "[EVENT](ICE)아메리카노",
    "price": 1600,
    "imageUrl": "https://img1.kakaocdn.net/thumb/C320x320@2x.fwebp.q82/?fname=https%3A%2F%2Fst.kakaocdn.net%2Fproduct%2Fgift%2Fproduct%2F20250515110714_9664acdff2b84e4e806c4d7d55dd8de0.jpg"
}

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
    "id": 1,
    "name": "[EVENT](ICE)아메리카노",
    "price": 1600,
    "imageUrl": "https://img1.kakaocdn.net/thumb/C320x320@2x.fwebp.q82/?fname=https%3A%2F%2Fst.kakaocdn.net%2Fproduct%2Fgift%2Fproduct%2F20250515110714_9664acdff2b84e4e806c4d7d55dd8de0.jpg"
}

❌ 상품 삭제

Request

DELETE /api/products/{productId} HTTP/1.1

Response

HTTP/1.1 204 No Content

🎁 위시 리스트 API

---

🔎 위시 리스트 보기

Request

• Header: Authorization: Bearer {JWT}

GET /api/wishes?page=0&size=5&sort=createdDate,desc HTTP/1.1
Host: localhost:8080

Response

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "id": 1,
        "product": {
            "id": 10,
            "name": "테스트 상품 1",
            "price": 15000,
            "imageUrl": "http://example.com/image.jpg"
        }
    },
    {
        "id": 2,
        "product": {
            "id": 12,
            "name": "테스트 상품 2",
            "price": 20000,
            "imageUrl": "http://example.com/image2.jpg"
        }
    }
]

➕ 위시 리스트 추가

Request

• Header: Authorization: Bearer {JWT}

POST /api/wishes HTTP/1.1
Content-Type: application/json
host: localhost:8080

{
    "productId": 1
}

Response

{
    "id": 1,
    "product": {
        "id": 10,
        "name": "테스트 상품 1",
        "price": 15000,
        "imageUrl": "[http://example.com/image.jpg](http://example.com/image.jpg)"
    }
}

❌ 위시 리스트 삭제

Request

• Header: Authorization: Bearer {JWT}

DELETE /api/wishes/{wishlistId} HTTP/1.1
host: localhost:8080

Response

HTTP/1.1 204 No Content

👤 유저 화면

---

✅ 로그인 및 회원가입

로그인

[GET] http://localhost:8080/members/login
→ 로그인 화면으로 이동합니다.

특정 상품 조회

[GET] http://localhost:8080/members/register
→ 회원 가입 화면으로 이동합니다.

🔎 상품 조회

전체 상품 목록

[GET] http://localhost:8080/members/products
→ 등록된 모든 상품을 목록으로 확인할 수 있는 화면입니다.

특정 상품 조회

[GET] http://localhost:8080/members/products/{productId}
→ 선택한 상품의 상세 정보를 확인할 수 있는 화면입니다.

위시 리스트 조회

[GET] http://localhost:8080/members/wishes
→ 선택한 상품의 상세 정보를 확인할 수 있는 화면입니다.

🧑‍💻 관리자 화면

---

🔎 상품 조회

전체 상품 목록

[GET] http://localhost:8080/admin/products
→ 등록된 모든 상품을 목록으로 확인할 수 있는 화면입니다.

특정 상품 조회

[GET] http://localhost:8080/admin/products/{productId}
→ 선택한 상품의 상세 정보를 확인할 수 있는 화면입니다.

➕ 상품 추가

상품 추가 화면

[GET] http://localhost:8080/admin/products/new
→ 새 상품을 입력하는 폼으로 이동합니다.

상품 추가 요청

[POST] http://localhost:8080/admin/products
→ 폼에서 입력된 내용을 서버에 전송해 새 상품을 추가합니다.

✏️ 상품 수정

상품 수정 화면

[GET] http://localhost:8080/admin/products/edit/{productId}
→ 선택한 상품의 정보를 수정할 수 있는 화면입니다.

상품 수정 요청

[PUT] http://localhost:8080/admin/products/{productId}
→ HTML <form>에서 _method=put로 전송되는 요청입니다.
→ 실제 HTTP 메서드는 POST이며,
→ AdminController에서 @PutMapping으로 처리합니다.

❌ 상품 삭제

상품 삭제 요청

[DELETE] http://localhost:8080/admin/products/{productId}
→ HTML <form>에서 _method=delete로 전송됩니다.
→ 실제 HTTP 메서드는 POST이며,
→ AdminController에서 @DeleteMapping으로 처리합니다.

💾 데이터베이스

---

🛠️ 사용 DB

H2 Database (인메모리 DB)

• JDBC URL: jdbc:h2:mem:spring-gift
• Username: sa
• Password: ``

📌 DB 초기화

create table product (
    id bigint auto_increment primary key,
    name varchar(255) not null,
    price bigint not null,
    image_url varchar(1000)
);

create table member (
    id bigint auto_increment primary key,
    email varchar(255) not null unique,
    password varchar(255) not null,
    role varchar(50) not null
);

create table wishlist (
    id bigint auto_increment primary key,
    member_id bigint not null,
    product_id bigint not null,
    created_date timestamp(6) not null,
    foreign key (member_id) references member(id) on delete cascade,
    foreign key (product_id) references product(id) on delete cascade,
    unique (member_id, product_id)
);

⚖️ 유효성 검사 및 예외 처리

---

🔍 유효성 검사

상품 이름

• 필수 입력
• 최소 1자, 최대 15자
• (), [], +, -, &, /, _ 외의 특수 문자를 사용할 수 없음
• RequiresApprovalWords 어노테이션을 사용하여 특정 단어가 포함되지 않도록 검사

상품 가격

• 0원 이상

상품 이미지 URL

• 필수 입력

🚨 예외 처리

상품 조회

• 상품이 존재하지 않을 경우: ProductNotFoundException

상품 수정

• 상품이 존재하지 않을 경우: ProductNotFoundException

상품 삭제

• 상품이 존재하지 않을 경우: ProductNotFoundException

🧪 테스트

---

API 테스트

• 상품 조회 (전체 상품)
• 상품 조회 (특정 상품)
• 상품 추가
• 상품 수정
• 상품 삭제

유효성 검사 테스트

• 상품 이름 (최대 15자 실패)
• 상품 이름 (특수 문자 성공)
• 상품 이름 (특수 문자 실패)
• 상품 이름 (MD 승인 글자)
• 상품 가격 (0원 이상 실패)