12장. 용어·라벨 가이드
한글 10자/영문 18자·동사형 버튼
11장 화면 구조에 일관된 언어 적용하기
11장에서 확정한 FO·BO 사이트맵에 등장하는 모든 텍스트의 작성 규칙을 정의한다. 용어·라벨 가이드는 메뉴명·화면 제목·버튼·필드 라벨·안내 문구에 일관성을 부여하는 사전이다.
용어 가이드가 필요한 이유는 화면 설계자·개발자·콘텐츠 담당자가 각자 다른 단어를 쓰면 사용자가 혼란스럽기 때문이다. "주문 내역"과 "주문 조회", "구매하기"와 "결제하기"처럼 비슷한 의미의 단어를 통일해야 한다. 특히 FO와 BO에서 같은 개념을 다른 단어로 표현하지 않도록 도메인 용어를 표준화한다.
이 장에서는 쇼핑몰 특화 용어를 정리하고, 길이 제약(한글 10자·영문 18자)과 버튼 동사형 규칙을 적용한다.
기본 원칙
원칙 1: 한글 우선, 영문 보조
FO·BO 모두 한글을 기본으로 한다. 영문은 API 엔드포인트나 코드 변수명에서만 사용한다. 단, 고유명사(PG사명·브랜드명)나 업계 표준 용어(SKU·API)는 영문 그대로 쓴다.
원칙 2: 길이 제약
한글
메뉴·버튼·필드 라벨: 최대 10자
화면 제목: 최대 15자
안내 문구: 최대 50자
영문
메뉴·버튼: 최대 18자 (공백 포함)
필드 라벨: 최대 20자
모바일 화면에서 버튼 텍스트가 잘리지 않도록 제약을 둔다. 10자를 넘으면 축약하거나 다른 표현을 찾는다.
원칙 3: 동사형 버튼
버튼은 사용자 액션을 명확히 표현하는 동사형으로 작성한다. "확인", "취소"처럼 애매한 단어 대신 "등록하기", "삭제하기"처럼 구체적으로 쓴다.
좋은 예
등록하기, 수정하기, 삭제하기, 검색하기, 적용하기, 저장하기
나쁜 예
확인, 취소, OK, Submit, 완료 (무엇을 확인·취소·완료하는지 불명확)
원칙 4: 도메인 용어 통일
같은 객체는 FO·BO에서 동일한 용어를 사용한다. 상품·주문·고객·쿠폰 같은 핵심 객체는 절대 바꾸지 않는다.
도메인별 표준 용어
상품(Product) 관련
상품 기본
FO·BO 공통: "상품"으로 통일
상품 분류
FO·BO 공통: "카테고리"로 통일
브랜드
FO·BO 공통: "브랜드"로 통일
상품 코드
FO: 노출하지 않음
BO: "SKU"
가격
FO·BO 공통: "판매가"로 통일
할인 가격
FO·BO 공통: "할인가"로 통일
재고
FO·BO 공통: "재고 수량"으로 통일
품절
FO·BO 공통: "품절"로 통일
옵션
FO: "옵션 (색상·사이즈)"
BO: "옵션"
상세 정보
FO: "상품 정보" (고객 관점)
BO: "상세 설명"
제외 용어
"아이템", "제품", "물품" → 모두 "상품"으로 통일
"스톡", "inventory" → "재고"로 통일
주문(Order) 관련
주문 기본
FO·BO 공통: "주문"으로 통일
주문 번호
FO·BO 공통: "주문번호"로 통일
주문 목록
FO: "주문 내역" (사용자 관점)
BO: "주문 리스트"
주문 상세
FO·BO 공통: "주문 상세"로 통일
주문 날짜
FO: "주문일"
BO: "주문일시" (시간 포함)
주문 상태
FO: "배송 상태" (배송 중심 표현)
BO: "주문 상태"
결제
FO·BO 공통: "결제"로 통일
결제 수단
FO: "결제 방법"
BO: "결제 수단"
배송
FO·BO 공통: "배송"으로 통일
배송지
FO: "배송지"
BO: "배송 주소"
운송장
FO: "배송 조회" (고객 친화적)
BO: "운송장 번호"
취소
FO: "주문 취소" (고객 행동)
BO: "취소 처리"
환불
FO·BO 공통: "환불" 또는 "환불 처리"로 통일
주문 상태 용어 (FO·BO 공통)
결제 대기 (payment_pending)
결제 완료 (paid)
상품 준비 중 (preparing)
배송 중 (shipped)
배송 완료 (delivered)
취소 (cancelled)
환불 완료 (refunded)
상태 표현은 영문 코드값과 한글 라벨을 쌍으로 관리한다.
고객(Customer) 관련
사용자
FO: 사용하지 않음 (1인칭 관점)
BO: "고객"
회원
FO·BO 공통: "회원"으로 통일
비회원
FO: "비회원 주문"
BO: "비회원"
계정
FO: "내 정보" (1인칭)
BO: "고객 정보"
로그인
FO: "로그인"
BO: 해당 없음
회원가입
FO: "회원가입"
BO: 해당 없음
이메일
FO·BO 공통: "이메일"로 통일
비밀번호
FO: "비밀번호"
BO: 관리하지 않음
등급
FO: "회원 등급"
BO: "등급"
적립금
FO·BO 공통: "적립금"으로 통일
제외 용어
"유저", "사용자", "멤버" → "고객" 또는 "회원"으로 통일
"아이디" → "이메일"로 통일 (이메일이 ID 역할)
장바구니·찜(Cart·Wishlist) 관련
장바구니
FO: "장바구니"
BO: 해당 없음
찜
FO: "찜한 상품"
BO: 해당 없음
수량
FO·BO 공통: "수량"으로 통일
합계
FO: "총 상품 금액"
BO: 해당 없음
배송비
FO·BO 공통: "배송비"로 통일
최종 금액
FO: "총 결제 금액" (고객 관점)
BO: "주문 금액"
쿠폰·프로모션(Coupon·Promotion) 관련
쿠폰
FO·BO 공통: "쿠폰"으로 통일
쿠폰함
FO: "내 쿠폰"
BO: 해당 없음
할인
FO·BO 공통: "할인"으로 통일
쿠폰 적용
FO: "쿠폰 사용"
BO: "쿠폰 적용"
유효 기간
FO: "사용 기한" (고객 친화적)
BO: "유효 기간"
프로모션
FO: "이벤트" (고객 친화적)
BO: "프로모션"
배너
FO·BO 공통: "배너"로 통일
버튼 텍스트 규칙
버튼은 사용자가 클릭했을 때 일어날 일을 명확히 알려준다. 동사형으로 작성하고, 10자를 넘지 않는다.
주요 액션 버튼
등록·생성
등록하기, 추가하기, 생성하기, 저장하기
예: "상품 등록하기", "쿠폰 추가하기"
수정·변경
수정하기, 변경하기, 편집하기
예: "정보 수정하기", "상태 변경하기"
삭제·제거
삭제하기, 제거하기, 취소하기
예: "상품 삭제하기", "쿠폰 제거하기"
조회·검색
검색하기, 조회하기, 찾기
예: "주문 조회하기", "고객 검색하기"
확인·완료
확인하기, 완료하기, 적용하기
예: "선택 완료하기", "쿠폰 적용하기"
구매 흐름 버튼
FO의 구매 흐름에서는 단계별로 명확한 동사를 사용한다.
상품 상세
장바구니 담기, 바로 구매하기
장바구니
선택 상품 주문, 전체 상품 주문
결제
결제하기 (최종 버튼)
주문 완료
주문 내역 보기, 쇼핑 계속하기
부정 액션 버튼
부정적 액션(삭제·취소)은 긍정 버튼과 색상을 다르게 한다.
취소·닫기
취소하기, 닫기, 돌아가기
예: "주문 취소하기", "팝업 닫기"
거절·거부
거부하기, 건너뛰기
예: "알림 거부하기", "이 단계 건너뛰기"
길이 초과 시 축약 규칙
공백 포함 10자를 넘으면 다음 방법으로 축약한다.
방법 1: "하기" 제거
"상품 등록하기" → "등록" (맥락이 명확한 경우)
"결제하기" → "결제" (최종 버튼)
방법 2: 주어 생략
"선택 상품 주문하기" → "선택 주문" (5자)
"전체 상품 삭제하기" → "전체 삭제" (5자)
방법 3: 동사 교체
"조회하기" → "보기" (2자)
"검색하기" → "찾기" (2자)
단, 축약 후에도 의미가 명확해야 한다. "확인"처럼 애매한 단어는 피한다.
필드 라벨 규칙
입력 필드 라벨은 필수·선택을 명시하고, 형식 안내를 추가한다.
기본 형식
필수 필드
상품명 *
이메일 *
비밀번호 *
별표()로 필수 표시하고, 폼 상단에 " 필수 입력 항목"을 안내한다.
선택 필드
할인가 (선택)
배송 메모 (선택)
"(선택)" 표시를 괄호로 감싼다.
형식 안내
필드 아래에 형식이나 제약을 안내한다.
예시
휴대폰 번호 *
010-1234-5678 형식으로 입력하세요
비밀번호 *
8자 이상, 영문·숫자·특수문자 포함
쿠폰 유효 기간 *
시작일은 종료일보다 이전이어야 합니다
안내 문구는 50자 이내로 간결하게 작성한다.
안내 메시지 규칙
성공·오류·경고 메시지는 사용자가 다음 행동을 알 수 있도록 작성한다.
성공 메시지
액션이 완료되었음을 알리고, 결과를 명시한다.
형식: "[대상]이(가) [액션]되었습니다."
예시
"상품이 등록되었습니다."
"주문이 취소되었습니다."
"쿠폰이 적용되었습니다."
오류 메시지
무엇이 잘못되었는지, 어떻게 해결할지 명시한다.
형식: "[문제] [해결 방법]"
예시
"이메일 형식이 올바르지 않습니다. 다시 확인해 주세요."
"재고가 부족합니다. 수량을 줄여주세요."
"쿠폰 사용 기한이 만료되었습니다."
"오류가 발생했습니다"처럼 애매한 메시지는 피한다.
경고 메시지
중요한 액션 전 확인을 요청한다.
형식: "[액션] 하시겠습니까? [결과]"
예시
"상품을 삭제하시겠습니까? 삭제 후 복구할 수 없습니다."
"주문을 취소하시겠습니까? 환불은 3~5 영업일이 소요됩니다."
용어 관리 방법
용어 가이드는 엑셀이나 구글 스프레드시트에 표로 정리해 팀 전체가 접근할 수 있도록 한다.
관리 항목
용어(한글·영문)
정의
FO 라벨
BO 라벨
사용 화면 목록
비고
용어가 추가·변경되면 표를 업데이트하고, 메신저로 공지한다. 특히 화면 설계 중 "이 용어가 맞나?"는 질문이 나오면, 가이드를 먼저 확인하도록 습관화한다.
용어 정리는 중요하지만, 잘 이행되지 않는 면이 있다. 프로젝트 처음에는 잘 정리되지만, 진행되면서 흐지부지 끝나는 경우가 많다.
용어가 정리되지 않으면 회의나 메일로 대화를 주고받을 때 혼란이 생길 수밖에 없다. 같은 것을 이야기하는데, 다른 용어로 사용하면 다른 이야기를 하는 것으로 대부분 오해를 한다. 그 오해를 바탕으로 개발이 진행되면 더 큰 문제가 발생한다.
용어 정리는 귀찮은 작업이지만, 언어를 통일하기 위해서는 반드시 필요한 작업이다.
