'sirsoft-ecommerce.manager', 'name' => [ 'ko' => '이커머스 관리자', 'en' => 'Ecommerce Manager', ], 'description' => [ 'ko' => '이커머스 관리 권한을 가진 역할', 'en' => 'Role with ecommerce management permissions', ], ], ]; } /** * 모듈 권한 목록 반환 (계층형 구조, 다국어 지원) * * 구조: 모듈(1레벨) → 카테고리(2레벨) → 개별 권한(3레벨) * identifier는 자동 생성됨: {module}.{category}.{action} */ public function getPermissions(): array { return [ 'name' => [ 'ko' => '이커머스', 'en' => 'Ecommerce', ], 'description' => [ 'ko' => '이커머스 모듈 권한', 'en' => 'Ecommerce module permissions', ], 'categories' => [ // 상품 관리 권한 [ 'identifier' => 'products', 'resource_route_key' => 'product', 'owner_key' => 'created_by', 'name' => [ 'ko' => '상품 관리', 'en' => 'Product Management', ], 'description' => [ 'ko' => '상품 관리 권한', 'en' => 'Product management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '상품 조회', 'en' => 'Read Products', ], 'description' => [ 'ko' => '상품 목록 및 상세 조회', 'en' => 'Read product list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'create', 'name' => [ 'ko' => '상품 생성', 'en' => 'Create Product', ], 'description' => [ 'ko' => '새 상품 등록', 'en' => 'Create new product', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '상품 수정', 'en' => 'Update Product', ], 'description' => [ 'ko' => '상품 정보 수정', 'en' => 'Update product information', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '상품 삭제', 'en' => 'Delete Product', ], 'description' => [ 'ko' => '상품 삭제', 'en' => 'Delete product', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 주문 관리 권한 [ 'identifier' => 'orders', 'resource_route_key' => 'order', 'owner_key' => 'user_id', 'name' => [ 'ko' => '주문 관리', 'en' => 'Order Management', ], 'description' => [ 'ko' => '주문 관리 권한', 'en' => 'Order management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '주문 조회', 'en' => 'Read Orders', ], 'description' => [ 'ko' => '주문 목록 및 상세 조회', 'en' => 'Read order list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '주문 수정', 'en' => 'Update Order', ], 'description' => [ 'ko' => '주문 상태 변경', 'en' => 'Update order status', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], ], ], // 카테고리 관리 권한 [ 'identifier' => 'categories', 'name' => [ 'ko' => '카테고리 관리', 'en' => 'Category Management', ], 'description' => [ 'ko' => '카테고리 관리 권한', 'en' => 'Category management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '카테고리 조회', 'en' => 'Read Categories', ], 'description' => [ 'ko' => '카테고리 목록 및 상세 조회', 'en' => 'Read category list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'create', 'name' => [ 'ko' => '카테고리 생성', 'en' => 'Create Category', ], 'description' => [ 'ko' => '카테고리 생성', 'en' => 'Create category', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '카테고리 수정', 'en' => 'Update Category', ], 'description' => [ 'ko' => '카테고리 수정', 'en' => 'Update category', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '카테고리 삭제', 'en' => 'Delete Category', ], 'description' => [ 'ko' => '카테고리 삭제', 'en' => 'Delete category', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 브랜드 관리 권한 [ 'identifier' => 'brands', 'resource_route_key' => 'brand', 'owner_key' => 'created_by', 'name' => [ 'ko' => '브랜드 관리', 'en' => 'Brand Management', ], 'description' => [ 'ko' => '브랜드 관리 권한', 'en' => 'Brand management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '브랜드 조회', 'en' => 'Read Brands', ], 'description' => [ 'ko' => '브랜드 목록 및 상세 조회', 'en' => 'Read brand list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'create', 'name' => [ 'ko' => '브랜드 생성', 'en' => 'Create Brand', ], 'description' => [ 'ko' => '브랜드 생성', 'en' => 'Create brand', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '브랜드 수정', 'en' => 'Update Brand', ], 'description' => [ 'ko' => '브랜드 수정', 'en' => 'Update brand', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '브랜드 삭제', 'en' => 'Delete Brand', ], 'description' => [ 'ko' => '브랜드 삭제', 'en' => 'Delete brand', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 상품정보제공고시 관리 권한 [ 'identifier' => 'product-notice-templates', 'name' => [ 'ko' => '상품정보제공고시 관리', 'en' => 'Product Notice Template Management', ], 'description' => [ 'ko' => '상품정보제공고시 템플릿 관리 권한', 'en' => 'Product notice template management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '조회', 'en' => 'Read', ], 'description' => [ 'ko' => '상품정보제공고시 조회', 'en' => 'Read product notice templates', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'create', 'name' => [ 'ko' => '생성', 'en' => 'Create', ], 'description' => [ 'ko' => '상품정보제공고시 생성', 'en' => 'Create product notice template', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '수정', 'en' => 'Update', ], 'description' => [ 'ko' => '상품정보제공고시 수정', 'en' => 'Update product notice template', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '삭제', 'en' => 'Delete', ], 'description' => [ 'ko' => '상품정보제공고시 삭제', 'en' => 'Delete product notice template', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 공통정보 관리 권한 [ 'identifier' => 'product-common-infos', 'name' => [ 'ko' => '공통정보 관리', 'en' => 'Product Common Info Management', ], 'description' => [ 'ko' => '상품 공통정보 관리 권한', 'en' => 'Product common info management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '조회', 'en' => 'Read', ], 'description' => [ 'ko' => '공통정보 조회', 'en' => 'Read product common info', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'create', 'name' => [ 'ko' => '생성', 'en' => 'Create', ], 'description' => [ 'ko' => '공통정보 생성', 'en' => 'Create product common info', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '수정', 'en' => 'Update', ], 'description' => [ 'ko' => '공통정보 수정', 'en' => 'Update product common info', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '삭제', 'en' => 'Delete', ], 'description' => [ 'ko' => '공통정보 삭제', 'en' => 'Delete product common info', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 환경설정 권한 [ 'identifier' => 'settings', 'name' => [ 'ko' => '환경설정', 'en' => 'Settings', ], 'description' => [ 'ko' => '이커머스 환경설정 권한', 'en' => 'Ecommerce settings permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '환경설정 조회', 'en' => 'View Settings', ], 'description' => [ 'ko' => '이커머스 환경설정 조회', 'en' => 'View ecommerce settings', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '환경설정 수정', 'en' => 'Update Settings', ], 'description' => [ 'ko' => '이커머스 환경설정 수정', 'en' => 'Update ecommerce settings', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 쿠폰 관리 권한 [ 'identifier' => 'promotion-coupon', 'resource_route_key' => 'coupon', 'owner_key' => 'created_by', 'name' => [ 'ko' => '쿠폰 관리', 'en' => 'Coupon Management', ], 'description' => [ 'ko' => '쿠폰 관리 권한', 'en' => 'Coupon management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '쿠폰 조회', 'en' => 'Read Coupons', ], 'description' => [ 'ko' => '쿠폰 목록 및 상세 조회', 'en' => 'Read coupon list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'create', 'name' => [ 'ko' => '쿠폰 생성', 'en' => 'Create Coupon', ], 'description' => [ 'ko' => '새 쿠폰 등록', 'en' => 'Create new coupon', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '쿠폰 수정', 'en' => 'Update Coupon', ], 'description' => [ 'ko' => '쿠폰 정보 수정', 'en' => 'Update coupon information', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '쿠폰 삭제', 'en' => 'Delete Coupon', ], 'description' => [ 'ko' => '쿠폰 삭제', 'en' => 'Delete coupon', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 배송정책 관리 권한 [ 'identifier' => 'shipping-policies', 'resource_route_key' => 'shippingPolicy', 'owner_key' => 'created_by', 'name' => [ 'ko' => '배송정책 관리', 'en' => 'Shipping Policy Management', ], 'description' => [ 'ko' => '배송정책 관리 권한', 'en' => 'Shipping policy management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '배송정책 조회', 'en' => 'Read Shipping Policies', ], 'description' => [ 'ko' => '배송정책 목록 및 상세 조회', 'en' => 'Read shipping policy list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'create', 'name' => [ 'ko' => '배송정책 생성', 'en' => 'Create Shipping Policy', ], 'description' => [ 'ko' => '새 배송정책 등록', 'en' => 'Create new shipping policy', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '배송정책 수정', 'en' => 'Update Shipping Policy', ], 'description' => [ 'ko' => '배송정책 정보 수정', 'en' => 'Update shipping policy information', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '배송정책 삭제', 'en' => 'Delete Shipping Policy', ], 'description' => [ 'ko' => '배송정책 삭제', 'en' => 'Delete shipping policy', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 상품 라벨 관리 권한 [ 'identifier' => 'product-labels', 'name' => [ 'ko' => '상품 라벨 관리', 'en' => 'Product Label Management', ], 'description' => [ 'ko' => '상품 라벨 관리 권한', 'en' => 'Product label management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '상품 라벨 조회', 'en' => 'Read Product Labels', ], 'description' => [ 'ko' => '상품 라벨 목록 및 상세 조회', 'en' => 'Read product label list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'create', 'name' => [ 'ko' => '상품 라벨 생성', 'en' => 'Create Product Label', ], 'description' => [ 'ko' => '새 상품 라벨 등록', 'en' => 'Create new product label', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '상품 라벨 수정', 'en' => 'Update Product Label', ], 'description' => [ 'ko' => '상품 라벨 정보 수정', 'en' => 'Update product label information', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '상품 라벨 삭제', 'en' => 'Delete Product Label', ], 'description' => [ 'ko' => '상품 라벨 삭제', 'en' => 'Delete product label', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 본인인증 정책 관리 권한 [ 'identifier' => 'identity.policies', 'name' => [ 'ko' => '이커머스 본인인증 정책', 'en' => 'Ecommerce Identity Policies', ], 'description' => [ 'ko' => '이커머스 컨텍스트의 본인인증 정책 관리 권한', 'en' => 'Manage identity verification policies in ecommerce context', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '본인인증 정책 조회', 'en' => 'View Identity Policies', ], 'description' => [ 'ko' => '이커머스 본인인증 정책 조회', 'en' => 'View ecommerce identity policies', ], 'type' => 'admin', 'roles' => ['admin'], ], [ 'action' => 'update', 'name' => [ 'ko' => '본인인증 정책 수정', 'en' => 'Update Identity Policies', ], 'description' => [ 'ko' => '이커머스 본인인증 정책 수정/추가/삭제', 'en' => 'Update, add, delete ecommerce identity policies', ], 'type' => 'admin', 'roles' => ['admin'], ], ], ], // 리뷰 관리 권한 [ 'identifier' => 'reviews', 'resource_route_key' => 'review', 'owner_key' => 'user_id', 'name' => [ 'ko' => '리뷰 관리', 'en' => 'Review Management', ], 'description' => [ 'ko' => '상품 리뷰 관리 권한', 'en' => 'Product review management permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '리뷰 조회', 'en' => 'Read Reviews', ], 'description' => [ 'ko' => '리뷰 목록 및 상세 조회', 'en' => 'Read review list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'update', 'name' => [ 'ko' => '리뷰 처리', 'en' => 'Manage Review', ], 'description' => [ 'ko' => '리뷰 상태 변경, 답변 등록/수정/삭제, 일괄 처리', 'en' => 'Update review status, manage replies, bulk actions', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '리뷰 삭제', 'en' => 'Delete Review', ], 'description' => [ 'ko' => '리뷰 삭제', 'en' => 'Delete review', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 문의 관리 권한 [ 'identifier' => 'inquiries', 'name' => [ 'ko' => '문의 관리', 'en' => 'Inquiry Management', ], 'description' => [ 'ko' => '상품 1:1 문의 관리 권한', 'en' => 'Product inquiry management permissions', ], 'permissions' => [ [ 'action' => 'update', 'name' => [ 'ko' => '문의 처리', 'en' => 'Manage Inquiry', ], 'description' => [ 'ko' => '답변 등록/수정/삭제, 비밀글 내용 열람', 'en' => 'Create, update, and delete inquiry replies; view secret inquiry contents', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'delete', 'name' => [ 'ko' => '문의 삭제', 'en' => 'Delete Inquiry', ], 'description' => [ 'ko' => '고객이 작성한 문의 자체를 삭제', 'en' => 'Delete inquiries submitted by customers', ], 'roles' => ['admin', 'sirsoft-ecommerce.manager'], ], ], ], // 대시보드 권한 [ 'identifier' => 'dashboard', 'name' => [ 'ko' => '대시보드', 'en' => 'Dashboard', ], 'description' => [ 'ko' => '관리자 대시보드 이커머스 영역 조회 권한', 'en' => 'Admin dashboard commerce area view permissions', ], 'permissions' => [ [ 'action' => 'view', 'name' => [ 'ko' => '대시보드 조회', 'en' => 'View Dashboard', ], 'description' => [ 'ko' => '관리자 대시보드의 이커머스 판매 현황/리뷰/문의 위젯 조회', 'en' => 'View commerce sales/review/inquiry widgets on the admin dashboard', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], ], ], // ============================================================ // 사용자(User) 권한 — 블랙컨슈머 차단용 // ============================================================ // 사용자 상품 조회 권한 [ 'identifier' => 'user-products', 'name' => [ 'ko' => '사용자 상품', 'en' => 'User Products', ], 'description' => [ 'ko' => '사용자 상품 접근 권한 (블랙컨슈머 차단용)', 'en' => 'User product access permissions (for blocking malicious consumers)', ], 'permissions' => [ [ 'action' => 'read', 'type' => 'user', 'name' => [ 'ko' => '상품 조회', 'en' => 'View Products', ], 'description' => [ 'ko' => '상품 목록 및 상세 조회', 'en' => 'View product list and details', ], 'roles' => ['*'], ], ], ], // 사용자 주문 권한 [ 'identifier' => 'user-orders', 'name' => [ 'ko' => '사용자 주문', 'en' => 'User Orders', ], 'description' => [ 'ko' => '사용자 주문 관련 권한 (블랙컨슈머 차단용)', 'en' => 'User order permissions (for blocking malicious consumers)', ], 'permissions' => [ [ 'action' => 'create', 'type' => 'user', 'name' => [ 'ko' => '주문하기', 'en' => 'Create Order', ], 'description' => [ 'ko' => '주문 생성', 'en' => 'Create a new order', ], 'roles' => ['*'], ], [ 'action' => 'cancel', 'type' => 'user', 'name' => [ 'ko' => '주문 취소', 'en' => 'Cancel Order', ], 'description' => [ 'ko' => '주문 취소 요청', 'en' => 'Request order cancellation', ], 'roles' => ['*'], ], [ 'action' => 'confirm', 'type' => 'user', 'name' => [ 'ko' => '구매확정', 'en' => 'Confirm Purchase', ], 'description' => [ 'ko' => '주문 상품 구매확정', 'en' => 'Confirm purchase of order item', ], 'roles' => ['*'], 'resource_route_key' => 'id', 'owner_key' => 'user_id', ], ], ], // 사용자 리뷰 권한 [ 'identifier' => 'user-reviews', 'name' => [ 'ko' => '사용자 리뷰', 'en' => 'User Reviews', ], 'description' => [ 'ko' => '사용자 리뷰 관련 권한 (블랙컨슈머 차단용)', 'en' => 'User review permissions (for blocking malicious consumers)', ], 'permissions' => [ [ 'action' => 'write', 'type' => 'user', 'name' => [ 'ko' => '리뷰 작성', 'en' => 'Write Review', ], 'description' => [ 'ko' => '상품 리뷰 작성', 'en' => 'Write product review', ], 'roles' => ['*'], ], ], ], // 마일리지 관리 권한 [ 'identifier' => 'mileage', 'resource_route_key' => 'mileage-transaction', 'owner_key' => 'user_id', 'name' => [ 'ko' => '마일리지 관리', 'en' => 'Mileage Management', ], 'description' => [ 'ko' => '마일리지 내역 조회 및 수동 지급/차감 권한', 'en' => 'Mileage history and manual grant/deduct permissions', ], 'permissions' => [ [ 'action' => 'read', 'name' => [ 'ko' => '마일리지 내역 조회', 'en' => 'Read Mileage', ], 'description' => [ 'ko' => '마일리지 내역 목록 및 상세 조회', 'en' => 'Read mileage history list and details', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], [ 'action' => 'manage', 'name' => [ 'ko' => '마일리지 수동 처리', 'en' => 'Manage Mileage', ], 'description' => [ 'ko' => '마일리지 수동 지급/차감 및 일괄 유효기간 연장', 'en' => 'Manual grant/deduct and bulk expiry extension', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], ], ], // 회원 결제 통화 관리 권한 (A3 — 관리자 회원 편집에서 통화 변경) [ 'identifier' => 'user-currency', 'name' => [ 'ko' => '회원 결제 통화 관리', 'en' => 'User Currency Management', ], 'description' => [ 'ko' => '관리자가 회원별 결제 통화를 변경하는 권한', 'en' => 'Permission for admins to change a user\'s payment currency', ], 'permissions' => [ [ 'action' => 'manage', 'name' => [ 'ko' => '회원 결제 통화 변경', 'en' => 'Manage User Currency', ], 'description' => [ 'ko' => '회원별 결제 통화 변경', 'en' => 'Change a user\'s payment currency', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], ], ], // 회원 배송국가 관리 권한 (MP08 후속 — 관리자 회원 편집에서 배송국가 변경) [ 'identifier' => 'user-shipping-country', 'name' => [ 'ko' => '회원 배송국가 관리', 'en' => 'User Shipping Country Management', ], 'description' => [ 'ko' => '관리자가 회원별 배송국가를 변경하는 권한', 'en' => 'Permission for admins to change a user\'s shipping country', ], 'permissions' => [ [ 'action' => 'manage', 'name' => [ 'ko' => '회원 배송국가 변경', 'en' => 'Manage User Shipping Country', ], 'description' => [ 'ko' => '회원별 배송국가 변경', 'en' => 'Change a user\'s shipping country', ], 'roles' => ['admin', 'manager', 'sirsoft-ecommerce.manager'], ], ], ], ], ]; } /** * 모듈 설정 파일 목록 반환 */ public function getConfig(): array { return [ 'sirsoft-ecommerce' => $this->getModulePath().'/config/ecommerce.php', ]; } /** * 완전 공개 자산 스토리지 카테고리 목록 * * 이 카테고리들만 공개 자산 디스크 설정을 따른다. 권한 검사가 걸린 자산 * (회원 전용/비밀 자료 등)은 직접 URL 이 권한을 우회하므로 포함하지 않는다. * 새 공개 자산 카테고리가 생기면 여기에만 추가하면 된다. * * @var list */ private const PUBLIC_ASSET_CATEGORIES = ['images']; /** * 카테고리별 스토리지 디스크 이름 반환 * * 완전 공개 자산 카테고리만 공개 자산 디스크(모듈 설정 basic_info.public_asset_disk > * 코어 전역 core.storage.public_asset_disk)를 따르고, 설정/캐시 등 나머지 * 카테고리는 기본 디스크를 유지합니다. 미설정/고아 디스크는 기본 디스크로 * 폴백해 기존 스트리밍 동작을 보존합니다. * * 모듈 설정 조회는 공개 자산 카테고리에서만 수행합니다 — 'settings' 카테고리에서 * 조회하면 설정 로드와 재귀 고리가 생깁니다 (AbstractModule 주석 참조). * * @param string $category 카테고리 * @return string 디스크 이름 */ public function getStorageDiskFor(string $category): string { if (! in_array($category, self::PUBLIC_ASSET_CATEGORIES, true)) { return $this->getStorageDisk(); } $override = module_setting('sirsoft-ecommerce', 'basic_info.public_asset_disk', ''); return $this->resolvePublicAssetDisk(is_string($override) ? $override : '') ?? $this->getStorageDisk(); } /** * 모듈 설치 시 실행할 시더 목록 반환 * * 배열 순서대로 실행됩니다. * 나머지 시더는 개발/테스트용이므로 설치 시 필수 참조 데이터만 실행합니다. * * @return array> 시더 클래스명 배열 (FQCN) */ public function getSeeders(): array { return [ SequenceSeeder::class, ShippingCarrierSeeder::class, ClaimReasonSeeder::class, ]; } /** * 이 모듈이 등록할 IDV 정책 선언 (DB 동기화). * * ModuleManager 가 activate/update 시 `identity_policies` 테이블에 * `source_type='module' / source_identifier='sirsoft-ecommerce'` 로 upsert 하며, * 운영자가 S1d 관리자 UI 에서 수정한 필드(enabled/grace/provider/fail_mode) 는 * `user_overrides` JSON 으로 보존됩니다. * * 모든 정책은 보수적 기본값 `enabled=false` — 운영자가 S1d 에서 켜야 작동합니다. * * @return array> */ public function getIdentityPolicies(): array { return [ [ 'key' => 'sirsoft-ecommerce.payment.cancel', 'scope' => 'hook', 'target' => 'sirsoft-ecommerce.payment.before_cancel', 'purpose' => 'sensitive_action', 'grace_minutes' => 0, 'enabled' => false, 'applies_to' => 'both', 'fail_mode' => 'block', ], [ 'key' => 'sirsoft-ecommerce.payment.approve', 'scope' => 'hook', 'target' => 'sirsoft-ecommerce.payment.before_approve', 'purpose' => 'sensitive_action', 'grace_minutes' => 0, 'enabled' => false, 'applies_to' => 'admin', 'fail_mode' => 'block', ], [ 'key' => 'sirsoft-ecommerce.payment.confirm_deposit', 'scope' => 'hook', 'target' => 'sirsoft-ecommerce.payment.before_confirm_deposit', 'purpose' => 'sensitive_action', 'grace_minutes' => 0, 'enabled' => false, 'applies_to' => 'admin', 'fail_mode' => 'block', ], // 결제 직전 본인 확인 (사용자 측 가드, checkout_verification purpose 사용) [ 'key' => 'sirsoft-ecommerce.checkout.before_pay', 'scope' => 'hook', 'target' => 'sirsoft-ecommerce.checkout.before_payment', 'purpose' => 'checkout_verification', 'grace_minutes' => 30, 'enabled' => false, 'applies_to' => 'self', 'fail_mode' => 'block', ], ]; } /** * 이 모듈이 등록할 IDV 목적(purpose) 선언 (DB 비저장, 런타임 레지스트리). * * 코어 4종(`signup` / `password_reset` / `self_update` / `sensitive_action`) * 외에 이커머스 도메인이 필요로 하는 `checkout_verification` 을 추가합니다. * 이 purpose 를 실제 수행하려면 해당 purpose 를 `supportsPurpose()=true` 로 * 응답하는 Provider (예: 성인/본인확인 플러그인) 가 함께 등록되어야 합니다. * * @return array> */ public function getIdentityPurposes(): array { return [ 'checkout_verification' => [ // 모듈 i18n 표준 (docs/extension/module-i18n.md) — 백엔드 IdentityVerificationController // 의 resolvePurposeText() 가 `vendor-module::file.key` lang 키를 __() 로 해석. 'label' => 'sirsoft-ecommerce::identity.purposes.checkout_verification.label', 'description' => 'sirsoft-ecommerce::identity.purposes.checkout_verification.description', 'default_provider' => null, 'allowed_channels' => ['email', 'sms', 'ipin'], ], ]; } /** * 이커머스 모듈이 등록할 IDV 메시지 정의/템플릿. * * 코어 4종 fallback (signup/password_reset/self_update/sensitive_action) 외에 * 이 모듈이 신규 도입한 `checkout_verification` purpose 의 전용 메일 메시지를 제공합니다. * 등록되지 않으면 IdentityMessageDispatcher 가 `provider_default` (가장 일반적인 fallback) * 메일을 발송하므로 결제 도메인 컨텍스트가 사라집니다. * * 결제 도메인 정책 3건(payment.cancel/approve/confirm_deposit)은 purpose=sensitive_action * 코어 메일을 그대로 사용해도 충분하므로 별도 등록하지 않습니다. * (정책별 차별화가 필요하면 scope_type=SCOPE_POLICY + scope_value=policy_key 로 추가) * * @return array> */ public function getIdentityMessages(): array { return [ [ 'provider_id' => 'g7:core.mail', 'scope_type' => IdentityMessageDefinition::SCOPE_PURPOSE, 'scope_value' => 'checkout_verification', 'name' => [ 'ko' => '결제 시 본인 확인', 'en' => 'Checkout Verification', ], 'description' => [ 'ko' => '결제 진행 전 본인/성인 확인 인증 코드 메일', 'en' => 'Identity/adult verification code mail before checkout', ], 'channels' => ['mail'], 'variables' => [ ['key' => 'code', 'description' => '인증 코드 (text_code 흐름)'], ['key' => 'expire_minutes', 'description' => '만료까지 남은 분'], ['key' => 'purpose_label', 'description' => '인증 목적 라벨'], ['key' => 'app_name', 'description' => '사이트명'], ['key' => 'site_url', 'description' => '사이트 URL'], ['key' => 'recipient_email', 'description' => '수신자 이메일'], ], 'templates' => [ [ 'channel' => 'mail', 'subject' => [ 'ko' => '[{app_name}] 결제 본인 확인 인증 코드', 'en' => '[{app_name}] Checkout Verification Code', ], 'body' => [ 'ko' => '

결제 본인 확인

' .'

결제를 진행하기 위해 본인 확인이 필요합니다. 아래 인증 코드를 입력해 주세요.

' .'

{code}

' .'

이 코드는 {expire_minutes}분 후 만료됩니다.

' .'

본인이 결제를 진행하지 않았다면 이 메일을 무시하고 즉시 비밀번호를 변경해 주세요.

' .'

감사합니다,
{app_name}

', 'en' => '

Checkout Verification

' .'

Please enter the code below to proceed with payment.

' .'

{code}

' .'

This code will expire in {expire_minutes} minutes.

' .'

If you did not initiate this payment, please ignore this email and change your password immediately.

' .'

Thank you,
{app_name}

', ], ], ], ], ]; } /** * 이커머스 모듈이 등록할 알림 정의. * * AbstractModule 계약에 따라 ModuleManager 가 activate/update 시 자동으로 * NotificationSyncHelper 를 통해 동기화하며, uninstall(deleteData=true) 시 정리합니다. * 운영자가 관리자 UI 에서 수정한 필드는 user_overrides JSON 에 보존됩니다. * * `extension_type`/`extension_identifier` 는 Manager 가 자동 주입. * * @return array> */ public function getNotificationDefinitions(): array { return [ $this->orderConfirmedDefinition(), $this->orderPendingDepositDefinition(), $this->orderShippedDefinition(), $this->orderDeliveredDefinition(), $this->orderCompletedDefinition(), $this->orderCancelledDefinition(), $this->newOrderAdminDefinition(), $this->inquiryReceivedDefinition(), $this->inquiryRepliedDefinition(), $this->mileageExpiringSoonDefinition(), ]; } /** * 성능 계측 프로파일 정의 (`g7:bench`). * * 목록 프로파일의 `columns` 는 해당 목록이 실제로 select 하는 컬럼이어야 합니다. 주문 * 목록은 Repository 가 상수로 들고 있으므로 그 상수를 그대로 참조합니다 — 여기에 컬럼을 * 다시 적으면 Repository 변경 시 계측이 조용히 낡습니다. 나머지 목록의 `['*']` 는 * "응답 계약상 전 컬럼을 노출해 프루닝 불가" 선언이며, 이때 비교축은 select * vs select id * 입니다. * * @return array> 프로파일 키 → 정의 */ public function getBenchmarkProfiles(): array { return [ 'orders' => [ 'type' => 'list', 'label' => '주문 목록', 'table' => 'ecommerce_orders', 'columns' => OrderRepository::LIST_COLUMNS, 'order' => [['ordered_at', 'desc'], ['id', 'desc']], // 관리자 주문 목록은 상태 미지정 시 임시 주문 상태를 제외한다 // (OrderRepository::getListWithFilters). 이 술어를 빼고 재면 옵티마이저가 다른 // 인덱스를 골라 화면에서 일어나는 일과 다른 것을 잰다. 값은 Enum SSoT 를 참조한다. 'filters' => ['order_status' => ['not in', OrderStatusEnum::listHiddenValues()]], 'soft_delete' => true, ], 'products' => [ 'type' => 'list', 'label' => '상품 목록', 'table' => 'ecommerce_products', 'columns' => ['*'], 'order' => [['created_at', 'desc'], ['id', 'desc']], 'soft_delete' => true, ], // 상품 문의는 소프트 삭제 컬럼이 없다 — 실제 스키마 기준 선언 'product_inquiries' => [ 'type' => 'list', 'label' => '상품 문의 목록', 'table' => 'ecommerce_product_inquiries', 'columns' => ['*'], 'order' => [['created_at', 'desc'], ['id', 'desc']], 'soft_delete' => false, ], 'product_reviews' => [ 'type' => 'list', 'label' => '상품 후기 목록', 'table' => 'ecommerce_product_reviews', 'columns' => ['*'], 'order' => [['created_at', 'desc'], ['id', 'desc']], 'soft_delete' => true, ], 'coupon_issues' => [ 'type' => 'list', 'label' => '쿠폰 발급 이력 목록', 'table' => 'ecommerce_promotion_coupon_issues', 'columns' => ['*'], 'order' => [['issued_at', 'desc'], ['id', 'desc']], 'soft_delete' => false, ], 'extra_fee_templates' => [ 'type' => 'list', 'label' => '추가 배송비 템플릿 목록', 'table' => 'ecommerce_shipping_policy_extra_fee_templates', 'columns' => ['*'], 'order' => [['zipcode', 'asc'], ['id', 'asc']], 'soft_delete' => false, ], 'orders_screen' => [ 'type' => 'screen', 'label' => '관리자 주문 목록 화면', 'route' => 'api.modules.sirsoft-ecommerce.admin.orders.index', 'query' => ['per_page' => 20], 'permissions' => ['sirsoft-ecommerce.orders.read'], ], 'order_create' => [ 'type' => 'write', 'label' => '주문 생성 (임시 주문 → 주문 전환)', 'prepare' => [OrderCreationBenchmark::class, 'prepare'], 'callback' => [OrderCreationBenchmark::class, 'create'], ], ]; } /** * 무통장입금 입금 안내 알림 정의. * * 무통장입금(dbank) 주문 접수 직후 발송. 입금할 계좌·예금주·입금 기한과 함께 * 마일리지/예치금 차감 후 실제 입금 필요액(total_due_amount)을 안내한다. * 실제 발송 대상 분기(dbank + 입금 필요액 > 0)는 EcommerceNotificationDataListener 가 담당한다. */ private function orderPendingDepositDefinition(): array { return [ 'type' => 'order_pending_deposit', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '무통장 입금 안내', 'en' => 'Bank Transfer Payment Guide'], 'description' => ['ko' => '무통장입금 주문 접수 시 입금 계좌·금액을 고객에게 안내', 'en' => 'Sent to customer with deposit account and amount when a bank-transfer order is placed'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.order.after_create'], 'variables' => [ ['key' => 'name', 'description' => '수신자 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'order_number', 'description' => '주문번호'], ['key' => 'deposit_amount', 'description' => '입금 필요 금액 (마일리지/예치금 차감 후)'], ['key' => 'bank_name', 'description' => '입금 은행'], ['key' => 'account_number', 'description' => '입금 계좌번호'], ['key' => 'account_holder', 'description' => '예금주'], ['key' => 'depositor_name', 'description' => '입금자명'], ['key' => 'deposit_due_at', 'description' => '입금 기한'], ['key' => 'order_url', 'description' => '주문 상세 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'trigger_user']], 'subject' => [ 'ko' => '[{app_name}] 입금 안내 (주문번호: {order_number})', 'en' => '[{app_name}] Bank transfer guide (Order #{order_number})', ], 'body' => [ 'ko' => '
' .'

입금 안내

' .'

{name}님, 주문해 주셔서 감사합니다. 아래 계좌로 입금해 주시면 주문이 처리됩니다.

' .'
' .'

주문번호: {order_number}

' .'

입금 금액: {deposit_amount}

' .'

입금 은행: {bank_name}

' .'

계좌번호: {account_number}

' .'

예금주: {account_holder}

' .'

입금자명: {depositor_name}

' .'

입금 기한: {deposit_due_at}

' .'
' .'

입금 기한 내 미입금 시 주문이 자동 취소될 수 있습니다.

' .$this->notificationButton('주문 상세 보기', '{order_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

Bank Transfer Guide

' .'

Dear {name}, thank you for your order. Please transfer to the account below to complete your order.

' .'
' .'

Order Number: {order_number}

' .'

Amount to Deposit: {deposit_amount}

' .'

Bank: {bank_name}

' .'

Account Number: {account_number}

' .'

Account Holder: {account_holder}

' .'

Depositor Name: {depositor_name}

' .'

Due By: {deposit_due_at}

' .'
' .'

Your order may be cancelled automatically if payment is not received by the due date.

' .$this->notificationButton('View Order', '{order_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'trigger_user']], 'subject' => ['ko' => '입금 안내', 'en' => 'Bank Transfer Guide'], 'body' => [ 'ko' => '{name}님, 주문번호 {order_number}의 입금 금액은 {deposit_amount} 입니다. ({bank_name} {account_number})', 'en' => '{name}, the deposit amount for order {order_number} is {deposit_amount}. ({bank_name} {account_number})', ], 'click_url' => '{order_url}', ], ], ]; } /** * 소멸 예정 마일리지 알림 정의. */ private function mileageExpiringSoonDefinition(): array { return [ 'type' => 'mileage_expiring_soon', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '마일리지 소멸 예정', 'en' => 'Mileage Expiring Soon'], 'description' => ['ko' => '마일리지 소멸이 임박한 회원에게 발송', 'en' => 'Sent to members whose mileage is about to expire'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.mileage.notify_expiring'], 'variables' => [ ['key' => 'name', 'description' => '수신자 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'amount', 'description' => '소멸 예정 마일리지'], ['key' => 'currency', 'description' => '통화 코드'], ['key' => 'expires_date', 'description' => '소멸 예정일'], ['key' => 'balance', 'description' => '현재 사용 가능 잔액'], ['key' => 'mileage_url', 'description' => '마일리지 내역 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'trigger_user']], 'subject' => [ 'ko' => '[{app_name}] {amount}점의 마일리지가 곧 소멸됩니다', 'en' => '[{app_name}] {amount} mileage points are expiring soon', ], 'body' => [ 'ko' => '
' .'

마일리지 소멸 예정 안내

' .'

{name}님, 보유하신 마일리지 중 일부가 곧 소멸될 예정입니다.

' .'
' .'

소멸 예정 마일리지: {amount}점

' .'

소멸 예정일: {expires_date}

' .'

현재 잔액: {balance}점

' .'
' .'

소멸 전에 마일리지를 사용해 보세요.

' .$this->notificationButton('마일리지 내역 보기', '{mileage_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

Mileage Expiring Soon

' .'

Dear {name}, some of your mileage points are about to expire.

' .'
' .'

Expiring Mileage: {amount}

' .'

Expiry Date: {expires_date}

' .'

Current Balance: {balance}

' .'
' .'

Use your mileage before it expires.

' .$this->notificationButton('View Mileage', '{mileage_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'trigger_user']], 'subject' => ['ko' => '마일리지 소멸 예정 안내', 'en' => 'Mileage Expiring Soon'], 'body' => [ 'ko' => '{name}님, {amount}점의 마일리지가 {expires_date}에 소멸될 예정입니다.', 'en' => '{name}, {amount} mileage points will expire on {expires_date}.', ], 'click_url' => '{mileage_url}', ], ], ]; } /** * 주문 확인 알림 정의. */ private function orderConfirmedDefinition(): array { return [ 'type' => 'order_confirmed', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '결제 완료', 'en' => 'Payment Completed'], 'description' => ['ko' => '결제 완료 시 고객에게 발송', 'en' => 'Sent to customer when payment is completed'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.order.after_confirm'], 'variables' => [ ['key' => 'name', 'description' => '수신자 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'order_number', 'description' => '주문번호'], ['key' => 'total_amount', 'description' => '결제 금액'], ['key' => 'order_url', 'description' => '주문 상세 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ['key' => 'shipping_recipient_name', 'description' => '수취인 이름'], ['key' => 'shipping_country_name', 'description' => '배송국가명'], ['key' => 'shipping_address', 'description' => '배송지 주소'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'trigger_user']], 'subject' => [ 'ko' => '[{app_name}] 결제가 완료되었습니다 (주문번호: {order_number})', 'en' => '[{app_name}] Your payment has been completed (Order #{order_number})', ], 'body' => [ 'ko' => '
' .'

결제 완료

' .'

{name}님, 결제가 완료되었습니다. 주문해 주셔서 감사합니다.

' .'
' .'

주문번호: {order_number}

' .'

결제금액: {total_amount}

' .'

받는분: {shipping_recipient_name}

' .'

배송국가: {shipping_country_name}

' .'

배송지: {shipping_address}

' .'
' .'

주문 상세 내용은 아래 버튼을 클릭하여 확인하실 수 있습니다.

' .$this->notificationButton('주문 상세 보기', '{order_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

Payment Completed

' .'

Dear {name}, your payment has been completed. Thank you for your order.

' .'
' .'

Order Number: {order_number}

' .'

Total Amount: {total_amount}

' .'

Recipient: {shipping_recipient_name}

' .'

Shipping Country: {shipping_country_name}

' .'

Shipping Address: {shipping_address}

' .'
' .'

Click the button below to view your order details.

' .$this->notificationButton('View Order', '{order_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'trigger_user']], 'subject' => ['ko' => '결제가 완료되었습니다', 'en' => 'Your payment has been completed'], 'body' => ['ko' => '{name}님, 주문번호 {order_number}의 결제가 완료되었습니다.', 'en' => '{name}, payment for your order {order_number} has been completed.'], 'click_url' => '{order_url}', ], ], ]; } /** * 배송 시작 알림 정의. */ private function orderShippedDefinition(): array { return [ 'type' => 'order_shipped', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '배송 시작', 'en' => 'Order Shipped'], 'description' => ['ko' => '배송 시작 시 고객에게 발송', 'en' => 'Sent to customer when order is shipped'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.order.after_ship'], 'variables' => [ ['key' => 'name', 'description' => '수신자 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'order_number', 'description' => '주문번호'], ['key' => 'carrier_name', 'description' => '택배사 이름'], ['key' => 'tracking_number', 'description' => '운송장 번호'], ['key' => 'order_url', 'description' => '주문 상세 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ['key' => 'shipping_recipient_name', 'description' => '수취인 이름'], ['key' => 'shipping_country_name', 'description' => '배송국가명'], ['key' => 'shipping_address', 'description' => '배송지 주소'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'trigger_user']], 'subject' => [ 'ko' => '[{app_name}] 주문하신 상품이 발송되었습니다 (주문번호: {order_number})', 'en' => '[{app_name}] Your order has been shipped (Order #{order_number})', ], 'body' => [ 'ko' => '
' .'

배송 시작 안내

' .'

{name}님, 주문하신 상품이 발송되었습니다.

' .'
' .'

주문번호: {order_number}

' .'

택배사: {carrier_name}

' .'

운송장번호: {tracking_number}

' .'
' .'

주문 상세 및 배송 현황은 아래 버튼을 클릭하여 확인하실 수 있습니다.

' .$this->notificationButton('주문 상세 보기', '{order_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

Order Shipped

' .'

Dear {name}, your order has been shipped.

' .'
' .'

Order Number: {order_number}

' .'

Carrier: {carrier_name}

' .'

Tracking Number: {tracking_number}

' .'
' .'

Click the button below to view your order and tracking details.

' .$this->notificationButton('View Order', '{order_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'trigger_user']], 'subject' => ['ko' => '상품이 발송되었습니다', 'en' => 'Your order has been shipped'], 'body' => ['ko' => '{name}님, 주문번호 {order_number}이 {carrier_name}(송장번호: {tracking_number})으로 발송되었습니다.', 'en' => '{name}, your order {order_number} has been shipped via {carrier_name} (tracking: {tracking_number}).'], 'click_url' => '{order_url}', ], ], ]; } /** * 배송 완료 알림 정의. */ private function orderDeliveredDefinition(): array { return [ 'type' => 'order_delivered', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '배송 완료', 'en' => 'Order Delivered'], 'description' => ['ko' => '배송 완료 시 고객에게 발송', 'en' => 'Sent to customer when order is delivered'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.order.after_deliver'], 'variables' => [ ['key' => 'name', 'description' => '수신자 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'order_number', 'description' => '주문번호'], ['key' => 'carrier_name', 'description' => '택배사 이름'], ['key' => 'tracking_number', 'description' => '운송장 번호'], ['key' => 'order_url', 'description' => '주문 상세 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ['key' => 'shipping_recipient_name', 'description' => '수취인 이름'], ['key' => 'shipping_country_name', 'description' => '배송국가명'], ['key' => 'shipping_address', 'description' => '배송지 주소'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'trigger_user']], 'subject' => [ 'ko' => '[{app_name}] 주문하신 상품이 배송 완료되었습니다 (주문번호: {order_number})', 'en' => '[{app_name}] Your order has been delivered (Order #{order_number})', ], 'body' => [ 'ko' => '
' .'

배송 완료 안내

' .'

{name}님, 주문하신 상품의 배송이 완료되었습니다.

' .'
' .'

주문번호: {order_number}

' .'

택배사: {carrier_name}

' .'

운송장번호: {tracking_number}

' .'
' .'

상품을 확인하신 후 주문 상세에서 구매확정을 진행하실 수 있습니다.

' .$this->notificationButton('주문 상세 보기', '{order_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

Order Delivered

' .'

Dear {name}, your order has been delivered.

' .'
' .'

Order Number: {order_number}

' .'

Carrier: {carrier_name}

' .'

Tracking Number: {tracking_number}

' .'
' .'

After receiving your items, you can confirm your purchase from the order details.

' .$this->notificationButton('View Order', '{order_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'trigger_user']], 'subject' => ['ko' => '상품이 배송 완료되었습니다', 'en' => 'Your order has been delivered'], 'body' => ['ko' => '{name}님, 주문번호 {order_number}의 배송이 완료되었습니다.', 'en' => '{name}, your order {order_number} has been delivered.'], 'click_url' => '{order_url}', ], ], ]; } /** * 구매 확정 알림 정의. */ private function orderCompletedDefinition(): array { return [ 'type' => 'order_completed', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '구매 확정', 'en' => 'Order Completed'], 'description' => ['ko' => '구매 확정 시 고객에게 발송', 'en' => 'Sent to customer when order is completed'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.order.after_complete'], 'variables' => [ ['key' => 'name', 'description' => '수신자 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'order_number', 'description' => '주문번호'], ['key' => 'total_amount', 'description' => '결제 금액'], ['key' => 'order_url', 'description' => '주문 상세 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'trigger_user']], 'subject' => [ 'ko' => '[{app_name}] 구매가 확정되었습니다 (주문번호: {order_number})', 'en' => '[{app_name}] Your purchase has been completed (Order #{order_number})', ], 'body' => [ 'ko' => '
' .'

구매 확정 안내

' .'

{name}님, 구매가 확정되었습니다. 이용해 주셔서 감사합니다.

' .'
' .'

주문번호: {order_number}

' .'

결제금액: {total_amount}

' .'
' .'

주문 내역은 아래 버튼을 클릭하여 확인하실 수 있습니다.

' .$this->notificationButton('주문 내역 보기', '{order_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

Purchase Completed

' .'

Dear {name}, your purchase has been completed. Thank you for shopping with us.

' .'
' .'

Order Number: {order_number}

' .'

Total Amount: {total_amount}

' .'
' .'

Click the button below to view your order history.

' .$this->notificationButton('View Order', '{order_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'trigger_user']], 'subject' => ['ko' => '구매가 확정되었습니다', 'en' => 'Your purchase has been confirmed'], 'body' => ['ko' => '{name}님, 주문번호 {order_number}의 구매가 확정되었습니다.', 'en' => '{name}, your order {order_number} has been confirmed.'], 'click_url' => '{order_url}', ], ], ]; } /** * 주문 취소 알림 정의. */ private function orderCancelledDefinition(): array { return [ 'type' => 'order_cancelled', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '주문 취소', 'en' => 'Order Cancelled'], 'description' => ['ko' => '주문 취소 시 고객에게 발송', 'en' => 'Sent to customer when order is cancelled'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.order.after_cancel'], 'variables' => [ ['key' => 'name', 'description' => '수신자 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'order_number', 'description' => '주문번호'], ['key' => 'cancel_reason', 'description' => '취소 사유'], ['key' => 'order_url', 'description' => '주문 상세 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'trigger_user']], 'subject' => [ 'ko' => '[{app_name}] 주문이 취소되었습니다 (주문번호: {order_number})', 'en' => '[{app_name}] Your order has been cancelled (Order #{order_number})', ], 'body' => [ 'ko' => '
' .'

주문 취소 안내

' .'

{name}님, 주문이 취소되었습니다.

' .'
' .'

주문번호: {order_number}

' .'

취소 사유: {cancel_reason}

' .'
' .'

환불은 결제 수단에 따라 3~7영업일 이내에 처리됩니다. 주문 상세는 아래 버튼을 클릭하여 확인하실 수 있습니다.

' .$this->notificationButton('주문 상세 보기', '{order_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

Order Cancelled

' .'

Dear {name}, your order has been cancelled.

' .'
' .'

Order Number: {order_number}

' .'

Cancel Reason: {cancel_reason}

' .'
' .'

Refunds will be processed within 3-7 business days depending on your payment method. Click the button below to view your order details.

' .$this->notificationButton('View Order', '{order_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'trigger_user']], 'subject' => ['ko' => '주문이 취소되었습니다', 'en' => 'Your order has been cancelled'], 'body' => ['ko' => '{name}님, 주문번호 {order_number}이 취소되었습니다. 사유: {cancel_reason}', 'en' => '{name}, your order {order_number} has been cancelled. Reason: {cancel_reason}'], 'click_url' => '{order_url}', ], ], ]; } /** * 관리자 신규 주문 알림 정의. */ private function newOrderAdminDefinition(): array { return [ 'type' => 'new_order_admin', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '신규 주문 관리자 알림', 'en' => 'New Order Admin Notification'], 'description' => ['ko' => '신규 주문 접수 시 관리자에게 발송', 'en' => 'Sent to admin when a new order is placed'], 'channels' => ['mail', 'database'], // 발송 시점은 결제수단별로 다르다(아래 전용 훅으로 위임): // - 무통장/전액 비현금(0원) 주문: 주문 생성 시점(입금 전이라도 접수 알림 발송이 정상) // - 카드(PG) 주문: 결제완료 시점(주문 생성 시점은 pending_order 라 오발송 — 결제 미완료/이탈 가능) // OrderProcessingService 가 결제수단·결제완료 시점을 판단해 이 전용 훅을 1회 발화한다. 'hooks' => ['sirsoft-ecommerce.order.after_admin_notify'], 'variables' => [ ['key' => 'name', 'description' => '수신자(관리자) 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'order_number', 'description' => '주문번호'], ['key' => 'customer_name', 'description' => '주문자 이름'], ['key' => 'total_amount', 'description' => '결제 금액'], ['key' => 'order_url', 'description' => '주문 관리 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'role', 'value' => 'admin', 'exclude_trigger_user' => true]], 'subject' => [ 'ko' => '[{app_name}] 신규 주문이 접수되었습니다 (주문번호: {order_number})', 'en' => '[{app_name}] New order received (Order #{order_number})', ], 'body' => [ 'ko' => '
' .'

신규 주문 접수

' .'

{name}님, 새로운 주문이 접수되었습니다.

' .'
' .'

주문번호: {order_number}

' .'

주문자: {customer_name}

' .'

결제금액: {total_amount}

' .'
' .'

관리자 페이지에서 주문 상세를 확인해 주세요.

' .$this->notificationButton('주문 관리 바로가기', '{order_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

New Order Received

' .'

Dear {name}, a new order has been received.

' .'
' .'

Order Number: {order_number}

' .'

Customer: {customer_name}

' .'

Total Amount: {total_amount}

' .'
' .'

Please review the order details in the admin panel.

' .$this->notificationButton('Go to Order Management', '{order_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'role', 'value' => 'admin', 'exclude_trigger_user' => true]], 'subject' => ['ko' => '새로운 주문이 접수되었습니다', 'en' => 'New order received'], 'body' => ['ko' => '{customer_name}님이 주문번호 {order_number} (결제금액: {total_amount})을 접수했습니다.', 'en' => '{customer_name} placed order {order_number} (total: {total_amount}).'], 'click_url' => '{order_url}', ], ], ]; } /** * 상품 문의 접수 관리자 알림 정의. */ private function inquiryReceivedDefinition(): array { return [ 'type' => 'inquiry_received', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '상품 문의 접수', 'en' => 'Inquiry Received'], 'description' => ['ko' => '상품 문의 접수 시 관리자에게 발송', 'en' => 'Sent to admin when a product inquiry is received'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.product_inquiry.after_create'], 'variables' => [ ['key' => 'name', 'description' => '수신자(관리자) 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'product_name', 'description' => '상품명'], ['key' => 'customer_name', 'description' => '문의자 이름'], ['key' => 'inquiry_content', 'description' => '문의 내용 (요약)'], ['key' => 'inquiry_url', 'description' => '문의 관리 URL'], ['key' => 'site_url', 'description' => '사이트 URL'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'role', 'value' => 'admin', 'exclude_trigger_user' => true]], 'subject' => [ 'ko' => '[{app_name}] 새로운 상품 문의가 접수되었습니다', 'en' => '[{app_name}] New product inquiry received', ], 'body' => [ 'ko' => '
' .'

새 상품 문의 접수

' .'

{name}님, 새로운 상품 문의가 접수되었습니다.

' .'
' .'

상품명: {product_name}

' .'

문의자: {customer_name}

' .'

문의 내용: {inquiry_content}

' .'
' .'

관리자 페이지에서 문의 내용을 확인하고 답변해 주세요.

' .$this->notificationButton('문의 확인하기', '{inquiry_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

New Product Inquiry

' .'

Dear {name}, a new product inquiry has been received.

' .'
' .'

Product: {product_name}

' .'

Customer: {customer_name}

' .'

Inquiry: {inquiry_content}

' .'
' .'

Please review the inquiry and provide a response in the admin panel.

' .$this->notificationButton('View Inquiry', '{inquiry_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'role', 'value' => 'admin', 'exclude_trigger_user' => true]], 'subject' => ['ko' => '새로운 상품 문의가 접수되었습니다', 'en' => 'New product inquiry received'], 'body' => ['ko' => '{customer_name}님이 "{product_name}" 상품에 문의를 남겼습니다.', 'en' => '{customer_name} left an inquiry on "{product_name}".'], 'click_url' => '{inquiry_url}', ], ], ]; } /** * 문의 답변 완료 알림 정의. */ private function inquiryRepliedDefinition(): array { return [ 'type' => 'inquiry_replied', 'hook_prefix' => 'sirsoft-ecommerce', 'name' => ['ko' => '문의 답변 완료', 'en' => 'Inquiry Replied'], 'description' => ['ko' => '문의 답변 시 고객에게 발송', 'en' => 'Sent to customer when inquiry is replied'], 'channels' => ['mail', 'database'], 'hooks' => ['sirsoft-ecommerce.product_inquiry.after_reply'], 'variables' => [ ['key' => 'name', 'description' => '수신자(문의자) 이름'], ['key' => 'app_name', 'description' => '사이트 이름'], ['key' => 'product_name', 'description' => '상품명'], ['key' => 'inquiry_content', 'description' => '원래 문의 내용 (요약)'], ['key' => 'inquiry_url', 'description' => '문의 상세 URL (마이페이지)'], ['key' => 'site_url', 'description' => '사이트 URL'], ], 'templates' => [ [ 'channel' => 'mail', 'recipients' => [['type' => 'related_user', 'relation' => 'author']], 'subject' => [ 'ko' => '[{app_name}] 상품 문의에 답변이 등록되었습니다', 'en' => '[{app_name}] Your product inquiry has been answered', ], 'body' => [ 'ko' => '
' .'

문의 답변 안내

' .'

{name}님, 문의하신 내용에 답변이 등록되었습니다.

' .'
' .'

상품명: {product_name}

' .'

문의 내용: {inquiry_content}

' .'
' .'

아래 버튼을 클릭하여 답변 내용을 확인하세요.

' .$this->notificationButton('답변 확인하기', '{inquiry_url}') .'
' .'

본 메일은 {app_name}에서 발송되었습니다.

' .'
', 'en' => '
' .'

Inquiry Answered

' .'

Dear {name}, your product inquiry has been answered.

' .'
' .'

Product: {product_name}

' .'

Your Inquiry: {inquiry_content}

' .'
' .'

Click the button below to view the response.

' .$this->notificationButton('View Response', '{inquiry_url}') .'
' .'

This email was sent from {app_name}.

' .'
', ], ], [ 'channel' => 'database', 'recipients' => [['type' => 'related_user', 'relation' => 'author']], 'subject' => ['ko' => '문의 답변이 등록되었습니다', 'en' => 'Your inquiry has been answered'], 'body' => ['ko' => '{name}님, "{product_name}" 상품 문의에 답변이 등록되었습니다.', 'en' => '{name}, your inquiry on "{product_name}" has been answered.'], 'click_url' => '{inquiry_url}', ], ], ]; } /** * 이메일용 CTA 버튼 HTML 을 반환합니다. * * @param string $text 버튼 텍스트 * @param string $url 버튼 링크 * @return string 인라인 스타일 버튼 HTML */ private function notificationButton(string $text, string $url): string { return '
' .''.$text.'' .'
'; } /** * 훅 리스너 목록 반환 */ public function getHookListeners(): array { return [ SyncProductFromOptionListener::class, SyncOptionGroupsListener::class, ProductActivityLogListener::class, OrderActivityLogListener::class, CouponActivityLogListener::class, ShippingPolicyActivityLogListener::class, CategoryActivityLogListener::class, EcommerceAdminActivityLogListener::class, EcommerceUserActivityLogListener::class, ActivityLogDescriptionResolver::class, MergeCartOnLoginListener::class, ProductInquiryBoardListener::class, SearchProductsListener::class, CouponRestoreListener::class, CouponUseListener::class, SeoProductCacheListener::class, SeoCategoryCacheListener::class, CategoryTreeCacheListener::class, SeoSettingsCacheListener::class, ShippingPolicyCacheListener::class, MileageTransactionListener::class, UserMileageInfoListener::class, UserCurrencyInfoListener::class, UserShippingCountryInfoListener::class, AssignDefaultCurrencyOnRegisterListener::class, AssignDefaultShippingCountryOnRegisterListener::class, UserMileageCleanupListener::class, EcommerceNotificationDataListener::class, OrderStatusNotificationListener::class, InjectAppConfigDeviceListener::class, IssueCashReceiptOnDepositListener::class, PurgeCashReceiptIdentifierListener::class, Ckeditor5ReferenceSourcesListener::class, ]; } /** * 스케줄 작업 목록 반환 * * 모듈에서 등록하는 스케줄 작업 목록입니다. * 코어에서 이 메서드를 호출하여 모듈 스케줄러를 등록합니다. * * @return array 스케줄 작업 배열 * [ * [ * 'command' => 'artisan:command', * 'schedule' => 'daily' | 'hourly' | 'everyMinute' | 'weekly' | cron expression, * 'description' => '작업 설명 (선택)', * 'enabled_config' => 'config.key' (선택, 설정에 따라 활성화 여부 결정), * ], * ] */ public function getSchedules(): array { return [ [ 'command' => 'sirsoft-ecommerce:cancel-pending-orders', 'schedule' => 'daily', 'description' => '입금 기한 만료 주문 자동 취소', 'enabled_config' => 'sirsoft-ecommerce.order_settings.auto_cancel_expired', ], [ 'command' => 'sirsoft-ecommerce:prune-expired-carts', 'schedule' => 'daily', 'description' => '보관기간 만료 장바구니 자동 삭제', // cart_expiry_days < 1 시 커맨드 내부 self-guard 로 비활성 (별도 토글 없음) 'enabled_config' => null, ], [ 'command' => 'sirsoft-ecommerce:prune-temp-product-images', 'schedule' => 'daily', 'description' => '미연결 임시 상품 이미지 자동 삭제', // temp_key 가 남아 있으면 끝내 연결되지 않은 폼 세션 부산물이라 오탐 여지가 없다. // 운영 데이터가 아니므로 별도 토글 없이 상시 동작한다 (보존기간은 커맨드 옵션). 'enabled_config' => null, ], [ 'command' => 'sirsoft-ecommerce:prune-temp-orders', 'schedule' => 'hourly', 'description' => '만료 임시 주문 자동 삭제', // 만료 판정은 임시 주문 자체의 TTL 이 정하므로 별도 토글 없음 'enabled_config' => null, ], [ 'command' => 'sirsoft-ecommerce:earn-mileage', 'schedule' => 'hourly', 'description' => '지연 마일리지 적립', 'enabled_config' => 'sirsoft-ecommerce.mileage.enabled', ], [ 'command' => 'sirsoft-ecommerce:expire-mileage', 'schedule' => 'daily', 'description' => '마일리지 자동 소멸', 'enabled_config' => 'sirsoft-ecommerce.mileage.expiry_enabled', ], [ 'command' => 'sirsoft-ecommerce:notify-expiring-mileage', 'schedule' => 'daily', 'description' => '소멸 예정 마일리지 알림', 'enabled_config' => 'sirsoft-ecommerce.mileage.expiry_notification_enabled', ], [ 'command' => 'sirsoft-ecommerce:reconcile-mileage-balance', 'schedule' => 'daily', 'description' => '마일리지 잔액 캐시 정합 교정', 'enabled_config' => 'sirsoft-ecommerce.mileage.enabled', ], [ 'command' => 'sirsoft-ecommerce:aggregate-stats', 'schedule' => 'hourly', 'description' => '대시보드 판매 현황 집계', 'enabled_config' => 'sirsoft-ecommerce.dashboard.scheduler_enabled', ], ]; } /** * 이 모듈이 등록할 HTTP 미들웨어 선언을 반환합니다. * * 코어 self-gate 게이트가 요청 시점에 targets 패턴 매칭으로 실행합니다. * * - DetectDevice: 무명 User SSR 셸 catch-all(routes/web.php)에 라우트명이 없어 URI 패턴 '/' 로 * 타게팅(모든 web 요청 = 기존 web 그룹 append 와 동등). InjectAppConfigDeviceListener 가 * appConfig.isIos 로 주입(체크아웃 애플페이 iOS 게이팅). * - ResolveShippingCountry: 상품/장바구니/체크아웃/주문생성 라우트에만 부착 (배송국가 해석). * - VerifyGuestOrderToken: 비회원 주문 후속 액션 라우트에 부착 (취소·환불예상·배송지수정·구매확정 * 개별 지정 + 현금영수증 하위 전체 glob). `guest.orders.verify` 는 조회 토큰을 **발급**하는 * 엔드포인트라 호출 시점에 토큰이 없다 — 부착하면 최초 인증 요청이 404 로 막혀 비회원 조회가 * 통째로 죽으므로 제외한다(요청 빈도 제한은 throttle 과 GuestOrderAuthService 의 실패 잠금 담당). * 부착 대상 개수를 이 주석에 적지 않는다 — 개수를 문서에 박는 것이 다음 누락의 씨앗이다 * (실제로 현금영수증 라우트 2건이 추가될 때 targets 갱신이 누락돼 기능이 전면 불능이었다). * 정합성은 `GuestOrderTokenMiddlewareRegistrationTest` 가 라우트 테이블 전수로 강제한다. * * @return array, timing?: string, targets: array}> */ public function getMiddleware(): array { return [ [ 'class' => DetectDevice::class, 'groups' => ['web'], 'targets' => ['/'], ], [ 'class' => ResolveShippingCountry::class, 'groups' => ['api'], 'targets' => [ 'api.modules.sirsoft-ecommerce.products.*', 'api.modules.sirsoft-ecommerce.cart.*', 'api.modules.sirsoft-ecommerce.checkout.*', 'api.modules.sirsoft-ecommerce.user.orders.store', ], ], [ 'class' => VerifyGuestOrderToken::class, 'groups' => ['api'], 'targets' => [ 'api.modules.sirsoft-ecommerce.guest.orders.cancel', 'api.modules.sirsoft-ecommerce.guest.orders.estimate-refund', 'api.modules.sirsoft-ecommerce.guest.orders.update-shipping-address', 'api.modules.sirsoft-ecommerce.guest.orders.confirm-option', // 현금영수증 하위 전체(show/issue/향후 추가분). glob 은 이 서브트리의 기본값을 // '보호' 로 만들어 실패 방향을 안전한 쪽으로 뒤집는다. `cash-receipt` 가 리터럴 // 세그먼트라 구조적으로 `verify` 와 매칭될 수 없다. 'api.modules.sirsoft-ecommerce.guest.orders.cash-receipt.*', ], ], ]; } /** * SEO 변수 메타데이터 정의 * * 이커머스 모듈이 SEO 렌더링에 제공하는 변수를 page_type별로 선언합니다. * * @return array page_type별 변수 정의 배열 */ public function seoVariables(): array { return [ '_common' => [ 'commerce_name' => [ 'description' => '쇼핑몰명', 'source' => 'setting', 'key' => 'basic_info.shop_name', ], ], 'product' => [ 'product_name' => [ 'description' => '상품명', 'source' => 'data', 'required' => true, ], 'product_description' => [ 'description' => '상품 설명', 'source' => 'data', ], ], 'category' => [ 'category_name' => [ 'description' => '카테고리명', 'source' => 'data', 'required' => true, ], 'category_description' => [ 'description' => '카테고리 설명', 'source' => 'data', ], ], 'search' => [ 'keyword_name' => [ 'description' => '검색 키워드', 'source' => 'query', 'key' => 'q', ], ], 'shop_index' => [], ]; } /** * 페이지 타입별 OG 메타태그 기본값 선언 * * 이커머스 도메인 데이터로부터 og:type=product, og:image, image_alt, * 그리고 og:product:price:amount/currency 같은 도메인별 OG 부속 태그를 직접 제공. * 레이아웃 meta.seo.og 가 같은 키를 선언하면 그쪽이 우선 (override). * * @param string $pageType 페이지 타입 ('product', 'category', 'search', 'shop_index') * @param array $context 데이터 컨텍스트 * @param array $routeParams 라우트 파라미터 * @return array OG 데이터 */ public function seoOgDefaults(string $pageType, array $context, array $routeParams = []): array { if ($pageType === 'product') { $product = data_get($context, 'product.data', []); // 다국어 JSON array (MariaDB 환경 등) 자동 변환 $name = $this->resolveLocalizedValue($product['name'] ?? ''); $price = $product['selling_price'] ?? null; $extra = []; if ($price !== null && $price !== '') { $extra[] = ['property' => 'product:price:amount', 'content' => $this->resolveLocalizedValue($price)]; $extra[] = ['property' => 'product:price:currency', 'content' => 'KRW']; } if (! empty($product['sku'])) { $extra[] = ['property' => 'product:retailer_item_id', 'content' => $this->resolveLocalizedValue($product['sku'])]; } // 절대 URL 변환 — 슬랙/페이스북/쓰레드는 og:image 가 절대 URL 이어야 인식. // ProductImage::download_url 은 "/api/..." 상대 경로 형식이므로 url() 통과 필수. $imageRaw = $this->resolveLocalizedValue($product['thumbnail_url'] ?? ''); $image = $imageRaw !== '' ? (str_starts_with($imageRaw, 'http') ? $imageRaw : url($imageRaw)) : ''; // thumbnail_width/height 는 어떤 Resource 도 방출하지 않는 死키였다 — 값 공급이 // 불가능한 축이므로 제거하고 크기 메타는 코어 기본값 폴백에 맡긴다 (공개 #22 부수 정리) return array_filter([ 'type' => 'product', 'image' => $image, 'image_alt' => $name, 'extra' => $extra, ], fn ($v) => $v !== null && $v !== '' && $v !== []); } if ($pageType === 'category') { $category = data_get($context, 'category.data', []); $catImageRaw = $this->resolveLocalizedValue($category['thumbnail_url'] ?? ''); $catImage = $catImageRaw !== '' ? (str_starts_with($catImageRaw, 'http') ? $catImageRaw : url($catImageRaw)) : ''; return array_filter([ 'type' => 'website', 'image' => $catImage, 'image_alt' => $this->resolveLocalizedValue($category['name'] ?? ''), ], fn ($v) => $v !== null && $v !== ''); } return []; } /** * 페이지 타입별 JSON-LD 구조화 데이터 선언 * * 이커머스 도메인 스키마(Product/Offer/AggregateRating)를 모듈이 직접 owned. * 레이아웃 meta.seo.structured_data 가 비어있을 때 적용. * * @param string $pageType 페이지 타입 * @param array $context 데이터 컨텍스트 * @param array $routeParams 라우트 파라미터 * @return array Schema.org 형식 */ public function seoStructuredData(string $pageType, array $context, array $routeParams = []): array { if ($pageType !== 'product') { return []; } $product = data_get($context, 'product.data', []); if (empty($product)) { return []; } // 다국어 JSON array (MariaDB 환경 등) 자동 변환 $schema = [ '@type' => 'Product', 'name' => $this->resolveLocalizedValue($product['name'] ?? ''), ]; $description = $this->resolveLocalizedValue($product['short_description'] ?? $product['description'] ?? ''); if ($description !== '') { $schema['description'] = $description; } // 절대 URL 변환 (Schema.org image 도 검색엔진이 절대 URL 권장) $imageRaw = $this->resolveLocalizedValue($product['thumbnail_url'] ?? ''); if ($imageRaw !== '') { $schema['image'] = str_starts_with($imageRaw, 'http') ? $imageRaw : url($imageRaw); } if (! empty($product['sku'])) { $schema['sku'] = $this->resolveLocalizedValue($product['sku']); } $price = $product['selling_price'] ?? null; if ($price !== null && $price !== '') { // 재고 가능 여부 = 판매 상태(sales_status). ProductResource 가 'in_stock' 키를 만들지 // 않으므로(실제 키: sales_status enum value + stock_quantity) 종전 in_stock 참조는 항상 // 빈값이라 모든 상품이 OutOfStock 으로 출력되던 결함을 sales_status 기준으로 수정. $salesStatus = (string) $this->resolveLocalizedValue($product['sales_status'] ?? ''); $inStock = $salesStatus === 'on_sale'; $schema['offers'] = [ '@type' => 'Offer', 'price' => $this->resolveLocalizedValue($price), 'priceCurrency' => 'KRW', 'availability' => $inStock ? 'https://schema.org/InStock' : 'https://schema.org/OutOfStock', ]; } $rating = data_get($context, 'reviews.data.rating_stats.avg'); $reviewCount = data_get($context, 'reviews.data.reviews.total'); if ($rating !== null && $rating !== '' && $reviewCount !== null && (int) $reviewCount > 0) { $schema['aggregateRating'] = [ '@type' => 'AggregateRating', 'ratingValue' => $this->resolveLocalizedValue($rating), 'reviewCount' => (string) (int) $reviewCount, 'bestRating' => '5', 'worstRating' => '1', ]; } return $schema; } /** * OG 기본값 키별 데이터 출처(연결 칩) 메타 선언 — 편집기 전용 * * seoOgDefaults() 가 resolve 해 반환하는 평문값이 **어느 상품/카테고리 데이터에서 왔는지**를 * 편집기 [검색엔진] 탭이 "상품 대표 이미지"·"상품 이름" 같은 연결 칩으로 보여주고 교체할 수 * 있도록, 키별 데이터 경로(표현식)와 사용자용 라벨을 제공합니다. 데이터 경로가 1:1 로 단순한 * 키만 선언합니다(파생값 type/extra 는 제외 — 편집기는 평문 폴백). * * @param string $pageType 페이지 타입 * @return array}> 키별 데이터 경로 메타 */ public function seoOgDefaultMeta(string $pageType): array { // label 은 번역 키 — 번들 언어팩(ja 등)이 같은 키를 번역하면 추가 언어에 자동 대응(편집기가 __() 해석). if ($pageType === 'product') { return [ 'image' => ['expr' => '{{product.data.thumbnail_url}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.product_image'], 'image_alt' => ['expr' => '{{product.data.name}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.product_name'], ]; } if ($pageType === 'category') { return [ 'image' => ['expr' => '{{category.data.thumbnail_url}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.category_image'], 'image_alt' => ['expr' => '{{category.data.name}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.category_name'], ]; } return []; } /** * 구조화 데이터 속성별 데이터 출처(연결 칩) 메타 선언 — 편집기 전용 * * seoStructuredData() 의 중첩 객체를 점 경로 키로 평탄화한 기준으로 선언합니다(예: offers.price). * 파생값(offers.availability·aggregateRating.* 등)은 단순 경로가 아니라 제외합니다(평문 폴백). * * @param string $pageType 페이지 타입 * @return array}> 점 경로 키별 데이터 경로 메타 */ public function seoStructuredDataMeta(string $pageType): array { if ($pageType !== 'product') { return []; } // SEO 제목/설명은 사용자 입력 meta(다국어) 우선, 비어있으면 상품명/설명(다국어)으로 폴백. // $localized() 로 현재 로케일 문자열을 추출하여 언어별 SEO 분기를 지원한다. return [ 'name' => ['expr' => '{{$localized(product.data.meta_title) ?? $localized(product.data.name)}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.product_name'], 'description' => ['expr' => '{{$localized(product.data.meta_description) ?? $localized(product.data.short_description)}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.product_description'], 'image' => ['expr' => '{{product.data.thumbnail_url}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.product_image'], 'sku' => ['expr' => '{{product.data.sku}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.product_sku'], 'offers.price' => ['expr' => '{{product.data.selling_price}}', 'label' => 'sirsoft-ecommerce::seo.auto_value.product_price'], ]; } /** * 관리자 메뉴 정의 */ public function getAdminMenus(): array { return [ [ 'name' => [ 'ko' => '이커머스', 'en' => 'Ecommerce', ], 'slug' => 'sirsoft-ecommerce', 'url' => null, 'icon' => 'fas fa-shopping-cart', 'order' => 40, 'children' => [ [ 'name' => [ 'ko' => '환경설정', 'en' => 'Settings', ], 'slug' => 'sirsoft-ecommerce-settings', 'url' => '/admin/ecommerce/settings', 'icon' => 'fas fa-cog', 'order' => 1, 'permission' => 'sirsoft-ecommerce.settings.read', ], [ 'name' => [ 'ko' => '상품 관리', 'en' => 'Products', ], 'slug' => 'sirsoft-ecommerce-products', 'url' => '/admin/ecommerce/products', 'icon' => 'fas fa-box', 'order' => 2, 'permission' => 'sirsoft-ecommerce.products.read', ], [ 'name' => [ 'ko' => '카테고리 관리', 'en' => 'Categories', ], 'slug' => 'sirsoft-ecommerce-categories', 'url' => '/admin/ecommerce/categories', 'icon' => 'fas fa-folder', 'order' => 3, 'permission' => 'sirsoft-ecommerce.categories.read', ], [ 'name' => [ 'ko' => '브랜드 관리', 'en' => 'Brands', ], 'slug' => 'sirsoft-ecommerce-brands', 'url' => '/admin/ecommerce/brands', 'icon' => 'fas fa-tag', 'order' => 4, 'permission' => 'sirsoft-ecommerce.brands.read', ], [ 'name' => [ 'ko' => '상품정보제공고시', 'en' => 'Product Notice', ], 'slug' => 'sirsoft-ecommerce-product-notices', 'url' => '/admin/ecommerce/product-notices', 'icon' => 'fas fa-file-alt', 'order' => 5, 'permission' => 'sirsoft-ecommerce.product-notice-templates.read', ], [ 'name' => [ 'ko' => '공통정보 관리', 'en' => 'Common Info', ], 'slug' => 'sirsoft-ecommerce-common-info', 'url' => '/admin/ecommerce/common-info', 'icon' => 'fas fa-info-circle', 'order' => 6, 'permission' => 'sirsoft-ecommerce.product-common-infos.read', ], [ 'name' => [ 'ko' => '주문 관리', 'en' => 'Orders', ], 'slug' => 'sirsoft-ecommerce-orders', 'url' => '/admin/ecommerce/orders', 'icon' => 'fas fa-receipt', 'order' => 7, 'permission' => 'sirsoft-ecommerce.orders.read', ], [ 'name' => [ 'ko' => '쿠폰 관리', 'en' => 'Coupons', ], 'slug' => 'sirsoft-ecommerce-promotion-coupons', 'url' => '/admin/ecommerce/promotion-coupons', 'icon' => 'fas fa-ticket-alt', 'order' => 8, 'permission' => 'sirsoft-ecommerce.promotion-coupon.read', ], [ 'name' => [ 'ko' => '배송정책', 'en' => 'Shipping Policies', ], 'slug' => 'sirsoft-ecommerce-shipping-policies', 'url' => '/admin/ecommerce/shipping-policies', 'icon' => 'fas fa-truck', 'order' => 9, 'permission' => 'sirsoft-ecommerce.shipping-policies.read', ], [ 'name' => [ 'ko' => '리뷰 관리', 'en' => 'Reviews', ], 'slug' => 'sirsoft-ecommerce-reviews', 'url' => '/admin/ecommerce/reviews', 'icon' => 'fas fa-star', 'order' => 10, 'permission' => 'sirsoft-ecommerce.reviews.read', ], [ 'name' => [ 'ko' => '마일리지 내역', 'en' => 'Mileage History', ], 'slug' => 'sirsoft-ecommerce-mileage-transactions', 'url' => '/admin/ecommerce/mileage-transactions', 'icon' => 'fas fa-coins', 'order' => 11, 'permission' => 'sirsoft-ecommerce.mileage.read', ], ], ], ]; } }