Project

General

Profile

Actions

Feature #876

open
길문 수황

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

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

[PoC-09] CAD 도면과 계산서·BOQ 간 Evidence 연결

Feature #876: [PoC-09] CAD 도면과 계산서·BOQ 간 Evidence 연결

Added by 길래 문 23 days ago.

Status:
New
Priority:
High
Assignee:
Start date:
11/23/2026
Due date:
11/26/2026 (Due in 9 days)
% Done:

0%

Estimated time:

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 도면과 설계문서 간 관계를 구조화한다.

지원할 관계 유형:

  1. CAD 객체 1개 ↔ 문서 항목 1개
  2. CAD 객체 여러 개 ↔ 문서 집계 항목 1개
  3. CAD 객체 그룹 ↔ 여러 계산·수량 항목
  4. 연결 근거가 부족한 미매칭 항목

연결 결과에는 다음 정보를 포함한다.

  • CAD Source ID 및 객체 Locator
  • 문서 Source ID 및 Page/Sheet/Cell Locator
  • 연결 대상 및 관계 유형
  • 매칭 기준
  • 검증 상태
  • 근거 및 불확실성
  • 불일치 사유

STEP 4. CAD와 수량산출서 간 수량 검증

다음 항목을 검증한다.

  • CAD에서 확인한 태양광 모듈 수량
  • 수량산출서의 모듈 수량
  • BOQ에 기재된 해당 품목 수량
  • 설계계산서의 적용 모듈 수량
  • 구역별 또는 설비별 수량 차이

중요: 단순히 수치가 같거나 다르다는 이유만으로 설계 적합성이나 오류를 확정하지 않는다.

동일한 설비 집합, 구역, 단위 및 Revision인지 확인한 뒤 비교한다.

STEP 5. 데이터 불일치 원인 분류

다음과 같은 차이를 구분한다.

  1. 실제 수량 불일치 가능성
  2. 서로 다른 설계 Revision
  3. 구역 또는 설비 집계 범위 차이
  4. 문서 데이터 추출 오류
  5. 단위 또는 계산 방식 차이
  6. 중복 객체 또는 소계·합계 중복
  7. 설계 변경사항의 산출물 미반영 가능성
  8. 근거 부족으로 확인 불가

자동 판정이 어려운 항목은 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. 제출 산출물

  1. CAD ↔ 설계문서 Evidence Crosswalk 기능
  2. CAD 객체와 문서 항목 연결 데이터
  3. evidence_crosswalk.json 및 JSON Schema
  4. 수량 및 단위 비교 검증 결과
  5. 불일치·미매칭·추가 검토 대상 목록
  6. 합성 Golden Fixture 및 pytest 테스트
  7. 허가된 실제 L2 자료 분석 Evidence
  8. Source 및 문서 출처 추적 결과
  9. 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 상세계획

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-10 — L2 설계 규칙 및 배치 패턴 Knowledge 후보 추출

PoC-07의 CAD 배치 관찰 데이터, PoC-08의 설계문서 추출 데이터 및 PoC-09의 Evidence Crosswalk를 함께 분석하여 Engineering Knowledge 후보를 도출한다.

이 단계에서 생성하는 규칙은 Candidate이며, 반례 검증과 전문가 승인 이후에만 신규 L1 자동설계에 사용할 수 있다.

No data to display

Actions

Also available in: PDF Atom