docs(knowledge): 품셈 원문 MD ↔ 마스터 데이터 전수 대조 정밀 검증보고서 및 데이터 작성

resources/knowledge/technical_info/01_임도/05_원가정보/품셈_원문md_마스터데이터_대조_검증보고서.md

@@ -0,0 +1,159 @@
+# 품셈 원문 MD ↔ 마스터 데이터 대조 정밀 검증보고서
+
+## 1. 개요 및 감사 목적
+
+- **감사 대상**: 산림사업 표준품셈 원문 마크다운(`(산림청고시 제2025-82호) 산림사업 표준품셈.md`, 총 9,167행)과 시스템 마스터 데이터(`work_item_master_2026-01-01.json`, `pum_forest_2026.json`, `coef_2026.json` 등 기초값 15종) 전수 대조.
+- **감사 사슬**: PDF 원문 $\rightarrow$ 원문 MD (코덱스 담당) $\rightarrow$ **[원문 MD ↔ 마스터 데이터 대조 (본 일감)]**.
+- **원칙**:
+  - 원문 MD를 Ground Truth(정본 기준)로 간주하고 마스터 데이터를 대조함.
+  - 마스터 데이터나 소스코드를 임의 수정하지 않고, 불일치 명세와 원인을 정밀 기록·보고함 (수정은 개발 담당 창 몫).
+  - B08/B09 계산 로직이 아닌, 순수 원천 데이터(테이블, 셀, 밑수, 주석, 갈래)의 일치 여부를 검증함.
+
+---
+
+## 2. 감사 총괄 요약표
+
+| 검증 항목 | 점검 대상 | 일치/정상 | 불일치/결측 | 주요 영향 및 평가 |
+| :--- | :--- | :---: | :---: | :--- |
+| **① 표·절·갈래 누락** | 전체 476개 표 및 14개 장 | 453개 | **23개** (누락 1, 고아 22) | F0001(경과조치 1개 누락), F0455~F0476(부록 설계예시 22개 orphan) |
+| **② 값이 다른 칸** | 476개 표 전체 셀 수치 | **100% 일치** | **0건** | 표 내부의 모든 셀 숫자·글자는 raw 단위에서 100% 일치 |
+| **③ 밑수·단위 왜곡·결측** | 표 윗줄·표머리 밑수 규격 | 416개 | **60건** (결측 50, 왜곡 10) | 1.0 km ↔ 인/ha 왜곡, 100본 누락, 50개 표 밑수 null로 단가산출 불가 |
+| **④ [주] 계수·조건 누락** | 표 아래 단가 직결 주석 | 467개 | **9건** (핵심 주석 누락) | 덤프환산, 발파가산(20%), 고철공제, 유로폼 감속(9%), 손료(3%) 누락 |
+| **⑤ reference 오분류 (갈래)** | 단가 계산 대상 표 성격 | 449개 | **27건** (핵심공종 오분류) | 거푸집·PVC·채움재·고임돌·콘크리트 등 실값 표가 reference로 빠짐 |
+
+---
+
+## 3. 5대 항목별 상세 감사 결과
+
+### 항목 ① md에 있는데 마스터에 없는 것 (표·절·갈래 누락)
+
+- **원문 MD 테이블 총수**: 476개 (`F0001` ~ `F0476`)
+- **마스터 공종 축 연결 (`work_items[].tables`)**: **453개 표**
+- **마스터 고아 테이블 (`orphan_tables`)**: **22개 표** (`F0455` ~ `F0476`)
+  - **원인 분석**: 원문 MD Line 8031~9106에 위치한 "부록: 설계서 작성 예시" 표들임 (풀베기 예시, 덩굴제거 예시, 어린나무가꾸기 예시, 기계화작업 예시, 재선충병 방제 예시). 공종 축 본문(제1장~14장)의 산출 공종이 아니므로 `orphan_tables`로 분리된 상태는 데이터 구조상 정상적인 처리임.
+- **마스터 완전 누락 테이블**: **1개 표** (`F0001`)
+  - **원인 분석**: 원문 MD Line 31의 고시 본칙 `제2조(적용에 관한 경과조치)` 부칙 표로, 공사 공종이 아닌 행정 규칙 경과조치 표이므로 공종 축 마스터에서 정상 제외됨.
+- **절(Section) 매핑**: 제1장부터 제14장까지의 본문 절은 100% 공종 마디(477개 `work_items`)로 구조화되어 누락된 절은 없음.
+
+---
+
+### 항목 ② 값이 다른 칸 (옮겨지며 달라진 숫자)
+
+- **표 내부 셀(Raw Cells) 전수 대조 결과**: **불일치 0건 (100% 일치)**
+  - 원문 MD의 476개 표 내 모든 행·열 셀 값과 `pum_forest_2026.json`의 `rows` 데이터는 소수점 및 공백 정규화 시 100% 일치함을 확인.
+- **기초값 15종 대조 결과**:
+  - **토량환산계수 L, C (`F0004` vs `coef_2026.json`)**:
+    - 경암(1.70~2.00 / 1.30~1.50), 보통암(1.55~1.70 / 1.20~1.40), 보통토사(1.20 / 0.90) 등 원문의 17개 토질별 min, max 및 대표값이 `coef_2026.json`의 `coef_soil_L`, `coef_soil_C`에 100% 정확하게 일치 반영됨.
+  - **자재할증률 (`F0008`~`F0013` vs `coef_2026.json`)**:
+    - 원목(정치식 10%, 기타 5%), 각재(5%), 판재(10%), 붉은벽돌(3%), 합판(3~10%) 등 원문 수치와 100% 일치.
+  - **노임할증률 (`F0015`~`F0041` vs `coef_2026.json`)**:
+    - 26개 할증 기준(작업시기, 경사도, 이동거리, 작업시간 제한 등)의 퍼센트 수치 일치 확인.
+
+---
+
+### 항목 ③ 밑수·단위 왜곡 및 결측 (MD vs 마스터)
+
+총 **60개 표**에서 밑수·단위 왜곡 또는 결측이 발견됨. 특히 단위가 엉뚱한 차원(면적 $\leftrightarrow$ 거리)으로 들어가거나 밑수가 null로 비어 있어 단가 산출이 원천 차단되는 심각한 오류가 존재함.
+
+#### 1. 치명적 단위 왜곡 사례 (금액 왜곡 직결)
+| 표 번호 | 원문 MD 절 및 공종 | 원문 MD 밑수·단위 | 마스터 저장 단위 | 왜곡 내용 및 위험도 |
+| :---: | :--- | :--- | :--- | :--- |
+| **F0076** | 제3장 3-2. 작업로 선정 | `(단위 : 인/ha)` | **1.0 km** | **[치명]** 면적 단위(`ha`)를 선형 거리(`km`)로 왜곡 저장! 견적 물량 산출 시 10,000배 단위 불일치 위험 |
+| **F0223** | 제8장 8-4. 끈끈이 롤 트랩 | `(단위: 100본/ha당)` | **1.0 ha** | **[치명]** `100본` 수량이 탈락하고 단순 `ha`로 기록되어 100배 계산 오류 유발 |
+| **F0408** | 제13장 13-4-3. 고임돌 소요량 | `(단위: ㎥/㎡당)` | **1.0 ㎡** | 체적/면적 복합단위(`㎥/㎡`)가 단순 면적(`㎡`)으로 축소 기록 |
+| **F0410** | 제13장 13-4-4. 찰쌓기 뒷채움 콘크리트 | `(단위: ㎥/㎡당)` | **1.0 ㎡** | 뒷채움 콘크리트 타설량(`㎥/㎡`)이 면적으로 오인되어 레미콘 체적 누락 위험 |
+
+#### 2. 주요 핵심 공종 밑수 완전 결측 사례 (`basis_quantity: null`, `basis_unit: null`)
+| 표 번호 | 공종명 (절) | 원문 MD 명시 밑수 | 마스터 상태 | 비고 |
+| :---: | :--- | :--- | :--- | :--- |
+| **F0077** | 제3장 3-3. 작업로 설치 | `인/1일 1km당` | `null` | 선형 거리 밑수 누락 |
+| **F0082** | 제3장 3-8. 드론 영상 촬영 | `인/ha` | `null` | ha 밑수 누락 |
+| **F0085** | 제4장 나무베기 (벌채) | `㎥/1인/1일` | `null` | 일일 벌채능력 밑수 누락 |
+| **F0240** | 제9장 9-3-2. 터파기(기계) | `㎥당` | `null` | 토공량 밑수 누락 |
+| **F0251** | 제9장 9-8-1. 철근절단 | `㎥당` | `null` | 구조물 체적 밑수 누락 |
+| **F0256** | 제9장 9-11-1. 포장절단 | `일당` | `null` | 장비 일당 밑수 누락 |
+| **F0280** | 제9장 9-14-2. 다짐(콤펙터) | `㎥당` | `null` | 다짐 체적 밑수 누락 |
+| **F0338** | 제12장 12-6. 콘크리트 포장 | `일당` | `null` | 포장 작업조 일당 누락 |
+| **F0366** | 제12장 12-19. 강관비계 | `공㎥당` | `null` | 비계 체적 밑수 누락 |
+| **F0379** | 제12장 12-29. 스페이셔 설치 | `개소당` | `null` | 개소 밑수 누락 |
+| **F0424** | 제13장 13-8. 막돌쌓기 | `인/㎡` | `null` | 석축 면적 밑수 누락 |
+| **F0430** | 제13장 13-10-2. 말뚝박기(인력) | `1일당` | `null` | 인력 작업 일당 누락 |
+| **F0444** | 제13장 13-14. 식생토낭 | `인/개` | `null` | 토낭 개수 밑수 누락 |
+| **F0447** | 제13장 13-15-2. 목책 설치 | `인/조` | `null` | 목책 조 밑수 누락 |
+
+---
+
+### 항목 ④ [주]의 계수·조건 누락 (표 아래 붙은 주석 계수)
+
+원문 MD의 각 표 아래에는 할증, 손료, 공제, 부자재 소요량을 규정한 `[주]` 주석이 필수적으로 붙어 있음. 이 중 금액 계산에 직결되는데도 마스터의 `condition_note` 또는 산식에 누락된 핵심 9개 표:
+
+1. **F0068 (도폭선 암발파)**:
+   - 원문 [주]: 덤프환산 계수(제1장 1-2-7 7호 적용) 및 대형브레이커 조합 규정.
+   - 마스터: `condition_note` 미반영 $\rightarrow$ 덤프 운반량 환산 계수 누락.
+2. **F0146 (비탈덮기 거적)**:
+   - 원문 [주]: 볏짚거적 및 차광망 손율 적용 기준.
+   - 마스터: 손율 데이터 누락 $\rightarrow$ 자재 손료 미반영.
+3. **F0242 (토공 집토)**:
+   - 원문 [주]: 0.7㎥ 굴착기 기준 시간당 작업량 공식 $Q = \frac{3600 \times q \times k \times f \times E}{C_m}$ 및 암질별 계수.
+   - 마스터: 산식 파라미터 미연결.
+4. **F0245 (발파 집토)**:
+   - 원문 [주]: **"발파구간의 평균 횡단경사 80% 이상으로 굴진을 위한 발파 시 인건비의 20%를 가산한다."**
+   - 마스터: 인건비 20% 가산 조항 누락 $\rightarrow$ 급경사지 노무비 축소 발생.
+5. **F0251 (구조물 헐기 철근절단)**:
+   - 원문 [주]: **"고철공제 : $A = 1㎥ \times 0.008 \times 7,850kg/㎥ \times 80\% = 50.24kg/㎥ \fallingdotseq 50kg/㎥$"**
+   - 마스터: 고철 50kg/㎥ 공제 조항 누락 $\rightarrow$ 공제액 미반영으로 견적 과다 위험.
+6. **F0284 (노체다짐)**:
+   - 원문 [주]: 자주식 진동롤러(10ton)와 굴착기(0.7㎥) 조합 규정 및 $Q$ 공식.
+   - 마스터: 장비 조합 조건 누락.
+7. **F0285 (살수)**:
+   - 원문 [주]: 물탱크 5,500L 기준, 최적함수비(13%), 자연함수비(8%), 운반시간 $T_2$ 산출식.
+   - 마스터: 물탱크 규격 및 살수량 계산 조건 누락.
+8. **F0394 (유로폼 부자재)**:
+   - 원문 [주]: **"플랫 타이(Flat Tie) 대신 폼 타이(Form Tie) 사용 시 소요 수량은 12-4 합판 거푸집 자재수량을 따른다."**
+   - 마스터: 대체 자재 산출 기준 누락.
+9. **F0395 (유로폼 설치 및 해체)**:
+   - 원문 [주]: **"공구손료 및 경장비 기계경비는 인력품의 3%로 계상한다.", "수직고가 7m를 초과하는 경우 매 3m마다 시공량을 9%까지 감한다."**
+   - 마스터: 공구손료 3% 및 고소작업 감속율(9%) 미반영 $\rightarrow$ 노무비/경비 왜곡.
+
+---
+
+### 항목 ⑤ 갈래(variants) 및 `pum_form: reference` 오분류
+
+마스터 데이터에서 `pum_form`이 `reference`(단순 참고)로 지정되면 자동 견적 엔진이 해당 표를 자원 집계 대상에서 제외함. 그러나 조사 결과, **철근콘크리트(제12장)와 구조물(제13장)의 실제 공사비 산출 핵심 자재·인력 표 27개가 `reference`로 오분류**되어 있어 자원 축에서 탈락하고 있음!
+
+#### 금액 직결 핵심 오분류 표 명세 (27개 중 대표 15개)
+| 표 번호 | 원문 절 및 공종명 | 단위 | 원문 표 내용 (실제 비용 성격) | 마스터 현 분류 | 정상 분류 및 조치 요구 |
+| :---: | :--- | :---: | :--- | :---: | :---: |
+| **F0369** | 12-22. P.V.C 파이프 설치(50mm) | 개소당 | 아스팔트 4kg, 방수공 0.034인, 보통인부 0.04인 | `reference` | **`requirement`** (배수관 필수자재) |
+| **F0380** | 12-30-1. 다웰바 신축이음부 | 개소당 | D32 다웰바 필요수량, 설치비 재료비의 5% | `reference` | **`requirement`** (도로줄눈 필수공종) |
+| **F0381** | 12-30-2. 다웰바 접속스라브부 | 개소당 | D29 다웰바, PVC파이프, 특별인부 0.1인 | `reference` | **`requirement`** (도로줄눈 필수공종) |
+| **F0382** | 12-31. 물끊기 홈(NOTCH) 설치 | 개소당 | 특별인부 0.1인, 보통인부 0.001인 | `reference` | **`requirement`** (옹벽 상단 필수) |
+| **F0383** | 12-32. 전선관 설치(P.V.C ø54) | 개소당 | 주재료비 및 설치비(주재료비의 5%) | `reference` | **`requirement`** (전기/통신 배관) |
+| **F0386** | 12-34-2. 합판거푸집(3회 0~7m) | ㎡당 | 보통인부 0.29인, 콘크리트 진동기 2대 | `reference` | **`requirement`** (콘크리트 타설 필수) |
+| **F0388** | 12-34-4. 채움재(T=20mm) | ㎡당 | 채움재 자재비, 고철대 감(3%) | `reference` | **`requirement`** (신축이음 채움재) |
+| **F0390** | 12-36. P.C BOX 설치 | 식 | 미장공 0.14인, 보통인부 0.05인 | `reference` | **`requirement`** (암거 설치 필수) |
+| **F0391** | 12-37. 콘크리트 타설(무근) | ㎥당 | 레미콘 자재비, 콘크리트공 0.15인, 인부 0.27인 | `reference` | **`requirement`** (타설 필수 노무) |
+| **F0393** | 12-38-2. 유로폼 사용수량 | 10㎡당 | 웨지핀, 플랫타이, 박리제(주재료비 24~79%) | `reference` | **`requirement`** (유로폼 부자재) |
+| **F0400** | 13-2-3. 야면석 채집(운반) | 100개당 | 화물자동차 운반 품 (소형트럭 등) | `reference` | **`requirement`** (석재 운반비) |
+| **F0406** | 13-3. 돌붙이기 뒷채움자갈 | ㎡당 | 조약돌/자갈 소요량(0.15~0.30㎥/㎡) | `reference` | **`requirement`** (석축 뒷채움 필수) |
+| **F0408** | 13-4-3. 고임돌 소요량 | ㎥/㎡ | 석축 높이별 고임돌 소요 체적 기준표 | `reference` | **`requirement`** (석축 자재량 산출) |
+| **F0410** | 13-4-4. 찰쌓기 뒷채움 콘크리트 | ㎥/㎡ | 높이별 레미콘 소요량(0.20~0.55㎥/㎡) | `reference` | **`requirement`** (찰쌓기 핵심 레미콘비) |
+| **F0446** | 13-15-2. 목책 설치(목재) | m당 | 통나무 원목 및 부자재 소요량 | `reference` | **`requirement`** (목책 필수자재) |
+
+---
+
+## 4. 종합 평가 및 후속 개선 권고사항
+
+1. **원문 데이터(표 셀 수치)는 100% 무결점 보존됨**:
+   - 파서가 추출한 476개 표의 내부 셀 값과 기초값 15종의 기본 수치는 원문 MD와 완벽히 일치함.
+2. **가장 시급한 조치 사항 (금액 직결 3대 과제)**:
+   - **과제 1 (단위 왜곡 교정)**: `F0076`(작업로 선정)의 단위 `1.0 km` $\rightarrow$ `1.0 ha` 즉시 교정 (면적-거리 불일치 해소).
+   - **과제 2 (`reference` $\rightarrow$ `requirement` 전환)**: F0369(PVC), F0380/F0381(다웰바), F0391(타설 노무), F0410(뒷채움 레미콘) 등 27개 핵심 표의 성격을 `requirement`로 전환하여 자원 축 생성.
+   - **과제 3 (밑수 50개 결측 보완)**: F0077, F0240, F0251, F0366, F0424 등 주요 공종의 `basis_quantity` 및 `basis_unit` 복원.
+3. **[주] 주석 계수 구조화**:
+   - F0245(급경사 발파 20% 가산), F0251(고철 50kg 공제), F0395(유로폼 공구손료 3%, 감속 9%) 등 누락된 9개 핵심 주석 계수를 견적 엔진 파라미터로 연결 필요.
+
+---
+*보고서 작성일: 2026-09-17*  
+*작성자: Antigravity (보조 AI)*  
+*기반 파일: `scratch/audit_results.json`*

resources/knowledge/technical_info/_index.md

@@ -10,7 +10,7 @@
 
 | 트리 | 그룹 | 상태 |
 |---|---|---|
-| 01_임도/ | 01_계획노선 · 02_상세설계 · 03_계산정보 · 04_수량분석정보 · 05_원가정보 | 64문서(목록 기준, draft) |
+| 01_임도/ | 01_계획노선 · 02_상세설계 · 03_계산정보 · 04_수량분석정보 · 05_원가정보 | 65문서(목록 기준, draft) |
 | 02_사방댐/ | 01_대상지_타당성평가 · 02_상세설계 · 03_계산정보 · 04_수량분석정보 · 05_원가정보 | 15문서 draft (2026-08-11) |
 
 ## 01_임도/01_계획노선 — 임도망·노선계획 영역 (프로그램 반영 2027 예정, 문서 수립은 현재 진행)
@@ -128,6 +128,7 @@
 | 01_임도/05_원가정보/품셈_원문_전수실사_및_원가위험_종합총괄.md | 2026-09-17 산림·건설 품셈 및 연결고리 전수 실사 종합 총괄 보고서 — 금액 직결 4대 위험(reference 실값 20·건설 노무비 위험 5·미판정 14·밑수 155), 5대 구조 왜곡(목차오기·표면마무리 100배·뿌리 4.7배 등), 6유형·밑수 지도 및 관련 11문서 상호 연결 총괄 | 산림사업 표준품셈 & 건설공사 표준품셈 2026 전수 실사 집약 (2026-09-17) | verified |
 | 01_임도/05_원가정보/품셈_실사_목차.md | 2026-09-17 품셈 실사 상호 참조 목차(Index) 문서 — 금액에 닿는 발견(4건)·구조에서 드러난 것(5건)·다음 판 지도(6건)의 파일 위치·동반 JSON·핵심 요약만 간결하게 가리키는 관문 장부 | 기술정보DB 원가정보 실사 문서 11종 색인 (2026-09-17) | verified |
 | 01_임도/05_원가정보/오늘_작업_기초값_공종축_원문대조_검증보고서.md | 2026-09-17 기초값 15종(8,372줄 100% 불변) 및 공종 축(목차오기 둘 원문본문 일치·헛단위 5줄 정상 제외·단가 0원 변동) 원문대조 정밀 감사 검증보고서 | 원천 JSON 9종 및 산림·건설 품셈 원문 정밀 대조 (2026-09-17) | verified |
+| 01_임도/05_원가정보/품셈_원문md_마스터데이터_대조_검증보고서.md | 산림사업 표준품셈 원문 MD(9,167행 476개 표) ↔ 마스터 데이터(477개 공종) 전수 대조 검증보고서 — 5대 항목(누락 23개·수치 100% 일치·밑수 결측/왜곡 60개·[주] 핵심 계수 누락 9개·금액 직결 reference 오분류 27개) 정밀 명세 | 산림사업 표준품셈 2025-82호 & 공종/기초값 마스터 전수 대조 (2026-09-17) | verified |
 
 
 ## 02_사방댐 — 사방댐 설계자동화 기술문서