diff --git a/resources/knowledge/.secrets.local.md b/resources/knowledge/.secrets.local.md index 2e62224c..efe92687 100644 --- a/resources/knowledge/.secrets.local.md +++ b/resources/knowledge/.secrets.local.md @@ -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원). 값은 서울외국환중개 고시와 동일 원천 diff --git a/resources/knowledge/03_미결_및_확인사항.md b/resources/knowledge/03_미결_및_확인사항.md index d5ff6cfe..ed8020aa 100644 --- a/resources/knowledge/03_미결_및_확인사항.md +++ b/resources/knowledge/03_미결_및_확인사항.md @@ -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 (부가세 별도) diff --git a/resources/knowledge/original/_pipeline/collect_cost_sources.py b/resources/knowledge/original/_pipeline/collect_cost_sources.py new file mode 100644 index 00000000..afac399a --- /dev/null +++ b/resources/knowledge/original/_pipeline/collect_cost_sources.py @@ -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("&", "&") + 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 [출력폴더]") diff --git a/resources/knowledge/original/원가계산/건설공사_표준품셈/2026년_건설공사_표준품셈.pdf b/resources/knowledge/original/원가계산/건설공사_표준품셈/2026년_건설공사_표준품셈.pdf new file mode 100644 index 00000000..ab181a38 Binary files /dev/null and b/resources/knowledge/original/원가계산/건설공사_표준품셈/2026년_건설공사_표준품셈.pdf differ diff --git a/resources/knowledge/original/원가계산/건설공사_표준품셈/2026년_건설공사_표준품셈_개정사항.pdf b/resources/knowledge/original/원가계산/건설공사_표준품셈/2026년_건설공사_표준품셈_개정사항.pdf new file mode 100644 index 00000000..07429541 Binary files /dev/null and b/resources/knowledge/original/원가계산/건설공사_표준품셈/2026년_건설공사_표준품셈_개정사항.pdf differ diff --git a/resources/knowledge/original/원가계산/건설공사_표준품셈/_meta.md b/resources/knowledge/original/원가계산/건설공사_표준품셈/_meta.md new file mode 100644 index 00000000..d0ddfbb5 --- /dev/null +++ b/resources/knowledge/original/원가계산/건설공사_표준품셈/_meta.md @@ -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 개정 공종(돌쌓기·돌붙임·전석쌓기 등 임도 구조물 직결)과 대조 대상 diff --git a/resources/knowledge/original/원가계산/노임단가_건설업_대한건설협회/2026상반기_건설업_임금실태조사_대한건설협회.pdf b/resources/knowledge/original/원가계산/노임단가_건설업_대한건설협회/2026상반기_건설업_임금실태조사_대한건설협회.pdf new file mode 100644 index 00000000..59613ed6 Binary files /dev/null and b/resources/knowledge/original/원가계산/노임단가_건설업_대한건설협회/2026상반기_건설업_임금실태조사_대한건설협회.pdf differ diff --git a/resources/knowledge/original/원가계산/노임단가_건설업_대한건설협회/_meta.md b/resources/knowledge/original/원가계산/노임단가_건설업_대한건설협회/_meta.md new file mode 100644 index 00000000..4e6a73e7 --- /dev/null +++ b/resources/knowledge/original/원가계산/노임단가_건설업_대한건설협회/_meta.md @@ -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) diff --git a/resources/knowledge/original/원가계산/노임단가_제조업_중소기업중앙회/2026상반기_중소제조업_직종별_임금조사_중소기업중앙회.pdf b/resources/knowledge/original/원가계산/노임단가_제조업_중소기업중앙회/2026상반기_중소제조업_직종별_임금조사_중소기업중앙회.pdf new file mode 100644 index 00000000..d6bb1a98 Binary files /dev/null and b/resources/knowledge/original/원가계산/노임단가_제조업_중소기업중앙회/2026상반기_중소제조업_직종별_임금조사_중소기업중앙회.pdf differ diff --git a/resources/knowledge/original/원가계산/노임단가_제조업_중소기업중앙회/_meta.md b/resources/knowledge/original/원가계산/노임단가_제조업_중소기업중앙회/_meta.md new file mode 100644 index 00000000..a8f2f094 --- /dev/null +++ b/resources/knowledge/original/원가계산/노임단가_제조업_중소기업중앙회/_meta.md @@ -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 | diff --git a/resources/knowledge/original/다산소프트/2026-07-main.estx b/resources/knowledge/original/원가계산/다산소프트/2026-07-main.estx similarity index 100% rename from resources/knowledge/original/다산소프트/2026-07-main.estx rename to resources/knowledge/original/원가계산/다산소프트/2026-07-main.estx diff --git a/resources/knowledge/original/다산소프트/ESTX_값사전.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_값사전.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_값사전.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_값사전.md diff --git a/resources/knowledge/original/다산소프트/ESTX_값사전_견적내역.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_견적내역.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_값사전_견적내역.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_견적내역.md diff --git a/resources/knowledge/original/다산소프트/ESTX_값사전_물량도면.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_물량도면.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_값사전_물량도면.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_물량도면.md diff --git a/resources/knowledge/original/다산소프트/ESTX_값사전_옵션메타데이터.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_옵션메타데이터.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_값사전_옵션메타데이터.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_옵션메타데이터.md diff --git a/resources/knowledge/original/다산소프트/ESTX_값사전_인쇄옵션.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_인쇄옵션.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_값사전_인쇄옵션.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_인쇄옵션.md diff --git a/resources/knowledge/original/다산소프트/ESTX_값사전_자재노무기계.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_자재노무기계.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_값사전_자재노무기계.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_값사전_자재노무기계.md diff --git a/resources/knowledge/original/다산소프트/ESTX_검증근거.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_검증근거.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_검증근거.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_검증근거.md diff --git a/resources/knowledge/original/다산소프트/ESTX_데이터관계.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_데이터관계.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_데이터관계.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_데이터관계.md diff --git a/resources/knowledge/original/다산소프트/ESTX_분석.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_분석.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_분석.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_분석.md diff --git a/resources/knowledge/original/다산소프트/ESTX_테이블사전.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_테이블사전.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_테이블사전.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_테이블사전.md diff --git a/resources/knowledge/original/다산소프트/ESTX_파일구조.md b/resources/knowledge/original/원가계산/다산소프트/ESTX_파일구조.md similarity index 100% rename from resources/knowledge/original/다산소프트/ESTX_파일구조.md rename to resources/knowledge/original/원가계산/다산소프트/ESTX_파일구조.md diff --git a/resources/knowledge/original/다산소프트/PLAN_2026-07-main_ESTX_정밀분석.md b/resources/knowledge/original/원가계산/다산소프트/PLAN_2026-07-main_ESTX_정밀분석.md similarity index 98% rename from resources/knowledge/original/다산소프트/PLAN_2026-07-main_ESTX_정밀분석.md rename to resources/knowledge/original/원가계산/다산소프트/PLAN_2026-07-main_ESTX_정밀분석.md index 3d11f8e2..f0de8462 100644 --- a/resources/knowledge/original/다산소프트/PLAN_2026-07-main_ESTX_정밀분석.md +++ b/resources/knowledge/original/원가계산/다산소프트/PLAN_2026-07-main_ESTX_정밀분석.md @@ -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을 각각 계산하여 동일성을 확인한다. - 압축 해제나 변환이 필요하면 임시 작업공간만 사용하고 원본 폴더에는 중간 바이너리를 남기지 않는다. diff --git a/resources/knowledge/original/원가계산/자재단가/_meta.md b/resources/knowledge/original/원가계산/자재단가/_meta.md new file mode 100644 index 00000000..c5c9fdcd --- /dev/null +++ b/resources/knowledge/original/원가계산/자재단가/_meta.md @@ -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) diff --git a/resources/knowledge/technical_info/01_임도/05_원가정보/원가_기초데이터_원천.md b/resources/knowledge/technical_info/01_임도/05_원가정보/원가_기초데이터_원천.md index 80d48ce2..4b2571e8 100644 --- a/resources/knowledge/technical_info/01_임도/05_원가정보/원가_기초데이터_원천.md +++ b/resources/knowledge/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) | 노임·자재·기계 참조 교차검증 | ## 실무 검증 참조 diff --git a/resources/knowledge/technical_info/_index.md b/resources/knowledge/technical_info/_index.md index d797edff..66bdb306 100644 --- a/resources/knowledge/technical_info/_index.md +++ b/resources/knowledge/technical_info/_index.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_사방댐 — 사방댐 설계자동화 기술문서