팔도곳간
지역 농산물 커머스에서 BFF, 상품과 미디어 모듈, 리뷰 AI 분석을 맡은 팀 프로젝트 (진행 중)
프로젝트 개요
판매자가 지역 농산물을 올리고 구매자가 주문하는 커머스 서비스입니다. 회원, 상품, 주문, 지갑, 정산, 배송을 Spring Modulith 모듈로 나눈 구조에서 재고를 포함한 상품 모듈과 미디어 업로드 모듈을 맡았습니다. 주문 모듈과 맞물리는 재고 배정에서 동시 요청과 중복 요청을 안전하게 처리하는 데 집중했습니다. 프론트엔드 앞에는 Hono BFF를 두고 로그인 토큰을 브라우저 스토리지에서 HttpOnly 쿠키로 옮기는 방식을 설계하고 구현했습니다. 리뷰를 AI 의사결정 모델 JEV로 감성·키워드 분석해 판매자 감성 집계와 구매자 키워드 필터에 쓰는 기능도 맡았습니다.
기술 스택
Java · Spring Boot · Spring Data JPA · MySQL · Testcontainers · Hono
담당 범위와 결과
역할 · Hono BFF 설계와 구현, 상품 모듈과 S3 미디어 업로드 모듈 구현, 리뷰 AI 분석
재고 덮어쓰기와 초과 배정 막기
- 재고를 컬럼 하나로 두면 판매자가 입력한 값이 그사이 들어온 주문 차감을 덮어써서, 판매자가 바꾸는 총재고와 주문이 바꾸는 배정 수량을 나눴습니다. JPA가 엔티티를 저장할 때 옛 배정 수량을 다시 쓰지 않도록 두 값은 조건부 UPDATE로만 바뀌게 했습니다.
- 배정은 판매 가능 수량이 요청 수량 이상일 때만 반영되는 조건부 UPDATE 한 번으로 판정했습니다. 판단이 SQL 조건 하나로 표현돼 확인과 차감을 한 쿼리로 처리할 수 있었고, 낙관적 락처럼 재시도할 필요도 없어서입니다. 남은 재고보다 많은 주문이 동시에 들어와도 재고만큼만 성공하는 것을 Testcontainers 통합 테스트로 확인했습니다.
같은 주문이 여러 번 와도 한 번만 반영
- 주문 모듈이 같은 주문으로 배정이나 해제를 다시 호출해도 한 번만 반영되도록 주문별 배정 기록과 유니크 키를 두고, 해제는 기록 상태를 바꾼 호출만 재고를 되돌리게 했습니다. 주문 쪽은 중복을 신경 쓰지 않고 필요한 시점에 호출만 하면 됩니다.
- 여러 옵션은 옵션 ID 순서로 처리해 주문 사이의 데드락을 피했습니다.
상품 입력 검증
- 판매자가 에디터로 쓴 HTML이 구매자 화면에 그대로 나가므로, 조회가 수정보다 훨씬 많다는 점을 고려해 저장할 때 허용 목록 기반으로 한 번 정제하고 이미지 주소는 자사 저장소의 상품 경로로 제한했습니다.
- 옵션만 바뀐 수정에서도 상품 버전이 오르게 해 다른 사람의 수정을 덮어쓰지 않도록 하고, 주문 처리로는 버전이 오르지 않게 범위를 정했습니다.
미디어 업로드
- S3 미디어 업로드 모듈을 만들어 이미지는 형식과 용량을 확인한 뒤 크기를 줄이고 압축해 저장하도록 했습니다.
BFF로 브라우저 JS에서 인증 토큰 걷어내기
- 로그인 토큰을 브라우저 스토리지에서 BFF가 발급하는 HttpOnly 쿠키 두 개로 옮겨 브라우저 JS가 토큰을 읽지 못하게 했습니다.
- Redis 세션도 구현해 검증했지만 BFF가 한 대인 환경에서는 운영 부담이 이점보다 커서 채택하지 않았습니다.
리뷰 감성·키워드 AI 분석
- 리뷰 저장과 같은 트랜잭션에 분석 요청을 대기로 남기고, 5초마다 도는 백그라운드 작업이 이를 꺼내 트랜잭션 밖에서 AI 의사결정 모델 JEV로 감성과 키워드를 분석하게 했습니다.
- 앱이 여러 대여도 같은 요청을 두 번 호출하지 않도록 FOR UPDATE SKIP LOCKED와 10분 임대를 함께 썼습니다.