From c4fe18836109ad6cbd1a420854928ef9f982fe27 Mon Sep 17 00:00:00 2001 From: umsangdon Date: Fri, 14 Aug 2026 18:54:44 +0900 Subject: [PATCH] =?UTF-8?q?docs(knowledge):=20=EC=9B=90=EA=B0=80=20?= =?UTF-8?q?=EC=9E=85=EB=A0=A5=EB=B3=80=EC=88=98=20=EC=82=AC=EC=A0=84=20?= =?UTF-8?q?=EC=8B=A0=EC=84=A4=20(=EB=B3=80=EC=88=98=20=EB=8B=A8=EC=9C=84?= =?UTF-8?q?=20=E2=80=94=20data=5Fcost=5Finput=5Fvalue=20=EC=84=A4=EA=B3=84?= =?UTF-8?q?=20=EA=B8=B0=EC=B4=88)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - G1 환율 5 · G2 유가 2 · G3 노임(빈도 16+카탈로그) · G4 자재(빈도 21+카탈로그) · G5 중기 5필드 · G6 품(공종×자원) · G7 제비율 11 · G8 할증계수 · G9 사용자입력 구분 - 변수별 총람(A/B/C/D) 연결·단위·원천·갱신주기, 파일 분할안 8종 포함 --- .../01_임도/05_원가정보/원가_입력변수_사전.md | 167 ++++++++++++++++++ resources/knowledge/technical_info/_index.md | 1 + 2 files changed, 168 insertions(+) create mode 100644 resources/knowledge/technical_info/01_임도/05_원가정보/원가_입력변수_사전.md diff --git a/resources/knowledge/technical_info/01_임도/05_원가정보/원가_입력변수_사전.md b/resources/knowledge/technical_info/01_임도/05_원가정보/원가_입력변수_사전.md new file mode 100644 index 00000000..cded31b3 --- /dev/null +++ b/resources/knowledge/technical_info/01_임도/05_원가정보/원가_입력변수_사전.md @@ -0,0 +1,167 @@ +--- +title: 원가 입력변수 사전 (외부 수집 변수 → data_cost_input_value 설계 기초) +category: 05_원가정보 +sources: + - doc: 원가 기초데이터 원천·사용법 문서 5건 집약 (변수 단위 분해) + version: 2026-08-14 + loc: technical_info/01_임도/05_원가정보/ +status: draft +last_updated: 2026-08-14 +--- + +관련 문서: [내역서_구성항목_총람](내역서_구성항목_총람.md) · [원가_기초데이터_원천](원가_기초데이터_원천.md) · [노임단가_적용](노임단가_적용.md) · [자재단가_적용](자재단가_적용.md) · [기계경비_산정](기계경비_산정.md) · [제비율](제비율.md) + +> **용도**: 임도 설계내역서 계산에 **외부에서 가져와 입력되는 변수 하나하나**의 사전. `resources/data_cost_input_value/` 파일(json/csv) 설계의 기초 — 파일 생성 전 사용자 검토용. `총람 연결` = 이 변수가 어느 출력 항목([내역서_구성항목_총람](내역서_구성항목_총람.md)의 A/B/C/D 번호)에 흘러가는지. +> 변수코드는 제안값 — 파일 생성 시 확정. `[·]` = 카탈로그형(키별 다건), 그 외 = 스칼라(값 1개). +> ⚠ 카탈로그형의 개별 나열은 **빈도 판단** — 전체 카탈로그(노임 132직종 등)가 항상 후보이며 단일 공사 관측으로 한정하지 않는다. + +## G1. 환율 — ECOS API 731Y001, 일별, 스냅샷 보존 + +| 변수코드 | 한글명 | 단위 | 총람 연결 | +|---|---|---|---| +| fx_usd | 미국달러 매매기준율 | 원/$ | A10 환율및기초자료 → C3 중기 취득가 환산 | +| fx_jpy100 | 일본엔(100엔) | 원/¥100 | 〃 | +| fx_eur | 유로 | 원/€ | 〃 | +| fx_gbp | 영국파운드 | 원/£ | 〃 | +| fx_cny | 중국위안 | 원/위안 | 〃 | + +공통 메타: 기준일(일별), 출처=서울외국환중개 매매기준율 (ECOS 경유). + +## G2. 유가 — 오피넷 API, 주간, 지역 파라미터 지원 + +| 변수코드 | 한글명 | 단위 | 총람 연결 | +|---|---|---|---| +| oil_diesel | 경유 판매가 (전국/지역) | 원/L | A5 중기사용료 연료비 · A10 | +| oil_gasoline | 휘발유 판매가 | 원/L | 〃 | + +- 선박용경유·중유 = 제외 (2026-08-14 사용자 결정, 필요 시 재편입). 품셈 8-1-7: "유류가격은 해당지역의 가격" — 지역 코드 파라미터 유지. + +## G3. 노임 — 건협 132직종 (반기 1.1/9.1) · 중기중앙회 129직종 (반기 7.1/1.1) + +변수형: `labor_rate[직종번호]` (원/일, 1일 8시간). 메타: 공표일, 신뢰플래그(`*` 표본<5 / `**` 미조사). 빈도 상위 개별 변수: + +| 변수코드 | 직종 (번호) | 총람 연결 | +|---|---|---| +| labor_1001 | 작업반장 | B 전 공종 노무비 → A3·A4·A6 | +| labor_1002 | 보통인부 | 〃 (최다 사용) | +| labor_1003 | 특별인부 | 〃 | +| labor_1007 | 형틀목공 | B3 거푸집 | +| labor_1008 | 철근공 | B3-4 철근 | +| labor_1012 | 용접공 | B3·B5 강관 | +| labor_1013 | 콘크리트공 | B3-1 타설·B6-2 포장 | +| labor_1015 | 착암공 | B2-3 발파암 | +| labor_1016 | 화약취급공 | 〃 | +| labor_1017 | 할석공 | B4 석공 | +| labor_1018 | 포설공 | B6-1 쇄석 | +| labor_1019 | 포장공 | B6-2 포장 | +| labor_op_const | 건설기계운전사 (번호 = 원문 표 참조) | C3 중기 운전경비 | +| labor_op_truck | 화물차운전사 (〃) | 〃 | +| labor_op_general | 일반기계운전사 (〃) | 〃 | +| labor_mfg[직종코드] | 제조업 조사노임 (보조 — 제작·가공 단가산출 시) | A4 | + +전체 카탈로그: [3. 개별직종 노임단가](../../../original/원가계산/노임단가_건설업_대한건설협회/3.%20개별직종%20노임단가.md) (132행). + +## G4. 자재단가 — 경로별 3원천, 월간~수시 + +변수형: `mat_price[품목코드]` (원/단위). 메타: 규격, 단위, 원천경로(관급/조달/물가지/견적), 물품식별번호, 기준일(월호), 게재페이지. 빈도 상위 개별 변수 (울진·영월 관측 기준 — ⚠ 참조): + +| 변수코드 | 품목 | 단위 | 원천 경로 | 총람 연결 | +|---|---|---|---|---| +| mat_cement | 시멘트 (40kg) | 원/포 | 관급 (쇼핑몰 API — 검증 5,820원 일치) | A16 관급자재대 · B3 | +| mat_sand | 모래 | 원/㎥ | 관급 관측 | 〃 · D12 할증 10% | +| mat_gravel | 자갈 | 원/㎥ | 〃 | 〃 · D12 할증 3% | +| mat_crushed_stone | 깬돌·파쇄암 | 원/㎥ | 〃 | B4·B6-1 | +| mat_remicon | 레미콘 (규격별 25-18-120 등) | 원/㎥ | 조달 (쇼핑몰 MAS — 검증 91,580원) | B3-1 타설 | +| mat_rebar | 철근 (SD400 D10~) | 원/t | 조달 | B3-4 | +| mat_corrugated_pipe | 파형강관 (Ø·게이지별) | 원/m | 관급/조달 혼재 관측 | B5-3 | +| mat_coupling | 이음관(커플링) | 원/개 | 조달 | B5 관부설 세트 | +| mat_wiremesh | 와이어메쉬 | 원/㎡ | 조달 | B6-2 포장 | +| mat_wood | 목재 (판재·각재) | 원/㎥ | 조달 | B3 거푸집·B4-13 | +| mat_nail | 못 | 원/kg | 조달 | B3 | +| mat_fuel_site | 현장 유류 (경유 — 자재 계상분) | 원/L | 조달 (식별번호 관측) | A7 재료비목록표 | +| mat_pvc_pipe | PVC관 | 원/m | 물가지·견적 (미결 No.18) | B5 | +| mat_euroform | 유로폼 | 원/매 | 〃 | B3-7 | +| mat_explosive | 폭약 | 원/kg | 〃 | B2-3 발파 | +| mat_detonator | 뇌관 | 원/개 | 〃 | 〃 | +| mat_chisel | 치즐·드릴부품 | 원/개 | 가격정보 API 실존 확인 | C3 착암 소모품 | +| mat_seed | 종자 (녹화용) | 원/kg | 물가지·견적 | B7 녹화 | +| mat_fertilizer | 비료 | 원/포 | 〃 | 〃 | +| mat_sign_plate | 국가지점번호판·표지판 | 원/개 | 견적 관측 | B8 | +| mat_sod | 떼(잔디) | 원/㎡ | 물가지·견적 | B7 · D12 할증 10% | + +전체 카탈로그: 공사당 46~58종 관측 ([원가_기초데이터_원천 §5](원가_기초데이터_원천.md)) + 나라장터 API 27,485품목 스냅샷 ([자재단가 _meta](../../../original/원가계산/자재단가/_meta.md)). + +## G5. 중기 기초자료 — 품셈 8장 별표 + 조달청/자체조사, 연간 + +변수형: 기종·규격 키(`mach[기종코드]`)당 4필드. 임도 빈도 기종 = [총람 C3](내역서_구성항목_총람.md) (굴착기 0.2/0.6/1.0㎥ · 덤프 15ton · 불도저 · 진동롤러 · 살수차 · 공기압축기 · 착암기 · 콘크리트믹서 · 양수기 · 발전기 · 카고크레인). + +| 변수코드 | 한글명 | 단위 | 총람 연결 | +|---|---|---|---| +| mach_price[기종] | 취득가격 (국산 표준시가 / 수입 C.I.F×환율) | 천원 | A5 중기목록표 | +| mach_loss_coef[기종] | 시간당 손료계수 (상각+정비+관리 합계) | 1/hr (계수) | A5 → 시간당 손료 = 취득가 × 계수 | +| mach_fuel_rate[기종] | 연료 소비량 | L/hr | A5 운전경비 (× oil_diesel) | +| mach_operator_map[기종] | 운전사 직종 매핑 | 직종코드 | C1 labor_op_* 연결 | +| mach_rock_adj[기종] | 암석작업 손료 보정률 (불도저·덤프 25 / 굴착기·로더 20 / 전석 10) | % | D14 | + +⚠ 손료계수 원문 표(품셈 8장 후반 별표) 데이터 추출 미착수 — ESTX MachGijun 계수와 대조 필요 ([원가_기초데이터_원천 §2](원가_기초데이터_원천.md)). + +## G6. 품(원단위) — 산림품셈(수시)·건설품셈(연간) + +변수형: `pum[공종코드][자원코드]` = 단위수량당 소요량. 자원코드 = 직종(G3)·기종(G5)·자재(G4) 키. + +| 변수코드 | 한글명 | 단위 | 총람 연결 | +|---|---|---|---| +| pum[공종][직종] | 공종별 노무 품 | 인/단위수량 | B 공종 79항목 전부 → A3·A4 | +| pum[공종][기종] | 공종별 장비 품 | hr/단위수량 | 〃 | +| pum[공종][자재] | 공종별 재료 소요량 (품셈 명시분) | 자재단위/단위수량 | 〃 | +| pum_std_drawing[구조물][자원] | 구조물 표준도 원단위 (옹벽·날개벽·집수정 규격별 콘크리트·거푸집·철근량) | ㎥·㎡·t/개소 | B3·B5 — **현행 공백 E1** (실무 일람표 추출 필요) | + +공종→품셈 절 매핑 = [총람 B](내역서_구성항목_총람.md) (절 번호 열), 건설품셈 보완장 = [건설품셈_활용 §2](../04_수량분석정보/건설품셈_활용.md). + +## G7. 제비율 — 각 고시·조달청, 연간+수시 ([제비율](제비율.md) 현행값) + +| 변수코드 | 한글명 | 밑수 | 현행값 (2026 확보) | 총람 연결 | +|---|---|---|---|---| +| rate_sanjae | 산재보험료율 | 노무비 | 3.56 % (건설업 3.5+출퇴근 0.06) | D3 | +| rate_goyong | 고용보험료율 | 노무비 | 실업급여 1.8 % + 규모별 0.25~0.85 % (⚠ 등급 요율 재확인) | D3 | +| rate_health | 국민건강보험료율 | 직접노무비 | 3.595 % | D4 | +| rate_pension | 국민연금보험료율 | 직접노무비 | 4.5 % | D4 | +| rate_care | 노인장기요양보험료율 | 건강보험료 | 13.14 % | D4 | +| rate_safety_pct | 산업안전보건관리비율 (토목, 규모 3구간) | 재료비+직노 | 3.15 / 2.53 / 2.60 % | D5 | +| rate_safety_base | 안전관리비 기초액 (5~50억 구간) | — | 3,300,000원 | D5 | +| rate_indirect_labor | 간접노무비율 (규모·기간별 표) | 직접노무비 | 토목 18.9~21.0 % | D2 | +| rate_overhead | 일반관리비율 (규모별 표) | 재+노+경 | 토목 8.0~6.5 % | D7 | +| rate_profit | 이윤율 (규모별 표) | 노+경+일반관리비 | 15~9 % | D8 | +| rate_vat | 부가가치세율 | 총원가 | 10 % | D9 | + +- rate_indirect_labor·rate_overhead·rate_profit는 스칼라 아닌 **규모·기간 구간 표** — [조달청 제비율 원문](../../../original/행정규칙/토목공사원가계산 제비율 적용기준/현행_20260413.md) (W7 수동 갱신). + +## G8. 할증·보정 계수 — 품셈 개정 연동 (준정적) + +| 변수코드 | 한글명 | 값 구조 | 총람 연결 | +|---|---|---|---| +| surcharge_labor[계열][단계] | 품 할증 26계열 (작업시기·집단화·산지경사·이동거리·하층식생·장애물 등) | 계열별 0/5/10 % ([품셈_적용기준 §2](../04_수량분석정보/품셈_적용기준.md)) | D11 (⚠ 실무 미적용 관측 — 적용 여부 사용자 결정) | +| surcharge_mat[자재] | 재료 할증 (모래 10·자갈 3·흄관 3·포장포설 4·떼 10·이형철근 3 %) | % | D12 | +| rate_tool | 공구손료·잡자재율 | 주재료비의 2~5 % | D13 | +| coef_soil_L[토질] · coef_soil_C[토질] | 토량 환산계수 (흐트러짐/다짐) | 계수표 ([토량계산](../03_계산정보/토량계산.md)) | B2 운반·다짐 수량 | + +## G9. 사전 정의 파라미터 (외부 수집 아님 — 공사별 사용자 입력, 구분용) + +공사금액 규모(제비율 구간 선택) · 공사기간(간접노무비 구간·보험 적용) · 현장 소재지(유가 지역·수송비 거리) · 자재별 관급/사급 플래그 · 암질 구분(중기 보정 트리거) · 프로젝트 할증 속성(작업시기·경사·이동거리·집단화). → 입력 UI 영역, data_cost_input_value 파일 대상 아님. + +## 데이터셋 ↔ 변수 그룹 대응 (파일 설계 시) + +| data_cost_input_value 파일(안) | 변수 그룹 | 갱신 | +|---|---|---| +| fx_YYYY-MM-DD.csv | G1 | 일별 (원하는 시점) | +| oil_YYYY-MM-DD.json | G2 | 주간 | +| labor_const_YYYY-MM-DD.csv / labor_mfg_*.csv | G3 | 반기 | +| mat_price_YYYY-MM-DD.csv | G4 | 월간~수시 | +| mach_base_YYYY.json | G5 | 연간 | +| pum_forest_YYYY.json / pum_const_YYYY.json | G6 | 수시/연간 | +| rates_YYYY.json | G7 | 연간+수시 | +| coef_YYYY.json | G8 | 품셈 개정 시 | + +## 근거 + +전 변수 = 기존 5문서 집약: [원가_기초데이터_원천](원가_기초데이터_원천.md)(원천·검증) · [노임단가_적용](노임단가_적용.md) · [자재단가_적용](자재단가_적용.md) · [기계경비_산정](기계경비_산정.md) · [제비율](제비율.md) · [품셈_적용기준](../04_수량분석정보/품셈_적용기준.md) · [수량산출_일반](../04_수량분석정보/수량산출_일반.md) diff --git a/resources/knowledge/technical_info/_index.md b/resources/knowledge/technical_info/_index.md index e4065267..76eee1eb 100644 --- a/resources/knowledge/technical_info/_index.md +++ b/resources/knowledge/technical_info/_index.md @@ -111,6 +111,7 @@ | 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 | 외부 수집 입력변수 사전 G1~G8(환율 5·유가 2·노임·자재·중기 5필드·품·제비율 11·계수) — data_cost_input_value 파일 설계 기초, 변수별 총람 연결 | 원가 문서 5건 집약 | draft | ## 02_사방댐 — 사방댐 설계자동화 기술문서