Feature #875
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
PoC-08. L2 계산서·수량산출서·BOQ 정보 추출
0%
Description
PoC-08. L2 계산서·수량산출서·BOQ 정보 추출¶
1. 작업 개요¶
본 PoC는 기존 L2 태양광 설계 프로젝트의 설계계산서, 수량산출서, 공사비내역서(BOQ)에서 주요 설계 수치와 수량·단위·계산 근거를 추출하여 구조화하는 기능을 구축하는 작업이다.
PoC-07의 CAD 모듈 배치 분석과 병렬로 진행하며, 이후 도면과 산출물 간 정합성을 검증하고 Engineering Knowledge를 도출하기 위한 문서 분석 기반을 확보한다.
기존 저장소에 구현된 PDF/Excel 분석 및 Evidence 관리 기능을 우선 조사하고 재사용한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/149
상위 Redmine 일감: #867
담당: 황수아
PM 및 검토: 문길래
협력: 조영우, 이상재
계획 기간: 2026-11-09 ~ 2026-11-20
선행 작업: PoC-01 기존 자산 조사, PoC-04 Source 조회·무결성 검증
2. 세부 작업¶
STEP 1. 기존 L2 설계 산출물 조사¶
다음과 같은 대표 자료를 우선 분석한다.
- 직병렬 계산서(PDF)
- 태양광 부하 계산서(XLSX)
- 전기분야 수량산출서(XLSM)
- 공사비내역서(XLSX)
- 기타 승인된 설계계산 및 수량 관련 자료
각 파일의 Source ID, SHA-256, Revision, 승인 상태와 접근 권한을 확인한다.
기존 Source Manifest에 등록되었다는 사실만으로 해당 문서를 최종 승인본으로 확정하지 않는다.
STEP 2. 기존 문서 분석 기능 확인¶
- PDF 표 및 텍스트 추출 관련 코드 조사
- Excel Workbook·Sheet·Cell 분석 기능 확인
- 기존 수량산출·BOQ 처리 코드 조사
- 데이터 출처 및 검증 Evidence 관리 방식 확인
- 재사용 가능한 기능과 신규 구현 필요 기능 구분
STEP 3. 설계계산서 정보 추출¶
설계계산서에서 분석 가능한 주요 항목을 추출한다.
- 태양광 모듈 사양
- 모듈 수량
- 직렬·병렬 연결 관련 값
- 전력용량 및 단위
- 인버터 관련 정보
- 계산식과 계산 결과
- 구역별 또는 설비별 계산 조건
문서에 실제로 존재하는 항목만 추출하며 확인되지 않은 값은 임의로 생성하지 않는다.
STEP 4. 수량산출서 및 BOQ 정보 추출¶
다음 항목을 구조화한다.
| 추출 항목 | 주요 내용 |
|---|---|
| 공종·품목 | 자재 또는 설비 구분 |
| 규격 | 모델, 크기, 용량 등의 정보 |
| 수량 | 산출된 품목 수량 |
| 단위 | EA, m, kW 등 |
| 단가 | 확인 가능한 자재·작업 단가 |
| 금액 | 품목별 금액 및 합계 |
| 산출 근거 | 계산식 또는 참조 셀 |
| 적용 범위 | 구역, 설비 및 집계 범위 |
소계·합계와 개별 품목 수량을 중복 집계하지 않도록 처리한다.
STEP 5. Excel 수식 및 데이터 검증¶
- Workbook 및 Sheet 구조 확인
- 데이터가 있는 Cell과 Range 탐색
- 원본 수식과 계산 결과 구분
- 수식의 Cached Value 확인
- 병합 셀 및 숨김 Sheet 처리
- 숫자·문자열·단위 해석
- 누락값과 오류값 구분
주의: Excel 수식 원문이 있다는 이유만으로 계산 결과가 검증되었다고 판단하지 않는다. 수식 캐시가 없거나 실제 계산 확인이 불가능하면 미검증으로 기록한다.
STEP 6. 데이터 표준화 및 출처 관리¶
추출 데이터를 공통 JSON 구조로 정리한다.
예상 산출물: document_observations.json
주요 필드:
- Source ID
- Source SHA-256 및 Revision
- 문서 유형
- Sheet / Cell / Page / Table Locator
- 품목 또는 설계 항목
- 원본 값
- 정규화 값
- 단위
- 계산식
- 적용 구역 및 범위
- 추출 상태
- 검증 상태 및 Warning
후속 PoC에서 원본 문서의 정확한 위치로 추적할 수 있도록 설계한다.
STEP 7. 오류 및 불확실성 처리¶
다음 상황을 구분한다.
- 파일 누락 또는 손상
- 지원하지 않는 파일 형식
- Excel 수식 캐시 누락
- PDF 표 추출 오류
- 단위 불명확
- 품목명 또는 규격 불일치
- 소계·합계의 중복 가능성
- 구역 및 집계 대상 불명확
- Source Revision 또는 최종 승인 상태 미확정
근거가 부족한 값은 REVIEW 또는 HOLD로 분류한다.
STEP 8. 자동 테스트 및 결과 검증¶
- 합성 PDF/Excel Golden Fixture 분석
- 표·셀·계산식 추출 결과 비교
- 단위 및 정규화 처리 검증
- 합계·중복 수량 처리 테스트
- 오류 및 누락 자료 처리 테스트
- Source 원본 SHA-256 변경 여부 확인
- 허가된 실제 L2 문서 분석 결과 검토
실제 문서의 추출 결과와 합성 데이터의 테스트 결과를 구분한다.
STEP 9. GitHub 반영 및 결과 제출¶
- 기존 문서 분석 코드 재사용 또는 확장
- 데이터 추출 모듈 및 JSON Schema 작성
- pytest 자동 테스트 작성
- 실제 실행 결과 및 Evidence 기록
- Windows PowerShell 실행 가이드 작성
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 황수아 | 계산서·수량산출서·BOQ 분석 및 데이터 추출 구현 |
| 조영우 | 수량·단위·집계 범위 및 후속 L1 설계 연계 검토 |
| 이상재 | CAD 객체와 문서 데이터 간 참조 규격 협의 |
| 문길래 | 데이터 신뢰성·검증 기준 검토 및 PR 승인 |
4. 제출 산출물¶
- L2 설계계산서 주요 데이터 추출 기능
- 수량산출서·BOQ 항목 추출 기능
- Excel 수식 및 계산 결과 구분 기능
- PDF/Excel 출처 추적 구조
document_observations.json및 JSON Schema- 합성 Golden Fixture 및 pytest 테스트
- 실제 문서 분석 실행 Evidence
- 오류·불확실성 검증 보고서
- Windows 실행 가이드 및 GitHub PR
5. 완료 기준 (PASS)¶
- 기존 PDF/Excel/BOQ 분석 코드 및 재사용 자산 조사
- 설계계산서 주요 항목 추출
- 수량산출서의 품목·규격·수량·단위 추출
- BOQ 항목 및 금액 정보 추출
- Sheet·Cell·Page 등 정확한 출처 위치 기록
- Excel 수식과 Cached Value 구분
- 원본 값과 표준화 값을 분리하여 저장
- 단위·범위·집계 수준 불확실성 처리
- 누락·손상·형식 오류 처리 검증
- Source 원본 변경 없음
- 합성 Golden Fixture 테스트 PASS
- 허가된 실제 L2 자료 분석 결과 확인
-
document_observations.json및 Schema 작성 - PoC-09 연계 입력·출력 계약 작성
- GitHub PR 제출 및 PM 검토 완료
- main 병합 및 후속 PoC 연계 준비 완료
6. 개발 및 검증 원칙¶
- 기존 문서 분석 자산을 우선 재사용한다.
- 설계계산서와 수량산출서의 값이 다르더라도 즉시 설계 오류로 확정하지 않는다.
- 서로 다른 구역·집계 범위의 수량을 무조건 비교하지 않는다.
- Excel 수식과 계산 결과를 혼동하지 않는다.
- 미확인 값을 AI가 임의로 생성하거나 보정하지 않는다.
- 기존 Source 및 원본 문서를 수정하지 않는다.
- 고객 자료를 외부 클라우드에 업로드하지 않는다.
- Autodesk APS 및 유료 API를 사용하지 않는다.
- 모든 분석 결과에 검증 가능한 출처 정보를 유지한다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/149
25개 PoC 상세 로드맵
전체 업무계획서
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-09 — CAD 도면과 계산서·BOQ 간 Evidence 연결
PoC-07에서 생성한 CAD 모듈 배치 관찰 데이터와 PoC-08에서 생성한 설계계산서·수량산출서·BOQ 데이터를 연결한다.
동일한 장비 및 집계 범위로 확인된 항목만 비교하고, 설계 불일치 후보와 미확정 관계를 구분하여 검증한다.