HeuJung
e21bff678f
7.0.6 사이클에서 유입된 회귀 3건을 출시 전에 닫는다. 추가옵션 저장소의 반환 타입 선언이 실제 반환(중첩 맵)과 어긋나 추가옵션 있는 상품의 담기· 바로구매가 죽었고, 검색 엔진이 결과 소비 시점에 SELECT 를 재작성해 정렬이 참조하던 스코어 별칭을 지웠으며, 미들웨어 targets 가 늘어난 라우트를 따라가지 못해 비회원 현금영수증이 전면 불능이었다. 셋 다 정적 검사의 사각지대였으므로 룰 2건과 계약 테스트를 함께 세워 재발을 막는다. 같은 유형의 잠복 결함 3건(빈 반환의 타입 불일치 2건, 없는 메서드 호출 1건)도 호출 경로가 생기는 순간 fatal 이므로 함께 닫았다. 브라우저 검수 중 드러난 선행 결함 5건을 이어서 수정한다. 엔진이 event 키로 선언한 액션을 React prop 으로 연결하지 않아 오류 없이 조용히 무반응이었고, 연결한 뒤에는 커스텀 컴포넌트의 이벤트 payload 가 유실됐다. 비회원 주문상세 응답에 현금영수증 키가 없어 발급 결과에 도달할 수 없었으며, 입금확인과 현금영수증 발급이 base 통화 금액을 써서 결제 통화가 다른 주문에서 각각 저장 실패와 잘못된 증빙을 냈다. 마지막으로 통화 단위를 코드·문구에서 걷어내 설정으로 이관한다. 다국어 문구의 원/円, 프론트의 KRW 고정표와 리터럴 폴백 173건, 서버 포맷의 통화 코드 리터럴이 대상이며, 기본 통화가 원이 아닌 상점에서 값은 맞고 단위만 틀린 금액이 예외 없이 나가던 문제였다. 통화 판정을 설정 단일 출처로 모으고 규칙 3건을 정적 검사로 고정했다.
2616 lines
137 KiB
PHP
2616 lines
137 KiB
PHP
<?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\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\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',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 모듈 설치 시 실행할 시더 목록 반환
|
|
*
|
|
* 배열 순서대로 실행됩니다.
|
|
* 나머지 시더는 개발/테스트용이므로 설치 시 필수 참조 데이터만 실행합니다.
|
|
*
|
|
* @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,
|
|
MileageTransactionListener::class,
|
|
UserMileageInfoListener::class,
|
|
UserCurrencyInfoListener::class,
|
|
UserShippingCountryInfoListener::class,
|
|
AssignDefaultCurrencyOnRegisterListener::class,
|
|
AssignDefaultShippingCountryOnRegisterListener::class,
|
|
UserMileageCleanupListener::class,
|
|
EcommerceNotificationDataListener::class,
|
|
OrderStatusNotificationListener::class,
|
|
InjectAppConfigDeviceListener::class,
|
|
IssueCashReceiptOnDepositListener::class,
|
|
PurgeCashReceiptIdentifierListener::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: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))
|
|
: '';
|
|
|
|
return array_filter([
|
|
'type' => 'product',
|
|
'image' => $image,
|
|
'image_width' => isset($product['thumbnail_width']) && (int) $product['thumbnail_width'] > 0
|
|
? (int) $product['thumbnail_width'] : null,
|
|
'image_height' => isset($product['thumbnail_height']) && (int) $product['thumbnail_height'] > 0
|
|
? (int) $product['thumbnail_height'] : null,
|
|
'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',
|
|
],
|
|
],
|
|
],
|
|
];
|
|
}
|
|
}
|