eomsangdon/Aislo
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity

docs(knowledge): 값형 원본 스냅샷 저장·실무 자재 실측 반영

Browse Source 
- 계획 변경(사용자): 값형도 original/원가계산/에 원본 스냅샷 보존
  - 자재단가/ 나라장터 27,485행 CSV+JSON, 환율_한국은행ECOS/ 연초~일별 760행,
    유가_오피넷/ 전국평균+7일 JSON — collect_cost_sources.py values 모드 신설
- 실무 실측(울진 간선임도 46종·영월 58종): 관급 별도계상 16·조달가 15·물가지/견적 ~15
  - 실무 대비표 슬롯 = 조달가격/물가정보/물가자료/적산정보/견적단가 관측
  - 원가_기초데이터_원천.md §5 신설 — 유료지 실수요 = 공사당 사급 잡자재 15종 내외
- 노임 PDF 값 추출 가능 확인(직종코드 앵커), 품셈 기계경비 장(8장) 존재 확인
This commit is contained in:
eomsangdon
2026-08-14 16:54:02 +09:00
parent a98b9af3a0
commit c998afd3b6
7 changed files with 28506 additions and 69 deletions
Download Patch File Download Diff File Expand all files Collapse all files
resources/knowledge/technical_info/01_임도/05_원가정보/원가_기초데이터_원천.md
+63 -47
View File
@@ -11,7 +11,6 @@ sources:
status: draft
last_updated: 2026-08-14
---
관련 문서: [원가계산_체계](원가계산_체계.md) · [제비율](제비율.md) · [품셈_적용기준](../04_수량분석정보/품셈_적용기준.md) · [미결 No.17](../../../03_미결_및_확인사항.md)
## 0. 자료 성격과 검증 상태
@@ -24,27 +23,27 @@ last_updated: 2026-08-14
배포본 안내 시트(EstMainDat 41행)가 원천을 직접 명기한다. §1-보조(미결 No.17)의 게시판 표와 전 항목 정합.
| 데이터군 | 원천 (관측) | 기준일 (2026 하반기판) | 갱신주기 | ESTX 근거 |
|---|---|---|---|---|
| 노임 — 건설업 | 대한건설협회 시중노임 | 2026.1.1 (상반기분 적용) | 반기 | EstMain 공지 "1."; Laborc 381건 Date=2026-01-01 |
| 노임 — 제조업 | 중소기업중앙회 | 2026.1.1 | 반기 | EstMain 공지 |
| 자재 — 시중물가 | 간행물 5종: 가격정보·물가자료·유통물가·물가정보·거래가격 (+견적가 슬롯) | 2026년 7월호 | 월간 | ProjectDataInfo.Ini TitleName1..6; Stuffc Cost1..6 |
| 자재 — 주요 관급(철근·레미콘·아스콘) | 조달청 나라장터 | 조사기준일 2026.7.1 (조사기간 6.1~6.30) | 월간 | EstMain 공지 "4." |
| 중기 — 환율 | 서울외국환중개 매매기준율 | 2026.7.1 | 반기(배포 시점) | MachGijun 5통화; EstMain 공지 "2." |
| 중기 — 유류 | 한국석유공사 (휘발유·경유=주유소 판매가 주간, 선박용경유·중유=대리점 판매가 월간) | 26년 6월 4주 / 26년 5월 | 반기(배포 시점) | EstMain 공지 |
| 품셈 | 한국건설기술연구원 개정품셈 | 2026.1 | 연간 | EstMain 공지 "3." |
| 표준시장단가 — 토목·건축·기계설비 | 한국건설기술연구원 | 2026.5.8 발표 (하반기분) | 반기 | EstMain 공지 "5."; SilJuk 내부 공표일 일치 |
| 표준시장단가 — 항만 | 한국항만협회 | 2026.5.22 발표 | 반기 | EstMain 공지; SilJuk |
| 데이터군 | 원천 (관측) | 기준일 (2026 하반기판) | 갱신주기 | ESTX 근거 |
| --------------------------------------- | ----------------------------------------------------------------------------------- | --------------------------------------- | --------------- | -------------------------------------------------- |
| 노임 — 건설업 | 대한건설협회 시중노임 | 2026.1.1 (상반기분 적용) | 반기 | EstMain 공지 "1."; Laborc 381건 Date=2026-01-01 |
| 노임 — 제조업 | 중소기업중앙회 | 2026.1.1 | 반기 | EstMain 공지 |
| 자재 — 시중물가 | 간행물 5종: 가격정보·물가자료·유통물가·물가정보·거래가격 (+견적가 슬롯) | 2026년 7월호 | 월간 | ProjectDataInfo.Ini TitleName1..6; Stuffc Cost1..6 |
| 자재 — 주요 관급(철근·레미콘·아스콘) | 조달청 나라장터 | 조사기준일 2026.7.1 (조사기간 6.1~6.30) | 월간 | EstMain 공지 "4." |
| 중기 — 환율 | 서울외국환중개 매매기준율 | 2026.7.1 | 반기(배포 시점) | MachGijun 5통화; EstMain 공지 "2." |
| 중기 — 유류 | 한국석유공사 (휘발유·경유=주유소 판매가 주간, 선박용경유·중유=대리점 판매가 월간) | 26년 6월 4주 / 26년 5월 | 반기(배포 시점) | EstMain 공지 |
| 품셈 | 한국건설기술연구원 개정품셈 | 2026.1 | 연간 | EstMain 공지 "3." |
| 표준시장단가 — 토목·건축·기계설비 | 한국건설기술연구원 | 2026.5.8 발표 (하반기분) | 반기 | EstMain 공지 "5."; SilJuk 내부 공표일 일치 |
| 표준시장단가 — 항만 | 한국항만협회 | 2026.5.22 발표 | 반기 | EstMain 공지; SilJuk |
간행물 5종의 발행처 매핑(조달청/한국물가협회/한국응용통계연구원/한국물가정보/대한건설협회)은 판매처 게시판 표 기준 — [미결 §1-보조](../../../03_미결_및_확인사항.md) 참조. ESTX 내부에는 간행물명만 존재.
### 상반기→하반기 원천 변경 관측 (비교 스냅샷 `_` 필드)
| 항목 | 2026 상반기(변경전 값) | 2026 하반기(현재 값) |
|---|---|---|
| 중기기초자료 조사 주체 | 조달청 (2026.1.6) | **다산소프트 자체 조사** (2026.7.1) |
| 유류 원천 | 조달청 (휘발유 1,473원/L) | 한국석유공사 판매가 (휘발유 1,825원/L) |
| 환율 | 1,465.9원/$ | 1,548.4원/$ (서울외국환중개 동일) |
| 항목 | 2026 상반기(변경전 값) | 2026 하반기(현재 값) |
| ---------------------- | ------------------------------------------------- | ----------------------------------------- |
| 중기기초자료 조사 주체 | 조달청 (2026.1.6) | **다산소프트 자체 조사** (2026.7.1) |
| 유류 원천 | 조달청 (휘발유 1,473원/L) | 한국석유공사 판매가 (휘발유 1,825원/L) |
| 환율 | 1,465.9원/$ | 1,548.4원/$ (서울외국환중개 동일) | |
> [해석] 유류·중기 기초값은 반기마다 조사 주체가 바뀔 수 있는 **비고정 원천** — 상용사도 조달청 단가와 시장 판매가를 오간다. Aislo 원천 선정 시 "무엇을 쓰느냐"보다 "기준일·출처를 내역서에 명기"하는 쪽이 실무 관행에 부합.
@@ -57,11 +56,11 @@ last_updated: 2026-08-14
성분 기호: N=노무비, G=재료비, J=기계·경비, T=합계 / 접미 C=금액, U=단가(단위값) / 접미 `_`=반기 비교 스냅샷.
| 산식 | 적용 테이블 | 검증 |
|---|---|---|
| `TC = NC + GC + JC (+SC)` | 단가산출·일위대가·기계경비·표준시장단가 상세/제목 전부 | 91,000여 건 전건 통과 (오차 ≤ 2.33e-10) |
| `TU = NU + GU + JU (+SU)` | 일위대가 상세 (단가 성분) | 9,183건 전건 통과 |
| 비율행 `TC = GN × TU / 100` | 일위대가 상세 % 행 (GN=비율값, 예: 공구손료 노무비의 3%) | 1,028건 통과 (절사 오차 ≤0.098) |
| 산식 | 적용 테이블 | 검증 |
| ----------------------------- | --------------------------------------------------------- | ---------------------------------------- |
| `TC = NC + GC + JC (+SC)` | 단가산출·일위대가·기계경비·표준시장단가 상세/제목 전부 | 91,000여 건 전건 통과 (오차 ≤ 2.33e-10) |
| `TU = NU + GU + JU (+SU)` | 일위대가 상세 (단가 성분) | 9,183건 전건 통과 |
| 비율행`TC = GN × TU / 100` | 일위대가 상세 % 행 (GN=비율값, 예: 공구손료 노무비의 3%) | 1,028건 통과 (절사 오차 ≤0.098) |
- `SC/SU` 성분의 업무 의미는 파일만으로 미확정 (관측값 전부 0) — ⚠ 근거 미확인.
- 기계경비 기준계수 5건 관측 (MachGijun, 명칭이 산식 문자열): `1/8*16/12*25/20`=0.20833, `…*24/15`=0.33333, `…*12/10`=0.25, `…*14/12`=0.24306, `…*24/5`=1.0. 표준품셈 기계경비 산식(연간표준가동시간·손료 계수)과의 대응은 ⚠ 근거 미확인 — 품셈 원문 대조 필요.
@@ -87,13 +86,13 @@ last_updated: 2026-08-14
(공사별 내역서 — 배포본에는 없음. 일위대가·단가산출 단가를 수량에 곱해 조립)
```
| LinkIndex | 참조 대상 | 검증 |
|---|---|---|
| 5 | 자재 (Stuffc) | 코드 전수 일치 |
| 6 | 노임 (Laborc) | 코드 전수 일치 |
| 103 | 일위대가 제목 | 코드 전수 일치 |
| 104 | 단가산출 제목 | 코드 전수 일치 |
| 105 | 기계경비 제목 | 코드 전수 일치 |
| LinkIndex | 참조 대상 | 검증 |
| --------- | ------------- | -------------- |
| 5 | 자재 (Stuffc) | 코드 전수 일치 |
| 6 | 노임 (Laborc) | 코드 전수 일치 |
| 103 | 일위대가 제목 | 코드 전수 일치 |
| 104 | 단가산출 제목 | 코드 전수 일치 |
| 105 | 기계경비 제목 | 코드 전수 일치 |
- 자재 단가 결정: 6개 가격슬롯(간행물별 단가+페이지)을 병기하고 그중 하나를 대표단가 `TC`로 채택 — 23,962/23,987건에서 TC가 슬롯값 중 하나와 일치. 슬롯 채움률: 가격정보 23,960 / 나머지 4종+견적가 각 20,433건.
- 반기 배포마다 전 카탈로그를 재계산하고 **직전 반기값을 `_` 필드(변경전/후 비교 스냅샷)로 보존** — 단가 변동 대비표 출력 기능.
@@ -103,30 +102,47 @@ last_updated: 2026-08-14
## 4. Aislo 수집 경로 확정 (2026-08-14 실사 검증 — 어디서 가져와 어떻게 쓰는가)
원천별 입수 경로를 실제 다운로드·API 호출로 검증 완료. 문서형은 `original/원가계산/`(다운로드 위치 기준 폴더), 값형은 프로그램 값층(별도 파일/DB, 시점 스탬프)으로 관리 — original에 값형 저장 안 함. API 키 = `knowledge/.secrets.local.md`(로컬), 수집 스크립트 = [`original/_pipeline/collect_cost_sources.py`](../../../original/_pipeline/collect_cost_sources.py).
원천별 입수 경로를 실제 다운로드·API 호출로 검증 완료. 문서형·값형 모두 `original/원가계산/`(다운로드 위치 기준 폴더)에 **원본 스냅샷을 보존**하고(2026-08-14 사용자 결정 — 값형 폴더: 자재단가/·환율_한국은행ECOS/·유가_오피넷/), 프로그램용 데이터셋은 이 원본에서 별도 추출해 구성한다. API 키 = `knowledge/.secrets.local.md`(로컬), 수집 스크립트 = [`original/_pipeline/collect_cost_sources.py`](../../../original/_pipeline/collect_cost_sources.py) (`docs`=문서 3종, `values`=값형 3종 스냅샷).
| 데이터군 | 확정 경로 | 형식/층 | 갱신 | 내역서 사용처 |
|---|---|---|---|---|
| 노임(건설업) | 대한건설협회 게시판 (무료·비로그인, 텍스트 PDF) | 문서 → [노임단가_건설업](../../../original/원가계산/노임단가_건설업_대한건설협회/) | 반기 (1/1·9/1 적용) | 일위대가·단가산출의 노무비 단가, 중기 조종원 노임 |
| 노임(제조업) | 중소기업중앙회 게시판 (무료·비로그인, 텍스트 PDF) | 문서 → [노임단가_제조업](../../../original/원가계산/노임단가_제조업_중소기업중앙회/) | 반기 (7/1·1/1 적용) | 제작·가공 항목 노무비 (보조) |
| 자재단가 | 나라장터 가격정보현황서비스 API (검증: 시설공통자재 27,485건. ⚠ 철근·레미콘·아스콘은 종합쇼핑몰 계약단가 별도 경로 — 후속 조사) | 값층 (JSON) | 연2회+수시 | 재료비 단가, 자재단가대비표 |
| 유가 | 오피넷 무료 API (검증: 휘발유·경유 등 5유종. 선박용경유·중유 불요 — 사용자 결정) | 값층 (JSON) | 주간 | 중기사용료 연료비, 환율및기초자료 표 |
| 환율 | 한국은행 ECOS API 731Y001 (검증: $·¥100·€·£·위안 일별) | 값층 (JSON) | 일별 | 기계경비 외화 환산, 환율및기초자료 표 |
| 품셈(건설) | 표준품셈정보원 kseis 자료실 (무료, W7 제비율과 동일 사이트) | 문서 → [건설공사_표준품셈](../../../original/원가계산/건설공사_표준품셈/) | 연간 | 일위대가·단가산출의 품(원단위) — 산림품셈 보완 |
| 표준시장단가 | **수집 제외** (2026-08-14 사용자 결정) — 추정 100억 미만 공사 미적용·품셈 조립과 별도 트랙. ESTX에서도 내역 조립 계층(LinkIndex)에 미연결(참고 카탈로그) | — | — | 사용 안 함 |
| 유료지 4종 | 미결정 — 사급 자재의 80%가 유료지 전용(§3). 구독·재배포 라이선스 = 사업 판단 | — | 월간 | (구독 시) 사급 자재 재료비 |
| 데이터군 | 확정 경로 | 형식/층 | 갱신 | 내역서 사용처 |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- | -------------------- | -------------------------------------------------- |
| 노임(건설업) | 대한건설협회 게시판 (무료·비로그인, 텍스트 PDF) | 문서 →[노임단가_건설업](../../../original/원가계산/노임단가_건설업_대한건설협회/) | 반기 (1/1·9/1 적용) | 일위대가·단가산출의 노무비 단가, 중기 조종원 노임 |
| 노임(제조업) | 중소기업중앙회 게시판 (무료·비로그인, 텍스트 PDF) | 문서 →[노임단가_제조업](../../../original/원가계산/노임단가_제조업_중소기업중앙회/) | 반기 (7/1·1/1 적용) | 제작·가공 항목 노무비 (보조) |
| 자재단가 | 나라장터 가격정보현황서비스 API (검증: 시설공통자재 27,485건. ⚠ 철근·레미콘·아스콘은 종합쇼핑몰 계약단가 별도 경로 — 후속 조사) | 값층 (JSON) | 연2회+수시 | 재료비 단가, 자재단가대비표 |
| 유가 | 오피넷 무료 API (검증: 휘발유·경유 등 5유종. 선박용경유·중유 불요 — 사용자 결정) | 값층 (JSON) | 주간 | 중기사용료 연료비, 환율및기초자료 표 |
| 환율 | 한국은행 ECOS API 731Y001 (검증: $·¥100·€·£·위안 일별) | 값층 (JSON) | 일별 | 기계경비 외화 환산, 환율및기초자료 표 |
| 품셈(건설) | 표준품셈정보원 kseis 자료실 (무료, W7 제비율과 동일 사이트) | 문서 →[건설공사_표준품셈](../../../original/원가계산/건설공사_표준품셈/) | 연간 | 일위대가·단가산출의 품(원단위) — 산림품셈 보완 |
| 표준시장단가 | **수집 제외** (2026-08-14 사용자 결정) — 추정 100억 미만 공사 미적용·품셈 조립과 별도 트랙. ESTX에서도 내역 조립 계층(LinkIndex)에 미연결(참고 카탈로그) | — | — | 사용 안 함 |
| 유료지 4종 | 미결정 — 사급 자재의 80%가 유료지 전용(§3). 구독·재배포 라이선스 = 사업 판단 | — | 월간 | (구독 시) 사급 자재 재료비 |
> [구현] 내역서 산출 흐름과의 연결 (미결 No.17 대상표 기준): 환율및기초자료 표 = ECOS+오피넷 값층 → 중기목록표/중기사용료 = 품셈 기계손료 산식 × 기초값 → 단가산출근거·일위대가 = 품셈(원단위) × 노임·자재 단가 → 재료비·노무비·경비 집계표. 값층 파일에는 **기준일·출처 스탬프 필수**, 내역서에 원천·기준일 명기(§1 관행). 값층 스키마·저장 위치는 개발 단계 협의.
## 5. 실무 임도 내역서 자재 실측 (2026-08-14 — 유료지 필요성 판단 자료)
울진 간선임도(2024, 기번3) 내역 xlsx의 재료비목록표·자재단가대비표 전수 관측. 영월(기번6)도 동일 시트 구조 확인 (STmate 시트 구성 = 미결 No.17 대상표와 일치).
| 관측 항목 | 값 |
|---|---|
| 임도 1개 공사 자재 종수 | **46종** (영월 58종) — 수백 종이 아님 |
| 별도계상(관급)·율 항목 | 16종 — 시멘트·모래·자갈·깬돌·파쇄암·파형강관(일부) 등 "별도계상" = 내역 단가 0 (관급자재대 별도) |
| 조달가격 채택 | 15종 — 유류·목재·못·철근·와이어메쉬·파형강관·이음관·**레미콘(울진 102,970원/㎥ — 조달 경로 실증)** |
| 물가지·업체견적 채택 | 약 15종 — PVC·유로폼·치즐·뇌관·폭약·번호판·지역골재 등 (분류는 대비표 캐시값 한계로 근사 — ⚠) |
- 실무 대비표 가격 슬롯(관측): **조달가격 · 물가정보 · 물가자료 · 적산정보 · 견적단가** (각 단가+게재 페이지) — ESTX 6슬롯과 구성 상이(유통물가·거래가격 대신 적산정보), 유료지 실사용 = **물가정보·물가자료 중심** 관측.
- 원천 증빙 메타(STC 코드) 관측: 월호(`2024.01`류)·업체명(`거양`·`성호철관`)·**나라장터 물품식별번호**(경유 `1510150520282163` 16자리, 레미콘 `23734428`) — 실무도 조달 식별번호로 단가 근거를 남김.
- 특수 소모품(치즐·BUTTON BIT·유압드릴 부품)은 나라장터 가격정보 API(시설공통자재)에 실존하는 품목군과 일치 — API 커버 확인.
> [해석] 유료지 없이 못 채우는 범위 = 공사당 **사급 잡자재 15종 내외**. ESTX의 "사급 80% 유료지 의존"은 전 공종 카탈로그 기준이고 임도 실수요는 훨씬 좁다. 대안 후보: ① 유료지 1종만 구독 ② 실무 관측값 라이브러리(과거 참조)+업체 견적 입력 UI ③ 관급 단가 = 나라장터 쇼핑몰 경로 — 선택은 사업 판단(사용자).
## 근거
| 항목 | 출처 | 위치 |
|---|---|---|
| 원천 공지문 41행 | 2026-07-main.estx EstMainDat | Claude 재검증 덤프 (2026-08-14) |
| 환율·기계경비 계수 | 동 MachGijunDat 19행 | 동 |
| 가격자료 6종 명칭 | 동 ProjectDataInfo.Ini [자재단가] | 동 |
| 산식·조인·슬롯 검증 통계 | [ESTX_데이터관계](../../../original/원가계산/다산소프트/ESTX_데이터관계.md)·[ESTX_검증근거](../../../original/원가계산/다산소프트/ESTX_검증근거.md) | Claude 독립 재검증 일치 |
| 성분 기호 의미 (N/G/J) | [ESTX_값사전_견적내역](../../../original/원가계산/다산소프트/ESTX_값사전_견적내역.md) | 노임·자재·기계 참조 교차검증 |
| 항목 | 출처 | 위치 |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| 원천 공지문 41행 | 2026-07-main.estx EstMainDat | Claude 재검증 덤프 (2026-08-14) |
| 환율·기계경비 계수 | 동 MachGijunDat 19행 | 동 |
| 가격자료 6종 명칭 | 동 ProjectDataInfo.Ini [자재단가] | 동 |
| 산식·조인·슬롯 검증 통계 | [ESTX_데이터관계](../../../original/원가계산/다산소프트/ESTX_데이터관계.md)·[ESTX_검증근거](../../../original/원가계산/다산소프트/ESTX_검증근거.md) | Claude 독립 재검증 일치 |
| 성분 기호 의미 (N/G/J) | [ESTX_값사전_견적내역](../../../original/원가계산/다산소프트/ESTX_값사전_견적내역.md) | 노임·자재·기계 참조 교차검증 |
## 실무 검증 참조