관리자

가게 등록 승인

PUT /api/store/approve/{storeId}

관리자가 가게 등록을 승인합니다.

Path Variable:

• storeId: String (승인할 가게 ID)

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Response

200

{
  "message": "가게 등록을 승인했습니다."
}

400

---

가게 등록 거절

PUT /api/store/reject/{storeId}

관리자가 가게 등록을 거절합니다.

storeId: String (거절할 가게 ID)

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Name	Type	Description
reason	string	거절 사유

Requet Body

First Tab

등록서류 부족

Response

200

가게 등록을 거절했습니다. 사유: 등록서류 부족

400

---

가게 폐업 승인

PUT /api/store/closure/approve/{storeId}

관리자가 가게 폐업을 승인합니다.

요청(Request):

Path Variable:

• storeId: String (폐업 승인할 가게 ID)

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Response

200

{
  "message": "가게 폐업 신청을 승인했습니다."
}

400

---

가게 목록 조회

GET /api/store?status={status}&page={page}&?size={size}

가게 전체 목록을 조회합니다.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

요청 파라미터

이름	타입	필수 여부	기본값	설명
status	String	선택	전체 보기(ENTIRE)	가게 상태 (PENDING, CLOSURE_PENDING, OPEN, CLOSE)
page	int	선택	1	조회할 페이지 번호
size	int	선택	10	한 페이지에 보여줄 데이터 수

예시

GET /api/store?status=OPEN&page=2&size=5

화면상 버튼	status	Url 예시
전체 보기	ENTIRE	/api/store?status=ENTIRE&page=1&size=10
영업중	OPEN	/api/store?status=OPEN&page=1&size=10
영업종료	CLOSE	/api/store?status=CLOSE&page=1&size=10
등록신청	PENDING	/api/store?status=PENDING&page=1&size=10
폐업신청	CLOSURE_PENDING	/api/store?status=CLOSURE_PENDING&page=1&size=10

설명:

• status=OPEN: 영업 중인 가게 목록을 조회

• page=2: 두 번째 페이지를 조회

• size=5: 한 페이지에 5개 항목씩 표시

Response Body

이름	타입	설명
content	Array	가게 목록 데이터 (페이징된 데이터)
pageable	Object	페이징 관련 정보
totalPages	int	전체 페이지 수
totalElements	int	전체 데이터 개수
last	boolean	마지막 페이지 여부
size	int	한 페이지에 보여줄 데이터 수
number	int	현재 페이지 번호 (0부터 시작)
sort	Object	정렬 정보
first	boolean	첫 번째 페이지 여부
numberOfElements	int	현재 페이지의 데이터 개수
empty	boolean	데이터가 비어 있는지 여부

200

{
"content": [
    {
      "storeId": "TSID-1731993445111",//가게 아이디( String )
      "storeName": "가게 A",
       "userPhone": "010-1234-5678", //사장님 개인번호 
      "description": "설명 A", //null값이 올 수 있음
      "address": "서울특별시 강남구",
      "storeStatus": "OPEN",
      "storeLogo": "logo_a.png", //null 이 올 수 있음
      "userName": "사장님 A",
      "approvedDate": "2024-11-22T12:00:00"
    },
    {
      "storeId": "TSID-173195553332",
      "storeName": "가게 B",
      "userPhone": "010-5678-1234", //사장님 개인번호
      "description": "설명 B",
      "address": "서울특별시 서초구",
      "storeStatus": "OPEN",
      "storeLogo": "logo_b.png", //null이 올 수 있음
      "userName": "사장님 B",
      "approvedDate": "2024-11-21T12:00:00"
    }
  ],
  "pageable": {
    "sort": {
      "sorted": true,
      "unsorted": false,
      "empty": false},
    "offset": 5,
    "pageSize": 5,
    "pageNumber": 1,
    "paged": true,
    "unpaged": false},
  "totalPages": 3,
  "totalElements": 13,
  "last": false,
  "size": 5,
  "number": 1,
  "sort": {
    "sorted": true,
    "unsorted": false,
    "empty": false},
  "numberOfElements": 5,
  "first": false,
  "empty": false}

400

1. 페이지네이션 버튼 생성:

   • totalPages를 활용하여 UI 하단에 pageNumber / totalPages

   • first와 last로 이전/다음 버튼 비활성화 여부 결정.

2. 상태 필터링 버튼:

   • status 값을 전달하는 필터 버튼 생성.

     • 예: 전체 보기, 등록 신청, 영업 중, 영업 종료, 폐업 신청

---

가게 단일 조회

GET /api/store/{storeId}

가게 단일 정보를 조회합니다.

storeId: String (조회할 가게 ID)

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

필드 이름	타입	설명
storeId	String	가게 ID
storeName	String	가게 이름
userPhone	String	사장님 핸드폰 번호
address	String	가게 위치
description	String	가게 소개
categories	List<String>	가게 카테고리 목록
latitude	Double	위도
longitude	Double	경도
storeRegistrationDocs	String	등록 서류 URL
storeBannerImage	String	배너 이미지 URL
storeStatus	String	가게 상태 (e.g., ACTIVE)
userName	String	사장님 이름

Response

200

{
  "storeId": "TSID-1731993445512", //가게 아이디
  "storeName": "맛있는 한식집", //가게 이름
  "userPhone": "010-1234-5678", //사장님 개인번호 
  "address": "서울특별시 강남구 역삼동", //주소
  "description": "전통 한식의 깊은 맛을 전합니다.", //null 올 수 있음
  "categories": ["KOREAN", "LATENIGHTFOOD", "CHICKEN"], 최대 3개까지
  "latitude": 37.5665, //위도
  "longitude": 126.978, //경도
  "storeRegistrationDocs": "https://example.com/documents/registration.img", //이미지
  "storeBannerImage": "https://example.com/images/banner.jpg", //null 올 수 있음
  "storeStatus": "OPEN", //가게 상태 (승인 신청시 PENDING)
  "userName": "홍길동" //사장님 이름
}

400