1. 포인트샵 개요

DXCMS 포인트샵은 회원이 활동으로 적립한 포인트를 사용하여 뱃지•칭호•포인트 충전•기타 아이템을 구매할 수 있는 가상 상점 시스템입니다. 관리자는 [포인트샵 관리] 메뉴에서 상품을 등록•편집•비활성화하고, 구매 내역을 조회하며 필요 시 환불 처리를 수행합니다.

📌  접근 경로: 관리자 대시보드 → 포인트샵 관리 (URL: /admin/shop) 사용자 샵 페이지: /shop (사이트 프론트엔드)

1.1 포인트샵 시스템 구성

구성 요소	파일 경로	역할
관리자 화면	admin/shop/index.php	상품 등록·수정·비활성화, 구매 내역 조회, 환불 처리.
DxShop 엔진	core/DxShop.php	상품 조회·구매 처리·환불·회원 구매내역 조회·카테고리 목록 반환 등 비즈니스 로직.
구매 API	core/api/shop.php	AJAX POST 구매 요청 처리. 로그인 확인·CSRF 검증 후 DxShop::purchase() 호출.
사용자 샵 페이지	pages/shop.php	회원이 실제 상품을 보고 구매하는 프론트엔드 페이지. /shop URL.
DB 테이블: shop_items	shop_items	상품 정보 저장. id/name/description/category/type/price/stock/buy_limit/image/value/status/sort_order/created_at 컬럼.
DB 테이블: shop_purchases	shop_purchases	구매 이력 저장. id/member_id/item_id/item_name/price/status/note/created_at 컬럼.

1.2 관리자 화면 3탭 구성

탭	설명
📦 상품 리스트	등록된 모든 상품을 테이블로 표시. 수정·삭제 버튼 제공.
➕ 신규 상품 등록	새 상품을 등록하는 폼 화면. 상품 유형·가격·재고·구매 제한·이미지·가치값·상태 설정.
📋 구매/환불 이력	최근 50건의 전체 구매 내역. 구매자·상품명·결제 포인트·상태 표시. paid 상태에 환불 버튼 제공.

💡  상단 오른쪽 [사용자 샵 ↗] 버튼으로 실제 사용자 화면(/shop)을 새 탭에서 미리 볼 수 있습니다.

2. 상품 유형 (type)

포인트샵의 모든 상품은 4가지 유형 중 하나로 분류됩니다. 상품 유형은 구매 후 후처리(dx_shop_after_purchase 훅)에서 어떤 효과를 줄지를 결정하는 핵심 분류입니다.
 

유형값	표시명	주요 사용 사례	value 필드 활용 예시
badge	🏅 뱃지	프로필에 표시되는 특수 뱃지	"badge-pro", "badge-veteran" — 구매 후 훅에서 회원 프로필에 해당 뱃지 코드를 저장.
title	🎖 칭호	닉네임 옆에 표시되는 칭호 텍스트	"legendary-warrior", "golden-master" — 구매 후 훅에서 members 테이블의 title 컬럼 등에 저장.
point	💰 포인트 충전	포인트를 다시 충전하는 상품	"1000", "5000" — 구매 후 훅에서 value만큼 DxPoint::add()로 포인트를 지급.
etc	📦 기타	이모지 스티커, 전용 기능 등	"special-theme", "dark-mode-key" — 유연하게 커스텀 로직 적용.

2.1 상품 유형과 value 필드의 관계

상품 유형(type)은 카테고리 분류이며, 실제 구매 후 어떤 처리를 할지는 value 필드의 값과 dx_shop_after_purchase 훅이 결정합니다.

💡  DXCMS 기본 설치에서는 dx_shop_after_purchase 훅이 아무 동작도 하지 않습니다. 실제 효과(뱃지 지급, 칭호 저장 등)를 구현하려면 플러그인에서 이 훅을 처리하는 코드를 작성해야 합니다. value 필드는 훅 함수에서 $data["item"]["value"]로 접근할 수 있습니다.

3. 상품 등록 및 수정

[신규 상품 등록] 탭 또는 상품 목록에서 [수정] 버튼을 클릭하면 상품 등록/수정 폼이 표시됩니다. 신규와 수정 폼의 구조는 동일하며, 수정 시 기존 값이 자동으로 채워집니다.

3.1 상품 등록 폼 — 전체 필드 설명

필드명	필수 여부	설명 및 유의사항
상품 명칭 (name)	필수	사용자 샵 페이지에 표시되는 상품 이름. 미입력 시 "상품명을 입력하세요." 오류. DxSanitizer::text()로 XSS 방지.
상품 요약 설명 (description)	선택	상품 카드 하단에 표시되는 간략한 설명. 2줄 textarea. DxSanitizer::text() 처리.
상품 유형 (type)	필수	badge/title/point/etc 중 하나 선택. 드롭다운 형태. badge·title·point·etc 외 값이면 오류.
카테고리 (category)	선택	자유 텍스트 입력. 사용자 샵 필터 탭으로 자동 생성됨. 예: 한정판, 프리미엄, 시즌1. DxSanitizer::text() 처리.
판매 가격 (price)	필수	구매 시 차감될 포인트 수. 0 이상의 정수. 우측에 "P" 단위 표시. max(0, ...) 처리로 음수 불가.
재고 / 무제한 체크박스 (stock)	선택	[재고 무제한] 체크 시 stock=-1로 저장. 체크 해제 시 수량 입력. -1이면 품절 없음. 0이 되면 품절 처리. 기본값: 무제한.
1인당 구매 제한 (buy_limit)	선택	회원 1인이 구매할 수 있는 최대 횟수. 0이면 무제한. 예: 1이면 중복 구매 불가(1인 1구매 상품).
정렬 순서 (sort_order)	선택	낮을수록 상품 목록 상단에 표시. 기본값 0. 같은 sort_order이면 ID 오름차순.
상품 이미지 URL (image)	선택	상품 카드 썸네일 이미지 URL. DxSanitizer::url() 처리. 미입력 시 상품 유형별 기본 이모지 표시.
지급 데이터 값 (value)	선택	구매 후 훅(dx_shop_after_purchase)에서 사용할 식별값. 예: badge-pro, 1000. 모노스페이스 폰트 입력 창. DxSanitizer::text() 처리.
판매 상태 (status)	필수	판매중(1) 또는 숨김(0). 라디오 버튼 선택. 기본값: 판매중. 숨김 설정 시 사용자 샵에서 표시되지 않음.

3.2 등록/수정 처리 흐름

1. CSRF 토큰 검증 (dx_csrf_check())
2. _act === "save_item" 확인
3. 상품명 필수 검증 → 빈 값이면 "상품명을 입력하세요." 오류
4. type 유효성 검증 → badge/title/point/etc 외 값이면 오류
5. stock: stock_unlimited 체크 여부에 따라 -1 또는 max(0, 입력값) 처리
6. 신규(item_id=0): shop_items 테이블에 INSERT, created_at 자동 설정
7. 수정(item_id>0): shop_items 테이블에서 해당 id UPDATE
8. "상품이 등록되었습니다." 또는 "상품이 수정되었습니다." 성공 메시지
9. 자동으로 상품 목록(sub=items) 탭으로 이동

3.3 등록 절차

1. [신규 상품 등록] 탭 클릭
2. 상품 명칭 입력 (필수)
3. 상품 요약 설명 입력 (선택)
4. 상품 유형 선택: 뱃지/칭호/포인트 충전/기타
5. 카테고리 입력 (선택, 예: 한정판)
6. 판매 가격 입력 (P 단위)
7. 재고 설정: [재고 무제한] 체크 또는 수량 입력
8. 1인당 구매 제한 입력 (0=무제한)
9. 정렬 순서 입력 (낮을수록 상단)
10. 상품 이미지 URL 입력 (선택)
11. 지급 데이터 값(value) 입력 (선택, 훅에서 사용)
12. 판매 상태 선택: 판매중 또는 숨김
13. [새로운 상품 등록 완료] 버튼 클릭
14. 성공 메시지 확인 후 상품 목록에서 확인

4. 상품 목록 (상품 리스트 탭)

등록된 모든 상품이 sort_order ASC → id ASC 순으로 테이블에 표시됩니다. getItems(null, null, false)로 비활성(status=0) 상품도 포함하여 관리자에게 보여줍니다.

4.1 목록 컬럼 설명

컬럼	내용 및 설명
ID	#N 형식의 상품 고유 ID. 모노스페이스 이탤릭 회색 텍스트.
상품 정보	상품 이미지(또는 박스 아이콘) + 상품명(굵은 글씨) + 상품 유형(DxShop::typeName()으로 한글 변환). 마우스 호버 시 상품명이 초록색으로 변경.
카테고리	인디고색 pill 배지. 카테고리 미설정 시 "-" 표시.
가격	주황색 굵은 모노스페이스 숫자 + "P" 단위. 천 단위 쉼표 포함.
재고	stock=-1이면 파란색 "무제한" 배지. 그 외 숫자로 잔여 재고 표시.
구매제한	buy_limit=0이면 "제한없음". 그 외 "N회" 형식.
상태	판매중(초록 배지) / 중지됨(회색 배지). status=1이면 판매중.
관리	[수정] 하늘색 펜 아이콘: /admin/shop?sub=edit&id=N으로 이동. [삭제] 빨간 쓰레기통 아이콘: 확인 창 후 status=0으로 비활성화.

4.2 상품 삭제 처리

상품 목록에서 [삭제] 버튼을 클릭하면 "상품을 삭제(비활성) 처리하시겠습니까?" 확인 창이 표시됩니다.

⚠️  포인트샵의 상품 삭제는 DB에서 완전히 제거하지 않고 status=0으로 비활성화합니다. 이는 기존 구매 이력과의 참조 관계를 보존하기 위한 소프트 딜리트(Soft Delete) 방식입니다.

삭제 처리	UPDATE shop_items SET status=0 WHERE id=N 실행.
삭제 후	상품 목록에서 "중지됨" 상태로 표시. 사용자 샵에서는 표시되지 않음.
복구 방법	[수정] 버튼으로 편집 폼에 들어가 status를 "판매중"으로 변경 후 저장.
완전 삭제	완전 삭제가 필요하면 DB에서 직접 DELETE 쿼리를 실행해야 합니다.

5. 구매 처리 흐름 (DxShop::purchase)

사용자가 /shop 페이지에서 [구매하기] 버튼을 클릭하면 AJAX로 /api/shop에 POST 요청을 보내고, DxShop::purchase()가 다음 순서로 처리합니다.

5.1 구매 처리 단계

1. AJAX 요청 수신 (POST /api/shop, item_id 포함)
2. 로그인 확인: 비로그인이면 "로그인이 필요합니다." 오류(HTTP 401)
3. CSRF 토큰 검증 (dx_csrf_check())
4. 상품 조회: shop_items WHERE id=? AND status=1. 없으면 "존재하지 않는 상품입니다." 오류
5. 재고 확인: stock != -1 AND stock <= 0이면 "품절된 상품입니다." 오류
6. 구매 한도 확인: buy_limit > 0이면 shop_purchases에서 해당 회원의 결제완료(paid) 구매 수 조회 → 한도 초과 시 오류
7. 포인트 확인: DxPoint::getPoint(memberId) < price이면 "포인트가 부족합니다. (보유: NP, 필요: MP)" 오류
8. 포인트 차감: DxPoint::add(memberId, "purchase", -price, "shop_item", itemId, "[상품명] 구매")
9. 재고 감소: stock > 0이면 UPDATE shop_items SET stock=stock-1 WHERE id=? AND stock>0
10. 구매 기록: shop_purchases INSERT (member_id, item_id, item_name, price, status="paid", created_at)
11. 후처리 훅 실행: dx_run_hook("dx_shop_after_purchase", {member_id, item, purchase_id})
12. {"success":true, "message":"[상품명] 구매가 완료되었습니다.", "purchase_id":N} JSON 반환

5.2 구매 실패 응답

오류 메시지	원인
로그인이 필요합니다.	비로그인 상태에서 구매 시도.
존재하지 않는 상품입니다.	상품 ID가 없거나 status=0(비활성) 상품.
품절된 상품입니다.	stock=0인 상품. 재고 무제한(-1)은 해당 없음.
구매 한도를 초과했습니다.	buy_limit > 0이고 이미 해당 횟수만큼 구매한 경우.
포인트가 부족합니다.	현재 보유 포인트 < 상품 가격. 보유/필요 포인트가 메시지에 포함.

5.3 사용자 샵 구매 UX

1. /shop 페이지에서 [구매하기] 클릭 시 다음 순서로 처리됩니다.
2. "[상품명]을(를) NP에 구매할까요?" JavaScript confirm 창 표시
3. 확인 클릭 시 XMLHttpRequest로 POST /api/shop?item_id=N 전송 (CSRF 토큰 포함)
4. 성공: 상단 보유 포인트 표시가 즉시 차감 반영 → "✅ [성공 메시지]" 토스트 알림 → 1.5초 후 페이지 새로고침
5. 실패: "❌ [오류 메시지]" 토스트 알림 (하단 중앙 팝업, 3초 후 자동 소멸)

6. 구매/환불 이력 탭

[구매/환불 이력] 탭에서 최근 50건의 구매 내역을 조회하고 환불 처리합니다. DxShop::getAllPurchases(50)로 shop_purchases JOIN members 데이터를 조회합니다.

6.1 구매 이력 테이블 컬럼

컬럼	내용 및 설명
구매일시	shop_purchases.created_at. "MM.DD HH:MM:SS" 형식 표시.
구매자	members.name(굵은 글씨) + members.login_id(아래 줄 모노스페이스). LEFT JOIN으로 회원 정보 연결.
상품명	shop_purchases.item_name. 구매 시점의 상품 이름이 그대로 저장됨. 이후 상품명 변경해도 이력 보존.
결제 포인트	shop_purchases.price. 주황색 굵은 숫자 + "P". 천 단위 쉼표.
상태	"결제완료"(초록): status=paid. "환불"(회색): status=refunded. 그 외: status값 그대로 표시(주황).
관리	status=paid인 경우만 [환불 처리] 주황 버튼 표시. 이미 환불된 경우 "-" 표시.

6.2 환불 처리 상세

[환불 처리] 버튼 클릭 시 "환불 처리를 진행하시겠습니까? 지급된 아이템 회수 로직은 별도로 수행해야 할 수 있습니다." 확인 창이 표시됩니다.

6.3 환불 처리 흐름 (DxShop::refund)

1. CSRF 토큰 검증
2. shop_purchases WHERE id=? AND status="paid" 조회 → 없으면 "구매 내역을 찾을 수 없습니다." 오류
3. 포인트 환불: DxPoint::add(member_id, "refund", +price, "shop_purchase", purchaseId, "[상품명] 환불 (메모)")
4. 재고 복구: 상품의 stock >= 0이면(무제한 아니면) stock+1 증가
5. 구매 상태 업데이트: UPDATE shop_purchases SET status="refunded", note=메모 WHERE id=N
6. "환불이 완료되었습니다." 성공 메시지 표시

⚠️  환불은 포인트만 반환합니다. 뱃지•칭호 등 지급된 아이템(효과)은 자동으로 회수되지 않습니다. 아이템 회수가 필요하면 [회원 관리]에서 해당 회원의 프로필을 수동으로 수정하거나, dx_shop_after_refund 훅(미구현 시 플러그인으로 추가)을 활용해야 합니다.

7. 사용자 샵 페이지 (/shop)

사용자가 실제로 포인트로 상품을 구매하는 프론트엔드 페이지입니다. 관리자 패널의 [사용자 샵 ↗] 버튼으로 미리보기할 수 있습니다.

7.1 사용자 샵 화면 구성

영역	설명
헤더	"🛒 포인트샵" 제목과 로그인 회원의 현재 보유 포인트 표시 (💰 NP). 비로그인 시 "로그인 후 구매" 버튼.
필터 탭	"전체" + 상품 유형(뱃지/칭호/포인트/기타) + 카테고리별 필터 링크. URL 파라미터: ?type=badge, ?cat=한정판.
상품 그리드	auto-fill minmax(200px) CSS Grid. 모바일에서 2열로 자동 전환.
토스트 알림	구매 성공/실패 시 화면 하단 중앙에 3초간 표시되는 팝업 알림.

7.2 상품 카드 구성

요소	설명
이미지 영역	image URL이 있으면 80×80 이미지. 없으면 상품 유형 이모지(🏅/🎖/💰/📦) 표시.
카테고리	보라색 작은 텍스트. 없으면 미표시.
상품 유형	회색 작은 텍스트. DxShop::typeName()으로 한글 변환.
상품명·설명	굵은 상품명 + 회색 설명 텍스트.
가격·재고	주황색 가격(NP) + 우측에 재고("무제한" 또는 "N개 남음" 또는 "품절").
구매 버튼	상태별 버튼: [구매하기](파랑, 포인트 충분) / [포인트 부족](회색, 비활성) / [로그인 후 구매](파랑) / [품절](회색, 비활성). 품절 상품은 카드 전체 opacity 55%.

7.3 상품 필터 동작

전체 필터 (기본)	?type, ?cat 파라미터 없음. DxShop::getItems(null, null, true)로 전체 활성 상품 조회.
유형 필터 (?type=badge)	DxShop::getItems(null, "badge", true)로 해당 유형 상품만 조회.
카테고리 필터 (?cat=한정판)	DxShop::getItems("한정판", null, true)로 해당 카테고리 상품만 조회.
카테고리 목록 자동 생성	DxShop::getCategories()가 활성 상품에서 DISTINCT category를 조회하여 필터 탭 자동 생성.

8. 구매 후처리 훅 (dx_shop_after_purchase)

상품 구매가 완료되면 DxShop::purchase() 내부에서 dx_run_hook("dx_shop_after_purchase", ...)이 실행됩니다. 이 훅에 실제 아이템 지급 로직을 플러그인으로 구현합니다.

8.1 훅 전달 데이터

키	타입	내용
member_id	int	구매한 회원의 ID.
item	array	구매한 상품 정보 배열. id/name/type/value/price 등 shop_items 전체 컬럼.
purchase_id	int	생성된 shop_purchases 레코드의 ID.

8.2 훅 활용 예시

type과 value를 조합하여 구매된 상품에 맞는 효과를 구현합니다.
 

상품 유형	훅에서 구현해야 할 로직
badge	$data["item"]["value"]에서 뱃지 코드(예: "badge-pro")를 읽어 members 테이블의 badge 컬럼(또는 별도 member_badges 테이블)에 해당 회원에게 저장.
title	$data["item"]["value"]에서 칭호 텍스트(예: "legendary-warrior")를 읽어 members 테이블의 title 컬럼에 저장하거나 별도 칭호 시스템 처리.
point	$data["item"]["value"]에서 충전할 포인트 수(예: "1000")를 읽어 DxPoint::add($memberId, "refund", 1000, ...)로 포인트 지급.
etc	value 값에 따라 사이트 특화 커스텀 로직 실행. 예: 특정 게시판 접근 권한 부여, 테마 전환 키 저장 등.

💡  훅 등록 예시: dx_add_hook("dx_shop_after_purchase", function($data) { if($data["item"]["type"]==="point") { DxPoint::add($data["member_id"], "refund", (int)$data["item"]["value"], ...); } });

9. DxShop API 레퍼런스 (개발자)

메서드 시그니처	설명 및 반환값
DxShop::getItems($cat, $type, $onlyActive)	상품 목록 조회. 카테고리·유형·활성 여부 필터. sort_order ASC, id ASC 정렬. 배열 반환.
DxShop::getItem($itemId)	단일 상품 조회. id+status=1 조건. 없으면 null 반환.
DxShop::purchase($memberId, $itemId)	구매 처리. {success, message, purchase_id?, item?} 배열 반환.
DxShop::refund($purchaseId, $adminNote)	환불 처리. {success, message} 배열 반환. 관리자 전용.
DxShop::getMemberPurchases($memberId, $limit, $offset)	회원 구매 이력 조회. shop_purchases LEFT JOIN shop_items. 마이페이지에서 활용.
DxShop::getMemberPurchaseCount($memberId)	회원 전체 구매 건수 반환(int).
DxShop::getAllPurchases($limit, $offset, $itemId)	전체 구매 이력 조회. shop_purchases LEFT JOIN members. 관리자 화면에서 활용.
DxShop::typeName($type)	상품 유형 코드를 한글로 변환. badge→"🏅 뱃지", title→"🎖 칭호" 등.
DxShop::getCategories()	활성 상품의 카테고리 목록 배열. 사용자 샵 필터 탭 생성에 사용.

10. 전체 사용 절차

10.1 포인트샵 처음 운영 시작하기

1. 관리자 대시보드 → [포인트샵 관리] 메뉴 클릭
2. [신규 상품 등록] 탭 클릭
3. 첫 번째 상품 등록 (이름•유형•가격 최소 입력)
4. [새로운 상품 등록 완료] 클릭
5. [상품 리스트] 탭에서 등록된 상품 확인
6. [사용자 샵 ↗] 버튼으로 실제 화면 미리보기
7. 필요시 카테고리별•유형별 상품 추가
8. 회원들이 구매하면 [구매/환불 이력] 탭에서 내역 확인

10.2 환불 처리 절차

1. [구매/환불 이력] 탭 클릭
2. 환불할 구매 건의 [환불 처리] 버튼 클릭
3. "환불 처리를 진행하시겠습니까?" 확인 창에서 [확인]
4. "환불이 완료되었습니다." 성공 메시지 확인
5. 해당 회원의 포인트 잔액이 복구되었는지 [포인트 관리]에서 확인
6. 필요시 [회원 관리]에서 지급된 아이템(뱃지•칭호 등) 수동 회수

11. 자주 묻는 질문 (FAQ)

Q1. 상품을 구매했는데 아무 효과가 없습니다.

A. DXCMS 기본 설치에서 dx_shop_after_purchase 훅은 아무것도 하지 않습니다. 뱃지•칭호 지급 등 실제 효과는 이 훅을 처리하는 플러그인이 필요합니다. 개발자에게 해당 훅 구현을 의뢰하거나, 플러그인 마켓에서 관련 확장을 찾아보세요.

Q2. 삭제한 상품을 다시 활성화할 수 있나요?

A. 네. [상품 리스트]에서 "중지됨" 상태로 표시된 상품의 [수정] 버튼을 클릭하고, 판매 상태를 "판매중"으로 변경 후 저장하면 됩니다.

Q3. 환불 후 뱃지가 사라지지 않습니다.

A. 환불은 포인트만 반환합니다. 뱃지•칭호 등 지급된 아이템은 자동 회수되지 않습니다. 수동으로 [회원 관리]에서 해당 회원 프로필을 수정하거나, dx_shop_after_purchase 훅에서 환불 감지 로직을 구현해야 합니다.

Q4. 1인당 1번만 구매 가능한 상품을 만들려면?

A. 상품 등록 시 [1인당 구매 제한]을 1로 설정하세요. 해당 회원이 이미 paid 상태로 구매한 이력이 있으면 다음 구매 시도 시 "구매 한도를 초과했습니다." 오류가 발생합니다.

Q5. 재고가 0이 되면 어떻게 됩니까?

A. stock=0이 되면 DxShop::purchase()에서 "품절된 상품입니다." 오류로 구매가 차단됩니다. 사용자 샵 카드에서도 [품절] 비활성 버튼으로 표시되며 카드 전체가 반투명으로 변합니다.

Q6. 구매 이력이 50건을 초과하면 어떻게 되나요?

A. 관리자 화면의 [구매/환불 이력]은 최근 50건만 표시됩니다. 더 오래된 이력은 DB에서 직접 조회하거나, 개발자가 별도 페이지네이션 기능을 추가해야 합니다.

Q7. 포인트 충전형 상품(type=point)은 자동으로 포인트가 지급되나요?

A. 기본 설치에서는 자동 지급되지 않습니다. dx_shop_after_purchase 훅에서 item.type이 "point"일 때 item.value 값만큼 DxPoint::add()를 호출하는 코드를 플러그인으로 구현해야 합니다.

12. 용어 정리

용어	설명
shop_items	상품 정보 DB 테이블. id/name/description/category/type/price/stock/buy_limit/image/value/status/sort_order/created_at.
shop_purchases	구매 이력 DB 테이블. id/member_id/item_id/item_name/price/status/note/created_at.
type	상품 유형. badge(뱃지)/title(칭호)/point(포인트 충전)/etc(기타).
price	상품 구매에 필요한 포인트 수. 구매 시 회원 포인트에서 차감.
stock	재고 수량. -1이면 무제한. 0이면 품절. 구매 성공 시 1 감소.
buy_limit	1인당 최대 구매 횟수. 0이면 무제한. 초과 시 구매 차단.
value	구매 후 처리에 사용할 상품 고유 식별값. 훅에서 $data["item"]["value"]로 접근.
status (상품)	상품 활성 여부. 1=판매중, 0=숨김(소프트 딜리트).
status (구매)	구매 상태. paid=결제완료, refunded=환불.
sort_order	상품 표시 순서. 낮을수록 상단. 동일 시 id ASC.
DxShop	포인트샵 비즈니스 로직 담당 정적 클래스.
DxShop::purchase()	구매 처리 메서드. 재고·한도·포인트 확인 후 차감·기록·훅 실행.
DxShop::refund()	환불 처리 메서드. 포인트 반환·재고 복구·구매 상태 변경.
dx_shop_after_purchase	구매 완료 후 실행되는 훅. 실제 아이템 지급 로직 구현에 사용.
dx_run_hook()	등록된 훅 핸들러를 실행하는 DXCMS 함수.
dx_csrf_check()	CSRF 토큰 검증 함수. 구매 API와 관리자 POST 모두에 적용.
소프트 딜리트(Soft Delete)	실제 DB 삭제 없이 status=0으로 비활성화. 이력 보존.
카테고리 필터	DxShop::getCategories()가 활성 상품의 DISTINCT category를 반환하여 샵 필터 탭 자동 생성.
sp-toast	사용자 샵 구매 결과 알림 팝업 요소. 3초 후 자동 소멸.
dxBuy()	사용자 샵의 구매 버튼 JavaScript 함수. confirm 후 AJAX POST.