docs(knowledge): 원가계산 원문 수집 실행 — 폴더 재편·원문 3종 확보·수집 경로 확정

- original/원가계산/ 신설, 다산소프트 폴더 이동 (링크 전건 수정) - 원문 확보: 건설업 노임(건협)·제조업 노임(중기중앙회)·건설공사 표준품셈 PDF - 폴더별 _meta.md (출처 URL·갱신주기·수집 방법) - 표준시장단가 수집 제외 (사용자 결정 — 100억 미만 미적용·품셈과 별도 트랙) - 자재단가 = 값형, original 미보관 (_meta 안내만) — 값층 관리 예정 - _pipeline/collect_cost_sources.py 수집 스크립트 배치 - 원가_기초데이터_원천.md §4 Aislo 수집 경로 확정표 추가 (API 3종 검증 결과 반영)
2026-08-14 16:35:05 +09:00
parent 79852854f5
commit a3f5b98032
26 changed files with 249 additions and 12 deletions
@@ -17,3 +17,31 @@
 - 용도: 법령·행정규칙 원문 — `law.go.kr/DRF/lawSearch.do`, `lawService.do`
 - OC 키: `umsangdon` (이메일 ID = OC 값, 별도 만료 없음)
 - 사용법: `?OC=umsangdon&target=law&...`
+
+## 공공데이터포털 (data.go.kr) — 일반 인증키
+
+- 용도: 조달청 나라장터 가격정보현황서비스 등 data.go.kr OpenAPI 전반 (API별 활용신청 필요)
+- 인증키(Encoding형, URL에 그대로 사용): `0j5WZHeNxSkdPVSLXUsx9kVikXEN%2BDc%2Byv68jz8IpKFffjbZkRiQrJO78y6rxPCTqhiSOW4lDxpid0twkSVQ9g%3D%3D`
+- 발급: 2026-08-14, 계정 = data.go.kr 회원(사용자 개인). 만료 시 마이페이지 → 오픈API → 개발계정에서 갱신
+- 검증(2026-08-14): 가격정보현황서비스 실호출 정상 (resultCode 00)
+  - 엔드포인트: `http://apis.data.go.kr/1230000/ao/PriceInfoService/<오퍼레이션>?serviceKey=<키>&pageNo=1&numOfRows=999&type=json`
+  - 오퍼레이션: `getPriceInfoListFcltyCmmnMtril{Engrk|Bildng|MchnEqp|ElctyIrmc|Total}`(시설공통자재 토목/건축/기계설비/전기정보통신/종합), `getPriceInfoListMrktCnstrctPc{...}`(시장시공가격), `getCnsttyClsfcInfoList`, `getNetRsceinfoList`, `getStdMarkUprcinfoList`(표준시장단가 — 호출 방법 미해결, HTTP_ERROR 04)
+  - 데이터 범위 실측: 시설공통자재 4분야 27,485건, 고시일 2024-10~2026-04. ⚠ 철근·레미콘·아스콘·시멘트 미포함 — 주요 관급자재는 종합쇼핑몰 계약단가(조합공통품목) 별도 경로 필요
+
+## 오피넷 (opinet.co.kr) — 유가 무료 API
+
+- 용도: 유류 단가 (중기 기초자료 — 견적 엔진)
+- 무료 Key: `F260814125` (발급 2026-08-14, 사용자 계정)
+- 사용법: `https://www.opinet.co.kr/api/<오퍼레이션>?out=json&code=<키>` (out=xml 가능)
+- 검증(2026-08-14): `avgAllPrice.do`(전국 일별 평균 — 고급휘발유 B034/휘발유 B027/자동차용경유 D047/실내등유 C004/부탄 K015), `avgRecentPrice.do?prodcd=D047`(최근 7일 일별), `avgSidoPrice.do`(시도별) 실호출 정상
+- ⚠ 선박용경유·중유(벙커C)·대리점 판매가는 무료 API 미포함 — 필요 시 웹표 `opinet.co.kr/user/dopavsel/dopAvselSelect.do` 스크래핑 (임도·사방 건설기계 연료는 경유 위주라 실무 영향 낮음. 2026-08-14 사용자 결정: 선박용경유 불요, 필요 시 재요청)
+
+## 한국은행 ECOS (ecos.bok.or.kr) — 환율 API
+
+- 용도: 환율 매매기준율·재정환율 (중기 기초자료 — 기계경비 외화 환산)
+- 인증키: `0QUDJ05SXNFFD1T4XQUZ` (발급 2026-08-14, 사용자 계정. ecos.bok.or.kr/api 마이페이지에서 관리)
+- 사용법: `https://ecos.bok.or.kr/api/StatisticSearch/<키>/json/kr/1/100/731Y001/D/<시작일>/<종료일>/<항목코드>`
+- 통계표 731Y001 "주요국 통화의 대원화환율" (일별) — 항목코드 (2026-08-14 실조회):
+  - `0000001` 원/미국달러(매매기준율) · `0000002` 원/일본엔(100엔) · `0000003` 원/유로 · `0000012` 원/영국파운드 · `0000053` 원/위안(매매기준율)
+  - USD·위안만 공식 매매기준율, 엔·유로·파운드는 재정환율 — ESTX 기계경비 환율 5통화($·¥100·€·£·M) 중 마르크 제외 전부 커버
+- 검증(2026-08-14): USD 일별 5영업일 실호출 정상 (08-14 = 1,414.9원). 값은 서울외국환중개 고시와 동일 원천
@@ -1,4 +1,4 @@
-# 미결 및 확인사항 (Pending Issues & Checks)
+# 미결 및 확인사항 (Pending Issues & Checks)

 > §1 미결사항: 기술문서 작성 중 원문 근거 부족ㆍ용어 불명으로 확정하지 못한 항목. §2 확인사항: 원문 간 충돌 등 사용자 확인이 필요한 목록. **임도ㆍ사방댐 공용 파일** — 항목명 앞 [임도]/[사방]/[공통] 태그로 구분.
 > 처리 원칙: 실무문서 검증 + 산림청 기술교본(사방 등) 추가 확보 + 분석 후 사용자 재요청으로 해소.
@@ -13,7 +13,7 @@

 ### §1-보조 — No.17 원가 기초데이터 원천 참고표 (내역 프로그램 판매처 게시판, 2026-08-13 등록)

-> 출처: 내역서 산출 프로그램 판매처(다산소프트) 게시판 — 상용 내역 프로그램이 기초단가를 어디서 받는지 보여주는 **원천 후보 목록**. ✅ 검증됨(2026-08-14): EST Plus 2 하반기 배포본(`original/다산소프트/2026-07-main.estx`) 내부 공지·데이터와 전 항목 정합 — Claude 독립 재검증 통과. 정리본 = [원가_기초데이터_원천](technical_info/01_임도/05_원가정보/원가_기초데이터_원천.md). 잔여 = Aislo 입수 경로·갱신 절차 조사(사용자 협의 후 착수).
+> 출처: 내역서 산출 프로그램 판매처(다산소프트) 게시판 — 상용 내역 프로그램이 기초단가를 어디서 받는지 보여주는 **원천 후보 목록**. ✅ 검증됨(2026-08-14): EST Plus 2 하반기 배포본(`original/원가계산/다산소프트/2026-07-main.estx`) 내부 공지·데이터와 전 항목 정합 — Claude 독립 재검증 통과. 정리본 = [원가_기초데이터_원천](technical_info/01_임도/05_원가정보/원가_기초데이터_원천.md). 잔여 = Aislo 입수 경로·갱신 절차 조사(사용자 협의 후 착수).

 **중기 기초단가** (2026.7.1, 다산소프트 조사기준): 환율 1,548.4원/$ (매매기준율) · 휘발유 1,825원/L · 경유 1,819원/L · 선박용경유 1,773원/L · 중유 1,140원/L (부가세 별도)

@@ -0,0 +1,138 @@
+# -*- coding: utf-8 -*-
+"""원가 기초단가 원천 수집 스크립트 (미결 No.17 / 수집지침 W8 예정)
+
+수집 대상 → 저장 위치 (original/원가계산/):
+  1. 건설업 노임   : 대한건설협회 건설임금 게시판     → 노임단가_건설업_대한건설협회/
+  2. 제조업 노임   : 중소기업중앙회 조사·통계 게시판   → 노임단가_제조업_중소기업중앙회/
+  3. 건설공사 표준품셈 : 한국표준품셈정보원(kseis) 자료실 → 건설공사_표준품셈/
+
+사용법:
+  python collect_cost_sources.py docs       # 1~3 문서 다운로드 (게시판 최신글 자동 탐색은 미구현 —
+                                            # 반기마다 아래 URL 상수를 최신 게시글로 갱신 후 실행)
+  python collect_cost_sources.py snapshot [출력폴더]
+      # 나라장터 시설공통자재 API 전건 CSV 덤프 (검증·대조용. 키 = knowledge/.secrets.local.md)
+      # 정기 산출물 아님 — 자재단가는 값형이라 프로그램 값층에서 관리 예정 (original 저장 안 함)
+
+주의: 문서 URL(게시글 seq·uuid)은 반기마다 바뀐다. 갱신 절차는 knowledge/01_수집지침.md W8 예정.
+유가·환율·자재단가는 값형(API)이라 original에 저장하지 않는다 — 프로그램 값층에서 관리.
+표준시장단가는 수집 제외 (2026-08-14 사용자 결정 — 100억 미만 공사 미적용·품셈 방식과 별도 트랙).
+"""
+import csv
+import json
+import os
+import re
+import ssl
+import sys
+import urllib.request
+from datetime import date
+from pathlib import Path
+
+BASE = Path(__file__).resolve().parent.parent / "원가계산"
+SECRETS = Path(__file__).resolve().parent.parent.parent / ".secrets.local.md"
+UA = {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)"}
+
+# ── 반기 갱신 대상 URL (2026 상반기/2026년판 기준) ──
+DOC_SOURCES = [
+    # (폴더, 파일명, URL, referer)
+    ("노임단가_건설업_대한건설협회", "2026상반기_건설업_임금실태조사_대한건설협회.pdf",
+     "https://www.cak.or.kr/download.do?uuid=a0e92670-b6b7-4764-a15f-40c34febeaa0.pdf",
+     "https://www.cak.or.kr/lay1/S1T16C41/sublink.do"),
+    ("노임단가_제조업_중소기업중앙회", "2026상반기_중소제조업_직종별_임금조사_중소기업중앙회.pdf",
+     None,  # kbiz는 view 페이지에서 download.do 링크 추출 필요 — VIEW_URL 사용
+     "https://www.kbiz.or.kr/ko/contents/bbs/view.do?mnSeq=325&seq=163372"),
+    ("건설공사_표준품셈", "2026년_건설공사_표준품셈.pdf",
+     "https://www.kseis.co.kr/bbs/data/dataFileDown.do?bbs_seq=64699193400142&file_no=1",
+     "https://www.kseis.co.kr/bbs/data/dataDetail.do?bbs_seq=64699193400142&pgno=1"),
+    ("건설공사_표준품셈", "2026년_건설공사_표준품셈_개정사항.pdf",
+     "https://www.kseis.co.kr/bbs/data/dataFileDown.do?bbs_seq=64699193400142&file_no=2",
+     "https://www.kseis.co.kr/bbs/data/dataDetail.do?bbs_seq=64699193400142&pgno=1"),
+]
+
+G2B_OPS = [
+    ("getPriceInfoListFcltyCmmnMtrilEngrk", "토목"),
+    ("getPriceInfoListFcltyCmmnMtrilBildng", "건축"),
+    ("getPriceInfoListFcltyCmmnMtrilMchnEqp", "기계설비"),
+    ("getPriceInfoListFcltyCmmnMtrilElctyIrmc", "전기정보통신"),
+]
+
+_ctx = ssl.create_default_context()
+_ctx.check_hostname = False
+_ctx.verify_mode = ssl.CERT_NONE  # 일부 기관 인증서 체인 불량 — 무결성은 매직바이트로 검사
+
+
+def fetch(url, referer=None, timeout=120):
+    h = dict(UA)
+    if referer:
+        h["Referer"] = referer
+    req = urllib.request.Request(url, headers=h)
+    with urllib.request.urlopen(req, timeout=timeout, context=_ctx) as r:
+        return r.read()
+
+
+def read_g2b_key():
+    m = re.search(r"인증키\(Encoding형[^`]*`([^`]+)`", SECRETS.read_text(encoding="utf-8"))
+    if not m:
+        sys.exit("공공데이터포털 키를 .secrets.local.md에서 찾지 못함")
+    return m.group(1)
+
+
+def collect_docs():
+    for folder, fname, url, referer in DOC_SOURCES:
+        dest = BASE / folder / fname
+        if url is None:  # kbiz: view 페이지에서 download 링크 추출
+            html = fetch(referer).decode("utf-8", "replace")
+            links = re.findall(r'(/[^"\']*download\.do\?[^"\']+)', html)
+            if not links:
+                print(f"SKIP {fname}: 다운로드 링크 못 찾음")
+                continue
+            url = "https://www.kbiz.or.kr" + links[0].replace("&amp;", "&")
+        data = fetch(url, referer)
+        if not data[:4] == b"%PDF" and not data[:4] == b"PK\x03\x04" and not data[:8].startswith(b"\xd0\xcf\x11\xe0"):
+            print(f"FAIL {fname}: PDF/HWP 아님 ({data[:8].hex()}) — URL 갱신 필요")
+            continue
+        dest.write_bytes(data)
+        print(f"saved {folder}/{fname} ({len(data):,} B)")
+
+
+def collect_snapshot(outdir=None):
+    key = read_g2b_key()
+    today = date.today().isoformat()
+    rows, fieldnames = [], []
+    for op, label in G2B_OPS:
+        page, got, total = 1, 0, 1
+        while got < total:
+            url = (f"http://apis.data.go.kr/1230000/ao/PriceInfoService/{op}"
+                   f"?serviceKey={key}&pageNo={page}&numOfRows=999&type=json")
+            j = json.loads(fetch(url, timeout=60).decode("utf-8", "replace"))
+            body = j.get("response", {}).get("body", {})
+            total = int(body.get("totalCount") or 0)
+            items = body.get("items", [])
+            if isinstance(items, dict):
+                items = items.get("item", [])
+            if not items:
+                break
+            for it in items:
+                it["분야"] = label
+                rows.append(it)
+                for k in it:
+                    if k not in fieldnames:
+                        fieldnames.append(k)
+            got += len(items)
+            page += 1
+        print(f"{label}: {got}/{total}")
+    out = Path(outdir or ".") / f"나라장터_시설공통자재_{today}.csv"
+    with open(out, "w", newline="", encoding="utf-8-sig") as f:
+        w = csv.DictWriter(f, fieldnames=fieldnames)
+        w.writeheader()
+        w.writerows(rows)
+    print(f"saved {out.name} ({len(rows):,} rows)")
+
+
+if __name__ == "__main__":
+    mode = sys.argv[1] if len(sys.argv) > 1 else "docs"
+    if mode == "docs":
+        collect_docs()
+    elif mode == "snapshot":
+        collect_snapshot(sys.argv[2] if len(sys.argv) > 2 else None)
+    else:
+        sys.exit("mode: docs | snapshot [출력폴더]")
@@ -0,0 +1,15 @@
+# 건설공사 표준품셈 (국토교통부 공고 / 한국건설기술연구원 관리)
+
+- 성격: 건설공사 원단위(품) 기준 원문. 산림사업 표준품셈에 없는 일반 토목 공종의 품 근거
+  ※ **산림사업 표준품셈은 기존 위치 유지**: [행정규칙/임도 품셈 적용기준 (현 산림사업 표준품셈)](../../행정규칙/임도 품셈 적용기준 (현 산림사업 표준품셈)/) — 임도·사방 1차 품셈은 그쪽, 본 폴더는 보완용
+- 출처: 공식 게시처 = CODIL(codil.or.kr, SSL 인증서 불량으로 스크립트 수집 시 TLS 예외 필요) / 실사용 = 한국표준품셈정보원 kseis.co.kr 자료실 (무료·비로그인, 조달청 제비율 W7과 동일 사이트)
+- 갱신 주기: **연간** — 매년 12월 말 익년도판 공고
+- 형식: 텍스트형 PDF
+- 수집 방법: `original/_pipeline/collect_cost_sources.py docs` (kseis bbs_seq 연 1회 갱신 필요)
+
+| 파일 | 판 | 공고 | 수집일 |
+|---|---|---|---|
+| 2026년_건설공사_표준품셈.pdf | 2026년 적용 | 국토교통부 공고 (2025-12 계열) | 2026-08-14 |
+| 2026년_건설공사_표준품셈_개정사항.pdf | 2026년 개정분 | 〃 | 2026-08-14 |
+
+- 참고: ESTX 배포본 공지의 2026 개정 공종(돌쌓기·돌붙임·전석쌓기 등 임도 구조물 직결)과 대조 대상
@@ -0,0 +1,13 @@
+# 노임단가(건설업) — 대한건설협회 건설업 임금실태조사
+
+- 성격: 시중노임단가 공표 원문 (통계청 승인 제365004호). 견적 엔진 노무비 단가의 1차 원천 — [원가_기초데이터_원천](../../../technical_info/01_임도/05_원가정보/원가_기초데이터_원천.md)
+- 출처: 대한건설협회 건설적산기준>건설임금 게시판 `https://www.cak.or.kr/lay1/S1T16C41/sublink.do` (무료·비로그인)
+- 갱신 주기: **반기** — 12월 말 공표→1/1 적용, 8월 말 공표→9/1 적용. 2026 하반기판 공표 예정 2026-09-01
+- 형식: 텍스트형 PDF (표 추출 가능, 132개 직종). 게시글에 HWP/HWPX 병행 제공
+- 수집 방법: `original/_pipeline/collect_cost_sources.py docs` (게시글 uuid 반기마다 갱신 필요)
+
+| 파일 | 공표 | 적용 | 수집일 |
+|---|---|---|---|
+| 2026상반기_건설업_임금실태조사_대한건설협회.pdf | 2025-12-31 (article_seq=153402) | 2026-01-01 | 2026-08-14 |
+
+- 검증: ESTX 2026 하반기 배포본 노임(보통인부 172,068원 등)과 본 보고서 값 일치 확인 (2026-08-14)
@@ -0,0 +1,11 @@
+# 노임단가(제조업) — 중소기업중앙회 중소제조업 직종별 임금조사
+
+- 성격: 제조부문 노임단가 공표 원문. 임도·사방 내역에서는 제작·가공 항목에 한정 사용 (주 노임은 건설업 노임)
+- 출처: 중소기업중앙회 정보센터>조사·통계 게시판 `https://www.kbiz.or.kr/ko/contents/bbs/list.do?mnSeq=325` (무료·비로그인)
+- 갱신 주기: **반기** — 6월 말 공표→7/1 적용, 11월 말 공표→1/1 적용
+- 형식: 텍스트형 PDF (129개 직종, 세부 직종표 p.18~)
+- 수집 방법: `original/_pipeline/collect_cost_sources.py docs` (게시글 seq 반기마다 갱신 필요)
+
+| 파일 | 공표 | 적용 | 수집일 |
+|---|---|---|---|
+| 2026상반기_중소제조업_직종별_임금조사_중소기업중앙회.pdf | 2026-06-30 (seq=163372) | 2026-07-01 | 2026-08-14 |
@@ -1,4 +1,4 @@
-# `2026-07-main.estx` 정밀 분석 계획서
+# `2026-07-main.estx` 정밀 분석 계획서

 ## 1. 목적

@@ -22,7 +22,7 @@

 ## 3. 원본 보존 규칙

- 분석 대상: `resources/knowledge/original/다산소프트/2026-07-main.estx`
+- 분석 대상: `resources/knowledge/original/원가계산/다산소프트/2026-07-main.estx`
 - 원본은 읽기 전용으로 취급하며 수정·재저장·재패키징하지 않는다.
 - 분석 시작과 종료 시 SHA-256을 각각 계산하여 동일성을 확인한다.
 - 압축 해제나 변환이 필요하면 임시 작업공간만 사용하고 원본 폴더에는 중간 바이너리를 남기지 않는다.
@@ -0,0 +1,15 @@
+# 자재단가 — 원문 없음 (값형 원천 안내)
+
+이 폴더에는 보관 원문이 없다. 자재단가는 **분석이 필요 없는 값형 데이터**라 원문 보존 대상이 아니며,
+특정 시점 값을 프로그램 값층(별도 파일/DB)에서 주기 관리한다 (2026-08-14 사용자 결정).
+
+## 원천 (검증 완료 2026-08-14)
+
+| 원천 | 경로 | 갱신 | 상태 |
+|---|---|---|---|
+| 나라장터 가격정보현황서비스 API | `apis.data.go.kr/1230000/ao/PriceInfoService` (키 = knowledge/.secrets.local.md) | 연 2회+수시 | ✅ 검증 — 시설공통자재 4분야 27,485건 (2026-04까지) |
+| 종합쇼핑몰 계약단가 (철근·레미콘·아스콘 등 주요 관급) | 미조사 — 별도 API/경로 필요 | — | ⚠ 후속 조사 대상 |
+| 유료 물가지 4종 (사급 자재 80% 커버) | 물가자료·물가정보·유통물가·거래가격 — 유료 구독 | 월간 | 미결정 (사업 판단) |
+
+- 전건 CSV 덤프(검증·대조용): `python original/_pipeline/collect_cost_sources.py snapshot <출력폴더>` — 정기 산출물 아님
+- 사용 방식·내역서 반영: [원가_기초데이터_원천](../../../technical_info/01_임도/05_원가정보/원가_기초데이터_원천.md)
@@ -1,13 +1,13 @@
---
+---
 title: 원가 기초데이터 원천 (상용 내역 프로그램 배포자료 관측)
 category: 05_원가정보
 sources:
  - doc: 다산소프트 EST Plus 2 주자료 배포본 (2026년 하반기판)
    version: 2026-07 (상반기값은 비교 스냅샷 필드로 병존)
-    loc: original/다산소프트/2026-07-main.estx (SHA-256 CE37A421…73A0)
+    loc: original/원가계산/다산소프트/2026-07-main.estx (SHA-256 CE37A421…73A0)
  - doc: ESTX 정밀분석 문서 11건 (타 AI 작성 → Claude 독립 재검증 2026-08-14)
    version: 2026-08-13
-    loc: original/다산소프트/ESTX_*.md
+    loc: original/원가계산/다산소프트/ESTX_*.md
 status: draft
 last_updated: 2026-08-14
 ---
@@ -17,7 +17,7 @@ last_updated: 2026-08-14
 ## 0. 자료 성격과 검증 상태

 - 원본 = 상용 내역 프로그램 **EST Plus 2**(다산소프트)가 구매 고객에게 반기 배포하는 **주자료(자재·노임·기계경비·일위대가·단가산출·표준시장단가 카탈로그)**. 특정 공사의 완성 견적서 아님 (견적 테이블 30건 전부 빈 자리표시 확인).
- 타 AI 분석 11건([ESTX_분석](../../../original/다산소프트/ESTX_분석.md) 등)을 Claude가 원본 파일 대상 **독립 재검증(2026-08-14)**: SHA-256 일치 · ZIP 67항목 CRC 무오류 · 고정테이블 20/20 구조 일치 · 제목-상세 조인 3계열(1,569/1,468/1,049) 불일치 0 · 금액식 약 9.1만 건 전건 통과 · 자재 가격슬롯 23,962/23,987 일치 · 가격자료 6종 명칭 INI 일치. **분석 문서 신뢰 가능** (검사건수 집계 방식 차이 1건 외 반례 없음).
+- 타 AI 분석 11건([ESTX_분석](../../../original/원가계산/다산소프트/ESTX_분석.md) 등)을 Claude가 원본 파일 대상 **독립 재검증(2026-08-14)**: SHA-256 일치 · ZIP 67항목 CRC 무오류 · 고정테이블 20/20 구조 일치 · 제목-상세 조인 3계열(1,569/1,468/1,049) 불일치 0 · 금액식 약 9.1만 건 전건 통과 · 자재 가격슬롯 23,962/23,987 일치 · 가격자료 6종 명칭 INI 일치. **분석 문서 신뢰 가능** (검사건수 집계 방식 차이 1건 외 반례 없음).
 - ⚠ 이 문서의 원천·수치는 **상용사 배포자료의 관측값**이다. 법령·행정규칙이 아니며, Aislo 원천 확정은 미결 No.17 조사(사용자 협의)로 넘긴다 — 본 문서는 그 조사의 대조 기준선.

 ## 1. 정보 확보처 (원천·기준일·갱신주기) — ESTX 내부 공지문 관측
@@ -99,7 +99,24 @@ last_updated: 2026-08-14
 - 반기 배포마다 전 카탈로그를 재계산하고 **직전 반기값을 `_` 필드(변경전/후 비교 스냅샷)로 보존** — 단가 변동 대비표 출력 기능.
 - 노임 관측 예: 2026 상반기 보통인부 172,068원·작업반장 215,907원 (무할증 시중노임 그대로 — 실무 내역 관측과 동일 방식, [품셈_적용기준 §2](../04_수량분석정보/품셈_적용기준.md)).

-> [구현] Aislo 견적 엔진에 주는 시사점: ① 기초단가는 "자재·노임·기계 3계열 카탈로그 + 반기/월간 버전 스탬프" 구조가 실무 표준. ② 일위대가·단가산출은 원천이 아니라 **품셈 × 기초단가 파생물** — 미결 No.17의 원천 추정과 일치. ③ 내역서에 원천·기준일 명기(공지 시트) 관행 채택 검토. ④ 상세 필드 구조·값 분포는 [ESTX_값사전_견적내역](../../../original/다산소프트/ESTX_값사전_견적내역.md)·[자재노무기계](../../../original/다산소프트/ESTX_값사전_자재노무기계.md) 참조.
+> [구현] Aislo 견적 엔진에 주는 시사점: ① 기초단가는 "자재·노임·기계 3계열 카탈로그 + 반기/월간 버전 스탬프" 구조가 실무 표준. ② 일위대가·단가산출은 원천이 아니라 **품셈 × 기초단가 파생물** — 미결 No.17의 원천 추정과 일치. ③ 내역서에 원천·기준일 명기(공지 시트) 관행 채택 검토. ④ 상세 필드 구조·값 분포는 [ESTX_값사전_견적내역](../../../original/원가계산/다산소프트/ESTX_값사전_견적내역.md)·[자재노무기계](../../../original/원가계산/다산소프트/ESTX_값사전_자재노무기계.md) 참조.
+
+## 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).
+
+| 데이터군 | 확정 경로 | 형식/층 | 갱신 | 내역서 사용처 |
+|---|---|---|---|---|
+| 노임(건설업) | 대한건설협회 게시판 (무료·비로그인, 텍스트 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 관행). 값층 스키마·저장 위치는 개발 단계 협의.

 ## 근거

@@ -108,8 +125,8 @@ last_updated: 2026-08-14
 | 원천 공지문 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) | 노임·자재·기계 참조 교차검증 |
+| 산식·조인·슬롯 검증 통계 | [ESTX_데이터관계](../../../original/원가계산/다산소프트/ESTX_데이터관계.md)·[ESTX_검증근거](../../../original/원가계산/다산소프트/ESTX_검증근거.md) | Claude 독립 재검증 일치 |
+| 성분 기호 의미 (N/G/J) | [ESTX_값사전_견적내역](../../../original/원가계산/다산소프트/ESTX_값사전_견적내역.md) | 노임·자재·기계 참조 교차검증 |

 ## 실무 검증 참조

@@ -105,7 +105,7 @@
 | 01_임도/05_원가정보/원가계산_체계.md | 원가 구성 트리, 비목별 밑수 정의표(견적 엔진 핵심), 적용 조건 | 교본 15-5, 별표2 | draft |
 | 01_임도/05_원가정보/제비율.md | 현행 요율(산재 3.56%, 안전관리비 토목 3.15% 등) + 2019 대조 + 미수집 목록 | 각 고시 현행, 교본 15-5 | draft |
 | 01_임도/05_원가정보/설계·감리대가.md | 설계비(예산편성기준·미수집), 엔지니어링 대가 2방식, 감리비 | 엔지니어링대가 기준, 교본 | draft |
-| 01_임도/05_원가정보/원가_기초데이터_원천.md | 기초단가 원천·갱신주기 표(노임·자재·중기·품셈·표준시장단가), 내역 조립 계층, 검증 산식 — 미결 No.17 대조 기준선 | 다산소프트 ESTX 2026-07 배포본 (검증 완료) | draft |
+| 01_임도/05_원가정보/원가_기초데이터_원천.md | 기초단가 원천·갱신주기 표, 내역 조립 계층, 검증 산식, §4 Aislo 수집 경로 확정(API 3종 검증·문서 3종 확보·표준시장단가 제외) — 미결 No.17 대조 기준선 | 다산소프트 ESTX 2026-07 배포본 + 원천 실사 (2026-08-14) | draft |

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