기능 명세서 v0.3·2026.10.15 후보자 배포본 기준·채용 평가자용

CARTIFY 플랫폼 아키텍처

한국 브랜드가 셀러센터에 상품을 등록하고 CARTIFY 한국 창고로 보내면, 입고 승인 즉시 싱가포르·필리핀·말레이시아·베트남에서 동시에 판매가 시작되는 크로스보더 마켓플레이스입니다. 계약은 위탁이고 국가별 판매가는 브랜드가 정합니다. CARTIFY는 보관·판매·결제·포장·건별 특송·수출신고·정산을 맡습니다. 아래 구조는 명세서 v0.3의 기능을 도메인 모듈로 묶어 재구성한 것입니다.

Buyer Seller Center Admin 명세에 기능 ID가 없는 영역 (REC 보완 제안) C1 스프린트 1 카드 번호
명세서는 “DB 테이블 정의나 기술 구현 방식을 강제하지 않는다”고 밝히고 있습니다. 도메인 모듈 분할과 모듈 간 의존 관계는 명세의 관련 기능, 대표 처리 흐름, 공통 데이터 절을 근거로 정리한 해석입니다. 후보자가 다른 분할을 제시해도, 아래 의존 관계와 경계 규칙을 지키는지가 평가의 핵심입니다.
1 · Layered architecture

계층별 전체 구조

세 사용자 앱이 하나의 도메인 계층을 공유합니다. 도메인 모듈을 누르면 오른쪽에 포함된 기능, 업무 규칙, 미결정 항목이 열리고, 이 모듈에 데이터를 주는 모듈과 받는 모듈이 함께 표시됩니다.

사용자 앱메뉴·화면 수는 미확정
Buyer 웹

4개국 · 국가별 통화 · 브랜드 몰(왼쪽 브랜드 스토리 + 오른쪽 상품) · 통합 장바구니·결제 · 주문 조회

Seller Center

상품 등록 · Inventory·입고 신청 · Pricing & Profit · AI 광고 센터 · AI 브랜드 스토리·진열 · 수익·정산

Admin 콘솔

자사 광고 · 상품 발굴 · 입고·계측·잔여기한 검사 · 주문·포장·송장·출고 스캔 · 운임 · 수출신고 · 판매 통제 · 브랜드 스토리 검수·대리 작성 · 정산

공통 플랫폼모든 모듈이 사용하는 횡단 기능
역할·권한 체계REC-COM-001 · C0 변경·승인 감사로그REC-COM-002 알림·이벤트 허브REC-SYS-001 국가별 통화·언어·정책 버전REC-SYS-002 환율·수수료 스냅샷REC-PRC-001
도메인 모듈13개 · 클릭해서 상세 보기
AI 엔진초안·추천만 만들고 결정은 사람이 함
브랜드 스토리 생성·평가SEL-BRD-002·003 광고 전략·소재·최적화ADS (자사·셀러 공유) HS Code 후보·근거SEL-INV-007 Opportunity ScoreSCT-005·006 AI 가격 추천 (향후)PRC-009·010
외부 연동약관·API 범위 확인 후 확정
Meta · Google AdsTikTok 후보 특송사 운임표국가별 · 건별 발송 물류사·포워더출고 인계 · 스캔 주체 협의 전 uTradeHub파일 → 향후 API 외부 쇼핑·SNS·도매 채널발굴 소스 PG 결제REC-BUY-003 은행 송금·대사REC-SET-001 운송장·배송추적REC-LOG-002

스프린트 1 카드 5장과 모듈

모듈 카드의 C1 같은 배지가 이 표의 카드 번호입니다. 카드는 모두 같은 목 데이터로 독립 실행되게 설계되어 있습니다.

2 · Single source of truth

국가별 판매가능 판정이 시스템의 중심입니다

v0.3에서는 셀러가 국가별 판매가를 입력한 국가가 기본 ON이고, 입고가 승인되는 순간 판매가 시작됩니다. 그래서 “지금 이 나라에서 팔 수 있는가”를 한 곳에서 판정해야 합니다. Buyer 노출, 장바구니, 광고 집행이 모두 같은 결과를 참조해야 하며, 명세서가 가장 여러 번 강조하는 규칙입니다.

Seller해당 국가 판매가 입력 SEL-PRD-005
Admin출고 잔여기한을 채운 가용 재고 ADM-INV-005 · ADM-ORD-009
Admin국가별 금지·제한 품목 아님 ADM-PRD-001·003
Admin운영자 판매 제한 없음 ADM-PRD-001
Seller셀러가 판매를 중지하지 않음 SEL-INV-011 · SEL-PRD-008
ALL TRUE 국가별 실제 판매 가능 Country Saleability 통합 판정 API · REC-PRD-002
Buyer국가별 상품 노출 · 장바구니 담기 · 주문 가능 여부
Seller셀러센터에 국가별 판매 상태와 불가 사유 표시 SEL-PRD-009
1단계광고 후보 SKU 필터링 SEL-ADS-009
2단계캠페인 게시·재개 직전 재검증 SEL-ADS-010
3단계운영 중 감시 → 해당 SKU 광고 자동 일시중지 SEL-ADS-011
System중지 실패·동기화 지연 로그와 재시도 REC-ADS-001

판정 조건은 명세서 04장 흐름 B입니다. 국가별 금지 품목 목록과 근거, 재고 0일 때 노출 정책, 판매 중지 사유 코드는 미결정입니다. 운영 상태 모니터링 화면은 ADM-PRD-002입니다.

3 · End-to-end flows

핵심 사용자 흐름

모듈 경계를 넘나드는 다섯 가지 흐름입니다. 각 단계 아래 회색 태그는 그 단계를 담당하는 도메인 모듈입니다.

A. 상품 등록 → 입고 → 국가별 판매 시작

C. 판매가 → 예상 정산금 → 실제 정산

Pricing & Profit의 시뮬레이션 산식. 판매가는 브랜드가 국가별 현지 통화로 정하고, 수수료 외 항목의 부담 주체는 미정입니다.

브랜드 판매가−예상 운임 기여액−CARTIFY 수수료−결제비용−예상 세금=예상 정산금
예상 정산금−상품 원가 (LOT)−광고비 등 (별도 표시)=예상 이익

값이 두 갈래로 나뉩니다

추정값 (Pricing · 수익 대시보드)
확정값 (정산 원장)
상품별 예상 운임 기여분 ADM-SHP-002
Checkout 합배송 실제 배송비 BUY-CHK-001
예상 정산금·예상 이익
구매확정 후 지급 정산금 ADM-SET-003
광고비 주문별 귀속 (모형값)
광고 플랫폼 보고 전환 ≠ 실주문 집계

판매 발생 시 상품·국가·판매가·환율·비용 기준을 그 시점 버전으로 저장(스냅샷)하고, 취소·반환·비용 수정은 덮어쓰지 않고 조정 이력으로 남기는 것이 권장안입니다.

B. 자사 광고와 셀러 광고의 분리

AI 엔진은 공유하지만 계정·예산·권한·성과는 분리합니다. 같은 Closed-loop 구조가 두 주체로 존재합니다.

입력→AI 전략→AI 소재→Meta·Google 집행→성과 수집→AI 최적화↺
자사 광고 (Admin · ADM-ADS)
셀러 광고 (Seller · SEL-ADS)
CARTIFY 인지도·가입 획득
셀러 상품 판매·수익
랜딩: 홈·기획전·카테고리
판매가능 SKU만 후보
KPI: 가입·CAC·GMV
KPI: 전환·매출·수익
예산: CARTIFY 부담
예산: 해당 셀러 부담

미결정: 광고 계정 연결 주체, 광고비 결제·청구 구조, AI 자동 집행·예산 증액 한도, 어트리뷰션 정의.

D. 발굴 → 브랜드 스토리 → 구매

AI 상품 발굴 · Admin투자 판단

외부 채널 후보 수집 → Opportunity Score와 근거 → 운영자가 BUY / TEST / WATCH / PASS 결정

브랜드 스토리 · Seller + AI스토리 생성

셀러가 컨셉 컬러·테마·이미지·문구를 넣으면 AI가 매거진 화보처럼 연출한 스토리를 여러 안으로 만듦. 셀러가 고르고 다듬음

검수 · Admin공개 승인

효능 표현·사용권·완성도를 확인해 공개. 직접 하기 어려운 브랜드는 대신 만듦. 컴포넌트 라이브러리와 가드레일 관리

Buyer구매

왼쪽 스토리를 스크롤하며 읽고, 오른쪽에서 그 나라에서 판매 가능한 상품을 골라 공통 장바구니로 결제

실판매·광고·마진 결과는 다시 발굴 모듈로 돌아와 평가 로직을 개선합니다 (ADM-SCT-009).

E. 출고: 포장 → 송장 → 출고 스캔 → 수출신고 → 건별 특송 v0.3 신규

결제 완료→FIFO 대기열 · FEFO LOT 할당→송장 100장 일괄 출력→출고 스캔 (담당 주체 협의 전)→수출신고 데이터·HS 검증→국가별 특송→구매확정 → 정산 대기

관련 기능: ADM-ORD-001~009 · ADM-EXP-001~006. 출고 스캔은 CARTIFY 작업자와 물류 파트너 중 누가 할지 정해지지 않아 역할 중립 기능(설계 제안)으로 두었습니다. 외부 인력이 맡으면 구매자 정보를 가립니다.

4 · State machines

주요 엔터티의 상태 전이

실선은 명세에서 확정 방향으로 등록된 상태, 점선은 설계 제안, 주황은 예외 분기입니다. 상태 이름은 명세 표현을 그대로 썼고, 일부 중간 상태는 흐름 설명에서 도출했습니다.

상품 등록 v0.3 신규

SEL-PRD-008
임시저장→판매대기 (입고 전)→판매중 (입고 승인 즉시)→품절 · 판매중지
↳금지 품목 국가·판매가 미입력 국가 → 해당 국가만 판매 불가·운영자 검수 (사전/사후 미정)

판매 상태는 국가마다 따로 계산됩니다. 셀러 신고 중량·규격은 입고 후 CARTIFY Verified 값으로 대체됩니다.

입고 신청

SEL-INV · ADM-INV
신청→발송 (송장 / 직접입고 예정일)→수령·수량 대조→LOT 잔여기한 검사→계측 · CARTIFY Verified→입고 승인 → 판매 시작
↳수량 차이·파손·입고 최소 잔여기한 미달 → 보류·분할·초과 입고 (미정)

승인일이 입고일로 자동 기록되고 LOT·재고·원가 입력 영역이 열립니다. 물리적 도착일은 별도 개념입니다.

주문 포장·출고

ADM-ORD
접수순 정렬 (FIFO)→포장 대기→포장 중→포장 완료→송장 출력→출고 스캔 → 물류사 인계
↳재고 부족·출고 잔여기한 미달·주문정보 오류 → 예외 분리, 다음 주문 진행

포장 FIFO는 작업 순서이고, 어떤 LOT를 내보낼지는 FEFO(유통기한 빠른 순)입니다. 둘 다 원가 계산의 선입선출과 다릅니다. 발송 기한(결제 후 기한) 초과 여부도 함께 봅니다.

출고 스캔 설계 제안

ADM-ORD-007·008
인계 대상 확정→송장 바코드 스캔→출고완료 → 수출신고 대상
↳중복 스캔 · 미등록 송장 · 취소 주문 → 경고·기록

스캔 담당 주체(CARTIFY 작업자 / 물류 파트너)는 협의 전이라 역할에 묶지 않았습니다. 인계 마감과 이월 처리도 미결정입니다.

정산

ADM-SET · SEL-SET
정산 대기 (구매확정 전)→정산 중 (대상 확정·송금 처리)→정산 완료 (실송금 확인)
↳취소·반환·비용 정정 → 조정 이력

구매확정 이벤트 정의, 정산 주기, 분쟁·보류 기간은 미결정입니다.

브랜드 스토리 신규

SEL-BRD-001~005 · ADM-BRD-002
소재 입력→AI 생성 (여러 안)→AI 평가·자동 검사→셀러 편집·부분 재생성→검수 제출→운영자 승인 → 공개
↳반려 (사유 기록) → 수정·공개 후 수정 → 새 버전 검수

스토리가 공개되기 전에 브랜드 몰을 비공개로 둘지, 상품 판매는 계속할지는 미결정입니다. 운영자가 대신 만드는 경우(ADM-BRD-005)도 같은 상태를 거칩니다.

발굴 후보

ADM-SCT
후보 수집→분석·평가→Opportunity Score + 근거→BUY · TEST · WATCH · PASS
↳WATCH → 지표 모니터링·실성과로 예측 재평가

점수 가중치는 임의로 확정하지 않고, 관측값과 추정값을 구분해 표시합니다.

수출신고

ADM-EXP
대상 주문 조회→신고 데이터 생성→HS·금액·수량 검증→신고 파일 생성 (uTradeHub)→신고번호·결과 연결

HS 추천은 법적 확정 분류가 아닙니다. 신고인·수출자 법적 명의는 미결정이며, 직접 API 연동은 향후 확장(EXP-007)입니다.

셀러 광고 캠페인

SEL-ADS
생성→게시 전 판매상태 검증→집행 중→판매불가 감지 → 자동 일시중지→재개 전 재검증

다품목 캠페인은 가능한 최소 광고 단위(SKU)만 중지합니다. 정지 가능 단위는 광고 플랫폼 API마다 다릅니다.

브랜드 몰 노출

ADM-BRD-001·004 · SEL-BRD-006
비공개→브랜드 스토리 승인→공개 (왼쪽 스토리 + 오른쪽 판매 가능 상품)
↳노출 제한

PC는 왼쪽 스토리 열이 스크롤되고 오른쪽 상품 열이 고정됩니다. 브랜드별 결제·장바구니는 만들지 않습니다.

5 · Shared data

공통 데이터와 소유 모듈

명세서 v0.3 06장의 13개 개념 엔터티입니다. 소유 모듈은 데이터를 쓰는 단일 주체, 참조 모듈은 읽기만 하는 쪽으로 정리했습니다. 여러 모듈이 같은 엔터티를 쓰기 시작하면 정합성이 무너지는 지점입니다.

6 · Gaps & open policies

결정된 정책, 명세의 공백, 미결정 정책

명세서 07장 기준입니다. 거래 구조와 판매 방식은 결정됐지만, Buyer의 기본 거래 기능(회원·검색·결제·주문조회·CS)은 여전히 기능 ID 없이 보완 제안으로 남아 있습니다. 과제 수행자가 이 부분을 어떻게 다루는지가 판단력의 차이를 보여줍니다.

결정된 정책 (2026.10.15)

보완 제안 (REC) · 건

미결정 정책 · 건

과제에서는 합리적으로 가정하고, 가정한 내용을 기록하도록 안내했습니다.

7 · What to look for

평가 시 확인할 설계 판단 포인트

명세서 곳곳의 “업무 규칙·설계 보완” 항목에서 반복되는 원칙을 추렸습니다. 좋은 결과물은 화면 수보다 이 경계들을 코드와 데이터 구조로 지켜 냅니다.

8 · Function catalog

기능 카탈로그 전체

명세서에 등록된 기능 전체입니다. 역할·상태·검색어로 걸러 볼 수 있습니다.