2024-12-04 X2BEE 3.0 release

Owned by X2BEE 관리자, created
Last updated: 2025-01-02
8 min read

X2BEE는 기술 스택 고도화를 통해 X2BEE 3.0으로 업데이트를 진행하였습니다. Next.js 프레임워크 도입과 Front SHOP과 Back-Office 기술 통합을 완료하여 시스템 아키텍처를 혁신적으로 개선하였습니다. 이를 통해 사용자 경험과 개발 생산성을 대폭 향상 시켰으며, 급변하는 이커머스 시장의 요구사항에 더욱 유연하게 대응할 수 있습니다.

주요 변경 및 개선 사항

1. 프론트(Front)와 BO(Back-Office) 기술 스택 통합

  • React 및 Next.js 프레임워크로 프론트와 백오피스 기술 스택을 통일하여 개발 효율성과 유지보수성을 개선하였습니다.

  • 통합된 코드 베이스를 통해 일관된 사용자 경험을 제공합니다.

2. 사용자 경험(UX) 향상

  • 머트리얼 디자인(Material Design) 기반 UI 도입으로 다양한 디바이스에서 일관된 UX를 제공합니다.

  • UI 컴포넌트 기반 개발로 재사용성과 확장성 강화 되었습니다.

  • 다크모드 지원/폰트변경/테마 사용 등을 통하여, 사용자 경험을 향상 시켰습니다.

3. 성능 최적화

  • SSR(Server-Side Rendering) 및 ISR(Incremental Static Regenaeration)적용하여 초기 로딩 시간을 단축하여 필요한 데이터를 더 빠르게 확인할 수 있습니다.

  • 코드 분할 및 동적 임포트 기술이 적용되어 필요한 모듈만 로드하여 애플리케이션 성능을 최적화 하였습니다.

4. 개발 생산성 증가

  • 핫 모듈 리플레이스먼트(HMR) 기능을 활용하여 코드 변경사항을 실시간으로 반영하였으며, 풍부한 React/Next.js 생태계와 라이브러리를 활용하여 개발 속도를 한층 향상 시켰습니다.

5. UI 및 유지보수 효율성 강화

  • MUI(Material UI) 도입으로 커스터마이징과 반응형 디자인을 더 쉽게 구현할 수 있도록 하고, TypeScript 지원으로 코드 안정성 확보와 품질을 향상 시켰습니다.

 

기대 효과

  • 유지보수 비용 절감: 프론트와 백오피스 기술 통합으로 개발 및 유지보수 효율성 증대

  • 사용자 만족도 향상: UI 개선 및 성능 최적화로 높은 사용성을 제공하고, 접근성 있는 애플리케이션 개발 환경 제공

  • 개발 생산성 향상: 통합된 기술 스택과 툴을 활용한 개발 주기 단축 및 신속한 배포 환경 제공

 

적용 기술 스택

명칭

버전

용도

명칭

버전

용도

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

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

X2BEE 3.0에 적용된 라이브러리 상세 내용은 개발 환경 문서에서 확인할 수 있습니다

변경 내역

1. DB 변경 내역

  1. 컬럼 추가: ST_RT_TGT_BASE 테이블에 initial  (varchar(20))

  2. 재입고 발송 상태 PR071 코드 추가: 미발송 / 10, 발송완료 / 20, 기간만료 / 30, 고객취소 / 40

  3. st_rt_tgt_base_apollo_ml 테이블 생성:

    • 컬럼:

      • rt_tgt_seq (VARCHAR(15), NOT NULL)

      • lang_cd (VARCHAR(10), NOT NULL)

      • rt_tgt_nm (VARCHAR(200), NOT NULL)

      • sys_reg_id (VARCHAR(30), NOT NULL)

      • sys_reg_dtm (TIMESTAMP, NOT NULL)

      • sys_mod_id (VARCHAR(30), NOT NULL)

      • sys_mod_dtm (TIMESTAMP, NOT NULL)

    • Primary Key: (rt_tgt_seq, lang_cd)

    • Index: sys_mod_dtm

 

2. 개발 가이드 업데이트 안내

구분

업데이트 문서 연결

구분

업데이트 문서 연결

프로젝트 준비하기

Framework 가이드

그리드

개발 시작하기

 

3. API 변경 내역

  • Server: API-BO

API 명

메소드

엔드포인트

설명

API 명

메소드

엔드포인트

설명

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

GET

/v1/system/userMgmt/getIndividualInfoRightList

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

반품전환 처리대상조회

POST

/v2/claim/return/getReturnTransformPopupBaseInfo

REST API 마이그레이션

고객정보확인사유 체크

GET

/v2/member/memberInfoConfirmReason/validIndInfoParam

REST API 마이그레이션

배송상세 조회

GET

/v1/delivery/deliveryInquiry/getDeliveryOrderDetailList

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

판매 상품 현황 목록 조회

GET

/v1/statistics/goodsAnalysis/getGoodsSalesStatusList

REST 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

REST API 마이그레이션

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

POST

/v2/goods/goodsBatchRegistApi/goodsBatchRegist.excelUpload

REST API 마이그레이션

엑셀 업로드 양식 다운로드

GET

/v2/goods/goodsBatchRegistApi/goodsBatchRegist.excelDownload

REST API 마이그레이션

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

GET, POST

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

REST API 마이그레이션

저장소 파일 다운로드

GET

/v1/common/common/downloadFile

REST API 마이그레이션

일반상품 등록

POST

/v2/goods/generalGoodsApi/registTemporaryGeneralGoods

REST API URI 개선

일반상품 복사

GET

/v2/goods/generalGoodsApi/copyGeneralGoods

REST API URI 개선

이미지 저장

POST

/v2/goods/generalGoodsApi/uploadGoodsRegistImageFile

REST API 마이그레이션, REST API URI 개선

사은품 등록

POST

/v2/goods/giftGoodsApi/registerGiftGoods

REST API URI 개선

묶음대상 상품목록 조회

GET

/v2/goods/packageGoodsApi/getPackageTargetGoodsList

REST API URI 개선

묶음상품 등록

POST

/v2/goods/packageGoodsApi/temporaryPackageGoodsRegist

REST API URI 개선

상품 기본 정보 조회

GET

/v2/goods/goodsCommonApi/getGoodsBaseInfo

REST API URI 개선

일반상품 정보 조회

GET

/v2/goods/goodsCommonApi/getGeneralGoodsInfo

REST API URI 개선

묶음상품 정보 조회

GET

/v2/goods/goodsCommonApi/getPackageGoodsInfo

REST API URI 개선

사은품 정보 조회

GET

/v2/goods/goodsCommonApi/getGiftGoodsInfo

REST API URI 개선

상품고시항목 목록 조회

GET

/v2/goods/goodsCommonApi/getGoodsNotificationItemList

REST API URI 개선

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

GET

/v2/goods/goodsCommonApi/getGoodsCtgAttInfoList

REST API URI 개선

협력사 기본 정보 조회

GET

/v2/goods/goodsCommonApi/getEtEntrBase

REST API URI 개선

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

GET

/v2/goods/goodsCommonApi/getDeliveryPolicyList

REST API URI 개선

가격 변경 예약 등록/취소

POST

/v2/goods/goodsCommonApi/modifyGeneralGoodsPriceReservation

REST API URI 개선

일반상품 수정

POST

/v2/goods/goodsCommonApi/modifyGeneralGoods

REST API URI 개선

묶음상품 수정

POST

/v2/goods/goodsCommonApi/modifyPackageGoods

REST API URI 개선

사은품 수정

POST

/v2/goods/goodsCommonApi/modifyGiftGoods

REST API URI 개선

상품정보 일괄수정

POST

/v2/goods/goodsCommonApi/modifyGoodsInfo

REST API URI 개선

단품 옵션목록 조회

GET

/v2/goods/goodsCommonApi/getItemOptionList

REST API URI 개선

단품 판매상태 목록 조회

GET

/v2/goods/goodsCommonApi/getGoodsSaleStateList

REST API URI 개선

아이콘 정보 조회

GET

/v2/goods/goodsCommonApi/getPrGoodsIconInfoList

REST API URI 개선

상품 다국어 정보 조회

GET

/v2/goods/goodsCommonApi/getGoodsMultiLanguageInfo

REST API URI 개선

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

POST

/v2/goods/goodsCommonApi/registGoodsMultiLanguage

REST API URI 개선

메뉴 목록 조회

GET

/v2/system/menuMgmt

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

메뉴 상세 조회

GET

/v2/system/menuMgmt/{rtTgtSeq}

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

메뉴 상세정보 수정

PUT

/v2/system/menuMgmt/{rtTgtSeq}

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

하위 메뉴 목록 저장

POST

/v2/system/menuMgmt/{rtTgtSeq}

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

매핑된 상위 메뉴 목록 조회

GET

/v2/system/menuMgmt/upper

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

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

POST

/v2/system/systemNoticeMgmt/uploadFile

REST API 마이그레이션

메뉴 권한 목록 조회

GET

/v2/system/individualRightMgmt/getIndividualMenuTreeList

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

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

GET

/v2/display/displayConnect/shop

REST API URI 개선

카테고리 매장 조회

GET

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

REST API URI 개선

카테고리 매장 템플릿 지정

POST

/v2/display/displayConnect/shop/category

REST API URI 개선

비정형, 브랜드 매장 조회

GET

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

REST API URI 개선

비정형, 브랜드 매장 등록

POST

/v2/display/displayConnect/shop

REST API URI 개선

코너 세트 조회

GET

/v2/display/displayConnect/set

REST API URI 개선

스와이퍼 대상 목록 조회

GET

/v2/display/displayConnect/swiper/target

REST API URI 개선

코너 세트 저장

POST

/v2/display/displayConnect/set

REST API URI 개선

콘텐츠정보 목록 조회

GET

/v2/display/displayConnect/contents

REST API URI 개선

콘텐츠정보 목록 저장

POST

/v2/display/displayConnect/contents

REST API URI 개선

콘텐츠정보 단건 조회

GET

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

REST API URI 개선

콘텐츠정보 단건 저장

POST

/v2/display/displayConnect/contents/detail

REST API URI 개선

콘텐츠정보 다국어 조회

GET

/v2/display/displayConnect/contents/multiLang

REST API URI 개선

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

GET

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

REST API URI 개선

콘텐츠정보 다국어 저장

POST

/v2/display/displayConnect/contents/multiLang

REST API URI 개선

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

POST

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

REST API URI 개선

구좌 목록 조회

GET

/v2/display/account

REST API URI 개선

구좌 상세 정보 조회

GET

/v2/display/account/{adutId}

REST API URI 개선

구좌 정보 등록 및 수정

POST

/v2/display/account

REST API URI 개선

구좌 매장 관리 Tree 호출

GET

/v2/display/account/shop

/getDisplayCornerAccountTree와 /getDispCornerAccountPopupShopTree API 통합

구좌 매장 등록/수정

POST

/v2/display/account/shop

REST API URI 개선

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

GET

/v2/display/account/tmplConrNo

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

전시 코너 저장

POST

/v2/display/displayCornerMgmt

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

코너 저장

POST

/v1/display/displayCornerMgmt/registerCorner

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

코너 수정

POST

/v1/display/displayCornerMgmt/modifyCorner

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

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

GET

/v2/display/displayTemplateMgmt/tmplMappCheck

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

전시 템플릿 목록 저장

DELETE

/v2/display/displayTemplateMgmt

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

전시 템플릿 등록/수정

POST

/v2/display/displayTemplateMgmt/saveTemplate

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

전시 템플릿 저장

POST

/v1/display/displayTemplateMgmt/registerTemplate

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

전시 템플릿 수정

PUT

/v1/display/displayTemplateMgmt/modifyTemplate

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

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

GET

v1/display/displayCategoryMgmt/getCategoryTreeList

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

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

GET

/v2/goods/goodsCommonApi/getDisplayCategoryListByStandardCategory

REST API URI 개선

매장 연결 템플릿 목록 조회

GET

/v2/display/displayTemplateMappMgmt

REST API URI 개선

매장 연결 템플릿 조회

GET

/v2/display/displayTemplateMappMgmt/{shopNo}

REST API URI 개선

매장 연결 템플릿 목록 저장

POST

/v2/display/displayTemplateMappMgmt

REST API URI 개선

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

GET

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

REST API URI 개선

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

GET

/v2/display/displayTemplateMappMgmt/tmplNo

REST API URI 개선

템플릿코너 목록 조회

GET

/v2/display/displayCornerMappMgmt

REST API URI 개선

템플릿코너 목록 저장

POST

/v2/display/displayCornerMappMgmt

REST API URI 개선

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

GET

/v2/display/displayCornerMappMgmt/shopTmplNo

REST API URI 개선

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

GET

/v2/display/displayCornerMappMgmt/multiLang

REST API URI 개선

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

POST

/v2/display/displayCornerMappMgmt/multiLang

REST API URI 개선

브랜드 정보 삭제

POST

/v1/goods/brandMgmtApi/deleteBrandInfo

미사용 REST API를 Deprecated 처리

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

GET

/v1/claim/orderClaimProc/getOrdClmProcMbrInfoList

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

엑셀 다운로드 권한 체크

GET

/v1/common/common/hasListExcelDownloadPermission

권한 코드 타입 추가

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

GET

/v2/display/standardCategory

REST API URI 개선

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

GET

/v2/display/standardCategory/{stdCtgNo}

REST API URI 개선

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

GET

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

REST API URI 개선

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

GET

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

REST API URI 개선

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

PUT

/v2/display/standardCategory/{stdCtgNo}

REST API URI 개선

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

POST

/v2/display/standardCategory

REST API URI 개선

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

GET

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

REST API URI 개선

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

POST

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

REST API URI 개선

속성 정보 목록 조회

GET

/v2/display/standardCategory/goodsAttr

REST API URI 개선

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

POST

/v1/display/displayCategoryMgmt/getDisplayCategoryList

REST API URI 개선, 서비스 로직 변경

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

GET

/v1/display/displayCategoryMgmt/getDisplayCategoryListCount

REST API URI 개선

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

GET

/v1/display/displayCategoryMgmt/getDisplayCategoryTreeList

REST API URI 개선

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

PUT

/v1/display/displayCategoryMgmt/getDisplayCategoryMgmtSubCategoryMultiLanguageListCount

REST API URI 개선

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

GET

/v1/display/displayCategoryMgmt/getDisplayGoodsListCount

REST API URI 개선, count 추가

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

POST

/v1/display/displayCategoryMgmt/getValidDisplayGoodsList

REST API URI 개선

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

GET

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

REST API URI 개선

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

POST

/v2/display/display-category/tree

REST API URI 개선

전시상품 목록 조회

GET

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

REST API URI 개선

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

GET

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

REST API URI 개선

전시상품 목록 저장

POST

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

REST API URI 개선

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

POST

/v2/display/display-category/categories

REST API URI 개선, 저장 시 validation 추가

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

GET

/v2/display/display-category/multi-lang

REST API URI 개선, 일괄 조회 로직 개선

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

GET

/v2/display/display-category/multi-lang

REST API URI 개선

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

POST

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

REST API URI 개선

주문조회

GET

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

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

현금 결제내역 조회

GET

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

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

정기주문 주문 내역 조회

GET

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

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

정기주문 신청 상세 조회

GET

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

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

정기주문 변경 사항 저장

POST

/v2/display/standardDisplayCategoryConnect

요청(Request) DTO 변경

주문취소 내역 조회

POST

/v2/display/standardDisplayCategoryConnect

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

교환주문목록 조회

POST

/v1/claim/exchange/getExchangeOrderList

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

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

GET

/v1/popup/partnerMgmt/isDuplicateWithBusinessNo

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