fix(441 B05 스냅 끌기): 맞춤 교점 이동 한도 = 간격 · 미리보기 측점 밖 늘면 그 걸음 되돌림 · 초안 없는 측점 단계 = 저장 스냅

- StationFit reach = intervalM(반 간격이면 MC 18+9 ~ 19+1 못 맞춤)
- 끌기 · 방향키 — 미리보기 측점 밖 곡선 수가 누를 때보다 늘면 그 걸음 되돌림 · dragMoved 는 막힘 검사 뒤(433-14)
- 계산 줄 stations 단계 · follow 새 측점 — 초안 없으면 저장 노선 station_snap · station_snap_step(snapOptions)
- 시험 — 390_5 끌기 훑기(놓은 뒤 측점 밖 0 · 자동 · 고정 R) · 344_3 저장 스냅 · 266 사면 이동 한 걸음 · 다시 그림 한 번

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ji4nuyLVHcxrXWHTdb5nRD

resources/tester/helper_266_card_toggle.mjs

@@ -95,15 +95,17 @@ async function toggles(projectId, shift) {
   const steps = [];
   const run = async (tag) => {
     const updated = [];
+    let calls = 0; // 받는 쪽 = 카드 다시 그림 + 종단 · 유토 다시 그림(design_shared) — 한 걸음에 한 번
     const out = await m.refreshSavedCross(
       { projectId, routeId: R, detail, edits: EDITS, alignment },
       stations,
-      (rows) => updated.push(...rows),
+      (rows) => (calls++, updated.push(...rows)),
     );
     steps.push({
       tag,
       out: out ? Object.keys(out.byKey).length : null,
       updated,
+      calls,
       ...pick(target.design),
     });
   };
@@ -126,6 +128,9 @@ async function toggles(projectId, shift) {
     m.writeCrossDesignChoice(projectId, R, target.chainage_m, { ...choice });
     await run(tag);
   }
+  // 사면 이동 한 걸음(B06 ◀▶ 0.1 m · 깎기 쪽 · 441 · 요구 268-4)
+  m.writeShoulderExtend(projectId, R, target.chainage_m, job.mode.split("_")[0], 0.1);
+  await run("slope");
   return { target: target.chainage_m, steps };
 }
 

resources/tester/helper_266_card_toggle_entry.ts

@@ -1,5 +1,8 @@
 /* PLAN 439 시험 묶음 진입점 — 저장 노선 cross 차례(카드 단추 → 다시 셈 · 측점 어긋남) · 진짜 모듈 · vite ssr. */
 export { refreshSavedCross } from "../../A00_Common/design/design_shared";
-export { writeCrossDesignChoice } from "../../B06_Section/B06_Section_Cross_Design_Session";
+export {
+  writeCrossDesignChoice,
+  writeShoulderExtend,
+} from "../../B06_Section/B06_Section_Cross_Design_Session";
 export { rememberRockBoundaryDefault } from "../../B06_Section/B06_Section_UI_Standard_Panel";
 export { writeState } from "../../A00_Common/b_page_state";

resources/tester/helper_344_3_pipeline_stations.cjs

@@ -78,4 +78,24 @@ out.move = {
   same: after.map((s) => byKey.get(s.key) === s),
   empty: run(null, null, null, null),
 };
+// 441 — 초안 없는 저장 노선 = 저장 스냅 설정 따름 · 초안이 있으면 초안 값(스냅 case = cases[1])
+const snapCase = job.cases[1];
+const savedRun = (route, saved) =>
+  stage
+    .createStationsStage({ types: () => job.types, saved: () => saved })({
+      generation: 1,
+      range: null,
+      signal: new AbortController().signal,
+      inputs: { route, pipes: job.pipes, structures: job.structures },
+      out: { route: { line: snapCase.line, curves: snapCase.curves, chainage: [], lengthM: 0 } },
+      before: {},
+      prev: null,
+    })
+    .map((s) => s.chainageM);
+out.savedSnap = {
+  saved: savedRun(null, { station_snap: true, station_snap_step: null }),
+  savedOff: savedRun(null, { station_snap: false }),
+  noPlan: savedRun(null, null),
+  draftWins: savedRun({ stationSnap: false }, { station_snap: true }),
+};
 process.stdout.write(JSON.stringify(out));

resources/tester/helper_390_5_snap_step_ops.cjs

@@ -128,6 +128,82 @@ const drag = Object.fromEntries(
   }),
 );
 
+// ④ 끌기 훑기(441) — 편집 창 끌기 차례(`_Pointer`) 그대로: 하한 막힘 · 미리보기 측점 밖이 누를 때보다 늘면
+//    그 걸음 되돌림 · 놓을 때 정본 맞춤(`applyEdit`). 측점 No. · IP 셋 × 12 방향 × 3 거리 · 고정 R(곡선표 반경 못박음).
+const edits = loadTs(path.join(LOGIC, "B05_Profile_UI_RouteEdit_Edits.ts"));
+const copy = (c) => ({
+  ...c,
+  planned: c.planned.map(([x, y]) => [x, y]),
+  curveRadius: [...c.curveRadius],
+});
+function sweep(fixedR) {
+  const start = columns(fit.fitCurveStations(columns(ROUTE), LIMITS, 1));
+  if (fixedR)
+    start.curveRadius = edits
+      .rebuildLine(copy(start), LIMITS)
+      .nodes.map((n) => (n.radius_m === null ? null : Math.round(n.radius_m * 100) / 100));
+  const floor = (built) =>
+    edits.curveShortfalls(built.nodes, LIMITS.limitRadiusM, LIMITS.limitArcM);
+  const off = (built) => fit.offStationCount(built.vertices, built.curves, INTERVAL);
+  const tally = { drags: 0, released: 0, offAfter: 0, strayed: 0, worst: [] };
+  for (const K of [2, 3, 4])
+    for (let deg = 0; deg < 360; deg += 30)
+      for (const reach of [9, 17, 26]) {
+        const hist = copy(start);
+        let st = copy(hist);
+        let built = edits.rebuildLine(st, LIMITS);
+        const offBefore = off(built);
+        let raw = null;
+        let movedOnce = false;
+        const preview = () => {
+          raw = st.planned.map(([x, y]) => [x, y]);
+          st = { ...st, planned: fit.fitDrag(st, hist.planned, K, LIMITS) };
+          built = edits.rebuildLine(st, LIMITS);
+        };
+        const p0 = hist.planned[K];
+        for (let t = 0.5; t <= reach + 1e-9; t += 0.5) {
+          if (raw) raw.forEach((v, i) => (st.planned[i] = v));
+          built = edits.rebuildLine(st, LIMITS);
+          const before = floor(built);
+          const previous = st.planned[K];
+          st.planned[K] = [
+            p0[0] + Math.cos((deg * Math.PI) / 180) * t,
+            p0[1] + Math.sin((deg * Math.PI) / 180) * t,
+          ];
+          built = edits.rebuildLine(st, LIMITS);
+          if (edits.shortfallCrossed(before, floor(built))) {
+            st.planned[K] = previous;
+            preview();
+            continue;
+          }
+          preview();
+          if (off(built) > offBefore) {
+            raw.forEach((v, i) => (st.planned[i] = v));
+            st.planned[K] = previous;
+            preview();
+            tally.strayed += 1;
+            continue;
+          }
+          movedOnce = true;
+        }
+        tally.drags += 1;
+        if (!movedOnce) continue;
+        built = edits.rebuildLine(st, LIMITS);
+        if (edits.floorStop(hist, st.planned, built.nodes, LIMITS)) continue;
+        const from = fit.fitStart(hist, st);
+        st = { ...st, planned: fit.fitCurveStations(st, LIMITS, from) };
+        built = edits.rebuildLine(st, LIMITS);
+        tally.released += 1;
+        const left = fit.offStationMcs(built.vertices, built.curves, INTERVAL);
+        if (left.length) {
+          tally.offAfter += 1;
+          if (tally.worst.length < 5) tally.worst.push({ K, deg, reach, mc: left });
+        }
+      }
+  return tally;
+}
+const swept = { auto: sweep(false), fixed: sweep(true) };
+
 // ③ MC 측점 값 · 눈금 글
 const input = JSON.parse(process.argv[2] || '{"grid":[],"spans":[]}');
 const snapped = Object.fromEntries(
@@ -147,5 +223,12 @@ const labels = {
 };
 
 console.log(
-  JSON.stringify({ keys, drag, snapped, labels, scale: [0.1, 1, 10, null].map(frame.mcScale) }),
+  JSON.stringify({
+    keys,
+    drag,
+    swept,
+    snapped,
+    labels,
+    scale: [0.1, 1, 10, null].map(frame.mcScale),
+  }),
 );

resources/tester/test_266_card_toggle_mismatch.py

@@ -4,6 +4,7 @@
   - 저장 노선 cross 차례(`refreshSavedCross`) = 카드 자료(상세 설계)를 **늘** 다시 셈 —
     복합경사 · 측구 · 지반 단추마다 그 측점 설계선 · 면적이 바뀜.
   - 묶음 측점 = 상세 측점이면 돌려줌 · 1 mm 넘게 다르면 null(묶음 엔진) — 그래도 카드 자료는 고침.
+  - 사면 이동 한 걸음도 같음 · 걸음마다 받는 쪽(카드 · 종단 · 유토 다시 그림) 한 번(441 · 요구 268-2 · 4).
   - 서버 폴백(선형 저장분 없음)에도 카드 선택이 실림(열쇠 = 측점 자리) · 서버는 저장분 위에 얹음.
 짝: `helper_266_card_toggle.mjs` · 진입점 `helper_266_card_toggle_entry.ts` ·
 지형 · 노선 틀 = `test_346_2_pipeline_cross_page.py`.
@@ -99,7 +100,8 @@ def _check_toggles(case: dict, returned) -> None:
     steps = {step["tag"]: step for step in case["steps"]}
     assert steps["open"]["cut"] > 0.5  # 깎기 측점
     before = steps["open"]
-    for tag in ("two_stage", "ditch_off", "soil"):
+    assert all(step["calls"] == 1 for step in case["steps"])  # 걸음마다 다시 그림 한 번(441)
+    for tag in ("two_stage", "ditch_off", "soil", "slope"):
         step = steps[tag]
         assert case["target"] in step["updated"], tag  # 카드 다시 그림 대상
         assert step["line"] != before["line"], tag  # 카드 설계선 바뀜

resources/tester/test_344_3_pipeline_stations_mirror.py

@@ -264,6 +264,17 @@ def test_스냅_측점은_원래_격자_번호(r):
     assert moved and all(abs(a - b) <= 10 for a, b in moved.values())
 
 
+def test_초안_없으면_저장_스냅_따름(r):
+    """441 — 초안 없는 저장 노선 측점 단계 = 저장 station_snap · 초안이 있으면 초안 값."""
+    snapped = [s["chainageM"] for s in r["cases"][1]]
+    plain = [s["chainageM"] for s in r["cases"][0]]
+    assert snapped != plain
+    got = r["savedSnap"]
+    assert got["saved"] == snapped
+    assert got["savedOff"] == plain and got["noPlan"] == plain
+    assert got["draftWins"] == plain
+
+
 def test_노선_한_점_옮김_앞_구간_열쇠_그대로(r):
     m = r["move"]
     from_m = _first_changed_m()

resources/tester/test_390_5_snap_step_ops.py

@@ -80,7 +80,17 @@ def test_끄는_동안_MC_가_간격_배수(got, step) -> None:
     drag = got["drag"][step]
     assert drag["off"] == 0
     assert max(drag["residues"]) <= drag["tol"]
-    assert drag["dragMoved"] <= float(step) / 2 + 1e-6  # 끈 IP 는 접선 따라 ±간격/2 안만
+    assert drag["dragMoved"] <= float(step) + 1e-6  # 끈 IP 는 접선 따라 ±간격 안만(441)
+
+
+@pytest.mark.parametrize("mode", ["auto", "fixed"])
+def test_끌기_훑기_놓은_뒤_측점_밖_0(got, mode) -> None:
+    """441 — 측점 No. 끌기(IP 셋 × 12 방향 × 3 거리) · 놓은 뒤 MC 가 다 측점 위 · 맞춤이 늘 닿음
+    (반 간격 한도면 18+9 ~ 19+1 에서 못 맞춰 막힘 걸음이 생김)."""
+    swept = got["swept"][mode]
+    assert swept["drags"] == 108 and swept["released"] > 0
+    assert swept["offAfter"] == 0, swept["worst"]
+    assert swept["strayed"] == 0
 
 
 @pytest.mark.parametrize("step", ["0.1", "1", "10", "20"])
@@ -101,6 +111,12 @@ def test_끌기_방향키_편집기_이음() -> None:
     # 하한 검사는 맞추기 전 노선으로(맞춤이 IP 를 ±간격/2 밀어 10 m · 측점 No. 에서 헛걸림)
     assert "dragRaw.forEach((vertex, index) => (state.planned[index] = vertex))" in pointer
     assert "now.raw.forEach((vertex, index) => (state.planned[index] = vertex))" in keys
+    # 미리보기 측점 밖이 누를 때보다 늘면 그 걸음 되돌림 · 막힘 검사 뒤에 옮김 표시(441 · 433-14)
+    assert "params.offStation() > dragOff" in pointer and "params.offStation() > now.off" in keys
+    move = pointer[pointer.index("const previous = state.planned[dragNode];") :]
+    assert move.index("shortfallCrossed(") < move.index("params.offStation() > dragOff")
+    assert move.index("params.offStation() > dragOff") < move.index("dragMoved = true;")
+    assert "offStation: () => (stationSnap ? fit.offStationCount(" in edit
     assert edit.count("\n") <= 695
 
 
@@ -193,6 +209,9 @@ def test_서버_측점_셈이_저장_간격을_씀() -> None:
     page = (design / "design_pipeline_page.ts").read_text(encoding="utf-8")
     assert "stationSnapStep: routePlan.station_snap_step" in page
     stage = (design / "logic" / "design_pipeline_stations.ts").read_text(encoding="utf-8")
-    assert "stationSnapStep: ctx.inputs.route?.stationSnapStep" in stage
+    assert "...snapOptions(ctx.inputs.route, saved?.())" in stage  # 초안 · 없으면 저장 노선(441)
+    assert "stationSnapStep: draft.stationSnapStep" in stage
+    assert "stationSnapStep: saved?.station_snap_step" in stage
+    assert "saved: () => plan" in page and "...snapOptions(inputs.route, plan)" in page
     apply = (B05 / "B05_Profile_UI_RouteEdit_Apply.ts").read_text(encoding="utf-8")
     assert "stationSnap: true, stationSnapStep: null" in apply  # 추천 = 측점 No.