🚀 2024-12-04 X2BEE 3.0 release

Next.js

14.2.15

서버사이드 랜더링, 웹 어플리케이션 프레임워크

React

18.3.1

사용자 인터페이스

TypeScript

5.5.4

코드 안정성

MUI(Material-UI)

5.16.7

반응형 UI 컴포넌트

MUI X Data Grid

7.21.0

대용량 데이터 테이블 컴포넌트

프로젝트 준비하기

• 프로젝트 구조 표준 정의서

• /wiki/spaces/TG/pages/521076798

• /wiki/spaces/TG/pages/520093855

• /wiki/spaces/TG/pages/521044046

Framework 가이드

• /wiki/spaces/TG/pages/3408404

• /wiki/spaces/TG/pages/917517

• /wiki/spaces/TG/pages/983109

그리드

• 데이터 그리드(MUI-X)

개발 시작하기

• /wiki/spaces/TG/pages/520749057

• /wiki/spaces/TG/pages/287440897

• 유효성 체크 방법

• 숫자 및 날짜 변환 유틸 가이드

• BO/API 메시지 처리

• /wiki/spaces/TG/pages/11501677

사용자 개인정보 취급권한 조회

GET

/v1/system/userMgmt/getIndividualInfoRightList

로그인한 사용자의 개인정보 취급 권한 목록 조회 기능 추가

반품전환 처리대상조회

POST

/v2/claim/return/getReturnTransformPopupBaseInfo

수거지 및 배송지 설정 로직을 BO로 이관

고객정보확인사유 체크

GET

/v2/member/memberInfoConfirmReason/validIndInfoParam

API -BO 이관

배송상세 조회

GET

/v1/delivery/deliveryInquiry/getDeliveryOrderDetailList

배송 상세 필드에 개인정보 권한에 따른 마스킹 기능 적용

판매 상품 현황 목록 조회

GET

/v1/statistics/goodsAnalysis/getGoodsSalesStatusList

API 쿼리 정렬 순서 수정

그룹 행 삭제

POST

/v2/display/marketingDisplayGroupMgmt/

연결된 기획전 여부 검증 로직 추가

게시판 등록/수정

POST

/v1/display/bulletinBoardSystemMgmt/saveBoardSystemInfo

게시판 분류 항목 및 연결된 게시글 삭제 로직 추가

그리드 행 삭제

POST

/v1/display/bulletinBoardSystemMgmt/saveBoardSystemList

게시판과 연결된 게시글 삭제 로직 추가

상품 일괄등록 중복 체크

POST

/v1/display/marketingDisplayMgmt/getValidPlanShopGoodsList

GET 메서드를 POST 메서드로 변경

브랜드 정보 저장

POST

/v1/goods/brandMgmtApi/saveBrandInfo

MultipartFile로 브랜드 로고 이미지를 받아 S3에 저장하는 로직 추가

브랜드 다국어 조회

GET

/v2/goods/brandMgmt/getMultiLanguageBrandInfo

언어 코드와 브랜드 번호를 받아 브랜드 다국어 정보 조회 기능 추가

브랜드 다국어 조회

GET

/v1/goods/brandMgmtApi/getMultiLanguageBrandInfoList

비효율적인 언어 코드 조회 API를 /getMultiLanguageBrandInfo로 대체

사이트별 게시판 목록 조회

GET

/v1/display/bulletinBoardContentsMgmt/getBoardSystemList/{siteNo}

게시글 목록 조회 시 게시판 및 분류 정보 추가

게시글 분류 조회

GET

/v1/system/bulletinBoardContentsMgmt/getBulletinBoardTypeInfo

사이트 번호 조회에 포함된 API 제외 처리

게시글 수정

POST

/v1/display/bulletinBoardContentsMgmt/saveBoardContentsList

게시글 저장 및 삭제 기능 추가

게시글 상세정보 조회

GET

/v1/display/bulletinBoardContentsMgmt/{bbcId}

댓글과 답변 정보 조회 로직 개선

게시글 등록/수정

POST

/v1/display/bulletinBoardContentsMgmt/

필수값 검증 로직 업데이트 및 상품 정보 분기 처리 저장

게시글 댓글 목록 조회

GET

/v1/display/bulletinBoardContentsMgmt/{bbcId}/reply

상세 조회를 제외하고 별도 그리드 조회로 변경

게시글 댓글 게시 여부 수정

POST

/v1/display/bulletinBoardContentsMgmt/reply

게시 여부만 업데이트 가능하도록 기존 전체 데이터 처리 방식을 변경

게시글 답변 목록 조회

GET

/v1/display/bulletinBoardContentsMgmt/{bbcId}/answer

답변 목록 조회는 답변형 게시글에 한해 추가

게시글 답변 저장

POST

/v1/display/bulletinBoardContentsMgmt/answer

답변형 게시글의 답변 목록 조회 및 답변 저장 로직 개선

상품일괄등록 엑셀 상품등록

POST

/v2/goods/goodsBatchRegistApi/saveExcelGoodsList

BO API 이관

상품일괄등록 엑셀파일 저장/데이터 확인

POST

/v2/goods/goodsBatchRegistApi/goodsBatchRegist.excelUpload

BO API 이관

엑셀 업로드 양식 다운로드

GET

/v2/goods/goodsBatchRegistApi/goodsBatchRegist.excelDownload

BO API 이관

웹에디터 이미지 파일 업로드

GET, POST

/v1/common/common/file/uploadImgEditor.do

BO API 이관

저장소 파일 다운로드

GET

/v1/common/common/downloadFile

BO API 이관

일반상품 등록

POST

/v2/goods/generalGoodsApi/registTemporaryGeneralGoods

API URI 개선

일반상품 복사

GET

/v2/goods/generalGoodsApi/copyGeneralGoods

API URI 개선

이미지 저장

POST

/v2/goods/generalGoodsApi/uploadGoodsRegistImageFile

BO API 이관 및 URI 개선

사은품 등록

POST

/v2/goods/giftGoodsApi/registerGiftGoods

API URI 개선

묶음대상 상품목록 조회

GET

/v2/goods/packageGoodsApi/getPackageTargetGoodsList

API URI 개선

묶음상품 등록

POST

/v2/goods/packageGoodsApi/temporaryPackageGoodsRegist

API URI 개선

상품 기본 정보 조회

GET

/v2/goods/goodsCommonApi/getGoodsBaseInfo

API URI 개선

일반상품 정보 조회

GET

/v2/goods/goodsCommonApi/getGeneralGoodsInfo

API URI 개선

묶음상품 정보 조회

GET

/v2/goods/goodsCommonApi/getPackageGoodsInfo

API URI 개선

사은품 정보 조회

GET

/v2/goods/goodsCommonApi/getGiftGoodsInfo

API URI 개선

상품고시항목 목록 조회

GET

/v2/goods/goodsCommonApi/getGoodsNotificationItemList

API URI 개선

상품 카테고리 속성 목록 조회

GET

/v2/goods/goodsCommonApi/getGoodsCtgAttInfoList

API URI 개선

협력사 기본 정보 조회

GET

/v2/goods/goodsCommonApi/getEtEntrBase

API URI 개선

배송비/반품비 정책 목록 조회

GET

/v2/goods/goodsCommonApi/getDeliveryPolicyList

API URI 개선

가격 변경 예약 등록/취소

POST

/v2/goods/goodsCommonApi/modifyGeneralGoodsPriceReservation

API URI 개선

일반상품 수정

POST

/v2/goods/goodsCommonApi/modifyGeneralGoods

API URI 개선

묶음상품 수정

POST

/v2/goods/goodsCommonApi/modifyPackageGoods

API URI 개선

사은품 수정

POST

/v2/goods/goodsCommonApi/modifyGiftGoods

API URI 개선

상품정보 일괄수정

POST

/v2/goods/goodsCommonApi/modifyGoodsInfo

API URI 개선

단품 옵션목록 조회

GET

/v2/goods/goodsCommonApi/getItemOptionList

API URI 개선

단품 판매상태 목록 조회

GET

/v2/goods/goodsCommonApi/getGoodsSaleStateList

API URI 개선

아이콘 정보 조회

GET

/v2/goods/goodsCommonApi/getPrGoodsIconInfoList

API URI 개선

상품 다국어 정보 조회

GET

/v2/goods/goodsCommonApi/getGoodsMultiLanguageInfo

API URI 개선

상품 다국어 정보 등록/수정

POST

/v2/goods/goodsCommonApi/registGoodsMultiLanguage

API URI 개선

메뉴 목록 조회

GET

/v2/system/menuMgmt

메뉴 Tree 및 하위 메뉴 목록 조회 API 병합 및 쿼리 성능 개선

메뉴 상세 조회

GET

/v2/system/menuMgmt/{rtTgtSeq}

메뉴명 다국어 관리에 따른 API URI 개선 및 신규 추가

메뉴 상세정보 수정

PUT

/v2/system/menuMgmt/{rtTgtSeq}

매핑된 하위 메뉴가 존재할 경우 최하위 여부 변경 불가능 로직 추가

하위 메뉴 목록 저장

POST

/v2/system/menuMgmt/{rtTgtSeq}

수정 목록을 일괄 등록할 수 있도록 API URI 및 쿼리 수정

매핑된 상위 메뉴 목록 조회

GET

/v2/system/menuMgmt/upper

BO 메뉴 목록 Grid의 삭제 목록 선검증을 위한 API 신규 추가

시스템 공지 첨부파일 업로드

POST

/v2/system/systemNoticeMgmt/uploadFile

첨부파일 업로드 API를 BO로 이관

메뉴 권한 목록 조회

GET

/v2/system/individualRightMgmt/getIndividualMenuTreeList

개인 권한별로 선택한 계정에 해당하는 시스템 메뉴만 조회되도록 변경

전시연결관리 매장 목록 조회(Tree 형식)

GET

/v2/display/displayConnect/shop

API URI 개선

카테고리 매장 조회

GET

/v2/display/displayConnect/shop/category/{dispCtgNo}

API URI 개선

카테고리 매장 템플릿 지정

POST

/v2/display/displayConnect/shop/category

API URI 개선

비정형, 브랜드 매장 조회

GET

/v2/display/displayConnect/shop/{shopNo}

API URI 개선

비정형, 브랜드 매장 등록

POST

/v2/display/displayConnect/shop

API URI 개선

코너 세트 조회

GET

/v2/display/displayConnect/set

API URI 개선

스와이퍼 대상 목록 조회

GET

/v2/display/displayConnect/swiper/target

API URI 개선

코너 세트 저장

POST

/v2/display/displayConnect/set

API URI 개선

콘텐츠정보 목록 조회

GET

/v2/display/displayConnect/contents

API URI 개선

콘텐츠정보 목록 저장

POST

/v2/display/displayConnect/contents

API URI 개선

콘텐츠정보 단건 조회

GET

/v2/display/displayConnect/contents/detail/{conrContNo}

API URI 개선

콘텐츠정보 단건 저장

POST

/v2/display/displayConnect/contents/detail

API URI 개선

콘텐츠정보 다국어 조회

GET

/v2/display/displayConnect/contents/multiLang

API URI 개선

TEXT 콘텐츠정보 다국어 목록 조회

GET

/v2/display/displayConnect/contents/multiLang/text

API URI 개선

콘텐츠정보 다국어 저장

POST

/v2/display/displayConnect/contents/multiLang

API URI 개선

TEXT 콘텐츠정보 다국어 목록 저장

POST

/v2/display/displayConnect/contents/multiLang/text

API URI 개선

구좌 목록 조회

GET

/v2/display/account

API URI 개선

구좌 상세 정보 조회

GET

/v2/display/account/{adutId}

API URI 개선

구좌 정보 등록 및 수정

POST

/v2/display/account

API URI 개선

구좌 매장 관리 Tree 호출

GET

/v2/display/account/shop

/getDisplayCornerAccountTree와 /getDispCornerAccountPopupShopTree API 통합

구좌 매장 등록/수정

POST

/v2/display/account/shop

API URI 개선

구좌에 연결된 템플릿코너번호 목록 조회

GET

/v2/display/account/tmplConrNo

구좌에 연결된 템플릿 코너의 삭제 방지를 위한 신규 API 추가

전시 코너 저장

POST

/v2/display/displayCornerMgmt

등록 및 수정이 분리된 API를 통합

코너 저장

POST

/v1/display/displayCornerMgmt/registerCorner

API 통합으로 제외된 항목 처리

코너 수정

POST

/v1/display/displayCornerMgmt/modifyCorner

API 통합으로 제외된 항목 처리

전시 템플릿 연결 매장 존재 여부

GET

/v2/display/displayTemplateMgmt/tmplMappCheck

템플릿 저장 시 각 항목의 체크를 목록 전달 방식으로 변경하여 확인할 수 있는 API 추가

전시 템플릿 목록 저장

DELETE

/v2/display/displayTemplateMgmt

등록/수정을 모두 처리하던 기존 API를 삭제 전용으로 수정

전시 템플릿 등록/수정

POST

/v2/display/displayTemplateMgmt/saveTemplate

등록 및 수정이 나뉘어 있던 API를 통합

전시 템플릿 저장

POST

/v1/display/displayTemplateMgmt/registerTemplate

API 통합으로 제외된 항목 처리

전시 템플릿 수정

PUT

/v1/display/displayTemplateMgmt/modifyTemplate

API 통합으로 제외된 항목 처리

전시 카테고리 조회 팝업(Tree)

GET

v1/display/displayCategoryMgmt/getCategoryTreeList

API 엔드포인트 변경: getDisplayCategoryTreeList → getCategoryTreeList (키 중복 이슈 해결, 셀렉트 박스 형식)

표준카테고리별 전시카테고리 목록 조회

GET

/v2/goods/goodsCommonApi/getDisplayCategoryListByStandardCategory

API URI 개선

매장 연결 템플릿 목록 조회

GET

/v2/display/displayTemplateMappMgmt

API URI 개선

매장 연결 템플릿 조회

GET

/v2/display/displayTemplateMappMgmt/{shopNo}

API URI 개선

매장 연결 템플릿 목록 저장

POST

/v2/display/displayTemplateMappMgmt

API URI 개선

전시템플릿 연결 매장/기획전 목록

GET

/v2/display/displayTemplateMappMgmt/{tmplNo}/shop

API URI 개선

매장/기획전에 연결된 템플릿번호 목록 조회

GET

/v2/display/displayTemplateMappMgmt/tmplNo

API URI 개선

템플릿코너 목록 조회

GET

/v2/display/displayCornerMappMgmt

API URI 개선

템플릿코너 목록 저장

POST

/v2/display/displayCornerMappMgmt

API URI 개선

템플릿코너 연결 매장템플릿번호 목록 조회

GET

/v2/display/displayCornerMappMgmt/shopTmplNo

API URI 개선

템플릿코너 다국어 목록 조회

GET

/v2/display/displayCornerMappMgmt/multiLang

API URI 개선

템플릿코너 다국어 목록 저장

POST

/v2/display/displayCornerMappMgmt/multiLang

API URI 개선

브랜드 정보 삭제

POST

/v1/goods/brandMgmtApi/deleteBrandInfo

미사용 API를 Deprecated 처리

주문관리 > 주문 클레임 처리 고객목록 조회

GET

/v1/claim/orderClaimProc/getOrdClmProcMbrInfoList

주문 클레임 처리 시 고객 조회 로직을 회원 정보 테이블을 기준으로 주문이 있는 고객 목록 조회로 변경

엑셀 다운로드 권한 체크

GET

/v1/common/common/hasListExcelDownloadPermission

권한 코드 타입 추가

전체 표준 카테고리 목록 조회

GET

/api/bo/v2/display/standardCategory

REST-API URL 규칙 적용

표준 카테고리 기본 정보 조회

GET

/api/bo/v2/display/standardCategory/{stdCtgNo}

REST-API URL 규칙 적용

하위 표준 카테고리 목록 및 개수 조회

GET

/api/bo/v2/display/standardCategory/children/{stdCtgNo}

REST-API URL 규칙 적용

표준 카테고리 상품 목록 조회

GET

/api/bo/v2/display/standardCategory/goods/{stdCtgNo}

REST-API URL 규칙 적용

표준 카테고리 기본 정보 수정

PUT

/api/bo/v2/display/standardCategory/{stdCtgNo}

REST-API URL 규칙 적용

하위 표준 카테고리 목록 저장

POST

/api/bo/v2/display/standardCategory

REST-API URL 규칙 적용

표준 카테고리 상품 속성 목록 조회

GET

/api/bo/v2/display/standardCategory/goodsAttr/{stdCtgNo}

REST-API URL 규칙 적용

표준 카테고리 상품 속성 목록 저장

POST

/api/bo/v2/display/standardCategory/goodsAttr/{stdCtgNo}

REST-API URL 규칙 적용

속성 정보 목록 조회

GET

/api/bo/v2/display/standardCategory/goodsAttr

REST-API URL 규칙 적용

엑셀 전시상품 목록 일괄 저장

POST

/api/bo/v2/display/display-category/{dispCtgNo}/excel

REST-API URL 규칙 적용, 서비스 로직 변경

전체 전시 카테고리 목록 조회

GET

/api/bo/v2/display/display-category/tree

REST-API URL 규칙 적용

전시 카테고리 기본 정보 조회

GET

/api/bo/v2/display/display-category/{dispCtgNo}

REST-API URL 규칙 적용

전시 카테고리 기본 정보 수정

PUT

/api/bo/v2/display/display-category/{dispCtgNo}

REST-API URL 규칙 적용

하위 전시 카테고리 목록 조회

GET

/api/bo/v2/display/display-category/{dispCtgNo}/categories

REST-API URL 규칙 적용, count 추가

하위 전시 카테고리 목록 저장

POST

/api/bo/v2/display/display-category/categories

REST-API URL 규칙 적용

전시 카테고리명 다국어 목록 조회

GET

/api/bo/v2/display/display-category/multi-lang

REST-API URL 규칙 적용

전시 카테고리명 다국어 저장

POST

/api/bo/v2/display/display-category/multi-lang

REST-API URL 규칙 적용

전시상품 목록 조회

GET

/api/bo/v2/display/display-category/{dispCtgNo}/goods

REST-API URL 규칙 적용

전시상품목록 상세 조회(중복확인 후 상품목록 디테일)

GET

/api/bo/v2/display/display-category/{dispCtgNo}/goods/valid

REST-API URL 규칙 적용

전시상품 목록 저장

POST

/api/bo/v2/display/display-category/{dispCtgNo}}/goods

REST-API URL 규칙 적용

엑셀 전시상품 목록 일괄 저장

POST

/api/bo/v2/display/display-category/{dispCtgNo}/excel

REST-API URL 규칙 적용, 저장 시 validation 추가

일괄 등록 전시 상품의 유효성 조회

GET

/api/bo/v2/display/display-category/{dispCtgNo}/excel/valid

REST-API URL 규칙 적용, 일괄 조회 로직 개선

연결 소전시 카테고리 목록 조회

GET

/api/bo/v2/display/standardDisplayCategoryConnect

REST-API URL 규칙 적용

연결 소전시 카테고리 목록 저장

POST

/api/bo/v2/display/standardDisplayCategoryConnect

REST-API URL 규칙 적용

주문조회

GET

/v1/order/orderQuery/getOrderQueryList

주문 조회 시 멀티 조회 기능 개선 및 상품명 Like 검색('%keyword%' 형태) 기능 SB 적용

현금 결제내역 조회

GET

/v1/payment/paymentDetailsMgmt/getCashPaymentList

PG사 조회 조건 및 결과값 추가

정기주문 주문 내역 조회

GET

/v2/order/regularOrderApplicationMgmt/getRegularOrderApplicationHistoryList

날짜 조회 조건 삭제 및 요청(Request) 타입 변경

정기주문 신청 상세 조회

GET

/v2/order/regularOrderApplicationMgmt/getRegularOrderApplicationDetail

정기 주문 상품 정보에 단품 정보 추가

정기주문 변경 사항 저장

POST

/v2/order/regularOrderApplicationMgmt/saveRegularOrder

요청(Request) DTO 변경

주문취소 내역 조회

POST

/v1/claim/orderCancel/getOrderCancelList

상품명 Like 검색 기능 및 주문 구분 조회 조건 누락 사항 적용

교환주문목록 조회

POST

/v1/claim/exchange/getExchangeOrderList

사이트, 상품 멀티, 주문 멀티 검색 조건 개선

협력사 사업자 번호 중복여부 체크

GET

/v1/popup/partnerMgmt/isDuplicateWithBusinessNo

협력사 번호 기준으로 거래 대기/거래 중 협력사의 사업자 번호 중복 여부 조회 기능 추가