feat(structure): 65-1~5 세월교 · 박스암거 유입 · 유출 흙막이 양식 공통 · 없음 = 램프 뺌 · 세월교 기본값 · 물넘이 월류 폭 · 높이

- 흙막이 양식 한 벌(design_structure_guard) — 배관 · 박스 · 세월교가 같은 칸(형태 · 길이 · 높이 · 측점 전후) · 추가 흙막이 · 도수로/돌붙임 상자
- 세월교 · 박스 유입 · 유출: 흙막이 고르면 흙막이 칸(키 {side}_revet_* · 기본 찰 10 · 1.5 · 5 · 5) · [연동][경사] 옵션 줄
- B06 측벽 높이 · 좌우 · 상하 · 바닥판 읽기 줄을 세월교 · 박스 유입 · 유출 칸에 안 옮김(강조만)
- 유입 · 유출 「없음」 = 목록 램프 · 구조물 조합 잇기 줄 없음(명세 none)
- 세월교: 수량(련) 관경 바로 뒤 · 련 기본 2 · 새 시설 빈 월류 높이 = 유량 오면 필요 수심 · 종류 바꿀 때 유량 넘김
- 물넘이 포장: 경사각 기본 3° · 월류 폭 · 높이 칸(세월교와 같은 키 ford_width_m · ford_height_m · 같은 계산)
- 구조물정의 판 18(판_17 이력) · 이름 표 · 집계표 선택 컨테이너 짝 · 저장 병합 키
- 시험: 세월교 · 박스 · 물넘이 명세 기대값 · 흙막이 짝 자리 옮김

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

resources/master_template/구조물정의.json

@@ -1,5 +1,5 @@
 {
-  "판": 17,
+  "판": 18,
   "schema_version": 1,
   "comment": "B05 구조물 타입 레지스트리 정본. 근거·옵션 상세는 PLAN.md 구조물 리스트와 resources/knowledge/technical_info/01_임도 참조. 2026-08-17 선택지 재편: B군(종단배수)·F군(생태/녹화)·G군(노면공)은 enabled:false 보존 — B05 선택지에서 빠지고 B06 개별 횡단도 옵션으로 재사용한다. 바닥막이(bed_sill)·생태연못(eco_pond)은 임도 미사용 확정으로 삭제. 배관·BOX암거·물넘이·세월교는 pipe_points.json 정본 관리(managed_by) — structures.json에 저장하지 않으며, 배관 부속(유형/집수정/기슭막이/돌붙임)·날개벽 옵션 정의는 B06/B07 필수 승격의 선언 근거다. ★기본값 원칙(2026-08-16 크로스체크 2차): default를 두는 것은 ①법정이 등급과 무관하게 못박은 단일 수치 ②사용자가 개발 단계에서 확정한 값 ③도메인 수치가 아닌 표시용 문자열, 이 셋뿐이다. 재료·형식 같은 설계자 판단 선택지와 미확정 제원은 default 없이 required로 두어 사용자가 직접 고르게 한다 (pipe_diameter_mm 1000 = 별표2 원칙값+사용자 확정 — 화이트리스트 등재). BOX암거 본체 2.0×2.0·날개벽 유입/유출 있음·짧은쪽 높이 1m·길이 2m·각도 45°는 2026-08-17 사용자 확정값이다 — 본체 규격은 실무 관측 규격(2.0×2.0·3.0×3.0)을 폼에서 프리셋 select로 받고 필요 시 사용자 지정으로 자유 입력하되, 저장 키는 body_width_m·body_height_m 숫자 그대로다(프리셋 전용 키를 만들지 않는다). 이 값들은 B05 서브폼이 실제로 받으므로 phase를 detail로 두지 않는다. ★보호공 개편(2026-08-17 사용자 지시): 구 `*_pitching`(있음/없음) + `*_pitching_finish`(찰/메) 두 축을 `*_protection` 한 축(돌붙임(찰)·돌붙임(메)·도수로)으로 합쳤다 — 도수로·산비탈수로(B4)는 유출부에서 돌붙임 대신 쓰는 공종이라 별도 구조물이 아니라 보호공 선택지로 받는다. \"없음\"은 삭제(물이 흐르는 자리라 보호공 필수). 치수는 배타 — 돌붙임이면 `*_protection_area_m2`(10㎡), 도수로면 `*_protection_width_m`(1m, 지식DB 수치 근거 없음·사용자 확정, 실무 확인 후 개선). 구 저장분은 `common_util_drainage_pipes.parse_pipe_points`가 새 키로 옮긴다.",
   "구조물군": {
@@ -486,6 +486,15 @@
         "quantity"
       ],
       "options": [
+        {
+          "key": "ford_slope_deg",
+          "label": "경사각도",
+          "input": "number",
+          "unit": "°",
+          "default": 3,
+          "required": false,
+          "default_basis": "물넘이 포장 경사각 기본 3° — 사용자 확정값(PLAN 65-5)"
+        },
         {
           "key": "ford_width_m",
           "label": "월류 폭",
@@ -575,8 +584,9 @@
           "label": "배관 수량",
           "input": "number",
           "unit": "련",
-          "default": null,
-          "required": false
+          "default": 2,
+          "required": false,
+          "default_basis": "세월교 배관 수량 기본 2련 — 사용자 확정값(PLAN 65-4)"
         },
         {
           "key": "ford_width_m",
@@ -3381,10 +3391,48 @@
         "inlet.structure=없음": "없음",
         "inlet.structure=날개벽": "날개벽",
         "inlet.structure=흙막이": "흙막이",
+        "inlet.form": "형태",
+        "inlet.form=돌쌓기(찰)": "돌 쌓기(찰)",
+        "inlet.form=돌쌓기(메)": "돌 쌓기(메)",
+        "inlet.form=콘크리트": "콘크리트",
+        "inlet.form=돌망태": "돌망태",
+        "inlet.form=통나무·목재틀": "통나무/목재틀",
+        "inlet.form=바자": "바자",
+        "inlet.length": "길이 (m)",
+        "inlet.height": "높이 (m)",
+        "inlet.before": "기준측점 전 (m)",
+        "inlet.after": "기준측점 후 (m)",
         "outlet.structure": "구조",
         "outlet.structure=없음": "없음",
         "outlet.structure=날개벽": "날개벽",
-        "outlet.structure=흙막이": "흙막이"
+        "outlet.structure=흙막이": "흙막이",
+        "outlet.form": "형태",
+        "outlet.form=돌쌓기(찰)": "돌 쌓기(찰)",
+        "outlet.form=돌쌓기(메)": "돌 쌓기(메)",
+        "outlet.form=콘크리트": "콘크리트",
+        "outlet.form=돌망태": "돌망태",
+        "outlet.form=통나무·목재틀": "통나무/목재틀",
+        "outlet.form=바자": "바자",
+        "outlet.length": "길이 (m)",
+        "outlet.height": "높이 (m)",
+        "outlet.before": "기준측점 전 (m)",
+        "outlet.after": "기준측점 후 (m)",
+        "soil_add": "흙막이",
+        "soil_add.form": "형태",
+        "soil_add.form=돌쌓기(찰)": "돌 쌓기(찰)",
+        "soil_add.form=돌쌓기(메)": "돌 쌓기(메)",
+        "soil_add.form=콘크리트": "콘크리트",
+        "soil_add.form=돌망태": "돌망태",
+        "soil_add.form=통나무·목재틀": "통나무/목재틀",
+        "soil_add.form=바자": "바자",
+        "soil_add.length": "길이 (m)",
+        "soil_add.height": "높이 (m)",
+        "soil_add.before": "기준측점 전 (m)",
+        "soil_add.after": "기준측점 후 (m)",
+        "chute_add": "도수로/돌붙임",
+        "chute_add.structure": "구조",
+        "chute_add.structure=도수로": "도수로",
+        "chute_add.structure=돌붙임": "돌붙임"
       }
     },
     "ford_pavement": {
@@ -3405,17 +3453,55 @@
         "ford.diameter=1000": "1000",
         "ford.diameter=1200": "1200",
         "ford.diameter=1500": "1500",
+        "ford.count": "수량 (련)",
         "ford.width": "월류 폭 (m)",
         "ford.height": "월류 높이 (m)",
-        "ford.count": "수량 (련)",
         "inlet.structure": "구조",
         "inlet.structure=없음": "없음",
         "inlet.structure=날개벽": "날개벽",
         "inlet.structure=흙막이": "흙막이",
+        "inlet.form": "형태",
+        "inlet.form=돌쌓기(찰)": "돌 쌓기(찰)",
+        "inlet.form=돌쌓기(메)": "돌 쌓기(메)",
+        "inlet.form=콘크리트": "콘크리트",
+        "inlet.form=돌망태": "돌망태",
+        "inlet.form=통나무·목재틀": "통나무/목재틀",
+        "inlet.form=바자": "바자",
+        "inlet.length": "길이 (m)",
+        "inlet.height": "높이 (m)",
+        "inlet.before": "기준측점 전 (m)",
+        "inlet.after": "기준측점 후 (m)",
         "outlet.structure": "구조",
         "outlet.structure=없음": "없음",
         "outlet.structure=날개벽": "날개벽",
-        "outlet.structure=흙막이": "흙막이"
+        "outlet.structure=흙막이": "흙막이",
+        "outlet.form": "형태",
+        "outlet.form=돌쌓기(찰)": "돌 쌓기(찰)",
+        "outlet.form=돌쌓기(메)": "돌 쌓기(메)",
+        "outlet.form=콘크리트": "콘크리트",
+        "outlet.form=돌망태": "돌망태",
+        "outlet.form=통나무·목재틀": "통나무/목재틀",
+        "outlet.form=바자": "바자",
+        "outlet.length": "길이 (m)",
+        "outlet.height": "높이 (m)",
+        "outlet.before": "기준측점 전 (m)",
+        "outlet.after": "기준측점 후 (m)",
+        "soil_add": "흙막이",
+        "soil_add.form": "형태",
+        "soil_add.form=돌쌓기(찰)": "돌 쌓기(찰)",
+        "soil_add.form=돌쌓기(메)": "돌 쌓기(메)",
+        "soil_add.form=콘크리트": "콘크리트",
+        "soil_add.form=돌망태": "돌망태",
+        "soil_add.form=통나무·목재틀": "통나무/목재틀",
+        "soil_add.form=바자": "바자",
+        "soil_add.length": "길이 (m)",
+        "soil_add.height": "높이 (m)",
+        "soil_add.before": "기준측점 전 (m)",
+        "soil_add.after": "기준측점 후 (m)",
+        "chute_add": "도수로/돌붙임",
+        "chute_add.structure": "구조",
+        "chute_add.structure=도수로": "도수로",
+        "chute_add.structure=돌붙임": "돌붙임"
       }
     },
     "revetment": {

resources/tester/helper_52_structure_spec_box.cjs

@@ -1,5 +1,5 @@
 /* 박스암거 명세 단위검증 헬퍼(PLAN 52-2) — `design_structure_spec.ts` · `design_structure_box.ts` 를
- * 그 자리에서 트랜스파일해 Node 로 돌림(꼴만 import). 결과 = JSON 한 벌.
+ * 그 자리에서 트랜스파일해 Node 로 돌림(같은 폴더 명세 import 는 따라 옮김). 결과 = JSON 한 벌.
  * 인자 `names` 면 박스암거 이름 표(정의 `종류.box_culvert.이름`)만 냄.
  */
 const fs = require("fs");
@@ -13,7 +13,9 @@ const load = (file) => {
     compilerOptions: { module: ts.ModuleKind.CommonJS, target: ts.ScriptTarget.ES2020 },
   }).outputText;
   const box = { exports: {} };
-  new Function("exports", "module", "require", js)(box.exports, box, require);
+  // 같은 폴더 명세(흙막이 양식 · 65-2)는 그 자리에서 옮김
+  const near = (m) => (m.startsWith("./") ? load(`${m.slice(2)}.ts`) : require(m));
+  new Function("exports", "module", "require", js)(box.exports, box, near);
   return box.exports;
 };
 const s = load("design_structure_spec.ts");

resources/tester/helper_54_27_soil_tier_field.cjs

@@ -130,6 +130,7 @@ const STUBS = {
   // 관 보호공 [연동] · [경사] 줄(54-30) — 여기서는 자리만
   "./B05_Profile_UI_Drainage_Revet_Choice": {
     revetChoiceRow: () => ({ paint: () => new FakeNode("div") }),
+    guardChoiceFields: () => () => [],
   },
   "../../B05_Profile/B05_Profile_UI_Structures_Summary_Row": {
     buildSummaryRow: () => {

resources/tester/test_52_1b_pipe_links.py

@@ -75,13 +75,17 @@ def test_집계표_채움에_컨테이너_줄(world):
 
 def test_서버_컨테이너_표는_배관_명세와_짝():
     with open(
-        os.path.join(ROOT, "A00_Common/design/design_structure_pipe.ts"), encoding="utf-8"
+        os.path.join(ROOT, "A00_Common/design/design_structure_guard.ts"), encoding="utf-8"
     ) as f:
         text = f.read()
     found = re.findall(
         r'title: "([^"]+)",\s*required: false,\s*prefix: "(\w+)",\s*link: "(\w+)"', text
     )
     assert [(p, link, t) for t, p, link in found] == list(SPEC_CONTAINERS["pipe"])
+    # 박스 · 세월교 = 같은 흙막이 양식(65-2)
+    assert (
+        SPEC_CONTAINERS["box_culvert"] == SPEC_CONTAINERS["ford_bridge"] == SPEC_CONTAINERS["pipe"]
+    )
 
 
 def test_54_11_흙막이는_선_단_수까지만():

resources/tester/test_52_3_structure_spec_ford_pavement.py

@@ -70,22 +70,23 @@ def test_컨테이너_경사각도_필수_도수로돌붙임_선택(out):
 
 
 def test_저장_값은_도_와_인스턴스_키(out):
-    assert out["state"] == {"slope": [{"angle": "12.5"}], "chute": [{"structure": "돌붙임"}]}
+    slope = {
+        "angle": "12.5",
+        "width": "6",
+        "height": "0.3",
+    }  # 월류 폭 · 높이 = 옛 키 그대로 읽음(65-5)
+    assert out["state"] == {"slope": [slope], "chute": [{"structure": "돌붙임"}]}
     assert out["written"] == {
         "ford_slope_deg": 15,
+        "ford_width_m": 6,
+        "ford_height_m": 0.3,
         "ford_chute_1_structure": "돌붙임",
         "ford_chute_2_structure": "도수로",
     }
 
 
 def test_옛_칸은_지난_정의_값으로_남음(out):
-    assert out["retired"] == [
-        "ford_width_m",
-        "ford_height_m",
-        "ford_slope_pct",
-        "thickness_cm",
-        "length_m",
-    ]
+    assert out["retired"] == ["ford_slope_pct", "thickness_cm", "length_m"]
     # 폼이 모르는 옛 칸은 그대로 · 폼이 아는 머리(빠진 인스턴스)는 폼 값으로 갈아 끼움
     assert out["saved"] == {
         "ford_width_m": 6,
@@ -95,7 +96,12 @@ def test_옛_칸은_지난_정의_값으로_남음(out):
         "length_m": 7,
         **out["written"],
     }
-    assert out["formKeys"] == out["keys"]["keys"] == ["ford_slope_deg"]
+    # 월류 폭 · 높이 = 세월교와 같은 키(65-5)
+    assert (
+        out["formKeys"]
+        == out["keys"]["keys"]
+        == ["ford_slope_deg", "ford_width_m", "ford_height_m"]
+    )
     assert out["heads"] == out["keys"]["prefixes"] == ["ford_chute_"]
 
 

resources/tester/test_52_4_structure_spec_ford.py

@@ -39,17 +39,20 @@ def test_컨테이너_셋_모두_필수(out):
         ["ford", "세월교", True],
         ["inlet", "유입 구조", True],
         ["outlet", "유출 구조", True],
+        ["soil_add", "흙막이", False],
+        ["chute_add", "도수로/돌붙임", False],
     ]
+    # 수량(련) = 관경 바로 뒤(65-4)
     assert out["items"][0] == [
         ["diameter", "select", "pipe_diameter_mm"],
+        ["count", "number", "pipe_count"],
         ["width", "number", "ford_width_m"],
         ["height", "number", "ford_height_m"],
-        ["count", "number", "pipe_count"],
     ]
-    assert out["choices"] == [
-        [["800", "1000", "1200", "1500"]],
-        [["없음", "날개벽", "흙막이"]],
-        [["없음", "날개벽", "흙막이"]],
+    assert [c[0] for c in out["choices"][:3]] == [
+        ["800", "1000", "1200", "1500"],
+        ["없음", "날개벽", "흙막이"],
+        ["없음", "날개벽", "흙막이"],
     ]
 
 
@@ -73,7 +76,7 @@ def test_흙막이_날개벽_고르면_옛_설치_칸도_맞춰_씀(out):
 
 
 def test_잇기_키_컨테이너마다(out):
-    assert out["links"] == ["gford", "gfordin", "gfordout"]
+    assert out["links"] == ["gford", "gfordin", "gfordout", "gsoiladd1", "gchuteadd1"]
 
 
 def _manning_depth(q, b):

resources/tester/test_52_structure_spec_box.py

@@ -36,8 +36,10 @@ def test_컨테이너_셋_모두_필수(out):
         ["body", "본체", True],
         ["inlet", "유입 구조", True],
         ["outlet", "유출 구조", True],
+        ["soil_add", "흙막이", False],
+        ["chute_add", "도수로/돌붙임", False],
     ]
-    assert out["links"] == ["gboxbody", "gboxin", "gboxout"]
+    assert out["links"] == ["gboxbody", "gboxin", "gboxout", "gsoiladd1", "gchuteadd1"]
 
 
 def test_선택지_표_02_그대로(out):

resources/tester/test_54_29_pick_same_panel.py

@@ -56,9 +56,12 @@ def test_상자_칸을_고치면_그_부분을_고름() -> None:
 
 
 def test_흙막이_상자는_사면안정_흙막이와_같은_칸() -> None:
-    pipe = _src("A00_Common/design/design_structure_pipe.ts")
-    soil = pipe[pipe.index('id: "soil_add"') :]
-    assert soil[: soil.index("},")].count("items: guardItems(),") == 1
+    # 흙막이 양식 한 벌(65-2) — 배관 · 박스 · 세월교가 같은 상자를 씀
+    guard = _src("A00_Common/design/design_structure_guard.ts")
+    soil = guard[guard.index('id: "soil_add"') :]
+    assert soil[: soil.index("};")].count("items: guardItems(),") == 1
+    for spec in ("pipe", "box", "ford"):
+        assert "SOIL_ADD" in _src(f"A00_Common/design/design_structure_{spec}.ts")
 
 
 def test_관_보호공_연동_경사_단추() -> None: