Feature #901
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-21] 패널 수량·BOQ 및 설계변경 영향 분석
0%
Description
PoC-21. 패널 수량·BOQ 및 설계변경 영향 분석¶
1. 작업 개요¶
본 PoC는 신규 L1 태양광 패널 자동배치 결과와 생성된 CAD 도면을 분석하여 태양광 모듈 수량, BOQ(공사비내역서) 관련 항목 및 설계변경 전후의 수량 변화를 자동으로 계산·검증하는 기능을 개발하는 작업이다.
PoC-17~18의 Solver 결과, PoC-19의 신규 DXF Candidate, PoC-20의 Authorized Delta 적용 결과를 연결한다.
또한 PoC-08~09에서 구축한 설계문서 분석 및 Evidence Crosswalk를 활용하여 CAD 도면과 수량산출서·BOQ의 관계를 확인한다.
핵심 목표는 단순한 수량 계산에 그치지 않고 변경 전후 무엇이 얼마나 달라졌으며, 어떤 설계조건과 변경사항 때문에 영향을 받았는지 추적 가능한 분석 결과를 제공하는 것이다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/162
상위 Redmine 일감: #867
담당: 조영우
PM 및 검토: 문길래
협력: 이상재, 황수아
계획 기간: 2026-12-23 ~ 2027-01-03
선행 작업: PoC-0809, PoC-1720
2. 세부 작업¶
STEP 1. 기존 수량 및 BOQ 분석 자산 조사¶
- 기존 CAD 모듈 객체 수량 분석 코드 확인
- PoC-07의 L2 모듈 배치 관찰 데이터 검토
- PoC-08의 수량산출서·BOQ 분석 결과 확인
- PoC-09의 CAD ↔ 문서 Evidence Crosswalk 검토
- PoC-17~18의 Solver 출력 계약 확인
- PoC-19~20의 DXF 및 Authorized Delta 결과 확인
- 기존 기능의 REUSE / EXTEND / NEW / HOLD 분류
STEP 2. 태양광 패널 수량 집계 기준 정의¶
다음 단위로 모듈 수량을 집계할 수 있도록 정의한다.
| 집계 기준 | 내용 |
|---|---|
| Site | 전체 L1 사이트 |
| Zone | 설치 구역 |
| Row | 모듈 배치 행 |
| Module Spec | 모듈 규격별 수량 |
| Layout Candidate | 배치 후보별 수량 |
| Drawing Revision | 도면 버전별 수량 |
Block 정의 수와 실제 INSERT 배치 수, 중복 객체 및 소계·합계를 혼동하지 않도록 처리한다.
STEP 3. Solver 및 CAD 도면 수량 비교¶
다음 데이터를 비교한다.
- Solver에서 배치한 모듈 수
- 생성된 DXF의 모듈 객체 수
- Authorized Delta로 추가된 객체 수
- 기존 기준 도면에 존재하는 모듈 수
- 변경 후 Candidate 도면의 모듈 수
동일한 설치 구역, 모듈 유형, Source Revision 및 집계 대상을 기준으로 정합성을 검증한다.
STEP 4. 설계변경 전후 영향 분석¶
기준 설계와 신규 설계 Candidate를 비교한다.
주요 분석 항목:
- 태양광 패널 추가 수량
- 태양광 패널 삭제 수량
- 전체 모듈 수량 증감
- 구역별 배치 수량 변화
- 모듈 규격 변경
- 모듈 위치 및 방향 변경
- 설치 가능 영역 변경
- 장애물·이격조건 변경의 영향
- 적용 Engineering Knowledge 버전 변경의 영향
변경 원인이 확인되지 않는 경우 임의로 원인을 확정하지 않는다.
STEP 5. 설계변경 영향 계산¶
기본 수량 비교는 다음 방식으로 계산한다.
수량 증감 = 변경 후 모듈 수량 - 기준 모듈 수량
예시:
- 변경 전: 100개
- 변경 후: 112개
- 증감: +12개
이는 계산 방식 설명을 위한 예시이며 실제 프로젝트 수량을 의미하지 않는다.
모듈 사양이 서로 다른 경우 규격별 수량을 별도로 집계하고, 필요하다면 확인된 정격출력 자료를 근거로 용량 변화를 계산한다.
STEP 6. CAD ↔ BOQ 정합성 검증¶
PoC-08~09의 문서 분석 및 Crosswalk를 활용한다.
검증 항목:
- CAD 모듈 수량과 수량산출서 수량 비교
- BOQ에 기재된 관련 모듈·설비 품목 확인
- 모듈 규격과 BOQ 품목 규격 비교
- Source Revision 및 설계 범위 일치 여부
- 구역별 수량 비교
- 단위 및 집계 수준 비교
- 차이 발생 시 원인 후보 분류
동일한 설비 집합과 집계 범위가 확인되지 않으면 비교 결과를 HOLD 또는 REVIEW로 처리한다.
STEP 7. 비용 영향 분석 범위 정의¶
BOQ에 검증 가능한 단가 정보가 있는 경우에만 비용 영향 분석을 수행한다.
확인할 정보:
- 품목명
- 규격
- 단가
- 통화
- 적용 기준 시점
- 수량
- 관련 Source Revision
- 단가 근거
단가가 없거나 최신 적용 여부를 확인할 수 없으면 금액을 임의로 추정하지 않는다.
비용 관련 결과는 확정 견적이나 계약 금액이 아닌 검증 범위 내 참고 분석으로 관리한다.
STEP 8. Quantity Impact Report 정의¶
예상 산출물: quantity_impact_report.json
주요 필드:
- Impact Report ID
- Site ID
- Baseline Drawing ID / SHA-256
- New Candidate ID / SHA-256
- Solver Version
- Applied Rule IDs / Versions
- Module Spec ID
- Zone ID
- Baseline Quantity
- New Quantity
- Quantity Delta
- Change Type
- Change Reason
- Related BOQ Items
- Comparison Basis
- Source Evidence
- Verification Status
- Warning / HOLD Reason
각 비교 결과가 실제 원본 도면과 문서까지 추적 가능해야 한다.
STEP 9. 불일치 및 예외 처리¶
다음 상황을 구분한다.
- Solver 수량과 DXF 수량 불일치
- DXF와 Authorized Delta 수량 불일치
- CAD와 BOQ 수량 불일치
- 서로 다른 Source Revision
- 다른 구역이나 설비 집합의 수량 비교
- 중복 Entity 또는 Block 참조
- 모듈 규격 변경
- 단위 및 정격출력 정보 누락
- 기준 도면이 없는 경우
- 모듈 0개 배치 및 변경 없음
- 단가·비용 정보 미확정
오류 후보와 실제 검증된 오류는 구분한다.
STEP 10. 자동 테스트 및 검증¶
다음 Golden Fixture를 구성한다.
- 정상 모듈 수량 일치
- 모듈 추가
- 모듈 삭제
- 변경 없음
- 모듈 규격 변경
- 서로 다른 설치 구역
- 중복 Entity
- 모듈 0개
- BOQ 집계 범위 불일치
- Source Revision 불일치
- 단가 누락
- 단위 또는 정격출력 불일치
각 사례의 예상 수량, 실제 계산 결과 및 오류 처리 결과를 자동 검증한다.
STEP 11. 보고서 및 후속 QA 연계¶
분석 결과에 다음 정보를 포함한다.
- 변경 전후 수량 요약
- 구역별 및 규격별 증감
- CAD ↔ BOQ 비교 결과
- 불일치 및 미확정 항목
- 적용 규칙 및 Source 버전
- 검증 Evidence
- 전문가 검토 필요사항
PoC-22 및 INT-06에서 사용할 수 있는 공통 보고서 계약을 정의한다.
STEP 12. GitHub 반영 및 결과 제출¶
- 패널 수량 및 변경 영향 분석 모듈 구현
- CAD·Solver·BOQ 연계 기능 작성
- Quantity Impact Report JSON Schema 작성
- Golden Fixture 및 pytest 테스트 작성
- 실제 실행 Evidence 기록
- Windows PowerShell 실행 가이드 작성
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 조영우 | 패널 수량 집계, 설계변경 영향 계산, 보고서 생성 |
| 이상재 | DXF Entity 수량 및 Authorized Delta 검증 연계 |
| 황수아 | BOQ·수량산출서·Evidence Crosswalk 연계 |
| 문길래 | 정합성·완료 기준·검증 결과 검토 및 PR 승인 |
4. 제출 산출물¶
- 태양광 패널 자동 수량 집계 기능
- Solver·DXF·Authorized Delta 수량 비교 기능
- 설계변경 전후 수량 영향 분석 기능
- CAD ↔ BOQ 정합성 분석 기능
quantity_impact_report.json및 JSON Schema- 구역별·규격별 수량 변화 보고서
- 불일치 및 검토 필요 항목 목록
- Golden Fixture 및 pytest 테스트
- Source·Rule·Candidate 추적 Evidence
- PoC-22/INT-06 QA 보고서 연계 계약
- GitHub PR 및 PM 검토 결과
5. 완료 기준 (PASS)¶
- 기존 CAD·BOQ 수량 분석 자산 조사
- Site·Zone·ModuleSpec별 집계 기준 정의
- Solver 결과와 DXF 모듈 수량 비교
- Authorized Delta 적용 전후 수량 검증
- Baseline 대비 신규 Candidate 증감 계산
- 모듈 추가·삭제·규격 변경 처리
- 중복 Entity 및 Block 참조 중복집계 방지
- CAD와 BOQ의 집계 범위·단위·Revision 검증
- 수량 불일치와 원인 미확정 상태 구분
- 근거 없는 단가 및 비용 추정 차단
- 모듈 0개 및 변경 없음 사례 처리
- Quantity Impact Report 및 JSON Schema 작성
- Source SHA·Rule Version·Candidate ID 추적
- Golden Fixture 및 pytest 테스트 PASS
- 실제 실행 Evidence 및 원본 불변 확인
- PoC-22/INT-06 연계 계약 작성
- GitHub PR 제출 및 PM 검토 완료
- main 병합 및 후속 PoC 연계 준비 완료
6. 개발 및 검증 원칙¶
- 수량 비교 시 동일한 설비 집합·구역·규격·Revision을 확인한다.
- CAD 객체 수가 곧 실제 자재 발주 수량이라고 단정하지 않는다.
- Block 정의 수와 실제 배치 수를 혼동하지 않는다.
- 단순 수량 차이를 설계 오류로 즉시 확정하지 않는다.
- 근거 없는 단가·비용·시공 수량을 임의 계산하지 않는다.
- 변경 영향과 적용 규칙의 관계를 추적 가능한 형태로 기록한다.
- 자동 분석 결과는 최종 설계 및 공사비 승인으로 간주하지 않는다.
- 원본 DWG/DXF 및 설계문서를 임의로 수정하지 않는다.
- 고객 자료의 무단 외부 전송 및 Autodesk APS 유료 API 호출은 수행하지 않는다.
- 최종 설계 적합성은 설계 전문가 검토를 거친다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/162
25개 PoC 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-22 — DXF 정량 검증 및 DWG/PDF 시각 품질 검증
PoC-21의 수량·변경 영향 결과를 CAD 도면의 정량·시각 QA와 연결한다.
PoC-22는 이상재님이 주담당으로 수행하며, 신규 L1 Candidate의 CAD 구조·Geometry·수량 및 시각 품질을 종합적으로 검증한다.
No data to display