docs(knowledge): 원가 입력변수 사전 신설 (변수 단위 — data_cost_input_value 설계 기초)
- G1 환율 5 · G2 유가 2 · G3 노임(빈도 16+카탈로그) · G4 자재(빈도 21+카탈로그) · G5 중기 5필드 · G6 품(공종×자원) · G7 제비율 11 · G8 할증계수 · G9 사용자입력 구분 - 변수별 총람(A/B/C/D) 연결·단위·원천·갱신주기, 파일 분할안 8종 포함
This commit is contained in:
@@ -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)
|
||||
@@ -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_사방댐 — 사방댐 설계자동화 기술문서
|
||||
|
||||
|
||||
Reference in New Issue
Block a user