docs(B08): 허용오차 둘을 한 자리에 모으고 왜 다른지 남김 · 축 맞춤 검산 문장 추가

- 관 허용오차 두 값이 우연히 다른 것처럼 보였음. `LENGTH_MATCH_TOLERANCE_M`(0.5m,
  「길이를 어디서 가져오나」)과 `SECTION_MATCH_TOLERANCE_M`(0.05m, 「횡단이 있나」)을
  한 자리에 이름 붙여 모으고 **맞추면 둘 다 나빠지는 까닭**을 적음
  ⚠ 두 값의 차이는 증상이고 병은 「관 자리에 측점이 없는 것」(계획서 3-14, B06 자리)
- 채집석 축 맞춤 검산을 값과 함께 보냄 — 더하는 쪽·빼는 쪽에 같은 계수가 걸려
  사토 총량이 그대로임(61.88 → 61.887)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

B08_Quantity/B08_Quantity_Engine_HaulInputs.py

@@ -53,6 +53,16 @@ COLLECTED_STONE_COMPONENT = "채집석"
 #: ⚠ 갈래를 모르는 구조물 몫은 **환산하지 않는다**(계수가 없다) — 따로 낸다.
 COLLECTED_STONE_BY_GROUND_KEY = "collected_stone_by_ground_m3"
 COLLECTED_STONE_UNKNOWN_KEY = "collected_stone_ground_unknown_m3"
+#: ⭐ **축 맞춤의 검산** — 더하는 쪽(구조물 잔토)과 빼는 쪽(채집석 공제)에 **같은 계수**가
+#:   걸리므로 사토 총량은 안 흔들린다. 실측: 잔토 126.625 ×1.15 = 145.62 담기고 공제
+#:   64.75 ×1.15 = 74.46 빠져 사토(다짐) 71.16 → ÷1.15 = **61.887**, 축 맞추기 전 61.88 과 같다.
+#:   ⇒ **값을 안 흔들면서 축만 바로잡은 것**이다. 갈래가 갈리거나 모르는 몫이 섞이는
+#:   자리에서만 값이 달라진다.
+COLLECTED_STONE_AXIS_CHECK = (
+    "축 맞춤 검산 — 더하는 쪽과 빼는 쪽에 같은 계수가 걸려 사토 총량은 그대로"
+    "(잔토 ×C 담김 · 공제 ×C 빠짐 ⇒ ÷C 하면 같은 값)"
+)
+
 COLLECTED_STONE_BASIS_NOTE = (
     "벽 입적(제자리 부피) — 자연 축으로 보고 받는 쪽이 ×C 로 다짐 축에 맞춰 뺌."
     " ⚠ 벽 입적과 원바닥 암 부피의 관계를 정한 원문이 없음(캐면 부풀고 쌓으면 공극이 생기나"
@@ -128,7 +138,7 @@ def haul_inputs(unit_quantity_table: dict[str, Any] | None) -> dict[str, Any]:
             key: round(value, 3) for key, value in sorted(stone_by_ground.items())
         },
         COLLECTED_STONE_UNKNOWN_KEY: round(stone_unknown, 3) if stone_unknown else 0.0,
-        "collected_stone_basis": COLLECTED_STONE_BASIS_NOTE,
+        "collected_stone_basis": f"{COLLECTED_STONE_BASIS_NOTE} · {COLLECTED_STONE_AXIS_CHECK}",
         STRUCTURE_SPOIL_KEY: round(total, 3) if points or total else None,
         STRUCTURE_SPOIL_POINTS_KEY: sorted(points, key=lambda row: row["chainage_m"]),
         # 총량에도 상태를 적는다 — 측점값을 안 쓰는 쪽도 상태를 알아야 한다.

B08_Quantity/B08_Quantity_Engine_Pipe.py

@@ -45,8 +45,17 @@ NOTE_SECTION_MISSING = (
     "그 측점의 횡단 자체가 없습니다 — 관은 놓였는데 횡단이 안 만들어진 자리라 "
     "[저장]으로는 안 풀립니다. 횡단설계에서 그 측점이 서야 합니다"
 )
-#: 관 자리에 횡단이 있는지 볼 때의 허용 오차. **아주 좁게** — 옆 측점을 「있다」로 세면
+# ── 허용 오차 둘 — **묻는 것이 다르다.** 한 자리에 모아 둔다 ────────────────
-#: 거짓 안내가 된다. 길이 찾기(0.5m)보다 좁은 것은 뜻이 다르기 때문이다.
+#   ⚠ **맞추지 말 것.** 하나로 맞추면 둘 다 나빠진다(2026-09-09 세 창 확인).
+#     · `LENGTH_MATCH_TOLERANCE_M` (0.5m) — 「이 관의 **길이를 어디서 가져오나**」.
+#       넉넉해도 된다. 값을 못 찾는 것보다 옆 측점 길이를 쓰는 편이 낫다.
+#     · `SECTION_MATCH_TOLERANCE_M` (0.05m) — 「이 측점에 **횡단 설계가 있나**」.
+#       좁아야 한다. 없는 설계를 「있다」고 말하면 사용자가 [저장]을 눌러 보고 헤맨다.
+#   ⚠ 두 값의 차이는 **증상**이지 병이 아니다. 병은 **관 자리에 측점이 없는 것**이고
+#     (측점을 만드는 자리는 B05 노선 [확정] 한 곳뿐 — 관을 나중에 놓거나 옮기면 안 생긴다,
+#     계획서 3-14), 그것이 고쳐지면 두 값의 차이가 **아무 관도 안 건드린다**
+#     (자기 자리에 측점이 있는 관 다섯이 이미 그 상태다).
+LENGTH_MATCH_TOLERANCE_M = 0.5
 SECTION_MATCH_TOLERANCE_M = 0.05
 
 NOTE_KIND_DEFAULT = "관종을 안 정해 기본값({kind})으로 섰습니다 — 정하면 공종이 갈립니다"
@@ -72,10 +81,16 @@ def _length_by_chainage(designs: list[dict[str, Any]], key: str) -> dict[float,
     return found
 
 
-def _nearest(lengths: dict[float, float], chainage: float, tolerance: float = 0.5) -> float | None:
+def _nearest(
+    lengths: dict[float, float],
+    chainage: float,
+    tolerance: float = LENGTH_MATCH_TOLERANCE_M,
+) -> float | None:
     """관 측점과 단면 측점이 소수점에서 어긋날 수 있어 **가까운 것**을 본다.
 
     ⚠ 좁게 본다(기본 0.5m) — 넓히면 옆 측점의 길이를 물어 와 조용히 틀린다.
+    ⚠ 「횡단이 있나」를 재는 `SECTION_MATCH_TOLERANCE_M`(0.05m)와 **다른 물음**이다 —
+      위 주석을 볼 것. 맞추면 둘 다 나빠진다.
     """
     if not lengths:
         return None