SpringBoot과 Vue.js 기반 온라인 쇼핑몰 관리 시스템 설계 및 구현

시스템 개요

본 시스템은 전자상거래 비즈니스의 디지털 전환을 지원하기 위해 개발된 온라인 쇼핑몰 관리 플랫폼이다. 백엔드는 SpringBoot, MyBatis, MySQL을 기반으로 RESTful API를 제공하며, 프론트엔드는 Vue.js와 Element UI로 구성되어 반응형 사용자 경험을 구현한다. 핵심 기능으로는 회원 관리, 상품 카탈로그, 장바구니, 주문 처리 및 결제 모듈이 포함되며, 역할 기반 접근 제어(RBAC)를 통해 관리자와 일반 사용자의 권한을 분리하였다.

데이터베이스 스키마

시스템에서 사용하는 주요 테이블은 다음과 같다.

회원 정보 (members)

컬럼명데이터 타입설명
member_idBIGINT기본 키, 자동 증가
login_idVARCHAR(50)로그인 아이디 (고유)
pass_hashVARCHAR(100)BCrypt로 해싱된 비밀번호
emailVARCHAR(100)이메일 주소
mobileVARCHAR(20)휴대폰 번호
joined_atDATETIME가입 일시
last_login_atDATETIME마지막 로그인 시간
activeTINYINT계정 활성화 상태 (0:비활성, 1:활성)
roleTINYINT권한 레벨 (1:일반, 2:관리자)

상품 정보 (items)

컬럼명데이터 타입설명
item_idBIGINT기본 키
item_nameVARCHAR(100)상품명
category_idBIGINT카테고리 식별자
priceDECIMAL(10,2)판매 가격
stock_qtyINT재고 수량
descriptionTEXT상세 설명
img_pathVARCHAR(255)이미지 저장 경로
created_atDATETIME등록 일시
updated_atDATETIME갱신 일시
on_displayTINYINT전시 여부 (0:숨김, 1:전시)

주문 정보 (orders)

컬럼명데이터 타입설명
order_idBIGINT기본 키
member_idBIGINT주문 회원 ID
total_amountDECIMAL(10,2)총 주문 금액
pay_methodVARCHAR(20)결제 수단
pay_statusTINYINT결제 상태 (0:미결제, 1:완료)
shipping_addrVARCHAR(255)배송지 주소
ordered_atDATETIME주문 시간
shipped_atDATETIME출고 시간
received_atDATETIME수령 시간
order_stateTINYINT주문 상태 (0:대기, 1:출고대기, 2:배송중, 3:완료)

기술 스택

백엔드

  • Spring Boot 2.7.x : 자동 구성, 내장 톰캣, Actuator 모니터링을 통해 프로덕션 레벨의 마이크로서비스 기반을 제공한다.
  • MyBatis Plus : CRUD 자동화 및 동적 쿼리 래퍼를 통해 생산성을 높이고, SQL을 XML 없이도 처리할 수 있도록 지원한다.
  • MySQL 8.0 : 트랜잭션 처리와 데이터 무결성을 보장하며, 인덱스 최적화를 통해 대용량 상품 및 주문 데이터에 대응한다.
  • JWT 인증 : 토큰 기반 인증으로 무상태 API를 구현하고, 토큰 관리를 위한 유틸리티 클래스를 자체 제작하였다.

프론트엔드

  • Vue.js 2.x : 반응형 데이터 바인딩과 컴포넌트 재사용성을 통해 복잡한 UI 상태 관리를 단순화한다.
  • Vue Router : SPA 라우팅을 구성하고, 네비게이션 가드로 인증되지 않은 접근을 차단한다.
  • Axios : 백엔드 API와의 HTTP 통신을 담당하며, 인터셉터로 JWT 토큰을 헤더에 주입한다.

핵심 코드 예시

다음은 스프링 부트 애플리케이션의 진입점으로, MyBatis 매퍼 자동 스캔과 서블릿 초기화를 설정하는 예제이다.

package com.shop;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletComponentScan;

@ServletComponentScan
@SpringBootApplication
@MapperScan("com.shop.mapper")
public class MallApplication {

    public static void main(String[] args) {
        SpringApplication.run(MallApplication.class, args);
    }
}

아래는 회원 관리를 위한 REST 컨트롤러의 일부이다. JWT 기반 인증, CRUD 작업, 비밀번호 리셋 등을 포함하며, 입력 검증과 중복 확인 로직이 통합되어 있다.

package com.shop.controller;

import com.shop.common.JwtUtils;
import com.shop.common.RespResult;
import com.shop.entity.Member;
import com.shop.service.MemberService;
import com.shop.util.PasswordEncoder;
import org.springframework.web.bind.annotation.*;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;
import java.util.Date;
import java.util.Map;

@RestController
@RequestMapping("/api/members")
public class MemberController {

    @Resource
    private MemberService memberService;

    @Resource
    private JwtUtils jwtUtils;

    @PostMapping("/sign-in")
    public RespResult signIn(@RequestParam String loginId,
                             @RequestParam String password) {
        Member member = memberService.findByLoginId(loginId);
        if (member == null || !PasswordEncoder.matches(password, member.getPassHash())) {
            return RespResult.error("아이디 또는 비밀번호가 잘못되었습니다.");
        }
        String token = jwtUtils.generateToken(member.getMemberId(), loginId, member.getRole());
        return RespResult.success().data("token", token);
    }

    @PostMapping("/sign-up")
    public RespResult signUp(@RequestBody Member member) {
        if (memberService.existsByLoginId(member.getLoginId())) {
            return RespResult.error("이미 사용 중인 아이디입니다.");
        }
        member.setPassHash(PasswordEncoder.encode(member.getPassHash()));
        member.setJoinedAt(new Date());
        member.setActive(1);
        member.setRole(1);
        memberService.save(member);
        return RespResult.success();
    }

    @PutMapping("/reset-pwd")
    public RespResult resetPassword(@RequestParam String loginId) {
        Member member = memberService.findByLoginId(loginId);
        if (member == null) {
            return RespResult.error("존재하지 않는 아이디입니다.");
        }
        member.setPassHash(PasswordEncoder.encode("newpassword123"));
        memberService.updateById(member);
        return RespResult.success("비밀번호가 초기화되었습니다.");
    }

    @GetMapping("/list")
    public RespResult list(@RequestParam Map<String, Object> params) {
        return RespResult.success().data(memberService.queryPage(params));
    }

    @GetMapping("/{id}")
    public RespResult detail(@PathVariable Long id) {
        return RespResult.success().data(memberService.getById(id));
    }

    @PostMapping
    public RespResult create(@RequestBody Member member) {
        if (memberService.existsByLoginId(member.getLoginId())) {
            return RespResult.error("아이디가 이미 존재합니다.");
        }
        member.setJoinedAt(new Date());
        member.setPassHash(PasswordEncoder.encode(member.getPassHash()));
        memberService.save(member);
        return RespResult.success();
    }

    @PutMapping
    public RespResult update(@RequestBody Member member) {
        if (memberService.countDuplicateLoginId(member.getMemberId(), member.getLoginId()) > 0) {
            return RespResult.error("아이디 중복입니다.");
        }
        memberService.updateById(member);
        return RespResult.success();
    }

    @DeleteMapping("/batch")
    public RespResult deleteBatch(@RequestBody Long[] ids) {
        memberService.removeByIds(java.util.Arrays.asList(ids));
        return RespResult.success();
    }
}

이 컨트롤러는 서비스 계층과 결합되어 있으며, MemberService는 MyBatis Plus의 BaseMapper를 확장한 매퍼를 통해 데이터베이스에 접근한다. 인증이 필요한 엔드포인트는 인터셉터에서 토큰 유효성을 검사하도록 설계되었다.

시스템 동작 흐름

사용자는 회원 가입 후 상품 목록을 조회하고, 장바구니에 담은 뒤 주문을 생성한다. 주문 시 재고 차감과 결제 상태 변경이 트랜잭션으로 처리되어 데이터 일관성을 유지한다. 관리자는 상품 등록/수정, 주문 상태 변경, 회원 관리를 수행할 수 있으며, 모든 요청은 JWT에 담긴 역할(role) 정보를 기반으로 접근이 제어된다.

이 아키텍처는 프론트엔드와 백엔드가 완전히 분리되어 있어 확장이 용이하고, 동일한 API를 모바일 애플리케이션 등 여러 클라이언트에서도 사용할 수 있다.

태그: SpringBoot Vue.js MyBatis MySQL 전자상거래

10월 22일 05:26에 게시됨