# 실무문서 분석 운영지침

> 실무문서(실제 납품 최종 설계도서)를 공사지별로 분석해 `_분석보고서.md`를 만드는 작업 절차서.
> **이 파일과 각 공사지의 `_분석보고서.md`는 AI 생성물** — `original/` 불변 규칙의 예외다 (technical_info와 동일 지위). 원본 파일 자체는 절대 수정·삭제하지 않는다.

## 1. 목적

1. 실무문서는 법령·지침·교본에 **누락된 실무 정보**(적용 단가·할증·규격·양식)를 담은 최종 납품물 — 이를 추출해 기술문서(technical_info)를 검증·보강한다.
2. [03_미결_및_확인사항](03_미결_및_확인사항.md)의 "실무문서 검증 대기" 항목을 해소한다.
3. 현 프로그램(오솔길)·내역 프로그램의 산출 체계를 파악해 Aislo 산출물 형식의 기준으로 삼는다.

## 2. 공사지 목록·진행 순서

| 순서 | 공사지 폴더 | 사업 | 상태 |
|---|---|---|---|
| 1 | 2024년 간선임도(기번3-울진.대흥)(1공구) | 간선임도 | **완료** (2026-08-12) — 보고서 3파일 + (공통) 1파일 |
| 2 | 2024년 간선임도(기번3-울진.대흥)(2공구) | 간선임도 | **완료** (2026-08-12) |
| 3 | 2024년 간선임도(기번3-울진.대흥)(3공구) | 간선임도 | **완료** (2026-08-12) |
| 4 | 20250527 2025년 계류보전사업(기번1-영덕.병곡.영리.산214-1)(변경) | 사방(계류보전) | **완료** (2026-08-12) — 보고서 2파일 |
| 5 | 01.산불거창(거창북상병곡) | 산불진화임도 | **완료** (2026-08-12) |
| 6 | 02.산불 장수 | 산불진화임도 | **완료** (2026-08-12) — 내역 DRM 판독불가 기록 |
| 7 | 03.산불진안 | 산불진화임도 | **완료** (2026-08-12) — 내역 DRM 판독불가 기록 |
| 8 | 04.산불 봉화 | 산불진화임도 | **완료** (2026-08-12) |
| 9 | 05. 동부청 영월 | 산불진화임도 | **완료** (2026-08-12) |
| 10 | 25년 산불진화임도(기번8)(울진소광) | 산불진화임도 | **완료** (2026-08-12) |

- 울진대흥 `(공통)` 폴더 = 3개 공구의 공통 문서(통합 내역·시방서·사업계획서·안전관리) — 별도 보고서 없이 각 공구 보고서에서 참조·인용한다.
- 보고서 완료 시 이 표의 상태를 `완료 (YYYY-MM-DD)`로 갱신한다.

## 3. 분석 대상·제외

| 구분 | 규칙 |
|---|---|
| 대상 | dwg 제외 **전 파일**. 내용 판독 가능한 것은 전부 상세분석 |
| 제외 (내용 분석) | dwg(도면), tmp·bak·dwl·fbak·log(작업 부산물) — 단 **파일 분류표의 개수에는 포함**해 전체상 보존 |
| 오솔길 데이터 | rod·pln·crv·PIN·JD·MASS 등 전용 바이너리 — 내용 분석 불가, 목록·용도만 기재. **csv 산출물(운반거리·유토곡선)은 상세분석** |
| zip | 내부 목록 확인 후 실 문서 있으면 분석 |

## 4. 내역 프로그램 파일 처리 (2026-08-12 확인)

| 확장자 | 정체 | 처리 |
|---|---|---|
| **.STC** | STmate 프로젝트 (zip + DBF 15 + SIxMemo 3 + Ini 2) | **직접 파싱** — 포맷 전체 구조는 [_STC포맷분석](original/실무문서/_STC포맷분석.md) 참조 (Aislo→STC 변환 대비 상세 필드 사전). 내역 본체 = **BOQ11** (BOQ 아님 주의) |
| .estx / .ebkx | 견적 프로그램 전용 DB (dat/blb/idx) | 파싱 불가 — **병행 xlsx(내역+수량)로 대체** 분석. 프로그램명은 보고서에 기재 |
| .xlsx / .xls | 내역·수량·원가·구조도 산출 | 전 시트 구조 파악 후 상세분석 |
| .hwp | 시방서·사업계획서 | `_pipeline/hwp5_text.py`로 텍스트 추출 |
| .pdf | 계약·안전 문서 | 텍스트 추출, 스캔본은 육안 |

## 5. 보고서 규격 — 기능별 분할 (2026-08-12 확정)

내용이 방대하므로 공사지당 **기능별 파일 세트**로 작성한다. `_분석보고서.md`가 총괄 인덱스.

| 파일 | 역할 (절 배분) |
|---|---|
| `_분석보고서.md` | **총괄** — ① 공사 개요, ② 파일 분류표(전수), ⑥ 미결 검증 요약, ⑦ 특이사항, 하위 파일 링크, 검증 결과 요약 |
| `_분석_내역원가.md` | ③ 중 내역서·일위대가·**제비율 적용값**·단가 출처 (xlsx + STC DBF 파싱) |
| `_분석_수량산출.md` | ③ 중 수량산출서 — 공종 체계, 산출식, 구조물 규격·기울기·배수 값 |
| `_분석_시방계약.md` | ③ 중 시방서·사업계획서·계약/안전 문서 요지 |
| `_분석_대조.md` | ④ 기술문서 대조 + ⑤ 법령·지침 외 신규 정보 |

- frontmatter 공통: `title / 공사지 / 사업유형 / 분석일 / status(draft|confirmed)`
- 자료가 적은 공사지(장수·진안 등)는 총괄 1파일에 통합 가능. 700줄 초과 시 분할.
- 형식은 technical_info와 동일하게 표 중심·서술 최소화.

## 5-1. 검증절차 — 누락·할루시네이션 방지 (필수)

보고서 확정 전 아래 검증을 **스크립트로** 수행하고 결과를 총괄 보고서 끝에 `## 검증 결과` 절로 기록한다.

| 검증 | 방법 | 통과 기준 |
|---|---|---|
| V1. 파일 전수 커버리지 | 실제 파일 목록(스크립트 집계) vs 분류표 — 대조 | 누락 0, 분류표 합계 = 실제 개수 |
| V2. 수치 재대조 | 보고서에 기재한 **모든 핵심 수치**(제비율·합계·규격·연장)를 원본에서 재조회해 일치 확인 | 불일치 0 |
| V3. 좌표 인용 | 수치 인용 시 원본 위치 병기 — 엑셀 `파일명!시트!셀`, DBF `테이블.필드`, hwp/pdf는 페이지·절 | 좌표 없는 수치 0 |
| V4. 합계 정합 | 내역서 총계 = 하위 항목 합산 재계산 (파싱 오류 감지) | 오차 0 (반올림 규칙 내) |
| V5. 근거 없는 서술 금지 | 원본에 없는 추정·해석은 `> [해석]` 마커로만, 사실 서술과 분리 | 마커 없는 추정 0 |

- 판독 불가(암호화·손상·스캔본)는 "판독 불가"로 기록 — 추정 금지.

## 6. 미결사항 검증 매핑

| 미결 No. | 항목 | 검증 소스 |
|---|---|---|
| 3 | 흙막이 물빼기 구멍 기준 | 구조도·수량산출 (임도 공사지) |
| 4 | 절토 기울기 실무 기본값 | 횡단 관련 산출·구조도 |
| 7 | 배수 파라미터 (C값·도달시간·n) | 수량산출·구조도 내 배수 계산 |
| 9 | 구조물 표준도 원단위 | 구조도 xlsx·수량산출의 구조물 일람 |
| 10 | 공종별 할증 계열 | 내역서 일위대가 (STC DBF·xlsx) |
| 12① | 산재보험 업종 (건설 3.56 vs 임업 5.8) | 내역서 원가계산서 제비율 |
| 13 | 사방댐·계류보전 수량 산출식 | 계류보전 구조물재료산출·야계설명서 |
| 15 | 사방 부위별 강도 | 계류보전 내역·구조도 (사방댐 내역서는 미확보 — 확보 시 추가) |
| 신규 | 제비율 실적용값 전반 | 각 공사지 원가계산서 — 조달청 고시와 대조 |

## 7. 검증 원칙 (technical_info 운영지침 승계)

- **개별 공사지 보고서 = 첨부파일의 객관적 분석 기록** (사용자 결정 2026-08-12) — 현행법 판정·비교를 섞지 않는다. 실무값을 원본 그대로 기록하고, 현행 법령·기준과의 비교는 **최상위 비교 보고서**(전 공사지 완료 후 `_현행대비.md`)에서 일괄 수행한다. Aislo 반영값 결정(현행법 우선)도 그 단계에서.
- 문서가 없으면 없는 대로 기록한다 — 억지로 절을 채우지 않는다 (중복·공백 허용).
- 판정 불가한 원본 내부 불일치는 **판정하지 말고 기록** 후 사용자 확인에 넘긴다.
- 판독 불가한 값을 추정해서 채우지 않는다.
- 개인정보(감리자 성명·연락처 등) 발견 시 보고서에 옮기지 않는다.

## 7-1. 숨김탭 분석 (2026-08-12 추가)

- DRM 미적용 엑셀은 **숨김/veryHidden 탭에 해당 공사지 외 데이터**(구조물 라이브러리ㆍ템플릿 예시)가 있을 수 있다. 전수 스캔 결과·활용가치 분류: [_숨김탭분석](original/실무문서/_숨김탭분석.md).
- 활용가치: 소광 구조도 숨김 31탭 = 임도 구조물 원단위 전집(미결 No.9 소스). 오솔길 배수관표는 3공사지 동일값 → 템플릿 예시 의심.

## 8. 완료 후 처리

1. 보고서 → 이 지침 §2 상태 갱신 → [03_미결_및_확인사항](03_미결_및_확인사항.md) 해당 항목 갱신 (해소·부분해소·기록)
2. ⑤절의 신규 정보는 technical_info 해당 문서에 반영하고 sources에 실무문서 경로 추가
3. 전 공사지 완료 시 최상위 보고서 2건 작성:
   - `실무문서/_종합비교/` — **작성 완료 (2026-08-12)**. 6주제(원가·배수·토공·임도구조·사방·양식) + 00_인덱스. 각 주제 5블록(실무 관측→현행 범위→차이→Aislo 제안→근거). 누락검증 3회 통과(개별↔종합 무손실). technical_info 연결은 다음 단계.
   - Aislo 최종값·로직은 개발 과정에서 사용자가 직접 확정 (종합비교는 방향·검증 근거).