gper/Gnuboard7
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
acdff537928747be7c591382a3727d5cf80ac871
Gnuboard7/modules/_bundled/sirsoft-ecommerce/module.php
T
HeuJung 1ba67ca7cf feat(content): 본문 이미지 목록 썸네일·og:image 폴백 전 티어 구현 
공개 이슈 https://github.com/gnuboard/g7/issues/22 — 본문에 삽입한 이미지가
카드/갤러리 목록 썸네일과 공유 미리보기(og:image)에 반영되지 않던 공백을
코어+3모듈+2템플릿에서 해소.

- 코어 7.0.9: HtmlImageExtractor(내부 이미지 한정, origin 정규화 SSoT 재사용)
 + seo.og_image_default 사이트 기본 공유 이미지 설정 + SeoMetaResolver 폴백 체인
- board 1.1.0 / ecommerce 1.2.0 / page 1.1.0: content_thumbnail_url 캐시 컬럼,
 saving 추출(html 모드 한정·첨부 우선·비밀글 게이트 유지),
 filter_content_thumbnail 훅, 기존 데이터 백필 업그레이드 스텝
- ecommerce 카테고리 og:image 생산자 신설, page og:description 死키 정정
- sirsoft-basic 1.1.2 og 바인딩 정정, admin_basic 1.0.7 SEO 탭 업로더(+ja 팩 2종)
- 검수 중 발견한 text 모드 오캐시 결함은 실패 테스트 선행 후 수정
2026-08-22 22:21:54 +09:00

2670 lines
140 KiB
PHP
Raw Blame History

<?php
namespace Modules\Sirsoft\Ecommerce;
use App\Extension\AbstractModule;
use App\Models\IdentityMessageDefinition;
use App\Seo\Concerns\LocalizesSeoValues;
use Illuminate\Database\Seeder;
use Modules\Sirsoft\Ecommerce\Benchmark\OrderCreationBenchmark;
use Modules\Sirsoft\Ecommerce\Database\Seeders\ClaimReasonSeeder;
use Modules\Sirsoft\Ecommerce\Database\Seeders\SequenceSeeder;
use Modules\Sirsoft\Ecommerce\Database\Seeders\ShippingCarrierSeeder;
use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
use Modules\Sirsoft\Ecommerce\Http\Middleware\DetectDevice;
use Modules\Sirsoft\Ecommerce\Http\Middleware\ResolveShippingCountry;
use Modules\Sirsoft\Ecommerce\Http\Middleware\VerifyGuestOrderToken;
use Modules\Sirsoft\Ecommerce\Listeners\ActivityLogDescriptionResolver;
use Modules\Sirsoft\Ecommerce\Listeners\AssignDefaultCurrencyOnRegisterListener;
use Modules\Sirsoft\Ecommerce\Listeners\AssignDefaultShippingCountryOnRegisterListener;
use Modules\Sirsoft\Ecommerce\Listeners\CategoryActivityLogListener;
use Modules\Sirsoft\Ecommerce\Listeners\CategoryTreeCacheListener;
use Modules\Sirsoft\Ecommerce\Listeners\Ckeditor5ReferenceSourcesListener;
use Modules\Sirsoft\Ecommerce\Listeners\CouponActivityLogListener;
use Modules\Sirsoft\Ecommerce\Listeners\CouponRestoreListener;
use Modules\Sirsoft\Ecommerce\Listeners\CouponUseListener;
use Modules\Sirsoft\Ecommerce\Listeners\EcommerceAdminActivityLogListener;
use Modules\Sirsoft\Ecommerce\Listeners\EcommerceNotificationDataListener;
use Modules\Sirsoft\Ecommerce\Listeners\EcommerceUserActivityLogListener;
use Modules\Sirsoft\Ecommerce\Listeners\InjectAppConfigDeviceListener;
use Modules\Sirsoft\Ecommerce\Listeners\IssueCashReceiptOnDepositListener;
use Modules\Sirsoft\Ecommerce\Listeners\MergeCartOnLoginListener;
use Modules\Sirsoft\Ecommerce\Listeners\MileageTransactionListener;
use Modules\Sirsoft\Ecommerce\Listeners\OrderActivityLogListener;
use Modules\Sirsoft\Ecommerce\Listeners\OrderStatusNotificationListener;
use Modules\Sirsoft\Ecommerce\Listeners\ProductActivityLogListener;
use Modules\Sirsoft\Ecommerce\Listeners\ProductInquiryBoardListener;
use Modules\Sirsoft\Ecommerce\Listeners\PurgeCashReceiptIdentifierListener;
use Modules\Sirsoft\Ecommerce\Listeners\SearchProductsListener;
use Modules\Sirsoft\Ecommerce\Listeners\SeoCategoryCacheListener;
use Modules\Sirsoft\Ecommerce\Listeners\SeoProductCacheListener;
use Modules\Sirsoft\Ecommerce\Listeners\SeoSettingsCacheListener;
use Modules\Sirsoft\Ecommerce\Listeners\ShippingPolicyActivityLogListener;
use Modules\Sirsoft\Ecommerce\Listeners\ShippingPolicyCacheListener;
use Modules\Sirsoft\Ecommerce\Listeners\SyncOptionGroupsListener;
use Modules\Sirsoft\Ecommerce\Listeners\SyncProductFromOptionListener;
use Modules\Sirsoft\Ecommerce\Listeners\UserCurrencyInfoListener;
use Modules\Sirsoft\Ecommerce\Listeners\UserMileageCleanupListener;
use Modules\Sirsoft\Ecommerce\Listeners\UserMileageInfoListener;
use Modules\Sirsoft\Ecommerce\Listeners\UserShippingCountryInfoListener;
use Modules\Sirsoft\Ecommerce\Repositories\OrderRepository;
class Module extends AbstractModule
{
use LocalizesSeoValues;
/**
* 모듈 역할 정의
* 모듈 설치 시 자동 생성됨
*/
public function getRoles(): array
{
return [
[
'identifier' => '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<string>
*/
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<class-string<Seeder>> 시더 클래스명 배열 (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<int, array<string, mixed>>
*/
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<string, array<string, mixed>>
*/
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<int, array<string, mixed>>
*/
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' => '<h1>결제 본인 확인</h1>'
.'<p>결제를 진행하기 위해 본인 확인이 필요합니다. 아래 인증 코드를 입력해 주세요.</p>'
.'<p style="font-size:28px; font-weight:bold; letter-spacing:4px; text-align:center; padding:16px; background:#f4f6f8; border-radius:6px;">{code}</p>'
.'<p>이 코드는 <strong>{expire_minutes}분</strong> 후 만료됩니다.</p>'
.'<p><strong>본인이 결제를 진행하지 않았다면 이 메일을 무시하고 즉시 비밀번호를 변경해 주세요.</strong></p>'
.'<p>감사합니다,<br><a href="{site_url}">{app_name}</a></p>',
'en' => '<h1>Checkout Verification</h1>'
.'<p>Please enter the code below to proceed with payment.</p>'
.'<p style="font-size:28px; font-weight:bold; letter-spacing:4px; text-align:center; padding:16px; background:#f4f6f8; border-radius:6px;">{code}</p>'
.'<p>This code will expire in <strong>{expire_minutes} minutes</strong>.</p>'
.'<p><strong>If you did not initiate this payment, please ignore this email and change your password immediately.</strong></p>'
.'<p>Thank you,<br><a href="{site_url}">{app_name}</a></p>',
],
],
],
],
];
}
/**
* 이커머스 모듈이 등록할 알림 정의.
*
* AbstractModule 계약에 따라 ModuleManager 가 activate/update 시 자동으로
* NotificationSyncHelper 를 통해 동기화하며, uninstall(deleteData=true) 시 정리합니다.
* 운영자가 관리자 UI 에서 수정한 필드는 user_overrides JSON 에 보존됩니다.
*
* `extension_type`/`extension_identifier` 는 Manager 가 자동 주입.
*
* @return array<int, array<string, mixed>>
*/
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<string, array<string, mixed>> 프로파일 키 → 정의
*/
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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">입금 안내</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 주문해 주셔서 감사합니다. 아래 계좌로 입금해 주시면 주문이 처리됩니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>주문번호:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>입금 금액:</strong> {deposit_amount}</p>'
.'<p style="margin:5px 0"><strong>입금 은행:</strong> {bank_name}</p>'
.'<p style="margin:5px 0"><strong>계좌번호:</strong> {account_number}</p>'
.'<p style="margin:5px 0"><strong>예금주:</strong> {account_holder}</p>'
.'<p style="margin:5px 0"><strong>입금자명:</strong> {depositor_name}</p>'
.'<p style="margin:5px 0"><strong>입금 기한:</strong> {deposit_due_at}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">입금 기한 내 미입금 시 주문이 자동 취소될 수 있습니다.</p>'
.$this->notificationButton('주문 상세 보기', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">Bank Transfer Guide</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, thank you for your order. Please transfer to the account below to complete your order.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Order Number:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>Amount to Deposit:</strong> {deposit_amount}</p>'
.'<p style="margin:5px 0"><strong>Bank:</strong> {bank_name}</p>'
.'<p style="margin:5px 0"><strong>Account Number:</strong> {account_number}</p>'
.'<p style="margin:5px 0"><strong>Account Holder:</strong> {account_holder}</p>'
.'<p style="margin:5px 0"><strong>Depositor Name:</strong> {depositor_name}</p>'
.'<p style="margin:5px 0"><strong>Due By:</strong> {deposit_due_at}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Your order may be cancelled automatically if payment is not received by the due date.</p>'
.$this->notificationButton('View Order', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">마일리지 소멸 예정 안내</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 보유하신 마일리지 중 일부가 곧 소멸될 예정입니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>소멸 예정 마일리지:</strong> {amount}점</p>'
.'<p style="margin:5px 0"><strong>소멸 예정일:</strong> {expires_date}</p>'
.'<p style="margin:5px 0"><strong>현재 잔액:</strong> {balance}점</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">소멸 전에 마일리지를 사용해 보세요.</p>'
.$this->notificationButton('마일리지 내역 보기', '{mileage_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">Mileage Expiring Soon</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, some of your mileage points are about to expire.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Expiring Mileage:</strong> {amount}</p>'
.'<p style="margin:5px 0"><strong>Expiry Date:</strong> {expires_date}</p>'
.'<p style="margin:5px 0"><strong>Current Balance:</strong> {balance}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Use your mileage before it expires.</p>'
.$this->notificationButton('View Mileage', '{mileage_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">결제 완료</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 결제가 완료되었습니다. 주문해 주셔서 감사합니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>주문번호:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>결제금액:</strong> {total_amount}</p>'
.'<p style="margin:5px 0"><strong>받는분:</strong> {shipping_recipient_name}</p>'
.'<p style="margin:5px 0"><strong>배송국가:</strong> {shipping_country_name}</p>'
.'<p style="margin:5px 0"><strong>배송지:</strong> {shipping_address}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">주문 상세 내용은 아래 버튼을 클릭하여 확인하실 수 있습니다.</p>'
.$this->notificationButton('주문 상세 보기', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">Payment Completed</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, your payment has been completed. Thank you for your order.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Order Number:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>Total Amount:</strong> {total_amount}</p>'
.'<p style="margin:5px 0"><strong>Recipient:</strong> {shipping_recipient_name}</p>'
.'<p style="margin:5px 0"><strong>Shipping Country:</strong> {shipping_country_name}</p>'
.'<p style="margin:5px 0"><strong>Shipping Address:</strong> {shipping_address}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Click the button below to view your order details.</p>'
.$this->notificationButton('View Order', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">배송 시작 안내</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 주문하신 상품이 발송되었습니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>주문번호:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>택배사:</strong> {carrier_name}</p>'
.'<p style="margin:5px 0"><strong>운송장번호:</strong> {tracking_number}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">주문 상세 및 배송 현황은 아래 버튼을 클릭하여 확인하실 수 있습니다.</p>'
.$this->notificationButton('주문 상세 보기', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">Order Shipped</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, your order has been shipped.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Order Number:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>Carrier:</strong> {carrier_name}</p>'
.'<p style="margin:5px 0"><strong>Tracking Number:</strong> {tracking_number}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Click the button below to view your order and tracking details.</p>'
.$this->notificationButton('View Order', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">배송 완료 안내</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 주문하신 상품의 배송이 완료되었습니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>주문번호:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>택배사:</strong> {carrier_name}</p>'
.'<p style="margin:5px 0"><strong>운송장번호:</strong> {tracking_number}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">상품을 확인하신 후 주문 상세에서 구매확정을 진행하실 수 있습니다.</p>'
.$this->notificationButton('주문 상세 보기', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">Order Delivered</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, your order has been delivered.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Order Number:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>Carrier:</strong> {carrier_name}</p>'
.'<p style="margin:5px 0"><strong>Tracking Number:</strong> {tracking_number}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">After receiving your items, you can confirm your purchase from the order details.</p>'
.$this->notificationButton('View Order', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">구매 확정 안내</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 구매가 확정되었습니다. 이용해 주셔서 감사합니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>주문번호:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>결제금액:</strong> {total_amount}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">주문 내역은 아래 버튼을 클릭하여 확인하실 수 있습니다.</p>'
.$this->notificationButton('주문 내역 보기', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">Purchase Completed</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, your purchase has been completed. Thank you for shopping with us.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Order Number:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>Total Amount:</strong> {total_amount}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Click the button below to view your order history.</p>'
.$this->notificationButton('View Order', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #DC2626;padding-bottom:10px">주문 취소 안내</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 주문이 취소되었습니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>주문번호:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>취소 사유:</strong> {cancel_reason}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">환불은 결제 수단에 따라 3~7영업일 이내에 처리됩니다. 주문 상세는 아래 버튼을 클릭하여 확인하실 수 있습니다.</p>'
.$this->notificationButton('주문 상세 보기', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #DC2626;padding-bottom:10px">Order Cancelled</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, your order has been cancelled.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Order Number:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>Cancel Reason:</strong> {cancel_reason}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Refunds will be processed within 3-7 business days depending on your payment method. Click the button below to view your order details.</p>'
.$this->notificationButton('View Order', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">신규 주문 접수</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 새로운 주문이 접수되었습니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>주문번호:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>주문자:</strong> {customer_name}</p>'
.'<p style="margin:5px 0"><strong>결제금액:</strong> {total_amount}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">관리자 페이지에서 주문 상세를 확인해 주세요.</p>'
.$this->notificationButton('주문 관리 바로가기', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">New Order Received</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, a new order has been received.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Order Number:</strong> {order_number}</p>'
.'<p style="margin:5px 0"><strong>Customer:</strong> {customer_name}</p>'
.'<p style="margin:5px 0"><strong>Total Amount:</strong> {total_amount}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Please review the order details in the admin panel.</p>'
.$this->notificationButton('Go to Order Management', '{order_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">새 상품 문의 접수</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 새로운 상품 문의가 접수되었습니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>상품명:</strong> {product_name}</p>'
.'<p style="margin:5px 0"><strong>문의자:</strong> {customer_name}</p>'
.'<p style="margin:5px 0"><strong>문의 내용:</strong> {inquiry_content}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">관리자 페이지에서 문의 내용을 확인하고 답변해 주세요.</p>'
.$this->notificationButton('문의 확인하기', '{inquiry_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">New Product Inquiry</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, a new product inquiry has been received.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Product:</strong> {product_name}</p>'
.'<p style="margin:5px 0"><strong>Customer:</strong> {customer_name}</p>'
.'<p style="margin:5px 0"><strong>Inquiry:</strong> {inquiry_content}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Please review the inquiry and provide a response in the admin panel.</p>'
.$this->notificationButton('View Inquiry', '{inquiry_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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' => '<div style="font-family:\'Malgun Gothic\',sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">문의 답변 안내</h2>'
.'<p style="color:#555;line-height:1.6">{name}님, 문의하신 내용에 답변이 등록되었습니다.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>상품명:</strong> {product_name}</p>'
.'<p style="margin:5px 0"><strong>문의 내용:</strong> {inquiry_content}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">아래 버튼을 클릭하여 답변 내용을 확인하세요.</p>'
.$this->notificationButton('답변 확인하기', '{inquiry_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">본 메일은 {app_name}에서 발송되었습니다.</p>'
.'</div>',
'en' => '<div style="font-family:Arial,sans-serif;max-width:600px;margin:0 auto;padding:20px">'
.'<h2 style="color:#333;border-bottom:2px solid #4F46E5;padding-bottom:10px">Inquiry Answered</h2>'
.'<p style="color:#555;line-height:1.6">Dear {name}, your product inquiry has been answered.</p>'
.'<div style="background:#f8f9fa;padding:15px;border-radius:8px;margin:15px 0">'
.'<p style="margin:5px 0"><strong>Product:</strong> {product_name}</p>'
.'<p style="margin:5px 0"><strong>Your Inquiry:</strong> {inquiry_content}</p>'
.'</div>'
.'<p style="color:#555;line-height:1.6">Click the button below to view the response.</p>'
.$this->notificationButton('View Response', '{inquiry_url}')
.'<hr style="border:none;border-top:1px solid #eee;margin:20px 0">'
.'<p style="color:#999;font-size:12px">This email was sent from {app_name}.</p>'
.'</div>',
],
],
[
'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 '<div style="text-align:center;margin:25px 0">'
.'<a href="'.$url.'" style="display:inline-block;padding:12px 30px;'
.'background-color:#4F46E5;color:#ffffff;text-decoration:none;'
.'border-radius:6px;font-weight:bold">'.$text.'</a>'
.'</div>';
}
/**
* 훅 리스너 목록 반환
*/
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<int, array{class: class-string, groups: array<int, string>, timing?: string, targets: array<int, string>}>
*/
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<string, array{expr: string, label: array<string, string>}> 키별 데이터 경로 메타
*/
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<string, array{expr: string, label: array<string, string>}> 점 경로 키별 데이터 경로 메타
*/
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',
],
],
],
];
}
}
Reference in New Issue View Git Blame Copy Permalink