docs(knowledge): 총람에 F 계산로직 추가 (입력변수 G → 출력항목 A/B/D 연결 지도)

- 총람 = 출력변수 사전 성격 명시(공사지별 가감 가능), 5단계 파이프라인 (F1 수량 / F2 단가조립 / F3 내역 / F4 원가체인 / F5 목록·집계 역산) 각 단계 산식 요약·입력 G코드·출력 A코드·상세 로직 문서 링크 - 입력변수 사전·_index에 짝 문서·§F 상호 연결
2026-08-14 19:00:32 +09:00
parent c4fe188361
commit a9dee1884f
3 changed files with 37 additions and 3 deletions
@@ -14,7 +14,8 @@ last_updated: 2026-08-14

 관련 문서: [원가계산_체계](원가계산_체계.md) · [원가_기초데이터_원천](원가_기초데이터_원천.md) · [노임단가_적용](노임단가_적용.md) · [자재단가_적용](자재단가_적용.md) · [기계경비_산정](기계경비_산정.md) · [건설품셈_활용](../04_수량분석정보/건설품셈_활용.md)

-> **용도**: 임도 설계내역서 산출에 사용될 항목을 빠짐없이 나열한 결정용 목록. 각 표의 `채택` 칸은 비워둠 — **사용 여부는 사용자가 결정** (○ 사용 / △ 조건부 / ✕ 제외). 빈도 = 임도 공종 구성 기준 사용 확률 판단이며 한정 목록 아님 — 낮음 항목도 공사 조건에 따라 사용될 수 있고, 단일 공사 관측으로 일반화하지 않는다 (2026-08-14 사용자 지침).
+> **용도**: 임도 설계내역서 산출에 사용될 항목을 빠짐없이 나열한 결정용 목록 — **출력변수 사전** 역할 (실무 내역서 기준 필수 출력물이며, 공사지에 따라 항목 추가·삭제 가능). 각 표의 `채택` 칸은 비워둠 — **사용 여부는 사용자가 결정** (○ 사용 / △ 조건부 / ✕ 제외). 빈도 = 임도 공종 구성 기준 사용 확률 판단이며 한정 목록 아님 — 낮음 항목도 공사 조건에 따라 사용될 수 있고, 단일 공사 관측으로 일반화하지 않는다 (2026-08-14 사용자 지침).
+> 짝 문서: 입력변수 = [원가_입력변수_사전](원가_입력변수_사전.md) (G1~G9). 입력 → 출력을 잇는 **계산 로직 = §F** (이 문서).

 ## A. 내역서 문서(표) 구성 — 무엇을 출력해야 하는가

@@ -244,6 +245,38 @@ last_updated: 2026-08-14
 | E5 | 품 할증 26계열 실제 적용 여부 (실무 미적용 관측) | 개발 단계 사용자 협의 ([품셈_적용기준 §2](../04_수량분석정보/품셈_적용기준.md)) |
 | E6 | ESTX 기계경비 기준계수 ↔ 품셈 손료계수 대응 | 품셈 계수표 대조 필요 ([원가_기초데이터_원천 §2](원가_기초데이터_원천.md)) |

+## F. 계산 로직 — 입력변수(G) → 출력항목(A/B/D) 연결
+
+입력 G코드 = [원가_입력변수_사전](원가_입력변수_사전.md). 5단계 파이프라인 — 각 단계의 상세 산식은 `상세 로직` 문서가 원본이고, 여기는 연결 지도.
+
+```
+[F1 수량] 설계형상 ──→ 공종별 수량 (B·A12·A14)
+                          │
+[F2 단가조립] G3·G4·G5 + G1·G2 ──→ 기계경비 ──→ 단가산출 ──→ 일위대가 (A3~A5)
+                          │                    (G6 품 × 기초단가, G8 할증)
+[F3 내역] 수량 × 일위대가 단가 ──→ 공종별 내역서·관급 분리 (A2·A16)
+                          │
+[F4 원가계산] 직접비 집계 × G7 제비율 체인 ──→ 원가계산서 (A1)
+                          │
+[F5 목록·집계] 사용분 역집계 ──→ 목록표·대비표·집계표 (A6~A11·A13·A15)
+```
+
+| 단계 | 산식 (요약) | 입력 (G) | 출력 (A/B) | 상세 로직 |
+|---|---|---|---|---|
+| F1-1 토공 수량 | 횡단면적(측점별 절/성토·토질 분류) → 양단면평균법 구간 토량 → 토적표. 운반 = 흐트러진 토량(×L), 다짐 = ×C | 설계형상 + coef_soil_L/C (G8) | B2 · A14 토적표 · A12 | [토량계산](../03_계산정보/토량계산.md) · [토공_수량 §4](../04_수량분석정보/토공_수량.md) |
+| F1-2 구조물·배수 수량 | 구조물 단면 × 연장 (콘크리트 ㎥·거푸집 접촉 ㎡·철근 t). 배수관 지점마다 관+터파기+기초+유입·유출구+되메우기 **세트 생성**. 표준도 원단위(pum_std_drawing)는 공백 E1 | 설계형상 + G6 | B3~B5 · A12 | [구조물_수량](../04_수량분석정보/구조물_수량.md) · [배수공_수량 §2](../04_수량분석정보/배수공_수량.md) |
+| F1-3 사면·노면 수량 | 사면 공종 수량 = 사면적(사면길이 적분 × 연장), 노면 = 연장 × 폭 × 두께. 재료 할증 = 수량 × surcharge_mat | 설계형상 + G8 | B6·B7 · A12 | [비탈면·노면_수량](../04_수량분석정보/비탈면·노면_수량.md) |
+| F2-1 중기 시간당 경비 | 시간당 손료 = mach_price × mach_loss_coef (암질 시 × mach_rock_adj). 운전경비 = mach_fuel_rate × oil_diesel + labor_op_* + 소모품. 수입기계 취득가 = C.I.F × fx_* | G5 + G2 + G3 + G1 | A5 중기목록표·중기사용료 · A10 | [기계경비_산정 §1~3](기계경비_산정.md) |
+| F2-2 단가산출 | 단위수량당 비용 = Σ pum[공종][자원] × 자원단가 → NC(노무)+GC(재료)+JC(기계·경비), TC = NC+GC+JC. 품 할증 = pum × surcharge_labor (적용 여부 D11) | G6 × (G3·G4·F2-1) + G8 | A4 단가산출근거 | [원가_기초데이터_원천 §2~3](원가_기초데이터_원천.md) 검증 산식 |
+| F2-3 일위대가 | 단가산출·자재·노임·기계경비 조합 + 비율행(공구손료 = 노무비 × rate_tool 등). TU = NU+GU+JU | F2-2 + G8 | A3 일위대가표 | 〃 (LinkIndex 조립 계층) |
+| F3-1 공종별 내역 | 공종 금액 = 수량(F1) × 일위대가 단가(F2-3), 공종 트리 집계 (실무 대분류 옵션) | F1 × F2 | A2 내역서 · B 전체 | [원가계산_체계](원가계산_체계.md) |
+| F3-2 관급 분리 | 관급 플래그 자재 → 내역 단가 0, 관급자재대 별도 합산 (안전관리비 대상액 포함 여부 옵션) | G4 관급 플래그 | A16 | [자재단가_적용 §2](자재단가_적용.md) |
+| F4 원가계산 체인 | 직노 → 간노(×rate_indirect_labor) → 노무비 → 산재·고용(×rate_sanjae·rate_goyong) / 직노 → 건보(×rate_health)·연금(×rate_pension) → 요양(건보료×rate_care) / (재료비+직노) × rate_safety(+기초액) → 경비 합계 → 일반관리비(×rate_overhead) → 이윤(×rate_profit) → 총원가 → 부가세(×rate_vat) — **순서 의존** | F3 집계 + G7 | A1 원가계산서 · D1~D10 | [원가계산_체계 §2](원가계산_체계.md) 밑수 정의표 (견적 엔진 핵심) |
+| F5 목록·집계 역산 | 내역 전체에서 자원 사용분 역집계: 직종별 인수 합 → A6, 자재별 수량 합 → A7·A13, 중기 시간 합 → A5, 원천별 단가 병기 → A9, 기초값 스탬프 → A10, 비목 합계 → A11 | F1~F4 결과 | A6~A11 · A13 · A15 | [노임단가_적용 §4](노임단가_적용.md)·[자재단가_적용 §6](자재단가_적용.md) 연결 다이어그램 |
+
+- 계산 순서 의존성 요약: **F1 ∥ F2 → F3 → F4 → F5** (F1·F2는 병렬 가능, F4는 밑수 체인 때문에 내부 순서 고정).
+- 산식 검증 근거: TC=NC+GC+JC·비율행 산식은 상용 배포본 9.1만 건 전건 재계산 통과 ([원가_기초데이터_원천 §2](원가_기초데이터_원천.md)).
+
 ## 근거

 | 항목 | 출처 |
@@ -11,7 +11,8 @@ last_updated: 2026-08-14

 관련 문서: [내역서_구성항목_총람](내역서_구성항목_총람.md) · [원가_기초데이터_원천](원가_기초데이터_원천.md) · [노임단가_적용](노임단가_적용.md) · [자재단가_적용](자재단가_적용.md) · [기계경비_산정](기계경비_산정.md) · [제비율](제비율.md)

-> **용도**: 임도 설계내역서 계산에 **외부에서 가져와 입력되는 변수 하나하나**의 사전. `resources/data_cost_input_value/` 파일(json/csv) 설계의 기초 — 파일 생성 전 사용자 검토용. `총람 연결` = 이 변수가 어느 출력 항목([내역서_구성항목_총람](내역서_구성항목_총람.md)의 A/B/C/D 번호)에 흘러가는지.
+> **용도**: 임도 설계내역서 계산에 **외부에서 가져와 입력되는 변수 하나하나**의 사전 (**입력변수 사전**). `resources/data_cost_input_value/` 파일(json/csv) 설계의 기초 — 파일 생성 전 사용자 검토용. `총람 연결` = 이 변수가 어느 출력 항목([내역서_구성항목_총람](내역서_구성항목_총람.md)의 A/B/C/D 번호)에 흘러가는지.
+> 짝 문서: 출력변수 = [내역서_구성항목_총람](내역서_구성항목_총람.md). 입력 → 출력을 잇는 **계산 로직 = 총람 §F** (5단계 파이프라인 F1 수량 → F2 단가조립 → F3 내역 → F4 원가계산 → F5 목록·집계).
 > 변수코드는 제안값 — 파일 생성 시 확정. `[·]` = 카탈로그형(키별 다건), 그 외 = 스칼라(값 1개).
 > ⚠ 카탈로그형의 개별 나열은 **빈도 판단** — 전체 카탈로그(노임 132직종 등)가 항상 후보이며 단일 공사 관측으로 한정하지 않는다.

@@ -110,7 +110,7 @@
 | 01_임도/05_원가정보/노임단가_적용.md | 건설업(주)·제조업(보조) 노임 역할 구분, 적용 규칙(8시간·유사직종 준용), 임도 빈도 직종(참조), 내역서 연결 | 건협·중기중앙회 2026 상반기 보고서 md | draft |
 | 01_임도/05_원가정보/자재단가_적용.md | 단가 채택 법적 순서, 관급·조달·사급 3경로별 내역서 반영, 가격 슬롯·대비표 관행, 잡자재 2~5% | 국가계약법 시행규칙 §7, 나라장터 실사 | draft |
 | 01_임도/05_원가정보/기계경비_산정.md | 기계경비 구성(손료+운전경비+수송비), 유가·환율 연결점, 암석작업 손료 보정, 시공능력 Q식 | 건설품셈 공통 8장, ECOS·오피넷 | draft |
-| 01_임도/05_원가정보/내역서_구성항목_총람.md | 임도 내역서 사용 항목 전수 목록(문서 17·공종 79·직종·자재·중기·원가 14) — 채택 칸 = 사용자 결정용 | 별표2·산림품셈·미결 No.17·실무 관측 집약 | draft |
+| 01_임도/05_원가정보/내역서_구성항목_총람.md | 임도 내역서 **출력변수 사전**(문서 17·공종 79·기초단가·원가 14) + §F 계산 로직(입력 G → 출력 A/B/D 5단계 파이프라인) — 채택 칸 = 사용자 결정용 | 별표2·산림품셈·미결 No.17·실무 관측 집약 | draft |
 | 01_임도/05_원가정보/원가_입력변수_사전.md | 외부 수집 입력변수 사전 G1~G8(환율 5·유가 2·노임·자재·중기 5필드·품·제비율 11·계수) — data_cost_input_value 파일 설계 기초, 변수별 총람 연결 | 원가 문서 5건 집약 | draft |

 ## 02_사방댐 — 사방댐 설계자동화 기술문서