Feature #876
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-09] CAD 도면과 계산서·BOQ 간 Evidence 연결
0%
Description
PoC-09. CAD 도면과 계산서·BOQ 간 Evidence 연결¶
1. 작업 개요¶
본 PoC는 기존 L2 태양광 CAD 도면에서 추출한 모듈 배치 정보와 설계계산서·수량산출서·BOQ에서 추출한 정보를 연결하여 서로 다른 설계 산출물 간의 관계 및 검증 근거(Evidence)를 구축하는 작업이다.
PoC-07의 CAD 모듈 배치 관찰 데이터와 PoC-08의 계산서·수량산출서·BOQ 분석 결과를 활용한다.
설계자료 간 값이 일치하는지 확인할 뿐 아니라, 각 수치가 어떤 도면 객체, 어떤 문서, 어떤 계산식과 연결되는지 추적 가능한 Crosswalk 구조를 만드는 것이 핵심 목표이다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/150
상위 Redmine 일감: #867
담당: 황수아
PM 및 검토: 문길래
협력: 이상재, 조영우
계획 기간: 2026-11-23 ~ 2026-11-26
선행 작업: PoC-07, PoC-08
2. 세부 작업¶
STEP 1. CAD 및 문서 관찰 데이터 확인¶
- PoC-07의
module_observations.json구조 확인 - PoC-08의
document_observations.json구조 확인 - Source ID 및 SHA-256 확인
- 도면과 문서의 Revision 및 적용 범위 확인
- CAD 객체와 문서 항목의 식별자·단위·구역 정보 확인
- 기존 Crosswalk 또는 Evidence 연결 코드의 재사용 가능성 검토
STEP 2. CAD와 설계 산출물의 연결 기준 정의¶
다음 항목을 기준으로 연결 후보를 생성한다.
- 태양광 모듈 또는 설비 유형
- 모듈 규격 및 사양
- 배치 구역
- 설계 대상 및 집계 범위
- 관련 수량과 단위
- Source Revision 및 문서 버전
- 도면 객체와 문서 항목의 출처
동일한 명칭을 사용하더라도 서로 다른 설계 구역이나 집계 대상을 의미한다면 자동으로 같은 항목이라고 판단하지 않는다.
STEP 3. Evidence Crosswalk 모델 구현¶
CAD 도면과 설계문서 간 관계를 구조화한다.
지원할 관계 유형:
- CAD 객체 1개 ↔ 문서 항목 1개
- CAD 객체 여러 개 ↔ 문서 집계 항목 1개
- CAD 객체 그룹 ↔ 여러 계산·수량 항목
- 연결 근거가 부족한 미매칭 항목
연결 결과에는 다음 정보를 포함한다.
- CAD Source ID 및 객체 Locator
- 문서 Source ID 및 Page/Sheet/Cell Locator
- 연결 대상 및 관계 유형
- 매칭 기준
- 검증 상태
- 근거 및 불확실성
- 불일치 사유
STEP 4. CAD와 수량산출서 간 수량 검증¶
다음 항목을 검증한다.
- CAD에서 확인한 태양광 모듈 수량
- 수량산출서의 모듈 수량
- BOQ에 기재된 해당 품목 수량
- 설계계산서의 적용 모듈 수량
- 구역별 또는 설비별 수량 차이
중요: 단순히 수치가 같거나 다르다는 이유만으로 설계 적합성이나 오류를 확정하지 않는다.
동일한 설비 집합, 구역, 단위 및 Revision인지 확인한 뒤 비교한다.
STEP 5. 데이터 불일치 원인 분류¶
다음과 같은 차이를 구분한다.
- 실제 수량 불일치 가능성
- 서로 다른 설계 Revision
- 구역 또는 설비 집계 범위 차이
- 문서 데이터 추출 오류
- 단위 또는 계산 방식 차이
- 중복 객체 또는 소계·합계 중복
- 설계 변경사항의 산출물 미반영 가능성
- 근거 부족으로 확인 불가
자동 판정이 어려운 항목은 REVIEW 또는 HOLD로 처리하고 전문가 검토 대상으로 등록한다.
STEP 6. Crosswalk JSON 구조 정의¶
예상 산출물: evidence_crosswalk.json
주요 필드:
- Crosswalk ID
- CAD Source ID / SHA-256 / Revision
- 문서 Source ID / SHA-256 / Revision
- CAD Geometry Locator
- 문서 Page/Sheet/Cell Locator
- 연결 대상 항목
- 연결 유형
- 비교 대상 범위 및 단위
- 매칭 근거
- 검증 결과
- 불일치 사유
- 검토 필요 여부
각 관계는 원본 CAD 객체와 문서 위치로 역추적할 수 있어야 한다.
STEP 7. 자동 테스트 및 교차검증¶
다음 시나리오를 테스트한다.
- CAD와 문서의 모듈 수량 일치
- CAD와 문서의 수량 불일치
- Revision이 다른 자료 비교
- 동일 수량이지만 서로 다른 구역
- 소계와 합계의 중복 비교
- 단위가 다른 항목 비교
- 문서에는 있으나 CAD에는 없는 항목
- CAD에는 있으나 문서에는 없는 항목
- 동일한 객체와 문서 항목 간 중복 연결
합성 Golden Fixture와 접근이 허용된 실제 L2 자료의 결과를 구분하여 검증한다.
STEP 8. 후속 Engineering Knowledge 연계¶
- 연결이 검증된 CAD·문서 Evidence 정리
- 설계 규칙 후보 추출에 필요한 관계 및 근거 제공
- 불확실한 관계와 추가 검증 대상 분리
- PoC-10에서 활용할 JSON Schema 및 입력 계약 정의
Crosswalk에서 일치가 확인되더라도 이를 곧바로 승인된 Engineering Knowledge로 등록하지 않는다.
STEP 9. GitHub 반영 및 결과 제출¶
- Evidence Crosswalk 기능 구현
- JSON Schema 및 실행 예시 작성
- pytest 자동 테스트 작성
- 실제 실행 및 검증 Evidence 기록
- 오류 및 검토 대상 목록 작성
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 황수아 | Evidence Crosswalk 모델·매칭 로직·검증 결과 구현 |
| 이상재 | CAD 객체 식별자·Geometry Locator 연계 검토 |
| 조영우 | 모듈 수량·집계 범위·단위 비교 기준 검토 |
| 문길래 | 검증 신뢰성·완료 기준 검토 및 GitHub PR 승인 |
4. 제출 산출물¶
- CAD ↔ 설계문서 Evidence Crosswalk 기능
- CAD 객체와 문서 항목 연결 데이터
evidence_crosswalk.json및 JSON Schema- 수량 및 단위 비교 검증 결과
- 불일치·미매칭·추가 검토 대상 목록
- 합성 Golden Fixture 및 pytest 테스트
- 허가된 실제 L2 자료 분석 Evidence
- Source 및 문서 출처 추적 결과
- GitHub PR 및 PM 검토 보고서
5. 완료 기준 (PASS)¶
- PoC-07/08 관찰 데이터 입력 계약 확인
- 기존 Evidence/Crosswalk 자산 조사
- CAD 객체와 문서 항목 간 연결 후보 생성
- 1:1·1:N·N:1 및 미매칭 관계 처리
- Source·Revision·SHA 및 원본 Locator 기록
- 동일 집계 대상 여부 확인 후 수량 비교
- 수량·단위·구역·Revision 차이 처리
- 불일치 원인 및 미확정 상태 구분
- 연결 데이터의 원본 역추적 가능
- 확인된 관계와 추정 매칭 구분
- Source 원본 변경 없음
- 자동 테스트 및 실제 실행 Evidence 확보
- PoC-10 연계 JSON Schema 및 데이터 계약 작성
- GitHub PR 제출 및 PM 검토 완료
- main 병합 및 후속 PoC 연계 준비 완료
6. 개발 및 검증 원칙¶
- 동일한 설비·구역·Revision·집계 범위가 확인된 항목만 정량 비교한다.
- 단순 수량 일치만으로 설계 적합성을 승인하지 않는다.
- 불일치 발생 시 충분한 근거 없이 설계 오류로 확정하지 않는다.
- 문서 또는 CAD 원본을 임의로 수정하지 않는다.
- AI가 추정한 연결 관계와 검증된 관계를 명확히 구분한다.
- Evidence 연결만으로 Engineering Knowledge를 자동 승인하지 않는다.
- 고객 자료를 외부 클라우드에 업로드하지 않는다.
- Autodesk APS 및 유료 API 호출은 수행하지 않는다.
- 모든 검증 결과는 원본 근거로 추적 가능해야 한다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/150
25개 PoC 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-10 — L2 설계 규칙 및 배치 패턴 Knowledge 후보 추출
PoC-07의 CAD 배치 관찰 데이터, PoC-08의 설계문서 추출 데이터 및 PoC-09의 Evidence Crosswalk를 함께 분석하여 Engineering Knowledge 후보를 도출한다.
이 단계에서 생성하는 규칙은 Candidate이며, 반례 검증과 전문가 승인 이후에만 신규 L1 자동설계에 사용할 수 있다.
No data to display