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:
HeuJung committed 2026-09-02 17:36:11 +09:00
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 -->
## 권한
@@ -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": "장바구니 유효기간",
@@ -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": [
{
@@ -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": [
@@ -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": [
{
@@ -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": {
@@ -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})");
@@ -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'),
@@ -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일 이상이어야 합니다.',
@@ -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 },
);
}
@@ -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;
}
@@ -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);
});
});
@@ -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();
});
});
@@ -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);
});
});
@@ -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);
});
});
@@ -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 이므로 어떤 주문도 상태가 바뀌지 않아야 한다"