WP-6/7: 영카트 결제 및 장바구니 시스템 - 분석 보고서

# WP-6/7: 영카트 결제 및 장바구니 시스템 분석 보고서 > 분석일: 2026-01-05 > 대상: YoungCart (영카트) 5.x > 범위: 결제 시스템 + 장바구니 시스템 --- ## ? 목적 WP-8 콘텐츠 관리 시스템과 함께 향후 통합 가능성을 대비하여 GnuBoard5/YoungCart의 쇼핑몰 기능을 상세 분석합니다. **주요 분석 영역:** - 장바구니 (Cart) 시스템 - 주문 (Order) 시스템 - PG(Payment Gateway) 연동 구조 - DB 스키마 --- ## ?️ 디렉토리 구조 ### /shop/ 폴더 개요 ``` shop/ ├── cart.php # 장바구니 메인 ├── cartupdate.php # 장바구니 업데이트 처리 ├── orderform.php # 주문서 작성 ├── orderform.sub.php # 주문서 실제 UI (70KB!) ├── orderformupdate.php # 주문 처리 (38KB!) ├── orderinquiry.php # 주문 조회 ├── orderinquiryview.php # 주문 상세 (32KB!) ├── orderinquirycancel.php # 주문 취소 ├── item.php # 상품 상세 ├── list.php # 상품 목록 ├── mypage.php # 마이페이지 ├── wishlist.php # 위시리스트 ├── coupon.php # 쿠폰 ├── ajax.action.php # AJAX 처리 (15KB!) ├── ajax.orderdatasave.php # 주문 데이터 저장 ├── settle_inicis_common.php # 이니시스 공통 ├── settle_kcp_common.php # KCP 공통 ├── settle_lg_common.php # LG U+ 공통 ├── settle_kakaopay.inc.php # 카카오페이 ├── settle_naverpay.inc.php # 네이버페이 └── [PG별 폴더]/ ├── inicis/ # 이니시스 (45개 파일!) ├── kcp/ # KCP (25개 파일) ├── lg/ # LG U+ (13개 파일) ├── kakaopay/ # 카카오페이 (16개 파일) └── naverpay/ # 네이버페이 (4개 파일) ``` **특징:** - 총 **71개 PHP 파일** - PG별 별도 디렉토리 (총 **103개 PG 관련 파일**) - 핵심 파일이 대용량 (orderform.sub.php 70KB!) --- ## ? DB 스키마 ### 핵심 테이블 #### 1. g5_shop_cart (장바구니) ```sql -- 추정 구조 (코드 분석 기반) CREATE TABLE g5_shop_cart ( ct_id INT AUTO_INCREMENT PRIMARY KEY, od_id VARCHAR(20), -- 장바구니 세션 ID 또는 주문 ID mb_id VARCHAR(20), -- 회원 ID it_id VARCHAR(20), -- 상품 ID it_name VARCHAR(255), -- 상품명 ct_price INT, -- 단가 ct_point INT, -- 포인트 ct_qty INT, -- 수량 ct_status VARCHAR(10), -- 상태 ('쇼핑', '주문', '취소') ct_send_cost TINYINT, -- 배송비 (0=선불, 1=착불, 2=무료) ct_select TINYINT, -- 선택 여부 ct_direct TINYINT, -- 즉시구매 여부 it_sc_type TINYINT, -- 배송비 타입 io_id VARCHAR(255), -- 옵션 ID io_type TINYINT, -- 옵션 타입 io_price INT, -- 옵션 가격 ct_option TEXT, -- 옵션 정보 ca_id VARCHAR(10), -- 카테고리 ID ca_id2 VARCHAR(10), ca_id3 VARCHAR(10) ); ``` **용도:** - 장바구니 상품 임시 저장 - 주문 완료 후에도 보관 (`ct_status` 변경) - 세션 기반 장바구니 (비회원도 가능) #### 2. g5_shop_order (주문) ```sql -- 추정 구조 CREATE TABLE g5_shop_order ( od_id VARCHAR(20) PRIMARY KEY, -- 주문번호 mb_id VARCHAR(20), -- 회원 ID od_name VARCHAR(100), -- 주문자명 od_email VARCHAR(100), -- 이메일 od_tel VARCHAR(20), -- 전화번호 od_hp VARCHAR(20), -- 휴대폰 od_zip VARCHAR(10), -- 우편번호 od_addr1 VARCHAR(255), -- 주소 od_addr2 VARCHAR(255), -- 상세주소 od_addr3 VARCHAR(255), -- 참고항목 od_b_name VARCHAR(100), -- 받는분명 od_b_tel VARCHAR(20), -- 받는분전화 od_b_hp VARCHAR(20), -- 받는분휴대폰 od_b_zip VARCHAR(10), -- 받는분우편번호 od_b_addr1 VARCHAR(255), -- 받는분주소 od_b_addr2 VARCHAR(255), -- 받는분상세주소 od_b_addr3 VARCHAR(255), -- 받는분참고항목 od_memo TEXT, -- 메모 od_cart_price INT, -- 상품금액 od_send_cost INT, -- 배송비 od_send_cost2 INT, -- 추가배송비 od_coupon INT, -- 쿠폰할인 od_cart_coupon INT, -- 장바구니쿠폰 od_send_coupon INT, -- 배송비쿠폰 od_receipt_point INT, -- 사용포인트 od_receipt_price INT, -- 실결제금액 od_cash INT, -- 현금영수증 od_cash_no VARCHAR(255), -- 현금영수증번호 od_pg VARCHAR(20), -- PG사 od_tno VARCHAR(255), -- 거래번호 od_app_no VARCHAR(20), -- 승인번호 od_misu INT, -- 미수금 od_pay_type VARCHAR(10), -- 결제방법 od_receipt_time DATETIME, -- 결제시각 od_status VARCHAR(20), -- 주문상태 od_settle_case VARCHAR(20), -- 결제수단 od_time DATETIME, -- 주문시각 od_pwd VARCHAR(255), -- 비회원 주문 비밀번호 od_ip VARCHAR(50) -- IP ); ``` **주요 상태 값:** - `od_status`: '입금', '준비', '배송', '완료', '취소', '환불' 등 #### 3. g5_shop_order_data (주문 임시 데이터) ```sql CREATE TABLE g5_shop_order_data ( od_id VARCHAR(20), -- 주문번호 dt_data LONGTEXT, -- 직렬화된 주문 데이터 dt_pg VARCHAR(20), -- PG사 dt_type TINYINT, -- 타입 dt_time DATETIME -- 생성시각 ); ``` **용도:** - PG 결제 전 주문 정보 임시 저장 - 결제 완료 후 실제 주문 테이블로 이동 #### 4. g5_shop_order_address (배송지 관리) ```sql CREATE TABLE g5_shop_order_address ( ad_id INT AUTO_INCREMENT PRIMARY KEY, mb_id VARCHAR(20), -- 회원 ID ad_name VARCHAR(100),-- 배송지명 ad_tel VARCHAR(20), -- 전화번호 ad_hp VARCHAR(20), -- 휴대폰 ad_zip VARCHAR(10), -- 우편번호 ad_addr1 VARCHAR(255),-- 주소 ad_addr2 VARCHAR(255),-- 상세주소 ad_addr3 VARCHAR(255),-- 참고항목 ad_default TINYINT -- 기본배송지 ); ``` --- ## ? 주문 흐름도 ### 1. 장바구니 추가 플로우 ```mermaid graph TD A[상품 상세 페이지] -->|장바구니 버튼| B[cartupdate.php] B --> C{로그인 여부} C -->|회원| D[mb_id 기반 장바구니] C -->|비회원| E[세션 ID 기반 장바구니] D --> F[g5_shop_cart INSERT] E --> F F --> G{재고 확인} G -->|재고 부족| H[alert 오류] G -->|재고 OK| I[장바구니 페이지로 이동] ``` **핵심 코드:** ```php // cart.php:14 $s_cart_id = get_session('ss_cart_id'); // cartupdate.php:279 $sql = " INSERT INTO {$g5['g5_shop_cart_table']} SET od_id = '$tmp_cart_id', mb_id = '{$member['mb_id']}', it_id = '$it_id', it_name = '$it_name', ct_price = '$it_price', ct_qty = '$ct_qty', ct_time = '".G5_TIME_YMDHIS."' "; ``` ### 2. 주문서 작성 플로우 ```mermaid graph TD A[장바구니] -->|주문하기| B[orderform.php] B --> C[새 주문번호 생성] C --> D[get_uniqid 호출] D --> E[세션에 od_id 저장] E --> F[orderform.sub.php include] F --> G[장바구니 아이템 조회] G --> H[배송지 정보 입력 폼] H --> I[결제 수단 선택] I --> J[주문하기 버튼] ``` **핵심 코드:** ```php // orderform.php:32 $od_id = get_uniqid(); set_session('ss_order_id', $od_id); // orderform.sub.php:68 $sql = " select a.ct_id, a.it_id, a.it_name, a.ct_price, a.ct_qty from {$g5['g5_shop_cart_table']} a left join {$g5['g5_shop_item_table']} b on (a.it_id = b.it_id) where a.od_id = '$s_cart_id' and a.ct_status = '쇼핑' "; ``` ### 3. 결제 처리 플로우 ```mermaid graph TD A[주문서 작성 완료] -->|orderformupdate.php| B[주문 데이터 검증] B --> C[g5_shop_order INSERT] C --> D[g5_shop_cart UPDATE] D -->|ct_status = '주문'| E{결제 방법} E -->|카드/계좌이체| F[PG 모듈 호출] E -->|무통장입금| G[입금 대기 상태] F --> H[settle_xxx_common.php] H --> I[PG사 API 연동] I --> J{결제 성공?} J -->|YES| K[od_receipt_time 기록] J -->|NO| L[주문 취소] K --> M[주문 완료 페이지] ``` **핵심 코드:** ```php // orderformupdate.php:550 $sql = " insert {$g5['g5_shop_order_table']} set od_id = '$od_id', mb_id = '{$member['mb_id']}', od_name = '$od_name', od_email = '$od_email', ... od_time = '".G5_TIME_YMDHIS."' "; // orderformupdate.php:649 $sql = "update {$g5['g5_shop_cart_table']} set od_id = '$od_id', ct_status = '주문' where od_id = '$tmp_cart_id' and ct_select = '1'"; // settle_kcp_common.php:208 $sql = " update {$g5['g5_shop_cart_table']} set ct_status = '완료' where od_id = '$od_id' "; ``` --- ## ? PG 연동 구조 ### 지원 PG사 1. **이니시스 (Inicis)** - 45개 파일 2. **KCP** - 25개 파일 3. **LG U+** - 13개 파일 4. **카카오페이** - 16개 파일 5. **네이버페이** - 4개 파일 ### 공통 PG 처리 흐름 ``` 주문 생성 → PG 모듈 선택 → settle_{pg}_common.php → PG사 API 호출 → 승인/거절 처리 → 주문 상태 업데이트 ``` **예시: KCP 결제** ```php // settle_kcp_common.php:115 if($res_cd == '0000') { // 결제 성공 $sql = " update {$g5['g5_shop_order_table']} set od_tno = '$tno', od_app_no = '$app_no', od_receipt_time = '".G5_TIME_YMDHIS."', od_misu = 0 where od_id = '$od_id' "; } ``` ### PG 모듈 파일 구조 ``` /shop/kcp/ ├── pp_cli_hub.php # KCP 결제 허브 ├── orderform.1.php # 신용카드 ├── orderform.2.php # 계좌이체 ├── orderform.3.php # 가상계좌 ├── orderform.4.php # 휴대폰 └── orderpartcancel.inc.php # 부분취소 ``` --- ## ? 세션 관리 ### 주요 세션 키 ```php // 장바구니 ID (비회원/일반) ss_cart_id => 임시 장바구니 세션 ID // 직접구매 장바구니 ss_cart_direct => 즉시구매 전용 장바구니 ID // 주문 ID ss_order_id => 현재 주문 번호 // PG별 주문 ID ss_order_inicis_id => 이니시스용 주문 ID ``` **장바구니 ID 생성:** ```php // shop.override.js function set_cart_id(sw_direct) { if (sw_direct) { ss_cart = 'ss_cart_direct'; } else { ss_cart = 'ss_cart_id'; } if (!get_session(ss_cart)) { cart_id = get_uniqid(); set_session(ss_cart, cart_id); } } ``` --- ## ? 쿠폰 & 포인트 시스템 ### 쿠폰 종류 1. **장바구니 쿠폰** - 전체 주문 금액 할인 2. **상품 쿠폰** - 특정 상품 할인 3. **배송비 쿠폰** - 배송비 할인 **관련 파일:** - `ordercoupon.php` - 주문 쿠폰 적용 - `orderitemcoupon.php` - 상품별 쿠폰 - `ordersendcostcoupon.php` - 배송비 쿠폰 - `ajax.coupondownload.php` - 쿠폰 다운로드 ### 포인트 적립/사용 ```php // orderformupdate.php $od_receipt_point = $_POST['od_receipt_point']; // 사용 포인트 $tot_point = 0; // 적립 포인트 // 포인트 계산 foreach ($cart as $ct) { $tot_point += $ct['ct_point'] * $ct['ct_qty']; } // 주문 완료 시 포인트 차감/적립 update_member_point($member['mb_id'], -$od_receipt_point, '주문 사용'); update_member_point($member['mb_id'], $tot_point, '구매 적립'); ``` --- ## ? 배송비 계산 로직 ### 배송비 유형 (it_sc_type) - **0**: 선불 (고정) - **1**: 착불 - **2**: 무료 - **3**: 조건부 무료 **조건부 무료 예시:** ```php // cart.php:136 if($row['it_sc_type'] == 2) { $sendcost = get_item_sendcost($row['it_id'], $sum['price'], $sum['qty'], $s_cart_id); if($sendcost == 0) $ct_send_cost = '무료'; } ``` **배송비 합산:** ```php // orderform.sub.php $send_cost = get_sendcost($s_cart_id, 0); $tot_price = $tot_sell_price + $send_cost; ``` --- ## ⚠️ 주요 발견사항 ### 1. 코드 복잡도 - **대용량 파일**: `orderform.sub.php` (70KB), `orderformupdate.php` (38KB), `orderinquiryview.php` (32KB) - **높은 결합도**: UI와 비즈니스 로직이 혼재 - **중복 코드**: PG별로 유사 코드 반복 ### 2. 보안 이슈 (잠재적) ```php // orderformupdate.php:33 $sql = "select * from {$g5['g5_shop_order_table']} limit 1"; // 비회원 주문 조회 (비밀번호만으로 조회 가능) $sql_common = " from {$g5['g5_shop_order_table']} where od_id = '$od_id' and od_pwd = '$od_pwd' "; ``` **권장 개선:** - Prepared Statements 사용 - 비밀번호 해싱 강화 - CSRF 토큰 추가 ### 3. 데이터 정합성 - 장바구니 → 주문 이동 시 트랜잭션 미사용 (일부 파일) - 재고 차감 타이밍 문제 가능성 ### 4. 확장성 - PG 추가 시 별도 디렉토리 생성 필요 - 하드코딩된 PG 선택 로직 - 플러그인 아키텍처 부재 --- ## ? 템플릿 빌더 통합 방안 ### 시나리오: 빌드된 테마에 쇼핑몰 추가 #### 옵션 1: 기존 영카트 활용 (권장) **장점:** - 검증된 시스템 - PG 연동 완료 - 관리자 기능 완비 **단점:** - 무거운 구조 - 테마 통합 작업 필요 **통합 방법:** 1. 빌드 시 `/shop/` 폴더 포함 2. 상품 페이지 템플릿 커스터마이징 3. `list.skin.php`, `item.skin.php` 스킨 교체 #### 옵션 2: 경량 커머스 모듈 개발 **장점:** - 가벼운 구조 - 테마와 완벽 통합 **단점:** - 신규 개발 비용 - PG 재연동 필요 - 유지보수 부담 **최소 기능:** - 장바구니 CRUD - 주문 생성 - 단일 PG 연동 (카카오페이 우선) - 간단한 주문 조회 #### 옵션 3: API 기반 분리 **장점:** - 느슨한 결합 - 마이크로서비스 전환 가능 **단점:** - 복잡한 아키텍처 - 세션 관리 어려움 --- ## ? 개발 우선순위 제안 ### Phase 1: 분석 완료 ✅ (현재) - [x] 장바구니 시스템 분석 - [x] 주문 시스템 분석 - [x] PG 연동 구조 파악 - [x] DB 스키마 이해 ### Phase 2: 경량 커머스 설계 (미정) - [ ] 최소 DB 스키마 설계 - [ ] 장바구니 API 명세 - [ ] 주문 API 명세 - [ ] 카카오페이 연동 조사 ### Phase 3: 프로토타입 개발 (미정) - [ ] 장바구니 CRUD - [ ] 간단한 주문서 - [ ] 카카오페이 테스트 연동 ### Phase 4: 템플릿 빌더 연동 (미정) - [ ] 테마 빌드 시 쇼핑몰 옵션 - [ ] 상품 관리 UI - [ ] 주문 관리 UI --- ## ? 결론 ### 현재 분석 완료 항목 - ✅ 장바구니 시스템 (**g5_shop_cart** 테이블 기반) - ✅ 주문 시스템 (**g5_shop_order** 테이블 기반) - ✅ PG 연동 구조 (5개 PG사 지원) - ✅ 쿠폰/포인트 메커니즘 - ✅ 배송비 계산 로직 - ✅ 세션 관리 방식 ### 핵심 인사이트 1. **영카트는 완성도 높은 B2C 쇼핑몰 솔루션** - 10년 이상 검증 - 5개 주요 PG 연동 - 쿠폰/포인트/배송 등 핵심 기능 완비 2. **템플릿 빌더와의 통합은 별도 프로젝트** - WP-8과 직접적 연관 없음 - 독립적인 커머스 모듈로 설계 권장 - SaaS 맥락에서는 "상품 판매 기능" 옵션으로 제공 3. **즉시 개발 불필요** - Phase 1-3 (콘텐츠 관리) 우선 - 사용자 피드백 수집 후 결정 - 니즈 확인되면 경량 버전 개발 ### 제안 **WP-6/7은 분석만 진행하고, 실제 구현은 Phase 4 이후로 연기** 이유: - WP-8 Phase 3 완성이 더 시급 - 커머스 기능은 선택적 기능 - 기존 영카트로 충분히 대응 가능 --- ## ? 참고 자료 ### 주요 파일 - [`cart.php`](file:///e:/AutoSet10/public_html/ict/custemplate/html-custemplate/shop/cart.php) - 장바구니 메인 (316줄) - [`orderform.php`](file:///e:/AutoSet10/public_html/ict/custemplate/html-custemplate/shop/orderform.php) - 주문서 진입점 (64줄) - [`orderformupdate.php`](file:///e:/AutoSet10/public_html/ict/custemplate/html-custemplate/shop/orderformupdate.php) - 주문 처리 (38KB) - [`settle_kcp_common.php`](file:///e:/AutoSet10/public_html/ict/custemplate/html-custemplate/shop/settle_kcp_common.php) - KCP 연동 (15KB) ### DB 테이블 - `g5_shop_cart` - 장바구니/주문 아이템 - `g5_shop_order` - 주문 정보 - `g5_shop_order_data` - 주문 임시 데이터 - `g5_shop_order_address` - 배송지 관리 - `g5_shop_item` - 상품 정보 - `g5_shop_coupon` - 쿠폰 - `g5_member` - 포인트 필드 포함 ### 외부 문서 - [GnuBoard5 공식 매뉴얼](https://github.com/gnuboard/gnuboard5) - [YoungCart5 셋팅 가이드](https://sir.kr/) - KCP/Inicis/LG 각사 개발 가이드