docs(B08): 골막이를 돌쌓기와 합치지 못하게 못 박음 — 다른 넷·같은 여섯

「같은 돌쌓기니 한 함수로」가 되기 쉬운 자리라, 두 정본을 나란히 잰 결과를 코드에 남김.

다른 것 넷 (소광리 「골막이(찰)(치수조서연결)」 ↔ 「돌기슭막이」)
  두께식   골막이 (0.45+0.1H)/(0.45+0.4H)   ↔ 기슭막이 뒷길이 기반(ℓ3+0.30 …)
  밑수     골막이 **돌쌓기 + 돌붙임**        ↔ 기슭막이 돌쌓기만
  단위     골막이 **개소당**                ↔ 기슭막이 m당 (확정 ⑦ 「통일 안 함」)
  정면적   골막이 **사다리꼴**(상장·하장)    ↔ 기슭막이 직사각(H × 1)

같은 것 여섯 — 막자갈 2/3 · 야면석 0.88 ton/㎡ · 물구멍 2㎡/개소 · 기울기 몫 1.04 ·
고임돌 0.15 · 채움콘크리트 0.2. **우리 기본값이 어디서 왔는지의 답**이기도 함.

`STONE_MASONRY` 상수 머리에도 한 줄 — 「**기슭막이 계열 전용**. 골막이는 두께식이 다름
(정본 C26)」. 상수만 보고 가져다 쓰면 **값이 나오므로 아무 시험도 안 잡는** 자리임.

자체검증 — 회귀 586 통과 · 0 실패.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-09-09 08:27:37 +09:00
co-authored by Claude Opus 5
parent d6a64700fc
commit 60b7196754
2 changed files with 16 additions and 0 deletions
@@ -170,6 +170,10 @@ def stone_coefficients(options: dict[str, Any], back_cm: int) -> tuple[dict[str,
# 돌쌓기 전개식의 상수 — 실무 수식에 박혀 있던 값을 뺀 것.
#: ⚠⚠ **이 상수는 기슭막이 계열(돌쌓기 찰·메) 전용이다.**
#: 골막이는 두께식이 다르다 — 소광리 정본 「골막이(찰)(치수조서연결)」 C26 이
#: `{(0.45+0.1H) + (0.45+0.4H)} ÷ 2` 이고, 여기 두께식(뒷길이 기반)과 갈린다.
#: 상수만 보고 골막이에 가져다 쓰면 **값이 나오므로 아무 시험도 안 잡는다**(2026-09-09).
STONE_MASONRY = {
# ⚠ **곱하는 값이 아니라 검산 참고값이다** (2026-09-08 ㉘ 에서 고침).
# 실무 시트의 「돌쌓기 = 정면적 × 1.04」에서 그 1.04 가 **곧 기울기 몫**이다
@@ -45,6 +45,18 @@ WITHHELD_FORMS: dict[str, str] = {
#: 골막이·바닥막이 — **왜 아직 안 서는지**. 둘 다 돌 계열이나 돌쌓기 식을 그대로 못 쓴다.
#: ⚠ 근거 없는 식을 만들지 않는다(2026-09-09 확인). 칸·표가 오면 그때 붙인다.
#:
#: ⚠⚠ **골막이를 돌쌓기와 합치지 말 것** — 「같은 돌쌓기니 한 함수로」가 되기 쉬운 자리다.
#: 소광리 정본 「골막이(찰)(치수조서연결)」과 「돌기슭막이」를 나란히 재면 **넷이 다르다**:
#:
#: 두께식 골막이 (0.45+0.1H)/(0.45+0.4H) ↔ 기슭막이 뒷길이 기반(ℓ3+0.30 …)
#: 밑수 골막이 **돌쌓기 + 돌붙임** ↔ 기슭막이 돌쌓기만
#: 단위 골막이 **개소당** ↔ 기슭막이 m당 (확정 ⑦ 「통일 안 함」)
#: 정면적 골막이 **사다리꼴**(상장·하장) ↔ 기슭막이 직사각(H × 1)
#:
#: ⓘ 같은 것도 있다 — 막자갈 **2/3**·야면석 **0.88 ton/㎡**·물구멍 **2㎡/개소**·
#: 기울기 몫 **1.04**·고임돌 **0.15**·채움콘크리트 **0.2** 는 두 시트가 같은 값이다.
#: 우리 기본값이 어디서 왔는지의 답이기도 하다.
STONE_KIN_WITHHELD: dict[str, str] = {
"erosion_check": (
"골막이는 돌쌓기와 **두께식·밑수·단위가 다름**(소광리 정본 「골막이(찰)(치수조서연결)」 "