용어 정의 (Glossary)
냠냠픽업 모든 문서·UI·코드·CS 응대에서 사용하는 표준 용어를 정의합니다. 새 문서를 작성하거나 기존 문서를 수정할 때 이 사전과 일치시켜 주세요.
1. 핵심 엔티티
| 한국어 (표준) | English (표준) | 정의 | 사용 안 함 ❌ |
|---|---|---|---|
| 매장 | Store | 냠냠픽업에 입점하여 음식을 판매하는 사업장. 사장님이 운영하는 단위. | 가게, 음식점, 식당, 점포, restaurant |
| 사장님 | Merchant (코드: merchant) | B2B 단일 주체. 매장을 운영하는 개별 입점 사업자 (개인·소규모 운영자). 사장님 앱(Store App) 의 사용자. 영문 표기는 쿠팡이츠와 동일한 Merchant 로 통일. | 점주, 점장, 입점주, Owner |
| 파트너스 | Partners (코드: partners) | B2B 상위 개념. 사장님(Merchant) 을 포함해 법인·체인 본사·기업 등 냠냠픽업과 사업적으로 협력하는 모든 주체를 포괄. 사장님 입점 랜딩 페이지(partners.yumyum.im) 의 정식 명칭. | — |
| 사용자 | User (코드/문서) / Customer (마케팅 맥락) | B2C 사용자. 음식을 주문하고 픽업하는 일반 소비자. 사용자 앱(User App) 의 사용자. | 손님, 구매자, 회원 (1차 표기로 사용 자제) |
| 냠냠픽업 | YumYum Pickup | 서비스 정식 명칭. 약식 표기는 "냠냠" / "YumYum". | 냠냠픽업서비스, YumYum App |
| 사장님 앱 | Store App (브랜드: 냠냠픽업 스토어 / YumYum Store) | 사장님(Merchant)이 매장(Store)을 운영·관리하기 위해 사용하는 앱. 매장 관리 앱 이라는 핵심 가치 기준으로 Store 채택 — 쿠팡이츠 스토어와 동일 패턴. | Merchant App |
| 사용자 앱 | User App (브랜드: 냠냠픽업 / YumYum) | 사용자(User)가 음식을 검색·주문·픽업하기 위해 사용하는 앱. 서비스 메인 앱이며 별도 브랜드명 없이 "냠냠픽업"으로 노출. | Customer App |
💡 "매장" 으로 통일하는 이유: 사장님 앱 / 매장 상세 / 매장 운영 상태 등 UI에서 이미 "매장" 표기를 사용 중이며, 외래어를 한국어로 옮길 때 상점·매장이 가장 중립적입니다.
1-1. 서비스 코드명 (Service Code Names)
문서·Figma·코드 레포·빌드 산출물에서 동일하게 사용하는 코드명. 결정 배경은 ADR-0008 (현행) 참조.
8개 서비스 (20-product/ flat .md)
| # | 코드명 (라벨) | 파일명 | 한국어 | 도메인 / 플랫폼 | 디자인 |
|---|---|---|---|---|---|
| 1 | User | 10-user-app.md | 냠냠픽업 App | iOS / Android | B2C |
| 2 | Store-Portal | 20-store-portal.md | 사장님 운영 포털 | store.yumyum.im | B2B |
| 2-1 | Store-App | 21-store-app.md | 냠냠픽업 스토어앱 | iOS / Android | B2B |
| 2-2 | Store-POS | 22-store-pos.md | 냠냠픽업 POS | Windows | B2B |
| 3 | Marketing-Home | 30-marketing-home.md | 메인 마케팅 사이트 | www.yumyum.im | B2C |
| 3-1 | Marketing-Partners | 31-marketing-partners.md | 사장님 입점 마케팅 | partners.yumyum.im | B2C |
| 3-2 | Marketing-Company | 32-marketing-company.md | 회사 / 채용 / 브랜드 | www.yumyum.im/company 등 | B2C |
| 4 | Admin | 40-admin.md | 운영 어드민 | admin.yumyum.im | B2B |
그루핑:
1x고객 /2x사장님 운영 (Portal·App·POS) /3x마케팅 (Home·Partners·Company) /4x내부 디자인:B2C= YumYum v2 (warm yellow#FFCC33) /B2B= Binance + Wanted (cool yellow#FCD535) — ADR-0008
사용 규약
- 파일명: kebab-case + NN- 숫자 prefix (예:
10-user-app.md) — 정렬·매칭용 - 폴더 구조: 카테고리(
20-product/) 안에서는 flat .md sibling (sub-folder 금지) — ADR-0008 - 라벨 (코드명, 문서·문장 표기): PascalCase 또는
Foo-Bar, prefix 없음 (예:User,Store-Portal) - NN- 숫자는 정렬 안정 + 추후 삽입 여유 (11, 25 등). 라벨에는 노출하지 않는다.
- 한국어 명칭은 마케팅·UI 노출용 (예: "냠냠픽업", "냠냠픽업 스토어")
2. 거래·주문 관련
| 한국어 | English | 정의 |
|---|---|---|
| 주문 | Order | 사용자가 매장에 발생시킨 결제 완료된 거래 단위. |
| 카트 | Cart | 결제 전 임시 주문 상태. 단일 매장 카트 정책 — 한 번에 한 매장의 메뉴만 담을 수 있음. |
| 결제 | Checkout (과정) / Payment (수단/결과) | 카트의 주문을 확정하고 금액을 지불하는 절차. |
| 메뉴 | Menu Item | 매장이 판매하는 단위 상품. 전체 메뉴 = Menu, 단일 항목 = Menu Item |
| 픽업 | Pickup | 사용자가 매장에 직접 방문하여 음식을 수령하는 방식. 냠냠픽업 유일 fulfillment. |
| 노쇼 | No-show | 픽업 예정 시각이 지나도 사용자가 수령하지 않은 주문. |
| 포장 | Takeout | 픽업 후 외부에서 섭취하는 형태. |
| 매장식사 | Dine-in | 픽업 후 매장 내 좌석에서 섭취하는 형태. |
3. 매장 운영 상태
| 한국어 | English (코드) | UI 표기 |
|---|---|---|
| 영업중 | open | "Open now" |
| 영업준비중 | preparing | "Opening time" + 시각 |
| 주문폭주 (일시중지) | busy | "Receive orders at" + 시각 |
| 마감 | closed | "Closed" |
4. 정산·수수료
매장이 부담하는 수수료는 두 항목으로 분리되어 각각 고정 비율로 청구됩니다. 자세한 결정 배경은 ADR-0001 — 수수료 정책 참조.
| 한국어 | English | 정의 | 비율 |
|---|---|---|---|
| 수수료 (총칭) | Fees | 매장이 부담하는 수수료의 총칭. 아래 두 항목의 합. | 합계 5.5% |
| 중개수수료 | Commission Fee | 냠냠픽업 플랫폼 이용에 따른 수수료. | 2% 고정 |
| PG 결제대행수수료 | PG Payment Processing Fee | 카드/간편결제 처리 인프라 이용에 따른 수수료. | 3.5% 고정 |
| 정산 | Settlement | 매장 매출에서 수수료를 차감하고 사장님에게 지급하는 절차. | — |
| 정산일 | Settlement Date | 정산금이 사장님 계좌로 입금되는 일자. | — |
⚠️ 표기 원칙: 마케팅 자료에는 "중개수수료 2%"를 강조 표기하되, 사장님 입점 가이드/정산 명세서/약관에는 두 항목을 분리하여 투명하게 표시합니다.
5. 사용자 행동·UI
| 한국어 | English |
|---|---|
| 즐겨찾기 | Favorites |
| 카테고리 | Category |
| 위치 기반 검색 | Location-based search |
| 알림 | Notification |
| 영업 상태 배지 | Status Badge |
6. 사용 금지 / 회피 용어
서비스 정체성에 맞지 않거나 표준 용어와 충돌하는 표현입니다.
| ❌ 금지 / 회피 | ✅ 대신 사용 | 이유 |
|---|---|---|
| 배달, 배송 | 픽업 | 냠냠픽업은 배달 서비스가 아닙니다 |
| 라이더, 배달원 | (해당 없음) | 배달 인력이 없습니다 |
| 가게, 음식점, 식당 | 매장 | 표준 용어 통일 |
| 점주, 점장 | 사장님 | 친근감 있는 호칭 통일 |
| Restaurant | Store | 영문 표준 용어 |
| Owner | Merchant | 영문 표준 용어 — 쿠팡이츠와 동일 표기 |
| Merchant App | Store App | 사장님 앱 영문은 Store App — 매장 관리 를 핵심 기능으로 보는 객체 기준 명칭 (쿠팡이츠 스토어와 동일 패턴) |
| 손님 (1차 표기) | 사용자 | "손님 후기" 같은 일부 마케팅 표현은 허용, 1차 식별자는 "사용자" |
7. 적용 가이드
- 신규 문서 작성: 본 문서를 참조하여 표준 용어 사용
- 기존 문서 수정: 수정하는 김에 비표준 용어는 표준 용어로 함께 교체
- UI 텍스트: 본 문서의 한국어 표준 용어를 그대로 사용
- 코드 (변수명/타입명/API 경로): 본 문서의 English 표기 사용 (예:
Store,storeId,/api/stores) - 마케팅 카피: 일부 컨텍스트에서 "Customer" 등 부드러운 표현 가능
- B2B 표기 구분:
- 개별 사업자 한 명/한 매장 을 가리킬 땐 →
Merchant(사장님) - 사장님 + 법인/체인까지 묶은 상위 개념 을 가리킬 땐 →
Partners(파트너스) - 도메인 / 랜딩 페이지 / 영업·제휴 공식 명칭은
Partners
- 개별 사업자 한 명/한 매장 을 가리킬 땐 →
8. 변경 이력
용어 변경은 의사결정 로그(ADR) 에 기록합니다. 본 문서를 수정하는 PR은 영향받는 다른 문서까지 함께 정리해 주세요.
누락된 용어가 있거나 표준이 모호한 경우, 의사결정 로그 에 ADR을 작성하여 결정 후 본 문서에 반영합니다.