Files
dbx-main/tests/js/box_calc_ui.test.js
T
king 47e09b94d7 feat(cupang): 드래그 조작감 개선 — 핸들·플레이스홀더·오토스크롤
Pointer Events 기반으로 바꾸고(터치·펜 지원, setPointerCapture 로 창 밖
이동에도 이벤트 유실 없음) 업무툴 수준의 조작 피드백을 붙였다.

- 드래그 핸들(⠿)에서만 드래그 시작 → 카드 클릭/텍스트 선택과 충돌 없음
- 커서를 따라오는 고스트에 "잔여 N박스" 배지, 담을 수 없는 위치에서는
  빨간 테두리로 금지 표시
- 대상 센터에 "○○ — 여기에 담기" 플레이스홀더를 끼워 놓일 자리를 보여줌
- 센터 목록 위/아래 44px 안에 커서가 오면 자동 스크롤(센터가 많을 때 필수)
- pointermove 처리는 requestAnimationFrame 으로 1프레임 1회만 실행
- pointercancel / 창 blur / Esc 에서 드래그를 안전하게 취소

SortableJS 도입은 보류했다. 웨일에서 네이티브 DnD 가 시작조차 되지 않아
어차피 fallback 모드로만 동작하고, 브라우저 실측 검증 수단이 없는 상태에서
의존성만 늘어난다.

tests/js: 핸들 밖 드래그 차단·고스트 배지·플레이스홀더·금지 표시·Esc 취소
시나리오 추가(rAF 지연을 고려해 프레임 대기). 전체 통과.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-29 03:28:12 +09:00

220 lines
12 KiB
JavaScript

// 박스 계산 화면(cupang/box_calc.html) UI 테스트 — jsdom.
// 실행 전 `python tests/js/render_box_calc.py` 로 템플릿을 렌더해 둔다.
const fs = require("fs");
const path = require("path");
const { JSDOM } = require("jsdom");
const RENDER = path.join(__dirname, ".out", "box_calc_render.html");
const html = fs.readFileSync(RENDER, "utf8");
// 서버 응답 고정: 미라네 1호 18개(2박스+자투리2), 미라네 4호 12개(1박스+자투리4)
const apiResponse = {
results: [
{product_code:"MS-1001", product_name:"미라네 1호 세트", box_name:"쿠팡박스", units_per_box:8,
quantity:18, configured:true, full_boxes:2, remainder_units:2, required_boxes:3},
{product_code:"MS-1004", product_name:"미라네 4호 세트", box_name:"쿠팡박스", units_per_box:8,
quantity:12, configured:true, full_boxes:1, remainder_units:4, required_boxes:2},
],
totals: [],
mixes: [{box_name:"쿠팡박스", box_count:1, leftover_units:6, boxes:[
{items:[{product_code:"MS-1004",product_name:"미라네 4호 세트",quantity:4},
{product_code:"MS-1001",product_name:"미라네 1호 세트",quantity:2}], fill_percent:75.0}]}],
grand_total_boxes: 4,
};
const dom = new JSDOM(html, { runScripts: "dangerously", pretendToBeVisual: true });
const w = dom.window, d = w.document;
w.fetch = () => Promise.resolve({ ok: true, json: () => Promise.resolve(apiResponse) });
const fails = [];
function check(name, cond, extra) {
if (cond) console.log("PASS " + name);
else { console.log("FAIL " + name + (extra ? " → " + extra : "")); fails.push(name); }
}
const $ = (s) => d.querySelector(s);
const $$ = (s) => Array.from(d.querySelectorAll(s));
const text = (s) => ($(s) ? $(s).textContent.replace(/\s+/g, " ").trim() : "<none>");
const fire = (el, type) => el.dispatchEvent(new w.Event(type, { bubbles: true }));
// 이동 처리는 requestAnimationFrame 으로 1프레임 지연되므로 한 프레임 기다린다.
const frame = () => new Promise(r => setTimeout(r, 30));
// 포인터 드래그 시뮬레이션.
// jsdom 은 레이아웃이 없어 elementFromPoint 가 항상 null 이므로 드롭 대상을 스텁한다.
function pointer(el, type, x, y) {
el.dispatchEvent(new w.PointerEvent(type, {
bubbles: true, cancelable: true, clientX: x, clientY: y, button: 0, pointerId: 1, pointerType: "mouse",
}));
}
function handleOf(card) { return card.querySelector(".cpg-drag-handle"); }
function dragCardTo(card, target) {
d.elementFromPoint = () => target;
pointer(handleOf(card), "pointerdown", 10, 10);
pointer(d, "pointermove", 60, 60); // 임계값(4px) 초과 → 드래그 시작
pointer(d, "pointermove", 200, 200);
pointer(d, "pointerup", 200, 200);
d.elementFromPoint = () => null;
}
(async () => {
// ── ① 입력 → 계산 ──────────────────────────────────
const row1 = $(".cpg-calc-row");
row1.querySelector(".cpg-calc-name").value = "MS-1001";
row1.querySelector(".cpg-calc-qty").value = "18";
const ke = new w.KeyboardEvent("keydown", { key: "Tab", bubbles: true, cancelable: true });
row1.querySelector(".cpg-calc-qty").dispatchEvent(ke);
check("Tab 이 새 행을 만든다", $$(".cpg-calc-row").length === 2, "행수=" + $$(".cpg-calc-row").length);
check("Tab 후 포커스가 새 행 수량", d.activeElement === $$(".cpg-calc-row")[1].querySelector(".cpg-calc-qty"));
const row2 = $$(".cpg-calc-row")[1];
row2.querySelector(".cpg-calc-name").value = "MS-1004";
row2.querySelector(".cpg-calc-qty").value = "12";
$("#cpg-calc-run").click();
await new Promise(r => setTimeout(r, 20));
check("요약이 표시된다", $("#cpg-sum-body").hidden === false);
check("제품 카드 2장", $$(".cpg-sum-prod").length === 2, String($$(".cpg-sum-prod").length));
check("혼합 박스 1장", $$(".cpg-box-card").length === 1);
check("제품별 잔여 = 2박스(16개)", text(".cpg-sum-prod .cpg-sum-prod-nums").startsWith("2박스16개"),
text(".cpg-sum-prod .cpg-sum-prod-nums"));
check("KPI 총 박스 4", text(".cpg-kpi .cpg-kpi-value") === "4박스", text(".cpg-kpi .cpg-kpi-value"));
// ── ③ 센터는 추가한 것만 표시 ─────────────────────
check("초기 센터 패널 없음", $$(".cpg-dist-center").length === 0);
$("#cpg-center-pick").value = "1";
$("#cpg-center-add").click();
check("센터 추가 후 1개 표시", $$(".cpg-dist-center").length === 1, String($$(".cpg-dist-center").length));
check("추가한 센터 이름", text(".cpg-dist-center strong") === "대구3", text(".cpg-dist-center strong"));
// ── 마우스 드래그 → 드롭 → 대화상자 ───────────────
const card = $(".cpg-sum-prod.is-draggable");
check("드래그 핸들이 있다", !!handleOf(card));
d.elementFromPoint = () => $(".cpg-dist-center");
// 핸들이 아닌 카드 본문에서는 드래그가 시작되지 않는다
pointer(card.querySelector(".cpg-sum-prod-name"), "pointerdown", 10, 10);
pointer(d, "pointermove", 60, 60);
check("핸들 밖에서는 드래그 안 됨", !card.classList.contains("is-dragging") && !$(".cpg-drag-ghost"));
pointer(handleOf(card), "pointerdown", 10, 10);
pointer(d, "pointermove", 60, 60);
await frame();
check("핸들에서 4px 이상 움직이면 드래그 시작", card.classList.contains("is-dragging"));
check("고스트(복제 카드) 생성", !!$(".cpg-drag-ghost"));
check("고스트에 잔여 배지", text(".cpg-drag-badge") === "잔여 2박스", text(".cpg-drag-badge"));
check("드래그 중 대상 센터 강조", $(".cpg-dist-center").classList.contains("is-over"));
check("놓일 자리 플레이스홀더 표시", !!$(".cpg-drop-placeholder"));
check("플레이스홀더에 대상 이름", text(".cpg-drop-placeholder").includes("미라네 1호 세트"),
text(".cpg-drop-placeholder"));
// 대상 밖으로 나가면 금지 표시
d.elementFromPoint = () => $(".cpg-calc-card");
pointer(d, "pointermove", 400, 400);
await frame();
check("대상 밖이면 고스트가 금지 표시", $(".cpg-drag-ghost").classList.contains("is-invalid"));
check("대상 밖이면 플레이스홀더 제거", !$(".cpg-drop-placeholder"));
d.elementFromPoint = () => $(".cpg-dist-center");
pointer(d, "pointermove", 200, 200);
await frame();
pointer(d, "pointerup", 200, 200);
d.elementFromPoint = () => null;
check("드롭 후 고스트 제거", !$(".cpg-drag-ghost"));
check("드롭 후 플레이스홀더 제거", !$(".cpg-drop-placeholder"));
check("드롭하면 대화상자가 열린다", $("#cpg-dlg").hidden === false);
check("대화상자에 잔여/개수 표시", text("#cpg-dlg-item").includes("잔여 2박스 (16개)"), text("#cpg-dlg-item"));
check("대화상자 센터 = 드롭한 센터", $("#cpg-dlg-center").value === "1");
// 1박스만 담기
$("#cpg-dlg-qty").value = "1";
$("#cpg-dlg-ok").click();
check("대화상자가 닫힌다", $("#cpg-dlg").hidden === true);
check("센터에 항목 1줄", $$(".cpg-dist-item").length === 1);
check("센터 항목에 박스·개수 표시", text(".cpg-dist-item .cpg-dist-unit") === "박스 · 8개",
text(".cpg-dist-item .cpg-dist-unit"));
check("센터 합계 배지 1박스/8개", text(".cpg-dist-sum").replace(/\s/g, "").startsWith("1박스8개"),
text(".cpg-dist-sum"));
check("요약 잔여가 1박스로 줄어든다", text(".cpg-sum-prod .cpg-sum-prod-nums").startsWith("1박스8개"),
text(".cpg-sum-prod .cpg-sum-prod-nums"));
check("KPI 센터 배분 1박스", $$(".cpg-kpi-value")[1].textContent === "1박스", $$(".cpg-kpi-value")[1].textContent);
// ── 클릭 대체 경로 + 잔여 전부 담기 ───────────────
$$(".cpg-sum-prod")[0].click();
check("클릭으로도 대화상자가 열린다", $("#cpg-dlg").hidden === false);
$("#cpg-dlg-all").click();
check("전량 담기 후 잔여 0", text(".cpg-sum-prod .cpg-sum-prod-nums").startsWith("0박스0개"),
text(".cpg-sum-prod .cpg-sum-prod-nums"));
check("잔여 0 카드는 드래그 불가", $$(".cpg-sum-prod")[0].classList.contains("is-done"));
check("센터 합계 2박스/16개", text(".cpg-dist-sum").replace(/\s/g, "").startsWith("2박스16개"),
text(".cpg-dist-sum"));
// ── 수량 직접 수정 (상한 = 잔여 + 자기 수량) ──────
const qty = $(".cpg-dist-item .cpg-dist-qty");
qty.value = "5"; fire(qty, "input");
check("잔여 초과 입력은 최대치로 잘림", qty.value === "2", qty.value);
qty.value = "1"; fire(qty, "input");
check("수량 줄이면 개수 표시 갱신", text(".cpg-dist-item .cpg-dist-unit") === "박스 · 8개",
text(".cpg-dist-item .cpg-dist-unit"));
check("수량 줄이면 요약 잔여 복귀", text(".cpg-sum-prod .cpg-sum-prod-nums").startsWith("1박스8개"),
text(".cpg-sum-prod .cpg-sum-prod-nums"));
// ── 혼합 박스 담기 ────────────────────────────────
dragCardTo($(".cpg-box-card.is-draggable"), $(".cpg-dist-center"));
check("혼합 박스도 대화상자가 열린다", $("#cpg-dlg").hidden === false);
check("혼합 박스 잔여 1박스(6개)", text("#cpg-dlg-item").includes("잔여 1박스 (6개)"), text("#cpg-dlg-item"));
$("#cpg-dlg-ok").click();
check("혼합 박스가 센터에 담긴다", $$(".cpg-dist-item").length === 2);
check("혼합 담은 뒤 배분됨 표시", $(".cpg-box-card").className.includes("is-done"));
// ── 항목 빼기 / 센터 빼기 ─────────────────────────
$$(".cpg-dist-del")[1].click();
check("항목 빼면 줄이 사라진다", $$(".cpg-dist-item").length === 1);
check("항목 빼면 혼합 박스 복귀", !$(".cpg-box-card").className.includes("is-done"));
$(".cpg-dist-close").click();
check("센터 빼기", $$(".cpg-dist-center").length === 0);
check("센터 빼면 전량 잔여 복귀", text(".cpg-sum-prod .cpg-sum-prod-nums").startsWith("2박스16개"),
text(".cpg-sum-prod .cpg-sum-prod-nums"));
// ── 드롭 실패 경로 방어 ───────────────────────────
$("#cpg-center-pick").value = "2";
$("#cpg-center-add").click();
check("센터 다시 추가", $$(".cpg-dist-center").length === 1, String($$(".cpg-dist-center").length));
// (1) 패널이 아닌 ③ 카드 여백에 놓아도 센터가 하나면 그 센터로
dragCardTo($(".cpg-sum-prod.is-draggable"), $(".cpg-dist-card"));
check("여백에 놓아도 대화상자가 열린다", $("#cpg-dlg").hidden === false);
$("#cpg-dlg-qty").value = "1";
$("#cpg-dlg-ok").click();
check("여백 드롭도 센터에 담긴다", $$(".cpg-dist-item").length === 1, String($$(".cpg-dist-item").length));
// (2) ③ 밖에 놓으면 담기지 않고 안내만 뜬다
$(".cpg-dist-del").click();
dragCardTo($(".cpg-sum-prod.is-draggable"), $(".cpg-calc-card"));
check("③ 밖에 놓으면 담기지 않는다", $("#cpg-dlg").hidden === true && $$(".cpg-dist-item").length === 0);
check("③ 밖 드롭 안내 메시지", text("#cpg-calc-msg").includes("센터 위에 놓아야"), text("#cpg-calc-msg"));
// (3) Esc 로 드래그 취소
d.elementFromPoint = () => $(".cpg-dist-center");
const card4 = $(".cpg-sum-prod.is-draggable");
pointer(handleOf(card4), "pointerdown", 10, 10);
pointer(d, "pointermove", 80, 80);
d.dispatchEvent(new w.KeyboardEvent("keydown", { key: "Escape", bubbles: true }));
check("Esc 로 드래그 취소", !$(".cpg-drag-ghost") && $("#cpg-dlg").hidden === true);
pointer(d, "pointerup", 200, 200);
d.elementFromPoint = () => null;
// (4) 드래그 없이 클릭한 경우
$(".cpg-sum-prod.is-draggable").click();
check("클릭 대체 경로 동작", $("#cpg-dlg").hidden === false);
$("#cpg-dlg-qty").value = "1";
$("#cpg-dlg-ok").click();
check("클릭으로 담긴다", $$(".cpg-dist-item").length === 1);
console.log("\n" + (fails.length ? "FAILED: " + fails.join(" | ") : "ALL PASS"));
process.exit(fails.length ? 1 : 0);
})();