실무문서 분석 운영지침
실무문서(실제 납품 최종 설계도서)를 공사지별로 분석해 _분석보고서.md를 만드는 작업 절차서.
이 파일과 각 공사지의 _분석보고서.md는 AI 생성물 — original/ 불변 규칙의 예외다 (technical_info와 동일 지위). 원본 파일 자체는 절대 수정·삭제하지 않는다.
1. 목적
- 실무문서는 법령·지침·교본에 누락된 실무 정보(적용 단가·할증·규격·양식)를 담은 최종 납품물 — 이를 추출해 기술문서(technical_info)를 검증·보강한다.
- 03_미결_및_확인사항의 "실무문서 검증 대기" 항목을 해소한다.
- 현 프로그램(오솔길)·내역 프로그램의 산출 체계를 파악해 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포맷분석 참조 (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 탭에 해당 공사지 외 데이터(구조물 라이브러리ㆍ템플릿 예시)가 있을 수 있다. 전수 스캔 결과·활용가치 분류: _숨김탭분석.
- 활용가치: 소광 구조도 숨김 31탭 = 임도 구조물 원단위 전집(미결 No.9 소스). 오솔길 배수관표는 3공사지 동일값 → 템플릿 예시 의심.
8. 완료 후 처리
- 보고서 → 이 지침 §2 상태 갱신 → 03_미결_및_확인사항 해당 항목 갱신 (해소·부분해소·기록)
- ⑤절의 신규 정보는 technical_info 해당 문서에 반영하고 sources에 실무문서 경로 추가
- 전 공사지 완료 시 최상위 보고서 2건 작성:
실무문서/_종합비교/ — 작성 완료 (2026-08-12). 6주제(원가·배수·토공·임도구조·사방·양식) + 00_인덱스. 각 주제 5블록(실무 관측→현행 범위→차이→Aislo 제안→근거). 누락검증 3회 통과(개별↔종합 무손실). technical_info 연결은 다음 단계.- Aislo 최종값·로직은 개발 과정에서 사용자가 직접 확정 (종합비교는 방향·검증 근거).
eomsangdonandClaude Fable 5
00ca9da23f