이 문서 읽는 법
낯선 메뉴를 만났을 때 아래 세 갈래로 시작하세요. 위 검색창은 메뉴·기능·상태·코드를 한 번에 걸러줍니다. / 키로 검색으로 바로 이동합니다.
11개 메뉴로 이동
주문·결제·상품·회원 등 메뉴마다 화면·기능·관계도·주의점이 통째로 정리돼 있습니다.
상태 사전
주문·결제·배송·회수가 지금 어느 단계인지, 다음에 뭐가 오는지 흐름과 표로 봅니다.
마스터 코드 용어집
화면 뒤에서 분류를 정하는 코드값의 뜻을 사전에서 바로 찾습니다.
메뉴 지도 보는 법
각 메뉴(도메인) 페이지는 항상 같은 4단 구성입니다. 순서대로 읽으면 "이 메뉴엔 뭐가 있고, 어떻게 얽혀 있고, 뭘 조심해야 하는지"가 잡힙니다.
| 구성 | 무엇을 알려주나 | QA/기획이 얻는 것 |
|---|---|---|
| ① 화면·기능 | 그 메뉴 안에 있는 화면과 각 화면이 하는 일 | "어떤 버튼·기능을 테스트해야 하나" |
| ② 관계도 | 이 메뉴의 데이터가 어디서 오고 어디로 이어지는지(엔티티 관계) | "이걸 바꾸면 무엇이 영향받나" |
| ③ 상태·코드 | 화면에서 마주치는 상태값·분류 코드 | "이 상태에서 다음에 뭐가 와야 정상인가" |
| ④ QA 체크포인트 | 실제로 자주 헷갈리거나 깨지기 쉬운 지점 | "어디를 집중적으로 봐야 하나" |
관계도의 상자는 각 메뉴가 다루는 핵심 데이터 개념이고, 화살표는 개념 사이의 관계입니다. 상자 이름은 넘기고 화살표가 가리키는 관계 문장만 읽어도 됩니다.
핵심 정책 결정
개별 메뉴를 보기 전에 알아두면 좋은 '전체를 관통하는 기준'입니다. 예외 상황을 판단할 때 근거가 됩니다.
11개 메뉴(도메인)
플랫폼 전체를 업무 기능으로 나눈 최상위 지도입니다. 아래 칩을 눌러 바로 이동하세요.
주문 관리
사장님이 장바구니에 담은 상품이 '주문'이 되어, 준비·보관·배송·완료까지 흐르는 과정을 관리하는 메뉴. 이 플랫폼의 심장이며, 결제·정산·물류·CS가 전부 여기서 뻗어 나갑니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 주문 목록 | 기간·상태·센터·결제수단으로 주문 검색 | 필터 조합 결과가 정확한가, 페이징 |
| 주문 상세 | 한 주문의 상품 라인·금액·배송·결제 확인 | 라인별 상태·수량·금액 합이 맞는가 |
| 주문 상태 변경 | 라인 상태를 준비→보관→배송→완료로 이동 | 허용되지 않는 역방향 전이 차단 |
| 부분 취소 | 주문 안 특정 상품·수량만 취소 | 취소 수량이 주문 수량을 넘지 않는가 |
| 임의주문 | 운영이 수기로 주문 생성(보상·샘플 등) | 임의주문이 정산에 올바른 유형으로 잡히는가 |
| 주문 상태 이력 | 상태가 언제·누가 바꿨는지 로그 | 모든 상태 변경이 빠짐없이 남는가 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 주문 헤더엔 '전체 상태'가 없다. 목록에서 보이는 주문 상태는 라인들을 합쳐 계산한 것 — 라인마다 상태가 다른 주문에서 표시가 맞는지 확인.
- 부분 취소 시 취소 수량 > 주문 수량이 되지 않는지, 취소 후 금액·정산이 함께 조정되는지.
- 가상계좌 주문은 입금 전까지 VIRTUAL_WAIT — 미입금 만료 처리 흐름을 함께 볼 것(결제 메뉴 참고).
결제
주문 금액을 실제로 받는 과정. 카드·간편결제·예치금·가상계좌를 여러 PG(이니시스·나이스·KCP)로 처리하고, 각 결제·취소를 기록으로 남깁니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 결제 내역 | 주문별 결제·취소 기록 조회 | 결제 금액이 주문 금액과 일치하는가 |
| 가상계좌 | 입금 대기 계좌 발급·입금 확인·만료 처리 | 입금 통지 후 상태가 정상 전환되는가 |
| 정기결제(빌링키) | 등록 카드로 자동결제(KCP/나이스) | 빌링키 등록·해지·재결제 |
| 예치금 | 충전 잔액·무통장 기반 결제와 잔액 관리 | 잔액이 음수가 되지 않는가, 충전/차감 정합 |
| 결제 취소 | 전체·부분 결제 취소와 환불 | 취소가 정산(금전출납)에 반영되는가 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 가상계좌는 VIRTUAL_WAIT → 미입금 시 VIRTUAL_EXPIRY. 만료 후 재발급·주문 취소 흐름을 확인.
- 같은 주문의 결제가 여러 수단 로그에 분산되므로, 통합 화면 합계와 개별 로그 합계가 일치하는지.
- 예치금 잔액이 음수로 떨어지는 케이스(외상/여신 성격) — 의도된 것인지 담당자와 확인.
정산·금전출납
돈이 움직인 모든 사건(매출·취소·환불·비용)을 사유·책임소재와 함께 남기는 단일 원장. 파트너 정산과 세금계산서의 근거가 됩니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 금전출납부 | 모든 금액 변동을 유형·사유별로 기록·조회 | 주문/결제/취소가 빠짐없이 원장에 잡히는가 |
| 파트너 정산 | 공급사별 매입·수수료·지급액 산출 | 마진·수수료 계산이 정책과 맞는가 |
| 책임소재 관리 | 손실을 누구 귀책으로 볼지 지정 | 회수·클레임 금액의 귀책 분류 |
| 세금계산서 | 세금계산서 정보·발행 관리 | 과세/면세 구분, 발행 대상 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 주문·결제·취소가 모두 원장에 반영되는지 — 특히 임의주문·부분취소처럼 예외 경로.
- 모든 금액 변동에 사유(reason)와 책임소재(accountability)가 함께 붙는지.
- 파트너 정산의 마진·수수료가 상품/공급사 설정과 일치하는지(상품 메뉴의 가격과 교차 확인).
쿠폰·할인
고객에게 혜택을 주는 두 가지 도구 — 개별 발급되는 '쿠폰'과, 회원·업종·상품에 자동 적용되는 '할인'. 프로모션과 타겟팅을 같은 틀에서 다룹니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 쿠폰 관리 | 쿠폰 정의(할인액·사용조건·유효기간) 생성 | 발급 한도·중복 사용 규칙 |
| 그룹 발급 | 특정 조건 회원에게 일괄 발급 | 대상 선정·발급 수량이 정확한가 |
| 등급 쿠폰 | 회원 등급별 자동 지급 | 등급 변동 시 지급/회수 |
| 할인 설정 | 회원·업종·상품 스코프로 할인율 적용 | 스코프 중복 시 우선순위 |
| 순차 쿠폰 | 첫~4차 주문 유도 쿠폰 | 순서 없이 지급되는 모순 케이스 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 쿠폰 발급 한도 초과가 막히는지, 발급 카운터가 실제 발급 수와 일치하는지.
- 주문 취소 시 쿠폰이 복원되고, 사용/미사용 표시(used_at)가 함께 정확히 되돌아가는지.
- 회원·업종·상품 할인이 중복될 때 우선순위가 정책대로 적용되는지.
공급사·파트너
상품을 실제로 공급하는 파트너를 등록·관리하고, 그들의 상품·마진·정산 정보와 '발주'(주문을 공급사에 넘기는 일)를 다룹니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 공급사 관리 | 파트너 등록·유형·배송타입·최소주문금액 | 최소주문금액이 앱에 반영되는가 |
| 단가 엑셀 업로드 | 공급사 상품·단가를 엑셀로 일괄 등록 | 업로드 검증·충돌 처리 |
| 발주 | 주문을 공급사에 전달, 발주 상태 관리 | 발주 마감·상태 전이 |
| 정산 정보 | 공급사 정산 계좌·수수료 정책 | 정산 메뉴와 값이 일치하는가 |
| 프랜차이즈 | 프랜차이즈 본사·기본 공급사·마진 | 프랜차이즈 전용 마진 적용 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 공급사 최소주문금액이 앱 장바구니에 실제로 걸리는지(설정값 vs 앱 동작).
- 엑셀 업로드 시 기존 상품과의 충돌·중복이 걸러지는지.
- 공급사가 비활성/삭제돼도 과거 주문의 상품 정보(스냅샷)는 그대로 보이는지.
물류센터·배송
상품이 센터(MFC)에 입고·검수·피킹되고, 배송 코스·순번에 따라 사장님에게 배달되는 물리적 이행 과정. 배송비 정책도 여기서 관리합니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 센터·코스 관리 | MFC 센터·배송 코스·배송 순번 설정 | 회원의 센터/코스 배정 정합 |
| 입고·검수 | 공급사 상품을 센터에서 받고 확인 | 입고 이슈 등록·처리 |
| 피킹 | 주문별로 상품을 집품 | 피킹 완료가 상태에 반영되는가 |
| 배송 순번 | 코스 내 배송 순서 관리(기사용) | 순번 변경 이력 |
| 재고(MFC) | 센터 재고 잔고·예약 관리 | 예약 합이 잔고를 넘지 않는가 |
| 배송비 정책 | 무료 조건·부과·환불 규칙 | 7개 상태가 조건대로 매겨지는가 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 회원의 (센터, 코스) 배정이 마스터에 있는 조합인지 — 없는 조합이면 배송 동선이 꼬인다.
- MFC 재고에서 예약 합이 잔고를 초과하거나 음수 재고가 생기지 않는지.
- 배송비가 부과됐다가 조건 충족으로 무료 전환되는 케이스가 금액에 맞게 반영되는지.
상품
팔 물건을 정의하는 메뉴. 상품마다 고유코드가 붙고, 가격·노출·카테고리·이미지·그룹이 관리되며, 사장님의 '상품 추가 요청'도 여기서 처리됩니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 상품 관리 | 상품 등록·수정, 노출/판매 여부 | 노출 상태 조합(use/open/sold_out) |
| 가격·단가 | 공급가·판매가·마진 설정 | 판매가 계산이 정책과 맞는가 |
| 상품 그룹 | 같은 상품을 하나로 묶어 관리 | 그룹 이미지·대표 정보 |
| 품절 관리 | 일시/장기 품절 처리 | 품절이 앱 노출에서 빠지는가 |
| 상품추가요청 | 사장님 요청 접수→소싱→등록→답변 | 요청 상태 전이·미응답 |
관계도 — 데이터가 어디서 와서 어디로 가나
- '고객이 보는 가격'이 어느 값인지 명확히 — 공급가와 판매가가 다르므로, 판매가 기준이 맞는지.
- 상품 그룹·이미지가 상품명(글자)으로 연결되므로, 이름 수정 시 이미지가 사라지지 않는지.
- 품절·비노출 처리한 상품이 홈 큐레이션·장바구니에 남아 보이지 않는지.
회원
플랫폼을 쓰는 사장님(사업자) 계정. 등급·업종·사업자 정보와 결제수단·배송지를 관리하고, 가입부터 탈퇴까지의 생애주기를 다룹니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 회원 관리 | 회원 검색·상세·메모, 상태(사용/정지) | 검색 필터, 개인정보 노출 권한 |
| 등급 | LV1~LV6 등급과 등급별 혜택 | 등급 산정·변동 시 쿠폰 |
| 사업자·개인정보 | 사업자번호·대표자·연락처 등 | 필수값 검증, 마스킹 |
| 결제수단·배송지 | 등록 카드·계좌·배송 정보 | 결제 메뉴와 카드 공유 |
| 탈퇴 | 탈퇴 사유 수집·비활성화 | 사유 필수, 잔존 데이터 처리 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 탈퇴는 삭제가 아니라 비활성화 — 탈퇴 후에도 주문·정산 이력이 남고, 개인정보 파기는 별도 처리인지 확인.
- 탈퇴 시 사유 수집이 필수로 강제되는지(사유별 집계가 가능해야 함).
- 회원의 업종·등급이 홈 큐레이션·할인에 실제로 반영되는지(콘텐츠·쿠폰 메뉴와 교차).
콘텐츠·홈
앱 첫 화면에 무엇을 보여줄지 꾸미는 메뉴. 메인 콘텐츠·배너·팝업·퀵메뉴·공지와, 업종별로 다른 상품 큐레이션을 관리합니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 메인 콘텐츠 | 홈 화면 구성 블록·노출 상품 편성 | 노출 상품이 판매중인가 |
| 배너·팝업 | 홍보 배너·시작 팝업, 기간/대상 설정 | 기간·업종·센터 타겟팅 |
| 퀵메뉴 | 홈 상단 바로가기 아이콘 | 링크 정확성·정렬 |
| 공지·온보딩 | 공지사항·첫 사용 안내 | 노출 조건·순서 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 큐레이션에 편성된 상품이 품절·비노출·삭제 상태면 홈에서 빠지거나 대체되는지.
- 배너·팝업의 기간·업종·센터 타겟팅이 정확한 대상에게만 뜨는지.
- 업종별 인기상품이 최신 배치로 갱신되는지(오래된 데이터가 그대로 보이지 않는지).
고객지원
사장님의 문의·불만을 받고 처리하는 메뉴. 1:1 문의·콜/챗 이력·FAQ와, 상품 문제로 인한 입고 이슈·회수·반품·교환을 다룹니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 1:1 문의 | 문의 접수·답변·상태 관리 | 미답변 관리, 상태 전이 |
| 콜/챗 이력 | 전화·채팅 상담 기록(채널톡 연동) | 회원 연결이 정확한가 |
| FAQ | 자주 묻는 질문 관리 | 카테고리·노출 |
| 입고 이슈 | 검수 중 발견된 상품 문제 등록 | 이슈 유형·처리 |
| 회수·반품·교환 | 회수 요청→처리→책임소재→금액 조정 | 회수 상태·정산 연결 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 콜/챗 이력이 실제 회원과 연결되는지 — 채널톡 등 외부 ID가 섞여 연결이 끊긴 케이스가 많다.
- 1:1 문의 미답변 건이 상태로 잘 구분되는지(상태 컬럼 없이 답변 유무로 판정).
- 회수·반품 시 책임소재와 금액 조정이 정산(금전출납)에 정확히 반영되는지.
시스템·권한
어드민 자체를 운영하는 메뉴. 직원 계정·권한, 메뉴 노출 권한, 마스터 코드 사전, 정책, 알림톡 템플릿, 그리고 누가 무엇을 했는지 로그를 관리합니다.
화면·기능 — 이 메뉴에 있는 것
| 화면·기능 | 하는 일 | QA가 확인하는 것 |
|---|---|---|
| 계정·권한 | 어드민 계정 생성·역할·활성 관리 | 권한 없는 메뉴 접근 차단 |
| 메뉴 권한 | 역할별 메뉴 노출·기능 권한 매핑 | 역할 변경 시 즉시 반영 |
| 마스터 코드 | 분류 코드값 추가·수정·비활성 | 삭제 금지 코드 보호 |
| 알림톡 템플릿 | 카카오 알림톡 템플릿·발송 관리 | 템플릿 변수·발송 대상 |
| 액션 로그 | 어드민 조작 이력 기록 | 주요 액션이 남는가 |
관계도 — 데이터가 어디서 와서 어디로 가나
- 권한 없는 계정이 메뉴·기능에 접근하지 못하는지(역할별 노출·차단).
- 마스터 코드 삭제 금지 항목이 실제로 보호되는지(FAQ 카테고리 등).
- 주요 조작이 액션 로그에 남는지 — 감사·추적의 근거.
상태 사전
여러 메뉴에서 마주치는 상태값을 한곳에 모았습니다. 주문 흐름은 스테퍼로, 나머지는 표로.
주문 상태 흐름
VIRTUAL_WAIT 입금 대기 → 미입금 시 VIRTUAL_EXPIRY 만료.
어느 단계든 CANCEL_COMPLETE로 종결 가능. 부분 취소는 라인별 수량으로.
RETURN·EXCHANGE 계열은 상태 로그에 남는 확장 상태로, 표준 5단계와 별도 관리.
| 코드 | 업무 명칭 | 설명 |
|---|---|---|
| CARD | 신용카드 | 일반 카드 결제 |
| EASY | 간편결제 | 등록된 간편결제 수단 |
| DEPOSIT | 예치금 | 충전 잔액/무통장 기반 |
| VIRTUAL | 가상계좌 | 입금 대기 후 확정(이니시스) |
| KCP_BILLING | 정기결제 | KCP 빌링키 자동결제 |
| NICE_CARD / NICE_VIRTUAL / NICE_BILLING | 나이스페이 | 나이스 카드·가상계좌·빌링 |
| OPTIONAL | 임의주문 | 운영 수기 생성 |
| SAMPLE | 샘플 | 샘플 제공 건 |
| 코드 | 의미 | 고객 안내 포인트 |
|---|---|---|
| FREE_BY_AMOUNT | 금액 조건 무료 | 최소 주문금액 충족 |
| FREE_AFTER_AMOUNT | 사후 금액 무료 | 추가 주문으로 조건 충족 |
| ORDER_PASS | 오더패스 무료 | 구독/패스 혜택 |
| CHARGED | 부과 | 조건 미충족 |
| FREE_AFTER_CHARGED | 부과 후 무료 | 조건 충족으로 무료 전환 |
| REFUNDED | 환불 | 부과 배송비 환불 |
| NONE | 해당 없음 | 배송비 대상 아님 |
| 코드 | 단계 |
|---|---|
| RECALL_REQUIRED | 회수 필요(접수) |
| PARTNER_RECALL_REQUIRED | 파트너 회수 요청 |
| MFC_RECALL_CHECK_REQUIRED | MFC 확인 필요 |
| MFC_RECALL_CENTER_ARRIVED | 센터 도착 |
| MFC_RECALL_PICKUP_DONE | 픽업 완료 |
| RECALL_CLOSED | 회수 종결 |
마스터 코드 용어집
화면 뒤에서 분류값을 관리하는 마스터 코드 사전입니다. 코드를 클릭하면 복사됩니다. 위 검색창으로 함께 걸러집니다.
업무 흐름도
여러 메뉴를 가로지르는 대표 업무의 단계입니다. "이 일이 어느 메뉴를 거치는지"를 보여줍니다.
FLOW주문 이행(풀필먼트) — OR·SP·DV·ST
라인 상태가 PREPARE→STORAGE→DELIVERY→COMPLETE로 이동하며, 완료 후 금전출납부에 매출로 기록됩니다.
FLOW상품 추가 요청 — PD·SP·CS
상태는 PRODUCT_REQUEST_STATUS로 관리. 입고 완료 시 요청자에게 재입고 알림으로 연결할 수 있습니다.
FLOW회수·반품 처리 — CS·DV·ST
회수 상태(회수 상태)와 책임소재(CASHFLOW_RESPONSIBILITY_VALUE)가 함께 기록되어 손실 귀속이 명확해집니다.
문서 기여 가이드
이 지도는 살아있는 문서입니다. 새 화면·정책이 생기면 아래 원칙으로 추가해 주세요.
메뉴 4단 구성을 지킨다
새 기능은 화면·기능 / 관계도 / 상태·코드 / QA 체크포인트 순서로 추가합니다.
상태·코드는 사전에
새 상태값·분류값은 상태 사전과 마스터 코드 용어집에 등록해 화면마다 흩어지지 않게 합니다.
정책은 이유와 함께
중요한 결정은 정책 원장에 결정·이유·영향 세 칸으로 남깁니다.
사용자 언어로
개발 용어 대신 담당자가 화면에서 보는 이름으로 쓰고, 코드는 참고용으로 병기합니다.