fix(core,extensions): 보안 결함 3건과 이중저장소·레이아웃 중복키 결함군 폐쇄
KISA 제보 3건(KVE-2026-2010/2011/2018)과 그 동일 계열 형제 결함을 전수 조치하고, 그 과정에서 드러난 두 결함군을 함께 닫는다. - 검증 시점과 연결 시점이 host 를 다르게 읽던 SSRF 통로를 정규화 SSoT 한 곳으로 모았다 - 세션을 여는 지점(2FA 완료·토큰 재발급)이 잠금 검사를 거치지 않아 계정 잠금이 우회됐다 - 인증도 서명도 없는 브라우저 리턴 콜백이 주문 상태를 바꾸던 통로를 4 PG 전부에서 닫고, 소유권을 대조하는 close-report 를 토스에도 신설했다. 그 결과 정리 주체를 잃는 결제창 미완료 주문은 만료 자동취소가 거둔다 - 저장소 A(_local)에만 쓰는 경로가 B 의 값을 조용히 덮던 회귀를 정본 writer 로 닫았다 (engine-v1.63.5). 한 방향만 보던 정적 검사에 반대 방향 축과 양방향 계약 테스트를 더했다 - 레이아웃 JSON 의 같은 객체 중복 키가 앞선 선언을 오류 없이 삼키던 결함군을 닫았다
This commit is contained in:
1 parent
d4439ea30a
commit
21fc114f37
137 files changed
+6470
-829
No files matched your search
@@ -6,11 +6,16 @@
|
||||
|
||||
## [1.2.1] - 2026-08-28
|
||||
|
||||
### Changed
|
||||
|
||||
- 입금 기한 만료 주문 자동취소가 카드 등 결제창 결제까지 대상에 포함합니다. 종전에는 무통장입금·가상계좌만 정리되어, 결제창까지 갔으나 결제가 끝나지 않은 주문은 정리하는 주체가 없어 계속 남았습니다. 이제 주문 후 24시간이 지나면 함께 취소되며 미리 차감된 마일리지도 돌아옵니다. 결제가 이미 완료된 주문과 입금 대기 중인 가상계좌 주문은 대상이 아니며, 주문설정의 「만료 주문 자동취소」를 끄면 종전처럼 동작합니다.
|
||||
|
||||
### Added
|
||||
|
||||
- 개발자와 AI 에이전트를 위한 문서를 추가했습니다. 확장 폴더의 `AGENTS.md`(설계 의도·확장점·수정 시 확인할 것)와 `README.md`(도입·운영 안내), `docs/`(상세 문서)로 구성됩니다.
|
||||
- 확장 문서에 「레이아웃 편집기 스펙」 항목을 추가했습니다. 이 확장이 레이아웃 편집기에 무엇을 선언했는지와, 화면 요소나 데이터를 추가할 때 편집기 쪽에서 함께 해야 할 일을 담습니다.
|
||||
- 문서의 제품 표기를 「그누보드7」로 통일했습니다.
|
||||
- 환경설정 > 주문 설정 > 주문 자동취소 에 「결제 미완료 주문 만료 기준(분)」 입력이 추가되었습니다. 결제창까지 갔으나 결제가 끝나지 않은 주문을 몇 분 뒤에 정리할지 정하며, 0 으로 두면 그 부류는 정리하지 않습니다(기본 1440분 = 24시간). 종전에는 값만 있고 화면에서 조작할 수 없었습니다.
|
||||
|
||||
### Fixed
|
||||
|
||||
|
||||
@@ -85,6 +85,10 @@ return [
|
||||
// 주문
|
||||
'auto_cancel_days_min' => 1,
|
||||
'auto_cancel_days_max' => 30,
|
||||
// 결제창까지 갔으나 결제가 성립하지 않은 주문의 만료 기준(분).
|
||||
// 0 은 "그 부류는 정리하지 않음" 을 뜻한다 — 운영자가 끌 수 있는 여지를 남긴다.
|
||||
'pending_order_expire_minutes_min' => 0,
|
||||
'pending_order_expire_minutes_max' => 20160,
|
||||
'cart_expiry_days_min' => 1,
|
||||
'cart_expiry_days_max' => 365,
|
||||
|
||||
|
||||
@@ -241,6 +241,7 @@
|
||||
],
|
||||
"auto_cancel_expired": true,
|
||||
"auto_cancel_days": 3,
|
||||
"pending_order_expire_minutes": 1440,
|
||||
"cart_expiry_days": 30,
|
||||
"stock_restore_on_cancel": true,
|
||||
"cancellable_statuses": ["payment_complete"],
|
||||
|
||||
@@ -480,6 +480,7 @@ HTTP/1.1 200
|
||||
| order_settings.bank_accounts | body | array | 아니오 | — | 무통장 입금 계좌 목록. 항목별 `bank_code`·`account_number`·`account_holder`(모두 필수)·`is_active`·`is_default`. 계좌가 있으면 최소 1건은 사용+기본 상태여야 함 |
|
||||
| order_settings.auto_cancel_expired | body | boolean | 아니오 | — | 입금대기 상태 주문의 자동취소 사용 여부 |
|
||||
| order_settings.auto_cancel_days | body | integer | 아니오 | min 0, max 30 | 자동취소 기한(일). 주문일 포함 이 일수 경과 시 입금대기 주문을 자동 취소 |
|
||||
| order_settings.pending_order_expire_minutes | body | integer | 아니오 | min 0, max 20160 | 결제 미완료 주문 만료 기준(분). 결제창까지 갔으나 결제가 성립하지 않은 주문을 이 시간 경과 후 자동 취소. `0` 이면 그 부류를 정리하지 않음 |
|
||||
| order_settings.cart_expiry_days | body | integer | 아니오 | min 1, max 365 | 장바구니 보관기간(일). 경과 시 담긴 상품 자동 삭제 |
|
||||
| order_settings.stock_restore_on_cancel | body | boolean | 아니오 | — | 주문 취소 시 차감된 재고 자동 복구 여부 (반품/교환에도 적용) |
|
||||
| order_settings.confirmable_statuses | body | array | 아니오 | — | 사용자가 구매확정할 수 있는 주문 옵션 상태 목록 (`payment_complete`, `shipping_hold`, `preparing`, `shipping_ready`, `shipping`, `delivered` 중 선택) |
|
||||
@@ -599,6 +600,7 @@ Content-Type: application/json
|
||||
],
|
||||
"order_settings.auto_cancel_expired": true,
|
||||
"order_settings.auto_cancel_days": 1,
|
||||
"order_settings.pending_order_expire_minutes": 1440,
|
||||
"order_settings.cart_expiry_days": 1,
|
||||
"order_settings.stock_restore_on_cancel": true,
|
||||
"order_settings.confirmable_statuses": [
|
||||
|
||||
@@ -35,6 +35,21 @@ _`getSettingsSchema()` 선언이 없습니다._
|
||||
등록한 카탈로그의 병합**이라, 플러그인을 삭제·비활성화하면 저장값은 남아 있는데 카탈로그에서
|
||||
사라지는 고아 항목이 생깁니다. 공개 응답은 고아 항목을 걸러 내보내고 관리자 응답은 그대로
|
||||
노출하는 것이 규칙입니다 — 운영자는 그것을 보고 지워야 하기 때문입니다.
|
||||
|
||||
`order_settings.pending_order_expire_minutes` 는 결제창까지 갔으나 결제가 성립하지 않은
|
||||
주문(`PENDING_ORDER`)을 만료 자동취소 대상에 넣는 기준입니다(기본 1440분 = 24시간). 0 이면 그
|
||||
부류를 정리하지 않습니다.
|
||||
|
||||
이 값은 **환경설정 > 주문 설정 > 주문 자동취소** 카드에 있습니다. 형제 값
|
||||
`auto_cancel_days` 와 달리 `auto_cancel_expired` 토글 **하위가 아닙니다** — 정리 스케줄러가 그
|
||||
토글과 무관하게 이 값을 읽기 때문에, 토글을 끈 상태에서 이 입력만 사라지면 화면이 실제 동작을
|
||||
설명하지 못합니다. 입력 경계(0 ~ 20160분)는 `config/ecommerce.php` 의 `limits` 가 단일 출처이며,
|
||||
화면은 설정 응답의 `_meta.limits` 로 같은 값을 받습니다.
|
||||
|
||||
이 부류를 정리 대상에 넣은 이유는 **정리 주체가 아예 없었기** 때문입니다. 기존 자동취소는 입금
|
||||
기한(`vbank_due_at`·`deposit_due_at`)이 있는 결제수단만 훑고, 임시주문 정리는 다른 테이블을 봅니다.
|
||||
브라우저 리턴 콜백이 주문 상태를 바꾸지 않게 된 뒤로는 승인 거절분도 여기에 머무르므로, 이 정리가
|
||||
선차감 마일리지 복원의 최종 안전망입니다.
|
||||
<!-- @intent END -->
|
||||
|
||||
## 권한
|
||||
|
||||
+2
@@ -25,6 +25,7 @@
|
||||
"name": "Button",
|
||||
"props": {
|
||||
"className": "flex items-center gap-1.5 px-2.5 py-2 text-sm text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700 rounded-lg cursor-pointer transition-colors",
|
||||
"data-testid": "currency-switcher",
|
||||
"aria-haspopup": "listbox",
|
||||
"aria-expanded": "{{_local.showCurrencyDropdown ?? false}}",
|
||||
"aria-label": "$t:sirsoft-ecommerce.common.currency_label"
|
||||
@@ -151,6 +152,7 @@
|
||||
"name": "Button",
|
||||
"props": {
|
||||
"className": "w-full px-4 py-2.5 text-left text-sm flex items-center gap-3 cursor-pointer transition-colors {{_global.preferredCurrency === currency.code ? 'bg-blue-50 dark:bg-blue-900/20 text-blue-600 dark:text-blue-400' : 'text-gray-700 dark:text-gray-300 hover:bg-gray-100 dark:hover:bg-gray-700'}}",
|
||||
"data-testid": "currency-option-{{currency.code}}",
|
||||
"role": "option",
|
||||
"aria-selected": "{{_global.preferredCurrency === currency.code}}"
|
||||
},
|
||||
|
||||
@@ -213,7 +213,10 @@
|
||||
"toggle_description": "Automatically cancel pending payment orders after the specified period.",
|
||||
"toggle_hint": "When disabled, pending payment orders will not be auto-cancelled.",
|
||||
"days_prefix": "Pending payment orders will be auto-cancelled",
|
||||
"days_suffix": "days after the order date."
|
||||
"days_suffix": "days after the order date.",
|
||||
"pending_minutes_prefix": "Orders that reached the payment window but did not complete are cancelled after",
|
||||
"pending_minutes_suffix": "minutes.",
|
||||
"pending_minutes_hint": "Set 0 to leave this group alone. Maximum 20160 minutes (14 days)."
|
||||
},
|
||||
"cart_expiry": {
|
||||
"title": "Cart Expiry",
|
||||
|
||||
@@ -213,7 +213,10 @@
|
||||
"toggle_description": "입금대기 상태의 주문을 지정 기간 후 자동으로 취소합니다.",
|
||||
"toggle_hint": "비활성화하면 입금대기 주문이 자동 취소되지 않습니다.",
|
||||
"days_prefix": "입금대기 상태의 주문건은 주문일 포함",
|
||||
"days_suffix": "일 이후 자동 취소됩니다."
|
||||
"days_suffix": "일 이후 자동 취소됩니다.",
|
||||
"pending_minutes_prefix": "결제창까지 갔으나 결제가 끝나지 않은 주문은",
|
||||
"pending_minutes_suffix": "분 이후 자동 취소됩니다.",
|
||||
"pending_minutes_hint": "0 으로 두면 이 부류는 자동 취소하지 않습니다. 최대 20160분(14일)."
|
||||
},
|
||||
"cart_expiry": {
|
||||
"title": "장바구니 유효기간",
|
||||
|
||||
+2
-1
@@ -976,7 +976,8 @@
|
||||
"props": {
|
||||
"type": "button",
|
||||
"disabled": "{{_local.isSaving || (route.itemCode && product?.data?.abilities?.can_update !== true)}}",
|
||||
"className": "flex-center btn btn-primary gap-1.5 disabled:opacity-50 disabled:cursor-not-allowed"
|
||||
"className": "flex-center btn btn-primary gap-1.5 disabled:opacity-50 disabled:cursor-not-allowed",
|
||||
"data-testid": "product-save"
|
||||
},
|
||||
"children": [
|
||||
{
|
||||
|
||||
+4
-2
@@ -46,7 +46,8 @@
|
||||
"props": {
|
||||
"type": "button",
|
||||
"variant": "secondary",
|
||||
"className": "btn btn-outline"
|
||||
"className": "btn btn-outline",
|
||||
"data-testid": "additional-clear-cancel"
|
||||
},
|
||||
"text": "$t:sirsoft-ecommerce.common.cancel",
|
||||
"actions": [
|
||||
@@ -62,7 +63,8 @@
|
||||
"props": {
|
||||
"type": "button",
|
||||
"variant": "danger",
|
||||
"className": "btn btn-danger"
|
||||
"className": "btn btn-danger",
|
||||
"data-testid": "additional-clear-confirm"
|
||||
},
|
||||
"text": "$t:sirsoft-ecommerce.common.confirm",
|
||||
"actions": [
|
||||
|
||||
+6
-3
@@ -1661,7 +1661,8 @@
|
||||
"props": {
|
||||
"type": "button",
|
||||
"className": "btn-group-item {{(_local.form.additional_options ?? []).length > 0 ? 'active' : ''}} disabled:opacity-50 disabled:cursor-not-allowed",
|
||||
"disabled": "{{route.itemCode && product?.data?.abilities?.can_update !== true}}"
|
||||
"disabled": "{{route.itemCode && product?.data?.abilities?.can_update !== true}}",
|
||||
"data-testid": "additional-option-use"
|
||||
},
|
||||
"text": "$t:sirsoft-ecommerce.common.use",
|
||||
"actions": [
|
||||
@@ -1678,7 +1679,8 @@
|
||||
"props": {
|
||||
"type": "button",
|
||||
"className": "btn-group-item {{(_local.form.additional_options ?? []).length === 0 ? 'active' : ''}} disabled:opacity-50 disabled:cursor-not-allowed",
|
||||
"disabled": "{{route.itemCode && product?.data?.abilities?.can_update !== true}}"
|
||||
"disabled": "{{route.itemCode && product?.data?.abilities?.can_update !== true}}",
|
||||
"data-testid": "additional-option-not-use"
|
||||
},
|
||||
"text": "$t:sirsoft-ecommerce.common.not_use",
|
||||
"actions": [
|
||||
@@ -1891,7 +1893,8 @@
|
||||
"index_var": "addValIdx"
|
||||
},
|
||||
"props": {
|
||||
"className": "flex flex-col gap-2 sm:flex-row sm:items-start p-3 bg-white dark:bg-gray-900/40 border border-gray-200 dark:border-gray-700 rounded"
|
||||
"className": "flex flex-col gap-2 sm:flex-row sm:items-start p-3 bg-white dark:bg-gray-900/40 border border-gray-200 dark:border-gray-700 rounded",
|
||||
"data-testid": "additional-value-{{addIdx}}-{{addValIdx}}"
|
||||
},
|
||||
"children": [
|
||||
{
|
||||
|
||||
+58
@@ -662,6 +662,64 @@
|
||||
"text": "{{_local.errors?.['order_settings.auto_cancel_days']?.[0] ?? ''}}"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"comment": "결제 미완료 주문 만료 기준(분) — 결제창까지 갔으나 결제가 성립하지 않은 주문을 정리하는 스케줄러가 읽는다. 자동취소 토글과 독립이므로 토글 하위에 두지 않는다.",
|
||||
"id": "pending_order_expire_minutes_row",
|
||||
"type": "basic",
|
||||
"name": "Div",
|
||||
"props": {
|
||||
"className": "flex-center gap-2 flex-wrap"
|
||||
},
|
||||
"children": [
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "Span",
|
||||
"props": {
|
||||
"className": "text-body"
|
||||
},
|
||||
"text": "$t:sirsoft-ecommerce.admin.settings.order_settings.auto_cancel.pending_minutes_prefix"
|
||||
},
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "Input",
|
||||
"props": {
|
||||
"type": "number",
|
||||
"name": "order_settings.pending_order_expire_minutes",
|
||||
"value": "{{_local.form?.order_settings?.pending_order_expire_minutes ?? 1440}}",
|
||||
"min": "{{_local?.form?._meta?.limits?.pending_order_expire_minutes_min ?? 0}}",
|
||||
"max": "{{_local?.form?._meta?.limits?.pending_order_expire_minutes_max ?? 20160}}",
|
||||
"step": "1",
|
||||
"className": "{{_local.errors?.['order_settings.pending_order_expire_minutes'] ? 'input input-error w-24' : 'input w-24'}}",
|
||||
"disabled": "{{_computed.isReadOnly}}"
|
||||
}
|
||||
},
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "Span",
|
||||
"props": {
|
||||
"className": "text-body"
|
||||
},
|
||||
"text": "$t:sirsoft-ecommerce.admin.settings.order_settings.auto_cancel.pending_minutes_suffix"
|
||||
},
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "P",
|
||||
"props": {
|
||||
"className": "form-hint w-full"
|
||||
},
|
||||
"text": "$t:sirsoft-ecommerce.admin.settings.order_settings.auto_cancel.pending_minutes_hint"
|
||||
},
|
||||
{
|
||||
"type": "basic",
|
||||
"name": "Span",
|
||||
"if": "{{_local.errors?.['order_settings.pending_order_expire_minutes']}}",
|
||||
"props": {
|
||||
"className": "form-error-xs w-full mt-1"
|
||||
},
|
||||
"text": "{{_local.errors?.['order_settings.pending_order_expire_minutes']?.[0] ?? ''}}"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"props": {
|
||||
|
||||
+19
-4
@@ -65,8 +65,19 @@ class CancelPendingPaymentOrdersCommand extends Command
|
||||
);
|
||||
|
||||
try {
|
||||
// 결제창까지 갔으나 결제가 성립하지 않은 주문(PG 카드 등)의 만료 기준(분).
|
||||
// 0 이하로 두면 그 부류는 정리하지 않는다 — 운영자가 끌 수 있는 여지를 남긴다.
|
||||
$pendingOrderExpireMinutes = (int) module_setting(
|
||||
'sirsoft-ecommerce',
|
||||
'order_settings.pending_order_expire_minutes',
|
||||
1440
|
||||
);
|
||||
|
||||
// 만료된 주문 조회
|
||||
$expiredOrders = $this->orderRepository->getExpiredPendingPaymentOrders($limit);
|
||||
$expiredOrders = $this->orderRepository->getExpiredPendingPaymentOrders(
|
||||
$limit,
|
||||
$pendingOrderExpireMinutes > 0 ? $pendingOrderExpireMinutes : null,
|
||||
);
|
||||
|
||||
if ($expiredOrders->isEmpty()) {
|
||||
$this->info('처리할 만료 주문이 없습니다.');
|
||||
@@ -82,9 +93,13 @@ class CancelPendingPaymentOrdersCommand extends Command
|
||||
foreach ($expiredOrders as $order) {
|
||||
$paymentMethodEnum = $order->payment?->payment_method;
|
||||
$paymentMethodValue = $paymentMethodEnum?->value ?? 'unknown';
|
||||
$dueAt = $paymentMethodEnum === PaymentMethodEnum::DBANK
|
||||
? $order->payment?->deposit_due_at
|
||||
: $order->payment?->vbank_due_at;
|
||||
$dueAt = match (true) {
|
||||
$paymentMethodEnum === PaymentMethodEnum::DBANK => $order->payment?->deposit_due_at,
|
||||
$paymentMethodEnum === PaymentMethodEnum::VBANK => $order->payment?->vbank_due_at,
|
||||
// 결제창까지 갔으나 성립하지 않은 주문은 입금 기한이 없다 — 주문 시각을 보여
|
||||
// 운영자가 어느 기준으로 정리되었는지 알 수 있게 한다.
|
||||
default => $order->ordered_at,
|
||||
};
|
||||
|
||||
$this->line("- 주문번호: {$order->order_number} ({$paymentMethodValue}, 기한: {$dueAt})");
|
||||
|
||||
|
||||
+5
@@ -286,6 +286,7 @@ class StoreEcommerceSettingsRequest extends FormRequest
|
||||
// sometimes 필수: rules() 는 탭 구분 없이 적용되므로 무조건 required 로 두면
|
||||
// 이 키를 보내지 않는 다른 탭(마일리지 등) 저장이 통째로 막힌다. 키가 온 경우에만 필수.
|
||||
'order_settings.auto_cancel_days' => ['sometimes', 'required', 'integer', 'min:'.config('sirsoft-ecommerce.limits.auto_cancel_days_min', 1), 'max:'.config('sirsoft-ecommerce.limits.auto_cancel_days_max', 30)],
|
||||
'order_settings.pending_order_expire_minutes' => ['sometimes', 'required', 'integer', 'min:'.config('sirsoft-ecommerce.limits.pending_order_expire_minutes_min', 0), 'max:'.config('sirsoft-ecommerce.limits.pending_order_expire_minutes_max', 20160)],
|
||||
'order_settings.cart_expiry_days' => ['nullable', 'integer', 'min:'.config('sirsoft-ecommerce.limits.cart_expiry_days_min', 1), 'max:'.config('sirsoft-ecommerce.limits.cart_expiry_days_max', 365)],
|
||||
'order_settings.stock_restore_on_cancel' => ['nullable', 'boolean'],
|
||||
'order_settings.confirmable_statuses' => ['nullable', 'array'],
|
||||
@@ -1213,6 +1214,10 @@ class StoreEcommerceSettingsRequest extends FormRequest
|
||||
'order_settings.auto_cancel_days.integer' => __('sirsoft-ecommerce::validation.custom.order_settings.auto_cancel_days.integer'),
|
||||
'order_settings.auto_cancel_days.min' => __('sirsoft-ecommerce::validation.custom.order_settings.auto_cancel_days.min'),
|
||||
'order_settings.auto_cancel_days.max' => __('sirsoft-ecommerce::validation.custom.order_settings.auto_cancel_days.max'),
|
||||
'order_settings.pending_order_expire_minutes.required' => __('sirsoft-ecommerce::validation.custom.order_settings.pending_order_expire_minutes.required'),
|
||||
'order_settings.pending_order_expire_minutes.integer' => __('sirsoft-ecommerce::validation.custom.order_settings.pending_order_expire_minutes.integer'),
|
||||
'order_settings.pending_order_expire_minutes.min' => __('sirsoft-ecommerce::validation.custom.order_settings.pending_order_expire_minutes.min'),
|
||||
'order_settings.pending_order_expire_minutes.max' => __('sirsoft-ecommerce::validation.custom.order_settings.pending_order_expire_minutes.max'),
|
||||
'order_settings.cart_expiry_days.integer' => __('sirsoft-ecommerce::validation.custom.order_settings.cart_expiry_days.integer'),
|
||||
'order_settings.cart_expiry_days.min' => __('sirsoft-ecommerce::validation.custom.order_settings.cart_expiry_days.min'),
|
||||
'order_settings.cart_expiry_days.max' => __('sirsoft-ecommerce::validation.custom.order_settings.cart_expiry_days.max'),
|
||||
|
||||
+10
-4
@@ -167,14 +167,20 @@ interface OrderRepositoryInterface
|
||||
public function hasOrderByUser(int $userId): bool;
|
||||
|
||||
/**
|
||||
* 입금 기한 만료된 결제대기 주문 조회
|
||||
* 기한이 지난 미결제 주문 조회
|
||||
*
|
||||
* vbank/dbank 결제의 입금 기한이 지난 주문들을 조회합니다.
|
||||
* 두 부류를 함께 조회합니다.
|
||||
* - vbank/dbank 결제의 입금 기한이 지난 결제대기 주문
|
||||
* - 결제창까지 갔으나 결제가 성립하지 않은 주문대기 주문 (PG 카드 등, 경과 시간 기준)
|
||||
*
|
||||
* 후자는 입금 기한이라는 개념이 없어 어떤 정리 주체도 없이 남던 부류다.
|
||||
* `$pendingOrderExpireMinutes` 가 null 이거나 0 이하면 후자는 조회하지 않는다.
|
||||
*
|
||||
* @param int $limit 최대 조회 개수
|
||||
* @return Collection 입금 기한 만료된 결제대기 주문 컬렉션
|
||||
* @param int|null $pendingOrderExpireMinutes 주문대기 주문의 만료 기준(분)
|
||||
* @return Collection 기한이 지난 미결제 주문 컬렉션
|
||||
*/
|
||||
public function getExpiredPendingPaymentOrders(int $limit = 100): Collection;
|
||||
public function getExpiredPendingPaymentOrders(int $limit = 100, ?int $pendingOrderExpireMinutes = null): Collection;
|
||||
|
||||
/**
|
||||
* ID 목록으로 주문을 조회하고 ID 키 맵으로 반환합니다 (bulk activity log lookup).
|
||||
|
||||
@@ -17,6 +17,7 @@ use Illuminate\Database\Eloquent\Collection;
|
||||
use Illuminate\Support\Facades\DB;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\ShippingStatusEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Models\Order;
|
||||
use Modules\Sirsoft\Ecommerce\Models\OrderAddress;
|
||||
@@ -785,23 +786,47 @@ class OrderRepository implements OrderRepositoryInterface
|
||||
/**
|
||||
* {@inheritDoc}
|
||||
*/
|
||||
public function getExpiredPendingPaymentOrders(int $limit = 100): Collection
|
||||
public function getExpiredPendingPaymentOrders(int $limit = 100, ?int $pendingOrderExpireMinutes = null): Collection
|
||||
{
|
||||
return $this->model
|
||||
->with(['payment', 'user'])
|
||||
->where('order_status', OrderStatusEnum::PENDING_PAYMENT->value)
|
||||
->whereHas('payment', function ($query) {
|
||||
$query->where(function ($q) {
|
||||
// vbank 가상계좌 입금 기한 만료
|
||||
$q->where('payment_method', PaymentMethodEnum::VBANK->value)
|
||||
->whereNotNull('vbank_due_at')
|
||||
->where('vbank_due_at', '<', now());
|
||||
})->orWhere(function ($q) {
|
||||
// dbank 무통장입금(수동 입금확인) 입금 기한 만료
|
||||
$q->where('payment_method', PaymentMethodEnum::DBANK->value)
|
||||
->whereNotNull('deposit_due_at')
|
||||
->where('deposit_due_at', '<', now());
|
||||
->where(function ($outer) use ($pendingOrderExpireMinutes) {
|
||||
// 입금 기한이 있는 결제수단 — 기한 도과분
|
||||
$outer->where(function ($scope) {
|
||||
$scope->where('order_status', OrderStatusEnum::PENDING_PAYMENT->value)
|
||||
->whereHas('payment', function ($query) {
|
||||
$query->where(function ($q) {
|
||||
// vbank 가상계좌 입금 기한 만료
|
||||
$q->where('payment_method', PaymentMethodEnum::VBANK->value)
|
||||
->whereNotNull('vbank_due_at')
|
||||
->where('vbank_due_at', '<', now());
|
||||
})->orWhere(function ($q) {
|
||||
// dbank 무통장입금(수동 입금확인) 입금 기한 만료
|
||||
$q->where('payment_method', PaymentMethodEnum::DBANK->value)
|
||||
->whereNotNull('deposit_due_at')
|
||||
->where('deposit_due_at', '<', now());
|
||||
});
|
||||
});
|
||||
});
|
||||
|
||||
// 결제창까지 갔지만 결제가 성립하지 않은 주문(PG 카드 등) — 입금 기한이라는 개념이
|
||||
// 없어 종전에는 어떤 정리 주체도 없이 무한히 남았다. 브라우저 리턴 콜백이 주문
|
||||
// 상태를 바꾸지 않게 되면서(위조 콜백으로 남의 주문을 취소시킬 수 있었던 통로 차단)
|
||||
// 승인 거절분도 여기에 머무르므로, 주문 시각 기준 경과분을 정리 대상에 포함한다.
|
||||
// 선차감 마일리지 복원도 이 정리에서 함께 이루어진다.
|
||||
if ($pendingOrderExpireMinutes !== null && $pendingOrderExpireMinutes > 0) {
|
||||
$outer->orWhere(function ($scope) use ($pendingOrderExpireMinutes) {
|
||||
$scope->where('order_status', OrderStatusEnum::PENDING_ORDER->value)
|
||||
->where('ordered_at', '<', now()->subMinutes($pendingOrderExpireMinutes))
|
||||
// 승인 콜백과 경쟁해 이미 결제가 성립한 주문은 건드리지 않는다.
|
||||
->whereHas('payment', function ($query) {
|
||||
$query->whereNotIn('payment_status', [
|
||||
PaymentStatusEnum::PAID->value,
|
||||
PaymentStatusEnum::WAITING_DEPOSIT->value,
|
||||
]);
|
||||
});
|
||||
});
|
||||
}
|
||||
})
|
||||
->orderBy('ordered_at', 'asc')
|
||||
->limit($limit)
|
||||
|
||||
@@ -1451,6 +1451,7 @@ return [
|
||||
'order_settings.bank_accounts.*.is_default' => 'Default Account',
|
||||
'order_settings.auto_cancel_expired' => 'Auto Cancel Unpaid Orders',
|
||||
'order_settings.auto_cancel_days' => 'Auto Cancel Days',
|
||||
'order_settings.pending_order_expire_minutes' => 'Pending Payment Order Expiry (minutes)',
|
||||
'order_settings.cart_expiry_days' => 'Cart Expiry Days',
|
||||
'order_settings.default_pg_provider' => 'Default PG Provider',
|
||||
'order_settings.payment_methods.*.pg_provider' => 'PG Provider',
|
||||
@@ -1781,6 +1782,12 @@ return [
|
||||
'min' => 'Auto cancel days must be at least 1.',
|
||||
'max' => 'Auto cancel days cannot exceed 30.',
|
||||
],
|
||||
'pending_order_expire_minutes' => [
|
||||
'required' => 'Please enter the pending payment order expiry.',
|
||||
'integer' => 'Pending payment order expiry must be an integer.',
|
||||
'min' => 'Pending payment order expiry must be at least 0 (0 disables cleanup).',
|
||||
'max' => 'Pending payment order expiry cannot exceed 20160 minutes (14 days).',
|
||||
],
|
||||
'cart_expiry_days' => [
|
||||
'integer' => 'Cart expiry days must be an integer.',
|
||||
'min' => 'Cart expiry days must be at least 1.',
|
||||
|
||||
@@ -1451,6 +1451,7 @@ return [
|
||||
'order_settings.bank_accounts.*.is_default' => '기본 계좌',
|
||||
'order_settings.auto_cancel_expired' => '미결제 자동취소',
|
||||
'order_settings.auto_cancel_days' => '자동취소 기한(일)',
|
||||
'order_settings.pending_order_expire_minutes' => '결제 미완료 주문 만료 기준(분)',
|
||||
'order_settings.cart_expiry_days' => '장바구니 보관기간(일)',
|
||||
'order_settings.default_pg_provider' => '기본 PG사',
|
||||
'order_settings.payment_methods.*.pg_provider' => 'PG사',
|
||||
@@ -1781,6 +1782,12 @@ return [
|
||||
'min' => '자동취소 기한은 1일 이상이어야 합니다.',
|
||||
'max' => '자동취소 기한은 최대 30일까지 설정 가능합니다.',
|
||||
],
|
||||
'pending_order_expire_minutes' => [
|
||||
'required' => '결제 미완료 주문 만료 기준을 입력해주세요.',
|
||||
'integer' => '결제 미완료 주문 만료 기준은 정수여야 합니다.',
|
||||
'min' => '결제 미완료 주문 만료 기준은 0분 이상이어야 합니다. (0 은 정리하지 않음)',
|
||||
'max' => '결제 미완료 주문 만료 기준은 최대 20160분(14일)까지 설정 가능합니다.',
|
||||
],
|
||||
'cart_expiry_days' => [
|
||||
'integer' => '장바구니 보관기간은 정수여야 합니다.',
|
||||
'min' => '장바구니 보관기간은 1일 이상이어야 합니다.',
|
||||
|
||||
+48
@@ -228,6 +228,54 @@ class ShippingPolicyTestApiCallTest extends ModuleTestCase
|
||||
'localhost' => ['http://localhost/calc'],
|
||||
'사설 IP' => ['http://192.168.0.10/calc'],
|
||||
'내부 도메인' => ['http://vault.internal/calc'],
|
||||
|
||||
// 점 동등 유니코드 문자(U+3002·U+FF0E·U+FF61)와 전각 슬래시(U+FF0F)는 연결
|
||||
// 계층의 UTS#46 정규화에서 ASCII 로 바뀐다. 게이트가 원문 host 로만 판정하면
|
||||
// 검증 시점과 접속 시점의 목적지가 달라져 내부망 조회가 열린다.
|
||||
'U+3002 로 감춘 localhost' => ["http://localhost\u{3002}/calc"],
|
||||
'U+FF0E 로 감춘 localhost' => ["http://localhost\u{FF0E}/calc"],
|
||||
'U+FF61 로 감춘 localhost' => ["http://localhost\u{FF61}/calc"],
|
||||
'U+3002 로 감춘 루프백 IP' => ["http://127\u{3002}0\u{3002}0\u{3002}1/calc"],
|
||||
'U+FF0E 로 감춘 메타데이터' => ["http://169\u{FF0E}254\u{FF0E}169\u{FF0E}254/latest/meta-data/"],
|
||||
'U+3002 로 감춘 내부 도메인' => ["http://vault\u{3002}internal/calc"],
|
||||
'전각 슬래시로 감춘 루프백' => ["http://127.0.0.1\u{FF0F}.example.com/calc"],
|
||||
'후행 점 localhost' => ['http://localhost./calc'],
|
||||
];
|
||||
}
|
||||
|
||||
/**
|
||||
* 정규화가 정상 외부 API 엔드포인트까지 막지는 않는다 (회귀 방지).
|
||||
*
|
||||
* @param string $endpoint 정상 호출 가능한 엔드포인트
|
||||
*/
|
||||
#[DataProvider('legitimateEndpointProvider')]
|
||||
public function test_public_endpoint_is_still_callable(string $endpoint): void
|
||||
{
|
||||
Http::fake(['*' => Http::response(['shipping_fee' => 3000], 200)]);
|
||||
|
||||
$response = $this->actingAs($this->adminUser)->postJson($this->url, [
|
||||
'endpoint' => $endpoint,
|
||||
'method' => 'GET',
|
||||
'response_format' => 'json',
|
||||
'response_path' => 'shipping_fee',
|
||||
]);
|
||||
|
||||
$response->assertOk();
|
||||
Http::assertSentCount(1);
|
||||
}
|
||||
|
||||
/**
|
||||
* 정규화 후에도 통과해야 하는 정상 엔드포인트 목록.
|
||||
*
|
||||
* @return array<string, array{string}>
|
||||
*/
|
||||
public static function legitimateEndpointProvider(): array
|
||||
{
|
||||
return [
|
||||
'공개 도메인' => ['https://api.example.com/shipping/fee'],
|
||||
'비표준 포트' => ['https://api.example.com:8443/shipping/fee'],
|
||||
'국제화 도메인' => ["https://\u{4F8B}\u{3048}.jp/shipping/fee"],
|
||||
'punycode 도메인' => ['https://xn--r8jz45g.jp/shipping/fee'],
|
||||
];
|
||||
}
|
||||
|
||||
|
||||
@@ -0,0 +1,47 @@
|
||||
/**
|
||||
* 관리자 상품폼 E2E 공용 조회 헬퍼.
|
||||
*
|
||||
* 추가옵션 선택지(values)를 보유한 상품을 실행 시점에 찾아 그 **숫자 id** 를 돌려준다.
|
||||
* 상품 id 를 spec 에 상수로 박으면 실측 시드가 정리되는 순간 그 spec 이 통째로 죽는데,
|
||||
* 죽었다는 사실이 "대상 없음" 과 구분되지 않는다 (실제로 id 306 이 그렇게 사라졌다).
|
||||
*/
|
||||
import type { Page } from '@playwright/test';
|
||||
|
||||
const LIST_API = '/api/modules/sirsoft-ecommerce/admin/products?per_page=40';
|
||||
const DETAIL_API = '/api/modules/sirsoft-ecommerce/admin/products';
|
||||
|
||||
/**
|
||||
* 추가옵션 선택지를 보유한 상품의 숫자 id 를 찾습니다.
|
||||
*
|
||||
* @param page 인증이 적용된 Playwright 페이지 (auth_token 이 localStorage 에 있어야 한다)
|
||||
* @return 찾은 상품의 숫자 id (없으면 null)
|
||||
*/
|
||||
export async function findProductWithAdditionalOptionValues(page: Page): Promise<number | null> {
|
||||
return page.evaluate(
|
||||
async ({ listApi, detailApi }) => {
|
||||
const token = localStorage.getItem('auth_token') ?? '';
|
||||
const headers = { Accept: 'application/json', Authorization: `Bearer ${token}` };
|
||||
|
||||
const listRes = await fetch(listApi, { headers });
|
||||
if (!listRes.ok) return null;
|
||||
const listJson = await listRes.json();
|
||||
const rows = listJson?.data?.data ?? listJson?.data ?? [];
|
||||
|
||||
for (const row of rows) {
|
||||
const id = Number(row?.id);
|
||||
if (!Number.isFinite(id)) continue;
|
||||
|
||||
const detailRes = await fetch(`${detailApi}/${id}`, { headers });
|
||||
if (!detailRes.ok) continue;
|
||||
const detail = (await detailRes.json())?.data;
|
||||
|
||||
const groups = detail?.additional_options ?? [];
|
||||
const hasValues = groups.some((g: any) => (g?.values ?? []).length > 0);
|
||||
if (hasValues) return id;
|
||||
}
|
||||
|
||||
return null;
|
||||
},
|
||||
{ listApi: LIST_API, detailApi: DETAIL_API },
|
||||
);
|
||||
}
|
||||
+186
@@ -0,0 +1,186 @@
|
||||
/**
|
||||
* 유저 상품상세 추가옵션 흐름 공용 헬퍼 — 대상 상품 조회 + 커스텀 드롭다운 조작.
|
||||
*
|
||||
* `additional-options.spec.ts`(선택 payload 축)와
|
||||
* `additional-option-currency-conversion.spec.ts`(표시통화 환산 축)가 같은 화면의 같은
|
||||
* 조작을 한다. 사본을 각 spec 에 두면 한쪽만 고쳐졌을 때 그 차집합이 사각이 되므로
|
||||
* 여기 한 곳에서 소유한다.
|
||||
*
|
||||
* 이 템플릿(sirsoft-basic)의 Select 는 `options` 가 있으면 네이티브 `<select>` 가 아니라
|
||||
* `button[role=option]` 커스텀 드롭다운을 렌더한다 — `selectOption()` 은 동작하지 않는다.
|
||||
*/
|
||||
import type { Page } from '@playwright/test';
|
||||
|
||||
/** 공개 상품 목록 API */
|
||||
export const PRODUCT_LIST_API = '/api/modules/sirsoft-ecommerce/products?per_page=40';
|
||||
|
||||
export interface AddOptProduct {
|
||||
/** 상품 상세 경로 */
|
||||
url: string;
|
||||
/** 메인 옵션 그룹별로 고를 값 라벨 (그룹을 **전부** 골라야 블럭이 생긴다) */
|
||||
mainValues: string[];
|
||||
/** 추가옵션 그룹 id */
|
||||
groupId: number;
|
||||
/** 그 그룹에서 고를 선택지 이름 */
|
||||
valueName: string;
|
||||
/** 그 선택지의 추가금 (기본통화 기준, 0 이면 총액 증가 단언은 건너뛴다) */
|
||||
priceAdjustment: number;
|
||||
}
|
||||
|
||||
/**
|
||||
* 공개 목록에서 "메인 옵션 2개 이상 + 추가옵션 그룹 보유" 상품을 찾는다.
|
||||
*
|
||||
* @param page Playwright 페이지
|
||||
* @return 찾은 상품 (없으면 null)
|
||||
*/
|
||||
export async function findAdditionalOptionProduct(page: Page): Promise<AddOptProduct | null> {
|
||||
const codes: string[] = await page.evaluate(async (api) => {
|
||||
const res = await fetch(api, { headers: { Accept: 'application/json' } });
|
||||
if (!res.ok) return [];
|
||||
const json = await res.json();
|
||||
const rows = json?.data?.data ?? json?.data ?? [];
|
||||
return rows.map((p: any) => p.product_code).filter(Boolean);
|
||||
}, PRODUCT_LIST_API);
|
||||
|
||||
for (const code of codes.slice(0, 20)) {
|
||||
const detail = await page.evaluate(async (c) => {
|
||||
const res = await fetch(`/api/modules/sirsoft-ecommerce/products/${c}`, {
|
||||
headers: { Accept: 'application/json' },
|
||||
});
|
||||
if (!res.ok) return null;
|
||||
const json = await res.json();
|
||||
const d = json?.data ?? json;
|
||||
return {
|
||||
optionCount: (d?.options ?? []).length,
|
||||
// 옵션 그룹을 전부 골라야 선택 블럭이 만들어지고 그 안에 추가옵션이 렌더된다
|
||||
mainValues: (d?.option_groups ?? []).map((g: any) => g?.values_localized?.[0] ?? null),
|
||||
additional: d?.additional_options ?? [],
|
||||
};
|
||||
}, code);
|
||||
|
||||
if (!detail || detail.optionCount <= 1) continue;
|
||||
if (!detail.mainValues.length || detail.mainValues.some((v: any) => !v)) continue;
|
||||
|
||||
for (const group of detail.additional as any[]) {
|
||||
const active = (group.values ?? []).filter((v: any) => v.is_active !== false);
|
||||
// 총액 변화를 볼 수 있도록 추가금이 양수인 선택지를 우선한다
|
||||
const value = active.find((v: any) => Number(v.price_adjustment ?? 0) > 0) ?? active[0];
|
||||
if (!value) continue;
|
||||
return {
|
||||
url: `/shop/products/${code}`,
|
||||
mainValues: detail.mainValues.map(String),
|
||||
groupId: Number(group.id),
|
||||
valueName: String(value.name),
|
||||
priceAdjustment: Number(value.price_adjustment ?? 0),
|
||||
};
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 커스텀 드롭다운 Select 에서 라벨(부분 일치)로 항목을 고른다.
|
||||
*
|
||||
* @param page Playwright 페이지
|
||||
* @param testId Select 래퍼의 data-testid
|
||||
* @param label 고를 항목 라벨 (부분 일치)
|
||||
* @return 없음
|
||||
*/
|
||||
export async function pickOption(page: Page, testId: string, label: string | RegExp): Promise<void> {
|
||||
await page.getByTestId(testId).getByRole('button').first().click();
|
||||
await page.getByRole('option', { name: label }).first().click();
|
||||
}
|
||||
|
||||
/**
|
||||
* 정규식 메타문자를 이스케이프한다.
|
||||
*
|
||||
* 추가옵션 이름에는 괄호가 흔하고(`연장 보증 (2년)`), 화면 라벨은 그 뒤에 추가금이 붙으므로
|
||||
* **부분 일치**가 필요하다 — 이스케이프 없이 RegExp 로 감싸면 괄호가 캡처 그룹으로 해석돼
|
||||
* 아무것도 매칭되지 않는다.
|
||||
*
|
||||
* @param text 원문
|
||||
* @return 이스케이프된 문자열
|
||||
*/
|
||||
export function escapeRegExp(text: string): string {
|
||||
return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
|
||||
}
|
||||
|
||||
/**
|
||||
* 메인 옵션 그룹을 순서대로 전부 고른다.
|
||||
*
|
||||
* 하위 그룹 Select 는 상위 그룹이 선택될 때까지 disabled 이고, **모든** 그룹이 선택돼야
|
||||
* 선택 블럭(과 그 안의 추가옵션)이 만들어진다.
|
||||
*
|
||||
* @param page Playwright 페이지
|
||||
* @param values 그룹 순서대로의 값 라벨
|
||||
* @return 없음
|
||||
*/
|
||||
export async function pickAllMainOptions(page: Page, values: string[]): Promise<void> {
|
||||
for (let i = 0; i < values.length; i++) {
|
||||
await pickOption(page, `option-group-${i}`, values[i]);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 헤더 통화 셀렉터에서 **보이는** 요소를 고른다.
|
||||
*
|
||||
* 이 셀렉터는 데스크톱 헤더와 모바일 드로어 두 곳에 렌더되므로 같은 `data-testid` 가
|
||||
* 항상 2개 이상 잡힌다. `.first()` 는 그중 숨은 쪽을 집을 수 있고, 그러면 클릭이
|
||||
* 타임아웃되거나 목록이 비어 보인다 — 화면 폭에 따라 어느 쪽이 먼저인지도 달라진다.
|
||||
*
|
||||
* 인덱스로 고른 요소(`nth(i)`)를 돌려주면 안 된다 — 헤더는 데이터소스가 정착하며 다시
|
||||
* 그려지고, 그때 순서가 바뀌면 같은 인덱스가 숨은 쪽을 가리킨다(클릭이 "not visible" 로
|
||||
* 50회 재시도 후 실패). `:visible` 필터를 담은 locator 를 돌려주면 **동작 시점에** 다시
|
||||
* 해석되므로 그 경합이 성립하지 않는다.
|
||||
*
|
||||
* @param page Playwright 페이지
|
||||
* @param testId 대상 testid
|
||||
* @param timeoutMs 최대 대기 (기본 15초)
|
||||
* @return 보이는 요소 locator (마감까지 없으면 null)
|
||||
*/
|
||||
async function visibleByTestId(page: Page, testId: string, timeoutMs = 15_000) {
|
||||
const locator = page.locator(`[data-testid="${testId}"]:visible`).first();
|
||||
try {
|
||||
await locator.waitFor({ state: 'visible', timeout: timeoutMs });
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
return locator;
|
||||
}
|
||||
|
||||
/**
|
||||
* 헤더 통화 셀렉터로 **현재와 다른** 표시통화로 전환한다.
|
||||
*
|
||||
* 셀렉터는 이커머스 모듈이 `_user_base` 에 주입하는 레이아웃 확장이 소유한다(템플릿이 아니다).
|
||||
* 전환 대상은 현재 트리거가 보여 주는 코드가 아닌 것 중 하나를 고른다 — 어느 통화가
|
||||
* 기본인지 spec 이 알 필요가 없다.
|
||||
*
|
||||
* @param page Playwright 페이지
|
||||
* @param exclude 이 코드들은 고르지 않는다 (기본값: 현재 표시통화만 제외)
|
||||
* @return 전환한 통화 코드 (셀렉터가 없거나 고를 통화가 없으면 null)
|
||||
*/
|
||||
export async function switchToOtherCurrency(page: Page, exclude: string[] = []): Promise<string | null> {
|
||||
const trigger = await visibleByTestId(page, 'currency-switcher');
|
||||
if (trigger === null) return null;
|
||||
const current = (await trigger.innerText()).replace(/\s+/g, ' ').trim();
|
||||
|
||||
await trigger.click();
|
||||
const options = page.locator('[data-testid^="currency-option-"]');
|
||||
await options.first().waitFor({ state: 'attached', timeout: 10_000 }).catch(() => {});
|
||||
const codes: string[] = [];
|
||||
for (let i = 0; i < (await options.count()); i++) {
|
||||
const id = await options.nth(i).getAttribute('data-testid');
|
||||
const code = id ? id.replace('currency-option-', '') : null;
|
||||
if (code && !codes.includes(code)) codes.push(code);
|
||||
}
|
||||
|
||||
const target = codes.find((c) => !current.includes(c) && !exclude.includes(c));
|
||||
if (!target) {
|
||||
await page.keyboard.press('Escape');
|
||||
return null;
|
||||
}
|
||||
const option = await visibleByTestId(page, `currency-option-${target}`);
|
||||
if (option === null) return null;
|
||||
await option.click();
|
||||
return target;
|
||||
}
|
||||
+54
-43
@@ -1,7 +1,5 @@
|
||||
/**
|
||||
* 상품폼 추가옵션 선택지 round-trip + 생성 후 id 기반 리다이렉트 회귀 (skeleton, placeholder).
|
||||
*
|
||||
* 세션 D 정밀 점검에서 발견·수정한 2건의 관리자 폼 회귀를 커버한다.
|
||||
* 상품폼 추가옵션 선택지 round-trip (관리자 수정폼).
|
||||
*
|
||||
* @scenario product-additional-options
|
||||
* @effects edit_form_loads_existing_option_values,
|
||||
@@ -9,68 +7,81 @@
|
||||
* create_redirects_to_numeric_id_edit_url,
|
||||
* redirected_edit_form_loads_data
|
||||
*
|
||||
* e2e:allow 세션 D 회귀 수정 — 단위/구조 테스트로 1차 차단하고, 브라우저 회귀는 본 placeholder
|
||||
* (test.describe.skip)가 data-testid 보강 후 활성화될 때 검증한다.
|
||||
* 현재 커버리지:
|
||||
* (1) 회귀#1 (관리자 수정폼이 기존 추가옵션 선택지(values)를 미로드 → 저장 시 선택지 영구 소실):
|
||||
* findWithOptions 가 additionalOptions.values 를 eager-load 하고 ProductResource 가 values 를
|
||||
* round-trip 형식으로 노출함을 PHPUnit
|
||||
* tests/Unit/Resources/ProductResourceAdditionalOptionsTest.php
|
||||
* (test_get_detail_eager_loads_additional_option_values / test_resource_exposes_additional_option_values)
|
||||
* 가 검증한다. 수정 전 fail → eager-load 추가 후 green.
|
||||
* (2) 회귀#2 (저장 onSuccess navigate 가 product_code URL 사용 → detail API 405 → 폼 빈 로드):
|
||||
* 생성모드 navigate path 가 result.data.id 를 사용(product_code 미사용)함을 레이아웃 구조 테스트
|
||||
* resources/js/__tests__/layouts/productOptionsAdditionalToggle.test.tsx
|
||||
* ("회귀: 상품 생성/저장 후 navigate 는 id 기반") 가 검증한다.
|
||||
* 라이브 재검(Playwright MCP, 실 도메인 g7_2.dev):
|
||||
* - 회귀#1: 상품 306 edit 재로드 시 각인(없음+0/각인추가+5000)·선물포장(기본포장+3000/고급포장 off)
|
||||
* 선택지가 form.additional_options[].values 로 정상 로드됨을 확인.
|
||||
* - 회귀#2: 신규 상품 생성 → /admin/ecommerce/products/314/edit (숫자 id) 로 리다이렉트되고
|
||||
* 리다이렉트된 폼이 데이터를 로드(isDataLoaded 진입, name/code/options 표시)함을 확인.
|
||||
* 회귀#1 (관리자 수정폼이 기존 추가옵션 선택지(values)를 미로드 → 저장 시 선택지 영구 소실) 을
|
||||
* 브라우저에서 직접 차단한다. 로드와 저장-후-영속 두 축을 모두 재현한다.
|
||||
*
|
||||
* 본 spec 은 다음 사전 작업 완료 후 활성화한다 (data-testid 보강):
|
||||
* 1. 상품옵션 탭 버튼에 data-testid="product-tab-options"
|
||||
* 2. 추가옵션 선택지 행(name/추가금)에 data-testid="additional-value-{groupIdx}-{valueIdx}"
|
||||
* 3. 신규 등록 폼 필수 필드(상품코드/상품명/재고/카테고리/옵션) data-testid + 저장 버튼 data-testid="product-save"
|
||||
* 4. test.describe.skip → test.describe 변경 + 추가옵션 선택지 보유 상품 시드(§12.B 전제)
|
||||
* e2e:allow 회귀#2(생성 저장 후 navigate 가 product_code 대신 숫자 id 를 쓴다) 축은 브라우저
|
||||
* 시험으로 켜지 않는다 — 상품 생성 폼은 name(다국어)·product_code·category_ids·
|
||||
* list_price·selling_price·stock_quantity 에 더해 option_groups/options 를 필수로
|
||||
* 요구하고, 옵션 생성은 MultilingualTagInput(모달 기반 composite) → generateOptions →
|
||||
* 생성된 행별 가격·재고 입력을 거쳐야 한다. 그 흐름을 브라우저로 몰아 넣으면 검증하려는
|
||||
* navigate 한 줄보다 폼 조작 자체가 훨씬 자주 깨져 회귀 신호가 묻힌다.
|
||||
* 대신 레이아웃 구조 테스트
|
||||
* resources/js/__tests__/layouts/productOptionsAdditionalToggle.test.tsx
|
||||
* ("회귀: 상품 생성/저장 후 navigate 는 id 기반") 가 생성모드 navigate path 가
|
||||
* result.data.id 를 쓰고 product_code 를 쓰지 않음을 고정한다.
|
||||
* 라이브 재검(Playwright MCP)으로 신규 생성 → /admin/ecommerce/products/314/edit
|
||||
* (숫자 id) 리다이렉트 + 리다이렉트된 폼의 데이터 로드를 확인했다.
|
||||
*
|
||||
* 탭 클릭이 없는 이유: 상품폼 탭 네비게이션은 enableScrollSpy 방식이고 추가옵션 섹션에는
|
||||
* 조건부 렌더(if)가 없다 — 모든 섹션이 처음부터 DOM 에 있고 탭은 스크롤만 이동시킨다.
|
||||
*
|
||||
* 매트릭스 (시나리오 매니페스트 product-additional-options.yaml 와 1:1):
|
||||
* - 수정폼 진입: 기존 선택지(이름/추가금/기본/활성/정렬)가 round-trip 로드된다 (회귀#1)
|
||||
* - 수정폼 진입: 기존 선택지(이름/추가금)가 round-trip 로드된다 (회귀#1)
|
||||
* - 저장 후 재로드: 선택지가 소실 없이 영속된다 (회귀#1)
|
||||
* - 신규 생성 저장: /products/{숫자 id}/edit 로 리다이렉트된다 (회귀#2)
|
||||
* - 리다이렉트된 폼: 데이터가 로드된다(405 빈 로드 아님) (회귀#2)
|
||||
*/
|
||||
import { test, expect, authenticatePage } from '../../fixtures/ecommerce-auth';
|
||||
import { findProductWithAdditionalOptionValues } from '../../fixtures/admin-product-lookup';
|
||||
|
||||
// 추가옵션 그룹 + 선택지를 보유한 시드 상품의 수정폼 (숫자 id 경로 — product_code 직접 진입은 detail API 405)
|
||||
const EDIT_URL = '/admin/ecommerce/products/306/edit';
|
||||
const CREATE_URL = '/admin/ecommerce/products/create';
|
||||
// 대상 상품은 실행 시점에 찾는다 (숫자 id 경로 — product_code 직접 진입은 detail API 405).
|
||||
const editUrl = (id: number) => `/admin/ecommerce/products/${id}/edit`;
|
||||
|
||||
test.describe.skip('상품폼 추가옵션 round-trip + 생성 리다이렉트 (placeholder — data-testid 보강 후 활성화)', () => {
|
||||
test.describe('상품폼 추가옵션 선택지 round-trip', () => {
|
||||
test('수정폼 진입 — 기존 추가옵션 선택지가 round-trip 로드된다 (회귀#1)', async ({
|
||||
page,
|
||||
productManageToken,
|
||||
}) => {
|
||||
await authenticatePage(page, productManageToken);
|
||||
await page.goto(EDIT_URL);
|
||||
|
||||
await page.getByTestId('product-tab-options').click();
|
||||
await page.goto('/admin/ecommerce/products');
|
||||
const productId = await findProductWithAdditionalOptionValues(page);
|
||||
test.skip(productId === null, '추가옵션 선택지를 보유한 상품이 없어 검증할 수 없습니다');
|
||||
await page.goto(editUrl(productId as number));
|
||||
|
||||
// 그룹의 첫 선택지가 이름·추가금을 보유한 채 렌더되어야 한다 (values 미로드 시 0행 → 저장 시 소실)
|
||||
await expect(page.getByTestId('additional-value-0-0')).toBeVisible({ timeout: 10_000 });
|
||||
await expect(page.getByTestId('additional-value-0-0')).toBeVisible({ timeout: 15_000 });
|
||||
});
|
||||
|
||||
test('신규 생성 저장 — 숫자 id 기반 edit URL 로 리다이렉트되고 폼이 로드된다 (회귀#2)', async ({
|
||||
test('저장 후 재로드 — 추가옵션 선택지가 소실 없이 영속된다 (회귀#1)', async ({
|
||||
page,
|
||||
productManageToken,
|
||||
}) => {
|
||||
await authenticatePage(page, productManageToken);
|
||||
await page.goto(CREATE_URL);
|
||||
await page.goto('/admin/ecommerce/products');
|
||||
const productId = await findProductWithAdditionalOptionValues(page);
|
||||
test.skip(productId === null, '추가옵션 선택지를 보유한 상품이 없어 검증할 수 없습니다');
|
||||
await page.goto(editUrl(productId as number));
|
||||
|
||||
// (필수 필드 입력 — data-testid 보강 후 구현)
|
||||
await page.getByTestId('product-save').click();
|
||||
const firstValue = page.getByTestId('additional-value-0-0');
|
||||
await expect(firstValue).toBeVisible({ timeout: 15_000 });
|
||||
|
||||
// product_code 가 아닌 숫자 id 경로로 이동해야 한다 (회귀: code → detail API 405 빈 로드)
|
||||
await expect(page).toHaveURL(/\/admin\/ecommerce\/products\/\d+\/edit/, { timeout: 15_000 });
|
||||
// 저장 전 선택지 개수를 센다 — values 미로드 회귀에서는 저장 시 이 행들이 통째로 사라진다
|
||||
const before = await page.getByTestId(/^additional-value-0-/).count();
|
||||
expect(before).toBeGreaterThan(0);
|
||||
|
||||
const save = page.getByTestId('product-save');
|
||||
await expect(save).toBeEnabled();
|
||||
await save.click();
|
||||
|
||||
// 저장 완료를 응답으로 확인한 뒤 재로드한다 (토스트 문구는 로케일에 의존하므로 쓰지 않는다)
|
||||
await page.waitForResponse(
|
||||
(res) =>
|
||||
res.url().includes('/api/modules/sirsoft-ecommerce/admin/products/') &&
|
||||
res.request().method() === 'PUT',
|
||||
{ timeout: 20_000 },
|
||||
);
|
||||
|
||||
await page.goto(editUrl(productId as number));
|
||||
await expect(page.getByTestId('additional-value-0-0')).toBeVisible({ timeout: 15_000 });
|
||||
expect(await page.getByTestId(/^additional-value-0-/).count()).toBe(before);
|
||||
});
|
||||
});
|
||||
+30
-34
@@ -1,54 +1,46 @@
|
||||
/**
|
||||
* 상품폼 추가옵션 "사용/미사용" 토글 + 비우기 확인 모달 (skeleton, placeholder).
|
||||
* 상품폼 추가옵션 "사용/미사용" 토글 + 비우기 확인 모달.
|
||||
*
|
||||
* @scenario admin-product-additional-options-toggle
|
||||
* @effects use_toggle_adds_first_option_row,
|
||||
* not_use_opens_clear_confirm_modal,
|
||||
* @effects not_use_opens_clear_confirm_modal,
|
||||
* clear_modal_renders_cancel_and_confirm_buttons,
|
||||
* confirm_clears_options_and_toggle_switches_to_not_use,
|
||||
* cancel_keeps_options_and_modal_closes
|
||||
*
|
||||
* e2e:allow §13-D-FAIL 회귀 수정(확인 모달 footer 버튼 미렌더 + 비우기 후 토글 미갱신) 신규 시나리오 axis 부재 —
|
||||
* 본 placeholder spec(test.describe.skip)이 data-testid 보강 후 활성화될 때 함께 검증된다.
|
||||
* 레이아웃 렌더링 테스트(productOptionsAdditionalToggle.test.tsx)가
|
||||
* (1) 확인/save_template 모달의 slots.footer 부재 + footer 버튼이 children 말미
|
||||
* flex-justify-end Div 안에 존재(Modal.tsx 가 slots 미렌더 → children 만 렌더)함을,
|
||||
* (2) 확인 버튼이 dot-path 인라인 setState 가 아닌 clearAdditionalOptions 전용 핸들러를
|
||||
* 호출함을 구조적으로 회귀 차단한다.
|
||||
* 핸들러 단위 테스트(optionHandlers.test.ts > clearAdditionalOptionsHandler)가
|
||||
* clear 가 form 객체를 새 참조로 통째 교체(add 핸들러와 동일 패턴)하여
|
||||
* form 을 watch 하는 토글 className 파생식의 리렌더 누락을 차단함을 검증한다.
|
||||
* 라이브 재검(Playwright MCP, PW-ADDOPT-001 id 306)으로 미사용→확인 클릭 시
|
||||
* 취소/확인 버튼 렌더 + 비우기 후 토글 "미사용" active 전환 + "각인 문구" 행 소멸을 확증했다.
|
||||
* §13-D-FAIL 회귀(확인 모달 footer 버튼 미렌더 + 비우기 후 토글 미갱신)를 브라우저에서 직접 차단한다.
|
||||
* 같은 회귀를 구조적으로 고정하는 하위 테스트는 그대로 유지된다 —
|
||||
* 레이아웃 렌더링 테스트(productOptionsAdditionalToggle.test.tsx)가 footer 버튼의 children 배치와
|
||||
* 확인 버튼의 clearAdditionalOptions 핸들러 호출을, 핸들러 단위 테스트
|
||||
* (optionHandlers.test.ts > clearAdditionalOptionsHandler)가 form 객체 통째 교체를 검증한다.
|
||||
*
|
||||
* 본 spec 은 다음 사전 작업 완료 후 활성화한다 (data-testid 보강):
|
||||
* 1. 상품옵션 탭 버튼에 data-testid="product-tab-options"
|
||||
* 2. 추가옵션 "사용"/"미사용" 토글 버튼에 data-testid="additional-option-use" / "additional-option-not-use"
|
||||
* 3. 추가옵션 행 컨테이너(additional_options_content)에 data-testid="additional-options-content"
|
||||
* 4. 확인 모달(additional_options_clear_modal)의 취소/확인 버튼에
|
||||
* data-testid="additional-clear-cancel" / "additional-clear-confirm"
|
||||
* 5. test.describe.skip → test.describe 변경
|
||||
* 추가옵션 행 컨테이너는 testid 가 아니라 레이아웃이 이미 가진 DOM id(#additional_options_content)로
|
||||
* 잡는다 — 그 노드에 props 를 새로 만들어 붙이면 서빙 단계에서 props 가 [] 로 버려진다(실측).
|
||||
*
|
||||
* 탭 클릭이 없는 이유: 상품폼 탭 네비게이션은 enableScrollSpy 방식이고 추가옵션 섹션에는
|
||||
* 조건부 렌더(if)가 없다 — 모든 섹션이 처음부터 DOM 에 있고 탭은 스크롤만 이동시킨다.
|
||||
*
|
||||
* 매트릭스(시나리오 매니페스트 admin-product-additional-options-toggle.yaml 와 1:1):
|
||||
* - "사용" 클릭(0행) : 첫 추가옵션 행 추가 + "사용" active
|
||||
* - "미사용" 클릭(N행) : 확인 모달 노출(취소/확인 버튼 렌더)
|
||||
* - 확인 : 옵션 비워짐 + 토글 "미사용" active 전환 + 행 소멸 + 모달 닫힘
|
||||
* - 취소 : 옵션 유지 + 모달만 닫힘
|
||||
*/
|
||||
import { test, expect, authenticatePage } from '../../fixtures/ecommerce-auth';
|
||||
import { findProductWithAdditionalOptionValues } from '../../fixtures/admin-product-lookup';
|
||||
|
||||
// 추가옵션 1행을 보유한 시드 상품의 수정폼 (숫자 id 경로 — product_code 직접 진입은 detail API 405)
|
||||
const EDIT_URL = '/admin/ecommerce/products/306/edit';
|
||||
// 대상 상품은 실행 시점에 찾는다 (숫자 id 경로 — product_code 직접 진입은 detail API 405).
|
||||
const editUrl = (id: number) => `/admin/ecommerce/products/${id}/edit`;
|
||||
|
||||
test.describe.skip('상품폼 추가옵션 토글 + 비우기 확인 모달 (placeholder — data-testid 보강 후 활성화)', () => {
|
||||
test.describe('상품폼 추가옵션 토글 + 비우기 확인 모달', () => {
|
||||
test('미사용 클릭 — 확인 모달이 열리고 취소/확인 버튼이 렌더된다 (§13-D-FAIL footer)', async ({
|
||||
page,
|
||||
productManageToken,
|
||||
}) => {
|
||||
await authenticatePage(page, productManageToken);
|
||||
await page.goto(EDIT_URL);
|
||||
await page.goto('/admin/ecommerce/products');
|
||||
const productId = await findProductWithAdditionalOptionValues(page);
|
||||
test.skip(productId === null, '추가옵션 선택지를 보유한 상품이 없어 검증할 수 없습니다');
|
||||
await page.goto(editUrl(productId as number));
|
||||
|
||||
await page.getByTestId('product-tab-options').click();
|
||||
await page.getByTestId('additional-option-not-use').click();
|
||||
|
||||
// footer 버튼이 children 으로 이동했으므로 취소/확인 모두 렌더되어야 한다 (slots.footer 였을 땐 미렌더)
|
||||
@@ -61,28 +53,32 @@ test.describe.skip('상품폼 추가옵션 토글 + 비우기 확인 모달 (pla
|
||||
productManageToken,
|
||||
}) => {
|
||||
await authenticatePage(page, productManageToken);
|
||||
await page.goto(EDIT_URL);
|
||||
await page.goto('/admin/ecommerce/products');
|
||||
const productId = await findProductWithAdditionalOptionValues(page);
|
||||
test.skip(productId === null, '추가옵션 선택지를 보유한 상품이 없어 검증할 수 없습니다');
|
||||
await page.goto(editUrl(productId as number));
|
||||
|
||||
await page.getByTestId('product-tab-options').click();
|
||||
await page.getByTestId('additional-option-not-use').click();
|
||||
await page.getByTestId('additional-clear-confirm').click();
|
||||
|
||||
// clearAdditionalOptions 가 form 을 통째 교체 → 행 소멸 + "미사용" active
|
||||
await expect(page.getByTestId('additional-options-content')).not.toBeVisible();
|
||||
await expect(page.locator('#additional_options_content')).not.toBeVisible();
|
||||
await expect(page.getByTestId('additional-option-not-use')).toHaveClass(/active/);
|
||||
await expect(page.getByTestId('additional-option-use')).not.toHaveClass(/active/);
|
||||
});
|
||||
|
||||
test('취소 — 옵션이 유지되고 모달만 닫힌다', async ({ page, productManageToken }) => {
|
||||
await authenticatePage(page, productManageToken);
|
||||
await page.goto(EDIT_URL);
|
||||
await page.goto('/admin/ecommerce/products');
|
||||
const productId = await findProductWithAdditionalOptionValues(page);
|
||||
test.skip(productId === null, '추가옵션 선택지를 보유한 상품이 없어 검증할 수 없습니다');
|
||||
await page.goto(editUrl(productId as number));
|
||||
|
||||
await page.getByTestId('product-tab-options').click();
|
||||
await page.getByTestId('additional-option-not-use').click();
|
||||
await page.getByTestId('additional-clear-cancel').click();
|
||||
|
||||
// 비우기 미실행 — 행 유지 + 모달 닫힘
|
||||
await expect(page.getByTestId('additional-clear-confirm')).not.toBeVisible();
|
||||
await expect(page.getByTestId('additional-options-content')).toBeVisible();
|
||||
await expect(page.locator('#additional_options_content')).toBeVisible();
|
||||
});
|
||||
});
|
||||
+151
-66
@@ -1,7 +1,6 @@
|
||||
/**
|
||||
* 추가옵션 추가금의 표시통화 환산 — 기본통화 ≠ 표시통화 쇼핑몰에서 추가금이
|
||||
* 상품가와 같은 통화로 표시되고 합계에도 환산되어 더해지는지 검증.
|
||||
* 템플릿 sirsoft-basic (유저 화면). (skeleton, placeholder)
|
||||
* 추가옵션 추가금의 표시통화 환산 — 추가금이 상품가·총액과 **같은 통화**로 표기되고
|
||||
* 합계에도 그 통화로 더해지는지 검증. 템플릿 sirsoft-basic (유저 화면).
|
||||
*
|
||||
* @scenario currency-symbol-display
|
||||
* @effects additional_option_adjustment_uses_configured_symbol,
|
||||
@@ -15,97 +14,183 @@
|
||||
* "환산된 상품가 + 환산 안 된 추가금" 이라는 통화가 섞인 합계가 나왔다
|
||||
* (상품가 ₩114,000 + 추가금 ¥5,000 → ₩119,000 표기).
|
||||
*
|
||||
* e2e:allow 재현에 쇼핑몰 전역 통화 설정(기본통화를 KRW 가 아닌 통화로 전환 + 환율 지정)이
|
||||
* 필요해 공용 개발 사이트를 흔들지 않고는 자동화할 수 없다. 통화 설정 시드가
|
||||
* 갖춰지기 전까지는 아래 커버리지로 대체한다.
|
||||
* (1) 서버 계약 — tests/Unit/Resources/AdditionalOptionMultiCurrencyTest.php
|
||||
* (상품상세·장바구니 응답의 multi_currency_price_adjustment, 음수 추가금 부호 유지) green.
|
||||
* (2) 합계 계산 — templates/_bundled/sirsoft-basic/src/handlers/__tests__/
|
||||
* productOptionsAdditionalCurrency.test.ts
|
||||
* (표시통화 합계에 환산 추가금 가산, 수량 배수, 미선택 0, 항목 생성 시 통화별 합계 적재) green.
|
||||
* (3) 폴백 — productOptionsAdditional.test.ts 의 기존 케이스가 서버 맵이 없는
|
||||
* 응답에서 기본통화 피봇 환산으로 종전 값을 유지함을 고정 green.
|
||||
* 라이브 검수는 Chrome MCP 실측으로 기록됨 — 기본통화 JPY / 표시통화 KRW 상태에서
|
||||
* 수정 전 ₩119,000·"+¥3,000" → 수정 후 ₩142,500·"+28,500원" 확인.
|
||||
* **불변조건**: 한 화면 안에서 추가금 표기의 통화 = 그 상품가·총액 표기의 통화.
|
||||
* 어느 통화가 기본이든 성립해야 하므로 이 spec 은 통화 코드를 박지 않는다 —
|
||||
* 화면에서 읽은 총액의 통화 표식과 대조한다. 기본통화 = 표시통화인 쇼핑몰에서는
|
||||
* 대조가 자명하게 성립하므로, 결함을 실제로 잡으려면 둘이 다른 설정이 필요하다.
|
||||
* 그 상태를 이 spec 자신이 만든다 — 헤더 통화 셀렉터로 **기본통화가 아닌 통화**로
|
||||
* 전환한 뒤 검증하고, 전환할 통화가 하나도 없으면 사유와 함께 스킵한다.
|
||||
*
|
||||
* 활성화 조건:
|
||||
* 1. 기본통화가 KRW 가 아닌 쇼핑몰 통화 설정 시드(예: JPY 기본 + KRW 환율)
|
||||
* 2. _purchase_card 추가옵션 Select / 추가옵션 금액 라인에 data-testid
|
||||
* 3. _cart_item·_checkout_items 추가옵션 라인에 data-testid
|
||||
* 4. PLAYWRIGHT_BASE_URL = 실 도메인, test.describe.skip → test.describe
|
||||
* 이 spec 은 시드를 만들지 않는다 — 공개 상품 목록에서 "메인 옵션 2개 이상 + 추가금이
|
||||
* 양수인 추가옵션" 상품을 찾아 쓰고, 없으면 개별 테스트가 사유와 함께 스킵된다.
|
||||
*
|
||||
* 매트릭스:
|
||||
* T1 상품상세 선택지 라벨 — 표시통화로 환산 표기 (기준통화 기호가 남지 않는다)
|
||||
* T2 상품상세 "추가옵션 금액" + 총 금액 — 상품가와 같은 통화로 합산
|
||||
* T3 장바구니 줄 — 추가옵션 라벨이 그 줄의 상품가·소계와 같은 통화
|
||||
* T1 상품상세 추가옵션 선택지 라벨 — 총액과 같은 통화로 표기
|
||||
* T2 상품상세 "추가옵션 금액" — 총액과 같은 통화 (기준통화 표식이 남지 않는다)
|
||||
* T3 장바구니 줄 — 추가옵션 라벨이 상세에서 본 표시통화와 같은 통화
|
||||
* T4 주문서 줄 — 동일
|
||||
* T5 통화 전환 — 표시통화를 바꾸면 추가금 표기·합계가 함께 따라간다
|
||||
* T5 통화 전환 — 표시통화를 바꾸면 추가금 표기가 함께 따라간다
|
||||
*/
|
||||
import { test, expect, authenticatePage } from '../../fixtures/ecommerce-auth';
|
||||
import type { Page } from '@playwright/test';
|
||||
import {
|
||||
findAdditionalOptionProduct,
|
||||
pickOption,
|
||||
pickAllMainOptions,
|
||||
escapeRegExp,
|
||||
switchToOtherCurrency,
|
||||
type AddOptProduct,
|
||||
} from '../../fixtures/shop-additional-option-lookup';
|
||||
|
||||
// 추가옵션 보유 시드 상품 상세 (실 도메인 시드 후 경로 확정)
|
||||
const PRODUCT_PATH = '/shop/products/28';
|
||||
/**
|
||||
* 표기 문자열에서 **통화**를 뽑는다 (글리프가 아니다).
|
||||
*
|
||||
* KRW 는 한 화면 안에서도 두 표기가 공존한다 — 총액은 `₩142,500`, 추가금 라인은
|
||||
* `+28,500원` 이다. 앞은 다중통화 포맷터, 뒤는 레이아웃의 지역 포맷 분기가 만든다.
|
||||
* 이 spec 이 재는 불변조건은 "추가금과 총액이 **같은 통화**인가" 이므로 둘을 같은 값으로
|
||||
* 정규화한다. 글리프까지 맞추라고 요구하면 통화가 섞이지 않은 화면도 빨갛게 된다.
|
||||
*
|
||||
* @param text 화면에서 읽은 금액 표기
|
||||
* @return 통화 코드 성격의 표식 (찾지 못하면 null)
|
||||
*/
|
||||
function currencyMarkOf(text: string): string | null {
|
||||
if (text.includes('원') || text.includes('₩')) return 'KRW';
|
||||
const symbol = text.match(/[$¥€元]/);
|
||||
if (!symbol) return null;
|
||||
return { $: 'USD', '¥': 'JPY', '€': 'EUR', 元: 'CNY' }[symbol[0]] ?? symbol[0];
|
||||
}
|
||||
|
||||
test.describe.skip('추가옵션 추가금 표시통화 환산 (기본통화 ≠ 표시통화, skeleton)', () => {
|
||||
test('T1/T2 상품상세: 추가옵션 라벨과 총 금액이 표시통화로 환산된다', async ({ page, userToken }) => {
|
||||
await authenticatePage(page, userToken);
|
||||
await page.goto(PRODUCT_PATH);
|
||||
await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
|
||||
/**
|
||||
* 상품상세에서 메인 옵션 전부 + 추가금이 있는 추가옵션을 고른다.
|
||||
*
|
||||
* @param page Playwright 페이지
|
||||
* @param product 대상 상품
|
||||
* @return 없음
|
||||
*/
|
||||
async function selectOptionsWithAdditional(page: Page, product: AddOptProduct): Promise<void> {
|
||||
await pickAllMainOptions(page, product.mainValues);
|
||||
await pickOption(page, `add-option-0-${product.groupId}`, new RegExp(escapeRegExp(product.valueName)));
|
||||
}
|
||||
|
||||
// 기본옵션 선택 → 추가옵션 블럭 노출
|
||||
await page.getByTestId('option-select-0').selectOption({ index: 1 });
|
||||
await page.getByTestId('option-select-1').selectOption({ index: 1 });
|
||||
test.describe('추가옵션 추가금 표시통화 환산', () => {
|
||||
test('T1/T2 상품상세: 추가옵션 라벨과 추가금 합계가 총액과 같은 통화로 표기된다', async ({ page }) => {
|
||||
await page.goto('/shop');
|
||||
const product = await findAdditionalOptionProduct(page);
|
||||
test.skip(product === null, '메인 옵션 2개 이상 + 추가옵션을 가진 공개 상품이 없어 검증할 수 없습니다');
|
||||
test.skip(
|
||||
(product?.priceAdjustment ?? 0) <= 0,
|
||||
'추가금이 양수인 추가옵션 선택지가 없어 통화 표기를 검증할 수 없습니다',
|
||||
);
|
||||
|
||||
// 추가옵션 선택지 라벨에 기준통화 기호(¥)가 남아 있으면 안 된다
|
||||
const addOption = page.getByTestId('add-option-0-10');
|
||||
await expect(addOption).toBeVisible();
|
||||
await expect(addOption).not.toContainText('¥');
|
||||
await page.goto(product!.url);
|
||||
const switched = await switchToOtherCurrency(page);
|
||||
test.skip(switched === null, '기본통화 외 표시통화가 없어 기본통화 ≠ 표시통화 상태를 만들 수 없습니다');
|
||||
|
||||
await addOption.selectOption({ label: /선물 포장/ });
|
||||
await selectOptionsWithAdditional(page, product!);
|
||||
|
||||
// 추가옵션 금액 라인과 총 금액이 같은 통화(표시통화)로 표기된다
|
||||
const additionalAmount = page.getByTestId('additional-options-amount');
|
||||
await expect(additionalAmount).toContainText('원');
|
||||
const totalMark = currencyMarkOf(await page.getByTestId('purchase-total').innerText());
|
||||
expect(totalMark, '총액에서 통화 표식을 읽을 수 있어야 대조가 성립한다').not.toBeNull();
|
||||
|
||||
const total = page.getByTestId('purchase-total-amount');
|
||||
await expect(total).toContainText('₩');
|
||||
// T1 — 선택지 라벨의 추가금이 총액과 같은 통화
|
||||
const label = await page.getByTestId(`add-option-0-${product!.groupId}`).innerText();
|
||||
expect(currencyMarkOf(label), '추가옵션 선택지 라벨의 추가금이 총액과 다른 통화로 표기됐다').toBe(totalMark);
|
||||
|
||||
// T2 — "추가옵션 금액" 합계가 총액과 같은 통화
|
||||
const amount = await page.getByTestId('additional-options-amount').innerText();
|
||||
expect(currencyMarkOf(amount), '추가옵션 금액 합계가 총액과 다른 통화로 표기됐다').toBe(totalMark);
|
||||
});
|
||||
|
||||
test('T3 장바구니: 추가옵션 라벨이 그 줄의 소계와 같은 통화로 표기된다', async ({ page, userToken }) => {
|
||||
await authenticatePage(page, userToken);
|
||||
test('T3 장바구니: 추가옵션 줄이 상세에서 본 표시통화로 표기된다', async ({ page }) => {
|
||||
await page.goto('/shop');
|
||||
const product = await findAdditionalOptionProduct(page);
|
||||
test.skip(product === null, '메인 옵션 2개 이상 + 추가옵션을 가진 공개 상품이 없어 검증할 수 없습니다');
|
||||
test.skip(
|
||||
(product?.priceAdjustment ?? 0) <= 0,
|
||||
'추가금이 양수인 추가옵션 선택지가 없어 통화 표기를 검증할 수 없습니다',
|
||||
);
|
||||
|
||||
await page.goto(product!.url);
|
||||
const switched = await switchToOtherCurrency(page);
|
||||
test.skip(switched === null, '기본통화 외 표시통화가 없어 기본통화 ≠ 표시통화 상태를 만들 수 없습니다');
|
||||
|
||||
await selectOptionsWithAdditional(page, product!);
|
||||
const totalMark = currencyMarkOf(await page.getByTestId('purchase-total').innerText());
|
||||
|
||||
const [response] = await Promise.all([
|
||||
page.waitForResponse((r) => r.url().includes('/cart') && r.request().method() === 'POST'),
|
||||
page.getByTestId('add-to-cart').click(),
|
||||
]);
|
||||
expect(response.status(), '담기가 성공해야 장바구니를 확인할 수 있다').toBeLessThan(300);
|
||||
|
||||
await page.goto('/shop/cart');
|
||||
await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
|
||||
|
||||
const line = page.getByTestId('cart-item-additional-option').first();
|
||||
await expect(line).toContainText('원');
|
||||
await expect(line).not.toContainText('¥');
|
||||
await expect(line, '장바구니에 추가옵션 줄이 있어야 한다').toBeVisible();
|
||||
expect(
|
||||
currencyMarkOf(await line.innerText()),
|
||||
'장바구니 추가옵션 줄이 표시통화가 아닌 통화로 표기됐다',
|
||||
).toBe(totalMark);
|
||||
});
|
||||
|
||||
test('T4 주문서: 추가옵션 라벨이 표시통화로 표기된다', async ({ page, userToken }) => {
|
||||
test('T4 주문서: 추가옵션 줄이 표시통화로 표기된다', async ({ page, userToken }) => {
|
||||
await authenticatePage(page, userToken);
|
||||
await page.goto('/shop/checkout');
|
||||
await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
|
||||
await page.goto('/shop');
|
||||
const product = await findAdditionalOptionProduct(page);
|
||||
test.skip(product === null, '메인 옵션 2개 이상 + 추가옵션을 가진 공개 상품이 없어 검증할 수 없습니다');
|
||||
test.skip(
|
||||
(product?.priceAdjustment ?? 0) <= 0,
|
||||
'추가금이 양수인 추가옵션 선택지가 없어 통화 표기를 검증할 수 없습니다',
|
||||
);
|
||||
|
||||
await page.goto(product!.url);
|
||||
const switched = await switchToOtherCurrency(page);
|
||||
test.skip(switched === null, '기본통화 외 표시통화가 없어 기본통화 ≠ 표시통화 상태를 만들 수 없습니다');
|
||||
|
||||
await selectOptionsWithAdditional(page, product!);
|
||||
const totalMark = currencyMarkOf(await page.getByTestId('purchase-total').innerText());
|
||||
|
||||
// 주문서는 "바로 구매" 로 진입한다 — 장바구니를 거치지 않아 사전 적재가 필요 없다
|
||||
await Promise.all([
|
||||
page.waitForResponse((r) => r.url().includes('/checkout') && r.request().method() === 'POST'),
|
||||
page.getByTestId('buy-now').click(),
|
||||
]);
|
||||
await page.waitForURL(/\/shop\/checkout/, { timeout: 30_000 });
|
||||
|
||||
const line = page.getByTestId('checkout-item-additional-option').first();
|
||||
await expect(line).toContainText('원');
|
||||
await expect(line).not.toContainText('¥');
|
||||
await expect(line, '주문서에 추가옵션 줄이 있어야 한다').toBeVisible();
|
||||
expect(
|
||||
currencyMarkOf(await line.innerText()),
|
||||
'주문서 추가옵션 줄이 표시통화가 아닌 통화로 표기됐다',
|
||||
).toBe(totalMark);
|
||||
});
|
||||
|
||||
test('T5 통화 전환: 표시통화를 바꾸면 추가금 표기와 합계가 함께 따라간다', async ({ page, userToken }) => {
|
||||
await authenticatePage(page, userToken);
|
||||
await page.goto(PRODUCT_PATH);
|
||||
await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
|
||||
test('T5 통화 전환: 표시통화를 바꾸면 추가금 표기가 함께 따라간다', async ({ page }) => {
|
||||
await page.goto('/shop');
|
||||
const product = await findAdditionalOptionProduct(page);
|
||||
test.skip(product === null, '메인 옵션 2개 이상 + 추가옵션을 가진 공개 상품이 없어 검증할 수 없습니다');
|
||||
test.skip(
|
||||
(product?.priceAdjustment ?? 0) <= 0,
|
||||
'추가금이 양수인 추가옵션 선택지가 없어 통화 표기를 검증할 수 없습니다',
|
||||
);
|
||||
|
||||
await page.getByTestId('option-select-0').selectOption({ index: 1 });
|
||||
await page.getByTestId('option-select-1').selectOption({ index: 1 });
|
||||
await page.getByTestId('add-option-0-10').selectOption({ label: /선물 포장/ });
|
||||
await page.goto(product!.url);
|
||||
const first = await switchToOtherCurrency(page);
|
||||
test.skip(first === null, '기본통화 외 표시통화가 없어 전환을 검증할 수 없습니다');
|
||||
|
||||
await selectOptionsWithAdditional(page, product!);
|
||||
const before = await page.getByTestId('additional-options-amount').innerText();
|
||||
const beforeMark = currencyMarkOf(before);
|
||||
|
||||
await page.getByTestId('currency-switcher').click();
|
||||
await page.getByRole('option', { name: 'USD' }).click();
|
||||
const second = await switchToOtherCurrency(page);
|
||||
test.skip(second === null || second === first, '전환할 세 번째 통화가 없어 검증할 수 없습니다');
|
||||
|
||||
await expect(page.getByTestId('additional-options-amount')).not.toHaveText(before);
|
||||
await expect(page.getByTestId('additional-options-amount')).toContainText('$');
|
||||
await expect
|
||||
.poll(async () => currencyMarkOf(await page.getByTestId('additional-options-amount').innerText()))
|
||||
.not.toBe(beforeMark);
|
||||
// 전환 후에도 총액과 같은 통화여야 한다 (한쪽만 따라가면 통화가 섞인다)
|
||||
const totalMark = currencyMarkOf(await page.getByTestId('purchase-total').innerText());
|
||||
expect(
|
||||
currencyMarkOf(await page.getByTestId('additional-options-amount').innerText()),
|
||||
'통화 전환 후 추가금과 총액의 통화가 어긋났다',
|
||||
).toBe(totalMark);
|
||||
});
|
||||
});
|
||||
+75
-52
@@ -1,6 +1,6 @@
|
||||
/**
|
||||
* 유저 상품 추가옵션(유료) 흐름 — 상품상세 블럭 선택 → 담기/바로구매 → 장바구니 모달 재선택 → 체크아웃/주문 표시.
|
||||
* 템플릿 sirsoft-basic (유저 화면). (skeleton, placeholder)
|
||||
* 유저 상품 추가옵션(유료) 흐름 — 상품상세 블럭 선택 → 실시간 합계 → 담기 payload → 장바구니 표시.
|
||||
* 템플릿 sirsoft-basic (유저 화면).
|
||||
*
|
||||
* @scenario product-additional-options
|
||||
* @effects detail_block_renders_active_values_only,
|
||||
@@ -11,66 +11,89 @@
|
||||
* cart_modal_reselect_and_patch,
|
||||
* order_display_snapshot_additional_rows
|
||||
*
|
||||
* e2e:allow 세션 C(유저 흐름 + 표시) 신규 UI — 단위/레이아웃 렌더 테스트로 결함을 1차 차단하고,
|
||||
* 브라우저 회귀는 본 placeholder(test.describe.skip)가 data-testid 보강 + 실 도메인 시드 후 활성화될 때 검증한다.
|
||||
* 현재 커버리지:
|
||||
* (1) 핸들러 로직 — templates/_bundled/sirsoft-basic/src/handlers/__tests__/productOptionsAdditional.test.ts
|
||||
* (블럭별 추가옵션 선택/해제, 추가금×수량 배수 D6, 다통화 환산, payload 변환) green.
|
||||
* (2) 레이아웃 구조/렌더 — templates/_bundled/sirsoft-basic/src/__tests__/layouts/shopAdditionalOptions.test.tsx
|
||||
* (블럭 내부 그룹 iteration, setBlockAdditionalOption 호출, 담기 body 의 additional_option_selections,
|
||||
* 필수 미선택 가드, 레거시 자유텍스트 스텁 제거, 장바구니/체크아웃/주문완료/마이페이지 스냅샷 표시) green.
|
||||
* (3) 관리자 주문서 스냅샷 별행 — resources/js/__tests__/layouts/adminOrderInfoAdditionalOptions.test.ts green.
|
||||
* 백엔드 계약(담기/옵션변경/체크아웃 입력, CartItemResource/OrderOptionResource 출력, 422 reason)은
|
||||
* 세션 A PHPUnit 으로 검증됨.
|
||||
* 배경: 추가옵션 선택은 템플릿 커스텀 핸들러가 `context.setState` 로 기록한다. engine-v1.63.5
|
||||
* (트러블슈팅 사례 42) 이전에는 그 쓰기가 저장소 B 에 닿지 않아, 화면에는 선택이 보이는데
|
||||
* 담기 요청의 `additional_option_selections` 가 비어 나갔다. 예외도 콘솔 에러도 없었다.
|
||||
* 요청 body 를 보는 이 spec 이 그 결함을 잡는 종단 통로다.
|
||||
*
|
||||
* 본 spec 은 다음 사전 작업 완료 후 활성화한다:
|
||||
* 1. 추가옵션 그룹 2개(필수 "각인" / 선택 "포장") × 선택지 변종(추가금 0/양수/비활성) 보유 상품 시드 (§12.C 전제)
|
||||
* 2. _purchase_card 블럭 추가옵션 Select 에 data-testid="add-option-{itemIndex}-{groupId}"
|
||||
* 3. 담기/바로구매 버튼 + 필수 미선택 토스트에 data-testid
|
||||
* 4. _cart_item 추가옵션 라인 + _modal_cart_option_change 재선택 Select 에 data-testid
|
||||
* 5. PLAYWRIGHT_BASE_URL = 실 도메인, test.describe.skip → test.describe
|
||||
* 이 spec 은 시드를 만들지 않는다 — 공개 상품 목록에서 "메인 옵션 2개 이상 + 추가옵션 그룹 보유"
|
||||
* 상품을 찾아 쓰고, 없으면 개별 테스트가 사유와 함께 스킵된다(`test.skip`). describe 를 통째로
|
||||
* 끄면 커버리지가 0 이 되므로 그렇게 하지 않는다.
|
||||
*
|
||||
* 이 템플릿의 Select 는 `options` 가 있으면 네이티브 `<select>` 가 아니라
|
||||
* `button[role=option]` 커스텀 드롭다운을 렌더한다 — `selectOption()` 은 동작하지 않는다.
|
||||
*
|
||||
* 매트릭스 (시나리오 매니페스트 product-additional-options.yaml ui_surface 축과 1:1):
|
||||
* T1 상품상세: 기본옵션 미선택 → 추가옵션 미노출 (D10)
|
||||
* T2 기본옵션 선택 → 블럭 내부 활성 선택지만 렌더(V6 비활성 제외), 추가옵션 선택 → 소계·총액 실시간(옵션가+추가옵션×수량)
|
||||
* T3 같은 옵션 2블럭 → 블럭별 독립 추가옵션, 수량 3 → 추가금×3 (D6)
|
||||
* T4 담기/바로구매 → additional_option_selections 전송, 필수 미선택 → 422 additional_option_required / 잘못된 value → 422 additional_option_invalid
|
||||
* T5 장바구니 합산 키 — (옵션+추가옵션 해시) 동일 합산 / 상이 별개 행 (D3)
|
||||
* T6 새로고침 → 장바구니 추가옵션 영속(CartItemResource.additional_options)
|
||||
* T7 옵션변경 모달 추가옵션 재선택 → 실시간 재계산 → PATCH → 부모 정합
|
||||
* 표시: 체크아웃/주문완료/마이페이지/관리자주문서 스냅샷 별행 (D14), 과거 주문(추가옵션 없음) 깨짐 0
|
||||
* T2 기본옵션 선택 → 블럭 내부 활성 선택지만 렌더, 추가옵션 선택 → 총액 실시간 반영
|
||||
* T4 담기 요청이 additional_option_selections 를 전송한다
|
||||
* T6 담은 뒤 장바구니 행에 선택한 추가옵션이 표시된다
|
||||
*/
|
||||
import { test, expect, authenticatePage } from '../../fixtures/ecommerce-auth';
|
||||
import { test, expect } from '@playwright/test';
|
||||
import {
|
||||
findAdditionalOptionProduct,
|
||||
pickOption,
|
||||
pickAllMainOptions,
|
||||
escapeRegExp,
|
||||
} from '../../fixtures/shop-additional-option-lookup';
|
||||
|
||||
// 추가옵션 보유 시드 상품 상세 (실 도메인 시드 후 경로 확정)
|
||||
const PRODUCT_URL = '/shop/products/{ADDOPT_PRODUCT_ID}';
|
||||
test.describe('유저 추가옵션 흐름', () => {
|
||||
test('T2 기본옵션 선택 → 추가옵션 선택 시 총액에 추가금이 반영된다', async ({ page }) => {
|
||||
await page.goto('/shop');
|
||||
const product = await findAdditionalOptionProduct(page);
|
||||
test.skip(product === null, '메인 옵션 2개 이상 + 추가옵션을 가진 공개 상품이 없어 검증할 수 없습니다');
|
||||
test.skip(
|
||||
(product?.priceAdjustment ?? 0) <= 0,
|
||||
'추가금이 양수인 추가옵션 선택지가 없어 총액 증가를 검증할 수 없습니다',
|
||||
);
|
||||
|
||||
test.describe.skip('유저 추가옵션 흐름 (placeholder — data-testid 보강 + 시드 후 활성화)', () => {
|
||||
test('T2 기본옵션 선택 → 블럭 내부 추가옵션 선택 시 총액이 추가금만큼 증가한다', async ({ page }) => {
|
||||
await page.goto(PRODUCT_URL);
|
||||
// 기본옵션 선택 → 블럭 생성
|
||||
await page.getByTestId('option-group-0').selectOption({ index: 1 });
|
||||
// 추가옵션(각인 추가 +5000) 선택
|
||||
await page.getByTestId('add-option-0-1').selectOption({ label: /각인 추가/ });
|
||||
// 총액에 +5,000 반영
|
||||
await expect(page.getByTestId('purchase-total')).toContainText('5,000');
|
||||
await page.goto(product!.url);
|
||||
await pickAllMainOptions(page, product!.mainValues);
|
||||
|
||||
const before = (await page.getByTestId('purchase-total').innerText()).replace(/[^\d]/g, '');
|
||||
await pickOption(page, `add-option-0-${product!.groupId}`, new RegExp(escapeRegExp(product!.valueName)));
|
||||
await expect
|
||||
.poll(async () => (await page.getByTestId('purchase-total').innerText()).replace(/[^\d]/g, ''))
|
||||
.not.toBe(before);
|
||||
});
|
||||
|
||||
test('T4 필수 추가옵션 미선택 시 담기 차단 토스트', async ({ page }) => {
|
||||
await page.goto(PRODUCT_URL);
|
||||
await page.getByTestId('option-group-0').selectOption({ index: 1 });
|
||||
// 필수 그룹 미선택 상태로 담기
|
||||
await page.getByTestId('add-to-cart').click();
|
||||
await expect(page.getByText(/필수 추가옵션/)).toBeVisible();
|
||||
test('T4 담기 요청이 additional_option_selections 를 전송한다', async ({ page }) => {
|
||||
await page.goto('/shop');
|
||||
const product = await findAdditionalOptionProduct(page);
|
||||
test.skip(product === null, '메인 옵션 2개 이상 + 추가옵션을 가진 공개 상품이 없어 검증할 수 없습니다');
|
||||
|
||||
await page.goto(product!.url);
|
||||
await pickAllMainOptions(page, product!.mainValues);
|
||||
await pickOption(page, `add-option-0-${product!.groupId}`, new RegExp(escapeRegExp(product!.valueName)));
|
||||
|
||||
const [request] = await Promise.all([
|
||||
page.waitForRequest((r) => r.url().includes('/cart') && r.method() === 'POST'),
|
||||
page.getByTestId('add-to-cart').click(),
|
||||
]);
|
||||
const body = request.postDataJSON();
|
||||
expect(body.items?.length, '선택한 옵션이 요청 body 에 실려야 한다').toBeGreaterThan(0);
|
||||
const selections = body.items?.[0]?.additional_option_selections ?? [];
|
||||
expect(
|
||||
selections.some((s: any) => Number(s.additional_option_id) === product!.groupId),
|
||||
'선택한 추가옵션이 요청 body 에 실려야 한다',
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
test('T7 장바구니 옵션변경 모달에서 추가옵션 재선택 후 PATCH 정합', async ({ page, customerToken }) => {
|
||||
await authenticatePage(page, customerToken);
|
||||
test('T6 담은 뒤 장바구니 행에 선택한 추가옵션이 표시된다', async ({ page }) => {
|
||||
await page.goto('/shop');
|
||||
const product = await findAdditionalOptionProduct(page);
|
||||
test.skip(product === null, '메인 옵션 2개 이상 + 추가옵션을 가진 공개 상품이 없어 검증할 수 없습니다');
|
||||
|
||||
await page.goto(product!.url);
|
||||
await pickAllMainOptions(page, product!.mainValues);
|
||||
await pickOption(page, `add-option-0-${product!.groupId}`, new RegExp(escapeRegExp(product!.valueName)));
|
||||
|
||||
const [response] = await Promise.all([
|
||||
page.waitForResponse((r) => r.url().includes('/cart') && r.request().method() === 'POST'),
|
||||
page.getByTestId('add-to-cart').click(),
|
||||
]);
|
||||
expect(response.status(), '담기가 성공해야 장바구니를 확인할 수 있다').toBeLessThan(300);
|
||||
|
||||
await page.goto('/shop/cart');
|
||||
await page.getByTestId('cart-change-option').first().click();
|
||||
await page.getByTestId('modal-add-option-1').selectOption({ label: /각인 추가/ });
|
||||
await page.getByTestId('modal-apply').click();
|
||||
// 장바구니 행에 변경된 추가옵션 반영
|
||||
await expect(page.getByTestId('cart-item').first()).toContainText(/각인 추가/);
|
||||
await expect(page.getByTestId('cart-item').first()).toContainText(product!.valueName);
|
||||
});
|
||||
});
|
||||
+162
@@ -5,12 +5,14 @@ namespace Modules\Sirsoft\Ecommerce\Tests\Unit\Console;
|
||||
use App\Contracts\Extension\ModuleInterface;
|
||||
use App\Contracts\Extension\ModuleManagerInterface;
|
||||
use App\Contracts\Extension\ModuleSettingsInterface;
|
||||
use App\Extension\HookManager;
|
||||
use App\Models\User;
|
||||
use App\Services\ModuleSettingsService;
|
||||
use Carbon\Carbon;
|
||||
use Mockery;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\OrderStatusEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\PaymentMethodEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Enums\PaymentStatusEnum;
|
||||
use Modules\Sirsoft\Ecommerce\Models\Order;
|
||||
use Modules\Sirsoft\Ecommerce\Models\OrderPayment;
|
||||
use Modules\Sirsoft\Ecommerce\Services\EcommerceSettingsService;
|
||||
@@ -286,4 +288,164 @@ class CancelPendingPaymentOrdersCommandTest extends ModuleTestCase
|
||||
->expectsOutput('처리할 만료 주문이 없습니다.')
|
||||
->assertSuccessful();
|
||||
}
|
||||
|
||||
/**
|
||||
* 결제창까지 갔으나 성립하지 않은 주문(PG 카드 등)도 경과 후 정리한다.
|
||||
*
|
||||
* 이 부류는 입금 기한이라는 개념이 없어 종전에는 어떤 정리 주체도 없었다. 브라우저 리턴
|
||||
* 콜백이 주문 상태를 바꾸지 않게 되면서 승인 거절분도 여기에 머무르므로, 경과 기준으로
|
||||
* 정리해 선차감 마일리지가 무기한 묶이지 않게 한다.
|
||||
*/
|
||||
public function test_cancels_stale_pending_order_that_never_completed_payment(): void
|
||||
{
|
||||
$user = User::factory()->create();
|
||||
|
||||
$order = Order::factory()->create([
|
||||
'user_id' => $user->id,
|
||||
'order_status' => OrderStatusEnum::PENDING_ORDER,
|
||||
'ordered_at' => Carbon::now()->subDays(2),
|
||||
]);
|
||||
|
||||
OrderPayment::factory()->create([
|
||||
'order_id' => $order->id,
|
||||
'payment_method' => PaymentMethodEnum::CARD,
|
||||
'payment_status' => PaymentStatusEnum::READY,
|
||||
]);
|
||||
|
||||
$this->artisan('sirsoft-ecommerce:cancel-pending-orders')
|
||||
->assertSuccessful();
|
||||
|
||||
$order->refresh();
|
||||
$this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
|
||||
}
|
||||
|
||||
/**
|
||||
* 아직 기한이 지나지 않은 주문대기 주문은 건드리지 않는다 — 구매자가 결제창을 열어 둔
|
||||
* 상태일 수 있으므로, 진행 중인 결제를 취소해 버리면 안 된다.
|
||||
*/
|
||||
public function test_does_not_cancel_recent_pending_order(): void
|
||||
{
|
||||
$user = User::factory()->create();
|
||||
|
||||
$order = Order::factory()->create([
|
||||
'user_id' => $user->id,
|
||||
'order_status' => OrderStatusEnum::PENDING_ORDER,
|
||||
'ordered_at' => Carbon::now()->subMinutes(5),
|
||||
]);
|
||||
|
||||
OrderPayment::factory()->create([
|
||||
'order_id' => $order->id,
|
||||
'payment_method' => PaymentMethodEnum::CARD,
|
||||
'payment_status' => PaymentStatusEnum::READY,
|
||||
]);
|
||||
|
||||
$this->artisan('sirsoft-ecommerce:cancel-pending-orders')
|
||||
->assertSuccessful();
|
||||
|
||||
$order->refresh();
|
||||
$this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
|
||||
}
|
||||
|
||||
/**
|
||||
* 승인 콜백과 경쟁해 이미 결제가 성립한 주문은 정리 대상이 아니다.
|
||||
*/
|
||||
public function test_does_not_cancel_stale_pending_order_whose_payment_is_paid(): void
|
||||
{
|
||||
$user = User::factory()->create();
|
||||
|
||||
$order = Order::factory()->create([
|
||||
'user_id' => $user->id,
|
||||
'order_status' => OrderStatusEnum::PENDING_ORDER,
|
||||
'ordered_at' => Carbon::now()->subDays(2),
|
||||
]);
|
||||
|
||||
OrderPayment::factory()->create([
|
||||
'order_id' => $order->id,
|
||||
'payment_method' => PaymentMethodEnum::CARD,
|
||||
'payment_status' => PaymentStatusEnum::PAID,
|
||||
'paid_at' => Carbon::now()->subDay(),
|
||||
]);
|
||||
|
||||
$this->artisan('sirsoft-ecommerce:cancel-pending-orders')
|
||||
->assertSuccessful();
|
||||
|
||||
$order->refresh();
|
||||
$this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
|
||||
}
|
||||
|
||||
/**
|
||||
* 만료 기준을 0 으로 두면 주문대기 주문 정리를 끌 수 있다 (운영자 선택권).
|
||||
*/
|
||||
public function test_pending_order_cleanup_can_be_disabled_by_setting(): void
|
||||
{
|
||||
$this->moduleSettings['order_settings.pending_order_expire_minutes'] = 0;
|
||||
|
||||
$user = User::factory()->create();
|
||||
|
||||
$order = Order::factory()->create([
|
||||
'user_id' => $user->id,
|
||||
'order_status' => OrderStatusEnum::PENDING_ORDER,
|
||||
'ordered_at' => Carbon::now()->subDays(2),
|
||||
]);
|
||||
|
||||
OrderPayment::factory()->create([
|
||||
'order_id' => $order->id,
|
||||
'payment_method' => PaymentMethodEnum::CARD,
|
||||
'payment_status' => PaymentStatusEnum::READY,
|
||||
]);
|
||||
|
||||
$this->artisan('sirsoft-ecommerce:cancel-pending-orders')
|
||||
->assertSuccessful();
|
||||
|
||||
$order->refresh();
|
||||
$this->assertEquals(OrderStatusEnum::PENDING_ORDER, $order->order_status);
|
||||
}
|
||||
|
||||
/**
|
||||
* 정리 시 선차감 마일리지가 복원된다 — 이것이 이 정리를 넓힌 이유다.
|
||||
*
|
||||
* 마일리지 차감 시점을 '주문할 때'로 설정한 상점에서 카드 승인이 거절되면, 종전에는
|
||||
* 콜백의 실패 처리가 복원했다. 그 경로가 위조 가능해 막힌 뒤로는 이 정리가 복원을 맡는다.
|
||||
*/
|
||||
public function test_cancelling_stale_pending_order_restores_deducted_mileage(): void
|
||||
{
|
||||
$user = User::factory()->create();
|
||||
|
||||
$order = Order::factory()->create([
|
||||
'user_id' => $user->id,
|
||||
'order_status' => OrderStatusEnum::PENDING_ORDER,
|
||||
'ordered_at' => Carbon::now()->subDays(2),
|
||||
'is_mileage_deducted' => true,
|
||||
'total_points_used_amount' => 500,
|
||||
]);
|
||||
|
||||
OrderPayment::factory()->create([
|
||||
'order_id' => $order->id,
|
||||
'payment_method' => PaymentMethodEnum::CARD,
|
||||
'payment_status' => PaymentStatusEnum::READY,
|
||||
]);
|
||||
|
||||
// 복원은 마일리지 리스너에 위임되므로, 복원이 일어났다는 신호는 이 훅의 발화다
|
||||
// (취소 서비스는 플래그를 되돌리지 않고 취소 레코드 기준으로 멱등성을 보장한다).
|
||||
$restoredAmounts = [];
|
||||
HookManager::addAction(
|
||||
'sirsoft-ecommerce.mileage.restore',
|
||||
function ($amount) use (&$restoredAmounts) {
|
||||
$restoredAmounts[] = $amount;
|
||||
},
|
||||
10,
|
||||
['sync' => true],
|
||||
);
|
||||
|
||||
$this->artisan('sirsoft-ecommerce:cancel-pending-orders')
|
||||
->assertSuccessful();
|
||||
|
||||
$order->refresh();
|
||||
$this->assertEquals(OrderStatusEnum::CANCELLED, $order->order_status);
|
||||
$this->assertNotEmpty(
|
||||
$restoredAmounts,
|
||||
'정리된 주문의 선차감 마일리지 복원이 일어나지 않았습니다.'
|
||||
);
|
||||
$this->assertSame(500, (int) $restoredAmounts[0]);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
# audit:allow test-scenario-coverage reason: |
|
||||
# 조합·효과 마킹 면제. 룰은 이 매니페스트의 축을 정상 전개한다 — 파서 한계가 아니라
|
||||
# 커버 방식이 이유다. 정리 대상 판정은 주문 부류 × 경과 × 결제상태의 곱인데 테스트는
|
||||
# 그 곱을 메서드 하나당 한 점씩 찌르는 형태라 조합 단위 @scenario 마킹으로 표현되지
|
||||
# 않는다. 본 매니페스트는 "무엇을 반드시 시험해야 하는가" 의 SSoT 로 두고, 실제 커버는
|
||||
# test_files 의 통과 테스트가 담당한다. test_files 실재 검사는 면제 대상이 아니다.
|
||||
|
||||
feature: 미결제 주문 만료 자동 정리 (입금기한 부류 + 주문대기 부류)
|
||||
|
||||
description: |
|
||||
결제가 성립하지 않은 주문을 정리 배치가 취소로 거두는 계약.
|
||||
|
||||
종전에는 입금 기한이 있는 결제수단(vbank·dbank)만 정리 대상이었다. 결제창까지 갔으나
|
||||
승인되지 않은 주문(PG 카드 등)은 입금 기한이라는 개념이 없어 어떤 정리 주체도 없이 남았고,
|
||||
실무에서는 브라우저 리턴 콜백의 실패 처리가 그 자리를 대신하고 있었다.
|
||||
|
||||
그 콜백 경로는 인증도 서명도 없어 주문번호만 아는 제3자가 남의 주문을 취소시킬 수 있었고,
|
||||
그래서 주문 상태를 바꾸지 않도록 막았다. 그 결과 승인 거절분이 주문대기에 머무르게 되므로,
|
||||
이 정리가 그 부류까지 거두고 **선차감 마일리지 복원**도 함께 책임진다.
|
||||
|
||||
경계: 승인 콜백과 경쟁해 이미 결제가 성립한 주문(paid·입금대기)은 정리하지 않는다.
|
||||
운영자는 만료 기준(분)을 0 으로 두어 주문대기 부류의 정리만 끌 수 있고, 그때도 입금기한
|
||||
부류의 정리는 그대로 동작한다.
|
||||
|
||||
axes:
|
||||
order_class:
|
||||
- deposit_due_vbank # 가상계좌 — vbank_due_at 도과분
|
||||
- deposit_due_dbank # 무통장입금 — deposit_due_at 도과분
|
||||
- pending_order_never_paid # 결제창까지 갔으나 승인되지 않은 주문 (PG 카드 등)
|
||||
elapsed:
|
||||
- past_threshold # 기준 경과 → 대상
|
||||
- within_threshold # 기준 이내 → 구매자가 결제창을 열어 둔 상태일 수 있어 제외
|
||||
payment_status:
|
||||
- ready_or_failed # 결제 미성립 → 대상
|
||||
- paid # 승인 콜백과 경쟁해 이미 성립 → 제외
|
||||
- waiting_deposit # 입금 대기 → 제외
|
||||
expire_minutes_setting:
|
||||
- positive # 주문대기 부류 정리 활성 (기본 1440)
|
||||
- zero # 주문대기 부류만 끔 — 입금기한 부류는 계속 정리
|
||||
run_mode:
|
||||
- apply
|
||||
- dry_run
|
||||
|
||||
exclusions:
|
||||
- order_class: deposit_due_vbank
|
||||
expire_minutes_setting: zero
|
||||
reason: 만료 기준 설정은 주문대기 부류에만 걸린다 — 입금기한 부류의 동작을 바꾸지 않는다
|
||||
- order_class: deposit_due_dbank
|
||||
expire_minutes_setting: zero
|
||||
reason: 동일
|
||||
|
||||
effects:
|
||||
- stale_pending_order_is_cancelled # 기준 경과 + 미성립 → 취소
|
||||
- recent_pending_order_is_left_alone # 기준 이내 → 무변경 (진행 중 결제 보호)
|
||||
- paid_pending_order_is_left_alone # 승인 경쟁 보호
|
||||
- waiting_deposit_pending_order_is_left_alone
|
||||
- expired_vbank_order_is_cancelled
|
||||
- expired_dbank_order_is_cancelled
|
||||
- non_expired_order_is_left_alone
|
||||
- zero_setting_disables_pending_class_only # 운영자 선택권
|
||||
- deducted_mileage_is_restored_on_cleanup # 이 정리를 넓힌 이유
|
||||
- dry_run_mutates_nothing
|
||||
- limit_option_is_respected
|
||||
- disabled_toggle_skips_the_whole_run
|
||||
- pending_class_due_display_falls_back_to_ordered_at # 입금 기한이 없는 부류의 표기 기준
|
||||
|
||||
test_files:
|
||||
- modules/_bundled/sirsoft-ecommerce/tests/Unit/Console/CancelPendingPaymentOrdersCommandTest.php
|
||||
|
||||
manual_verification:
|
||||
- description: "만료 정리 대상 검출 — 운영 데이터 무변경 확인"
|
||||
steps:
|
||||
- "php artisan sirsoft-ecommerce:cancel-pending-orders --dry-run --limit=5"
|
||||
- "검출 목록에 주문대기 부류가 포함되고, 기한 표기가 주문 시각으로 나오는지 확인"
|
||||
- "dry-run 이므로 어떤 주문도 상태가 바뀌지 않아야 한다"
|
||||
Reference in new issue
Block a user