README

Laravel 패키지로 완전한 이커머스 솔루션을 제공합니다. 상품 관리, 장바구니, 주문 처리, 재고 관리, 결제 처리 등의 기능을 포함합니다.

설치

composer require jiny/shop

설정

서비스 프로바이더 등록 (Laravel 11+ Auto Discovery 지원)

Laravel 11 이상에서는 자동으로 서비스 프로바이더가 등록됩니다.

설정 파일 발행

php artisan vendor:publish --tag=jiny-shop-config

마이그레이션 실행

php artisan migrate

뷰 파일 발행 (선택사항)

php artisan vendor:publish --tag=jiny-shop-views

주요 기능

상품 관리 (Products)

상품 CRUD 작업
상품 카테고리 관리
상품 이미지 관리
상품 가격 관리
상품 재고 추적
상품 변형 지원
상품 리뷰 및 평점

장바구니 (Cart)

세션 기반 장바구니
영구 장바구니 (회원용)
게스트 장바구니 지원
장바구니 저장 기능
자동 정리 기능

주문 관리 (Orders)

주문 생성 및 처리
다단계 체크아웃 프로세스
주문 추적 시스템
주문 취소 및 반품
게스트 주문 지원
자동 주문 완료

재고 관리 (Inventory)

실시간 재고 추적
재고 부족 알림
재고 입고/출고 관리
백오더 관리
자동 재고 차감

결제 처리 (Payment)

다중 결제 수단 지원
다중 통화 지원
결제 계획 지원
결제 실패 처리

배송 관리 (Shipping)

다양한 배송 방법
실시간 배송비 계산
무료 배송 임계값
배송 추적 시스템
픽업 서비스 지원

프로모션 (Promotions)

쿠폰 시스템
할인 관리
대량 구매 할인
Buy X Get Y 프로모션
쿠폰 스택 지원

세금 관리 (Tax)

국가별 세율 관리
가격 내 세금 포함/제외
배송비 세금 계산
디지털 상품 세율

설정 옵션

config/shop.php 파일에서 다양한 옵션을 설정할 수 있습니다:

'products' => [
    'enable' => true,
    'pagination' => 20,
    'enable_reviews' => true,
    'enable_ratings' => true,
    'enable_wishlist' => true,
],

'cart' => [
    'enable' => true,
    'session_key' => 'jiny_cart',
    'persistent' => true,
    'expire_days' => 30,
],

'orders' => [
    'enable' => true,
    'order_number_prefix' => 'ORD',
    'enable_guest_orders' => true,
    'auto_complete_days' => 7,
],

라우트

관리자 라우트

/admin/cms/ecommerce - 이커머스 대시보드
/admin/cms/cart - 장바구니 관리
/admin/site/products - 상품 관리
/admin/cms/ecommerce/orders - 주문 관리
/admin/cms/ecommerce/inventory - 재고 관리

사용자 라우트

/shop - 쇼핑몰 메인
/products - 상품 목록
/cart - 장바구니
/checkout - 주문결제
/orders - 주문내역

뷰 커스터마이징

뷰 파일을 커스터마이징하려면:

php artisan vendor:publish --tag=jiny-shop-views

발행된 뷰 파일은 resources/views/vendor/jiny-shop/ 디렉토리에 위치합니다.

보안 기능

CSRF 보호
Rate Limiting
사기 탐지
주문 검증
최대 주문 금액 제한

캐시 지원

상품 캐시
가격 캐시
설정 가능한 캐시 TTL
캐시 태그 지원

분석 및 추적

페이지 뷰 추적
장바구니 추가 추적
구매 추적
검색 추적
Google Analytics 연동

알림

주문 완료 알림
주문 배송 알림
재고 부족 알림
결제 실패 알림

권한

관리자 기능은 admin 미들웨어를 사용합니다. jiny/admin 패키지가 필요합니다.

요구사항

PHP 8.1 이상
Laravel 10.0 이상
MySQL 또는 PostgreSQL

라이선스

MIT License

지원

문의사항이나 버그 리포트는 GitHub Issues를 이용해주세요.

jiny / shop

Maintainers

Details