Project

General

Profile

Actions

Feature #875

open
길문 수황

Feature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축

Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증

PoC-08. L2 계산서·수량산출서·BOQ 정보 추출

Feature #875: PoC-08. L2 계산서·수량산출서·BOQ 정보 추출

Added by 길래 문 23 days ago. Updated 14 days ago.

Status:
In Progress
Priority:
High
Assignee:
Start date:
11/09/2026
Due date:
11/20/2026 (Due in 3 days)
% Done:

0%

Estimated time:

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. 오류 및 불확실성 처리

다음 상황을 구분한다.

  1. 파일 누락 또는 손상
  2. 지원하지 않는 파일 형식
  3. Excel 수식 캐시 누락
  4. PDF 표 추출 오류
  5. 단위 불명확
  6. 품목명 또는 규격 불일치
  7. 소계·합계의 중복 가능성
  8. 구역 및 집계 대상 불명확
  9. 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. 제출 산출물

  1. L2 설계계산서 주요 데이터 추출 기능
  2. 수량산출서·BOQ 항목 추출 기능
  3. Excel 수식 및 계산 결과 구분 기능
  4. PDF/Excel 출처 추적 구조
  5. document_observations.json 및 JSON Schema
  6. 합성 Golden Fixture 및 pytest 테스트
  7. 실제 문서 분석 실행 Evidence
  8. 오류·불확실성 검증 보고서
  9. 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 상세 로드맵

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-poc-roadmap-20261025.md

전체 업무계획서

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-work-plan-20261025.md

업무분장 및 시스템 통합계획

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-team-knowledge-integration-plan-20261025.md

8. 후속 개발 연계

다음 작업: PoC-09 — CAD 도면과 계산서·BOQ 간 Evidence 연결

PoC-07에서 생성한 CAD 모듈 배치 관찰 데이터와 PoC-08에서 생성한 설계계산서·수량산출서·BOQ 데이터를 연결한다.

동일한 장비 및 집계 범위로 확인된 항목만 비교하고, 설계 불일치 후보와 미확정 관계를 구분하여 검증한다.

Actions

Also available in: PDF Atom