개발사례

샘플쉽 상품 spec templates 운영 회고와 실무 레슨런

2분 읽기
쇼핑몰상품정보고시템플릿과유효성검증구축과실전트러블슈팅노하우TOVLABMarketingOperationsNextjs14GoogleSearchConsoleSEOWebEngineeringSampleshipProductSpecTemplatePostgreSQL관리자화면이커머스운영

과제 개요

샘플쉽 관리자 상품 화면에는 상품마다 반복 입력해야 하는 고시정보(원산지, 배송기간, 판매자 정보 등)를 운영자가 매번 수기로 채워 넣는 구조적 비효율이 있었습니다.

이번 작업은 상품 유형별 고시정보 템플릿을 데이터베이스 단에 정의하고, 관리자 화면에서 선택 즉시 상품 데이터로 치환되도록 연동하는 데 초점을 맞췄습니다.

데이터 구조와 기본 템플릿 설계

PostgreSQL에 product_spec_templates 테이블을 신설하고, 구매대행 기본·전자기기·의류/패션·뷰티/생활·산업/공구 다섯 개 유형의 시드 템플릿을 등록했습니다.

상품군별로 요구되는 고시 항목이 다르다는 점을 고려해 유형을 나눠 관리하는 방식을 택했고, 관리자 화면에서 이 템플릿 목록을 조회하는 전용 API를 함께 구성했습니다.

토큰 치환을 통한 상품 데이터 자동 반영

템플릿 문구 내부에 {code}, {origin}, {shipping_days}, {seller} 토큰을 정의해, 상품 등록 화면에서 입력한 실제 값으로 자동 치환되도록 구현했습니다.

템플릿 선택만으로 상품별 고시 문구가 채워지도록 하여, 운영자가 고시정보 항목을 개별적으로 수정하는 단계를 줄이는 방향으로 설계했습니다.

관리자 화면 연동과 검증

Sampleship Admin Product Spec Template UI Sampleship Spec Template Selector

빌드 및 정적 검사를 통과시킨 뒤, 관리자 상품 고시정보 템플릿 API 응답과 Playwright 기반 관리자 화면 렌더링·템플릿 적용 여부를 확인했습니다.

검증 결과
[PASS] 빌드 및 정적 검사 통과
[PASS] 관리자 상품 고시정보 템플릿 API 응답 확인
[PASS] Playwright 기준 관리자 화면 템플릿 적용 확인

남은 과제

리뷰/상품문의, 쿠폰·적립금·회원 등급, 결제(PG) 연동, 운영용 인증 강화, 정책/SEO 정리는 아직 진행 전 단계입니다.

고시정보 템플릿 구조를 기반으로 상품 등록 흐름의 나머지 반복 작업도 순차적으로 자동화 범위를 넓혀갈 예정입니다.