🗂️ E-Commerce 앱을 위한 확장 가능한 카테고리 시스템 설계

Source: Dev.to

e‑commerce 애플리케이션을 구축할 때, 카테고리는 처음에 간단해 보입니다 — 제품 수가 증가하고 비즈니스에서 다음을 요구할 때까지:

• 하위 카테고리
• 중첩 메뉴
• 브레드크럼
• SEO‑친화적인 URL
• 손쉬운 재정렬

이 README는 실제 시스템에서 사용되는 확장 가능하고 프로덕션‑준비된 카테고리 설계를 과도한 엔지니어링 없이 설명합니다.

일반적인 실수

Many apps start with separate tables:

categories
sub_categories
sub_sub_categories

This breaks immediately when:

• you need more depth → 더 깊은 계층이 필요할 때
• the hierarchy changes → 계층 구조가 변경될 때
• queries become complex → 쿼리가 복잡해질 때

확장 가능한 솔루션 (단일 카테고리 테이블)

하나의 테이블을 사용하고 자체 참조를 설정합니다.

CREATE TABLE categories (
    id          UUID PRIMARY KEY,          -- or BIGINT
    name        VARCHAR(255) NOT NULL,
    slug        VARCHAR(255) UNIQUE NOT NULL,
    parent_id   UUID REFERENCES categories(id),
    level       INT NOT NULL,
    path        VARCHAR(500) NOT NULL,
    sort_order  INT DEFAULT 0,
    is_active   BOOLEAN DEFAULT TRUE,
    created_at  TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at  TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

이 구조는 무제한 중첩을 지원하며 쿼리가 깔끔합니다.

계층 구조 작동 방식

예시 구조

Electronics
 └── Mobiles
      ├── Smartphones
      └── Feature Phones

저장된 데이터

Source: …

필드 세부 설명 (중요 부분)

1️⃣ slug – URL‑친화적인 식별자

슬러그는 URL에 사용되는 읽기 쉬운 문자열입니다.

"Smart Phones" → "smart-phones"

사용 예:

/category/electronics/mobiles/smartphones

슬러그가 중요한 이유

• SEO 친화적
• 안정적인 URL
• ID 노출 방지

2️⃣ level – 카테고리 깊이

level은 카테고리가 얼마나 깊은지 나타냅니다.

level 0 = 최상위 카테고리
level 1 = 하위 카테고리
level 2 = 하위‑하위 카테고리

존재 이유

• 홈페이지에 최상위 카테고리만 표시
• 최대 깊이 제한
• 간단한 필터링

쿼리 예시

SELECT * FROM categories WHERE level = 0;

3️⃣ path – 전체 계층 구조 (Materialized Path)

path는 루트 → 현재 노드까지의 전체 계보를 저장합니다.

Electronics → Mobiles → Smartphones
path = "1/2/3"

강력한 이유

• 재귀 없이 전체 서브트리 조회 가능
• 브레드크럼을 쉽게 생성
• SEO URL 생성에 활용

쿼리 예시

SELECT * FROM categories WHERE path LIKE '1/2/%';

4️⃣ sort_order – 표시 순서 제어 (계층 구조와 무관)

sort_order는 UI에서 카테고리가 표시되는 순서를 제어합니다.

• 없을 경우 → 예측 불가능한 순서
• 있을 경우 → 비즈니스가 정의한 순서

쿼리 예시

SELECT * FROM categories ORDER BY sort_order ASC;

사용 용도

• 네비게이션 바 순서 지정
• 주요 카테고리 강조
• 시즌별 재배열

왜 level + path를 함께 사용하나요?

그들은 중복이 아니라 서로 다른 문제를 해결합니다.

제품 연관성

제품은 일반적으로 leaf category에 속합니다.

CREATE TABLE products (
    id          UUID PRIMARY KEY,
    name        VARCHAR(255) NOT NULL,
    slug        VARCHAR(255) UNIQUE NOT NULL,
    price       NUMERIC(10,2) NOT NULL,
    category_id UUID REFERENCES categories(id)
);

최종 권장 사항

• ✅ 단일 categories 테이블
• ✅ 구조를 위한 parent_id
• ✅ 깊이 로직을 위한 level
• ✅ 빠른 조회를 위한 path
• ✅ 깔끔한 URL을 위한 slug
• ✅ UI 제어를 위한 sort_order

이 설계는 스타트업 MVP에서 대규모 마켓플레이스로 스키마 변경 없이 확장됩니다.

인터뷰 한 줄 요약

확장 가능한 카테고리 시스템은 무한 깊이를 지원하고, 빠른 읽기, 깔끔한 URL, UI‑제어 정렬을 위해 자체 참조 테이블과 물리화된 경로를 사용합니다.