Project

General

Profile

Actions

Feature #904

open
길문 영조

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

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

[PoC-24] Autodesk APS와 로컬 CAD 엔진 정확도·호환성 비교

Feature #904: [PoC-24] Autodesk APS와 로컬 CAD 엔진 정확도·호환성 비교

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

Status:
New
Priority:
High
Assignee:
Start date:
01/13/2027
Due date:
01/22/2027 (Due in about 2 months)
% Done:

0%

Estimated time:

Description

PoC-24. Autodesk APS와 로컬 CAD 엔진 정확도·호환성 비교

1. 작업 개요

본 PoC는 Autodesk Platform Services(APS)와 Python·ezdxf 기반 로컬 CAD 엔진을 비교하여 CAD 도면의 처리 정확도, 형식 호환성, 시각 품질, 실행 성능, 비용 및 보안 측면의 차이를 검증하는 작업이다.

PoC-22의 로컬 CAD QA 결과와 PoC-23의 Autodesk APS 인증·비용·보안 검증 결과를 활용한다.

동일한 CAD 테스트 데이터를 기준으로 각 엔진의 지원 기능과 실제 처리 결과를 비교하고, 향후 MCP 기반 CAD 자동설계 플랫폼에서 로컬 엔진만 사용할지, Autodesk APS를 선택적으로 활용할지 판단한다.

GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/165

상위 Redmine 일감: #867

담당: 이상재

PM 및 검토: 문길래

협력: 조영우, 황수아

계획 기간: 2027-01-13 ~ 2027-01-22

선행 작업: PoC-22, PoC-23

2. 세부 작업

STEP 1. 비교 대상 CAD 엔진 및 기능 확정

로컬 CAD 엔진

  • Python 및 ezdxf 기반 DXF 읽기·생성
  • CAD Layer·Block·Entity 분석
  • 좌표·Geometry 및 Rotation 처리
  • 로컬 DXF Audit
  • 로컬 DWG/PDF 변환 도구가 있는 경우 해당 기능 확인

Autodesk APS

  • 실제 제공되는 CAD 관련 API 확인
  • Model Derivative 등 변환·시각화 관련 기능 검토
  • Automation API의 지원 제품 및 실행 조건 확인
  • 인증·비용·데이터 전송 조건 확인

두 엔진의 제공 기능이 반드시 동일한 것은 아니므로, 실제로 양쪽에서 수행할 수 있는 작업만 직접 비교한다.

STEP 2. 공통 Golden CAD Fixture 준비

다음 테스트용 CAD 자료를 준비한다.

Fixture 검증 목적
기본 사각형 사이트 기본 좌표·객체·출력 정확도
부정형 사이트 복잡한 Geometry 처리
다수 모듈 배치 CAD 모듈 객체 수량
회전된 모듈 Rotation 및 Footprint 정확도
Layer·Block 복합 도면 CAD 구조 보존
Text·Annotation 포함 도면 표현 호환성
단위·좌표 변환 사례 단위 및 Scale 정확도
모듈 0개 도면 빈 배치 처리
비정상 DXF 오류 및 예외 처리

테스트 자료는 합성 데이터 또는 사용 승인이 확인된 자료로 제한한다.

STEP 3. 로컬 CAD 엔진 기준 결과 확보

  • DXF 파일 읽기
  • CAD Audit 실행
  • Layer·Block·Entity 수량 분석
  • 모듈 좌표 및 크기 추출
  • Rotation 및 Footprint 분석
  • DXF 저장 및 재열기
  • 변환 가능한 경우 DWG/PDF 출력
  • 실행시간 및 오류 기록
  • 결과 파일 SHA-256 기록

STEP 4. Autodesk APS 테스트 실행

PoC-23에서 다음 조건이 충족되었는지 먼저 확인한다.

  1. API 인증 가능
  2. 테스트 앱 사용 권한 확보
  3. 필요한 API 기능 지원 확인
  4. 무료·유료 사용 조건 확인
  5. 비용 발생 시 PM 승인
  6. 데이터 외부 전송 승인
  7. 테스트 자료 사용 허가 확보

승인 조건을 충족한 경우에만 실제 APS API 테스트를 수행한다.

조건을 충족하지 못한 경우 APS_LIVE_PENDING으로 기록하고, Mock 또는 문서 검증 결과를 실제 API 테스트 결과로 대체하지 않는다.

STEP 5. CAD 객체 및 Geometry 정확도 비교

다음 항목을 비교한다.

비교 항목 확인 내용
Entity Count 객체 수량 일치 여부
Entity Type 객체 유형 호환성
Layer Layer 구성 및 속성
Block Block 정의와 참조
Position CAD 좌표
Dimension 모듈 폭·길이
Rotation 회전각
Footprint 실제 점유 Geometry
Units 치수 단위
Coordinate System 좌표계 및 기준점
Missing Objects 누락 객체
Unsupported Features 미지원 CAD 기능

좌표와 각도에는 명시된 허용오차를 적용하며, 포맷에 따라 비교 불가능한 속성은 별도로 표시한다.

STEP 6. DXF/DWG/PDF 호환성 및 시각 품질 비교

  • 지원되는 입력 CAD 형식 확인
  • 지원되는 출력 형식 확인
  • 도면 변환 성공 여부 비교
  • 객체 누락·중복 확인
  • 주요 Layer 표시 상태
  • 선종류 및 선가중치 표현
  • 텍스트·주석·치수선 호환성
  • 도면 축척 및 페이지 구성
  • 회전된 모듈 표현
  • 주요 구역의 시각적 차이

정량 Geometry 정확도와 시각적 유사성은 별도 지표로 관리한다.

STEP 7. 실행 성능 및 비용 비교

다음 정보를 기록한다.

  • 테스트 도면 크기
  • CAD Entity 수
  • 처리 대상 모듈 수
  • 전체 실행시간
  • API 호출 횟수
  • CAD 변환 성공·실패 횟수
  • 로컬 CPU 및 메모리 사용량(측정 가능한 경우)
  • APS 실제 과금 또는 예상 과금
  • 반복 실행 결과 차이

실제 청구 금액과 단순 예상 금액을 구분한다.

STEP 8. 데이터 보안 및 운영 복잡도 비교

로컬 엔진

  • 원본 파일의 로컬 처리
  • Python 라이브러리 및 변환 도구 관리
  • 실행환경과 버전 관리
  • 운영 서버의 자원 사용량

Autodesk APS

  • 외부 API 인증 및 접근권한
  • 고객 CAD 파일의 클라우드 전송 여부
  • 외부 처리·보관·삭제 정책
  • 사용량 제한 및 API 장애
  • API 비용과 계약 제약

실제 보안 적합성은 고객 승인 조건과 운영 정책을 기준으로 판단한다.

STEP 9. 엔진 선택 및 Fallback 정책 수립

다음 중 결과에 맞는 운영 방향을 권고한다.

A. LOCAL_ONLY

로컬 CAD 엔진만으로 필요한 기능과 검증 기준을 충족하는 경우.

B. HYBRID_SELECTED_APS

로컬 엔진을 기본으로 사용하면서 APS가 필요한 작업에 한해 승인된 외부 API를 선택적으로 호출하는 경우.

C. DEFER_APS

APS의 인증·기능·비용·보안 또는 테스트 조건이 충분히 검증되지 않아 도입을 보류하는 경우.

자동 Fallback과 수동 승인 조건을 구분하고, 외부 API 장애 시에도 로컬 CAD 처리 기능을 유지하도록 설계한다.

STEP 10. Comparison Matrix 작성

예상 산출물: comparison_matrix.json

주요 필드:

  • Test Case ID
  • Fixture ID / SHA-256
  • Local Engine Version
  • APS API / Version
  • API Authorization Status
  • Input Format
  • Output Format
  • Local Result
  • APS Result
  • Geometry Accuracy
  • Entity Compatibility
  • Visual QA
  • Execution Time
  • Cost Information
  • Security Constraints
  • Verification Status
  • Difference / Warning

STEP 11. 비교 검증 보고서 작성

예상 산출물: engine_comparison_report.md

보고서에는 다음 정보를 포함한다.

  1. 비교 목적 및 범위
  2. 테스트 환경
  3. 테스트 도면 및 Source 정보
  4. 엔진별 기능 지원 범위
  5. 정량 정확도 비교
  6. 시각 품질 비교
  7. 호환성 및 데이터 손실 가능성
  8. 성능 및 비용 비교
  9. 보안 및 운영 제약
  10. 미검증·HOLD 항목
  11. 권장 엔진 운영 방식
  12. PoC-25 MCP 연계 계약

STEP 12. 자동 테스트 및 GitHub 반영

  • 공통 Golden Fixture 준비
  • 로컬 CAD 테스트 자동화
  • 승인된 APS 테스트 실행
  • 비교 결과 JSON 생성
  • 정량 검증 및 반복 실행 테스트
  • 시각 비교 Evidence 작성
  • Windows PowerShell 실행 가이드 작성
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
이상재 로컬 CAD와 APS 기능·정확도·호환성·성능 비교
조영우 Solver 모듈 좌표·Footprint·Rotation 및 수량 검증
황수아 Source·Knowledge·Evidence 추적 및 고객자료 사용 정책 검토
문길래 APS 비용·보안 승인 및 엔진 운영 방식 최종 결정

4. 제출 산출물

  1. 공통 CAD Golden Fixture
  2. 로컬 CAD 엔진 기준 실행 결과
  3. 승인된 APS 실제 실행 결과 또는 HOLD 기록
  4. CAD 객체 및 Geometry 정량 비교 결과
  5. DWG/PDF 변환·시각 품질 비교 결과
  6. 성능 및 비용 비교 자료
  7. 보안·운영 위험 검토 결과
  8. comparison_matrix.json
  9. engine_comparison_report.md
  10. 엔진 선택 및 Fallback 정책
  11. PoC-25 MCP Tool 연계 계약
  12. pytest 및 실행 Evidence
  13. GitHub PR 및 PM 검토 결과

5. 완료 기준 (PASS)

  • 두 엔진의 실제 기능 지원 범위 확인
  • 동일 Golden Fixture를 사용한 비교 설계
  • 로컬 CAD 기준 결과 확보
  • APS 인증·비용·보안 Gate 확인
  • 승인 가능한 범위의 APS 테스트 수행
  • 미지원·미승인 항목은 NOT_SUPPORTED 또는 HOLD 처리
  • Entity·Layer·Block 수량 비교
  • 좌표·치수·회전각·Footprint 정확도 비교
  • DXF/DWG/PDF 호환성 검토
  • 실제 시각 QA Evidence 확보
  • 반복 실행 재현성 검증
  • 실행시간 및 API 비용 정보 기록
  • 고객자료 외부 전송·보안 조건 검토
  • Local/Hybrid/Defer 운영 권고 작성
  • Comparison Matrix 및 보고서 작성
  • PoC-25 엔진 선택·Fallback 계약 작성
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

주의: APS 실제 호출이 불가능한 경우 문서 기반 비교와 로컬 검증은 완료할 수 있으나, 실행되지 않은 APS 항목을 정확도 검증 PASS로 표시하지 않는다.

6. 개발 및 검증 원칙

  • Autodesk APS가 로컬 CAD 엔진보다 반드시 우수하다고 가정하지 않는다.
  • 실제 지원되지 않는 기능을 억지로 1:1 비교하지 않는다.
  • 동일한 입력과 검증 기준을 사용하여 비교한다.
  • 정량 정확도와 시각 품질을 구분한다.
  • 확인되지 않은 API 성능이나 비용을 추정값 없이 확정하지 않는다.
  • 고객 CAD 파일을 승인 없이 외부로 업로드하지 않는다.
  • PM 승인 없는 유료 APS 호출을 수행하지 않는다.
  • API Key, Client Secret, Access Token을 GitHub에 저장하지 않는다.
  • APS 장애 시 로컬 처리 가능성을 유지한다.
  • 실제 설계 적합성은 최종적으로 설계 전문가가 검토한다.

7. GitHub 관련 문서

GitHub Issue

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/165

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

선행 PoC-22

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/163

선행 PoC-23

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/164

8. 후속 개발 연계

다음 작업: PoC-25 — MCP 기반 L2 Knowledge → L1 설계 End-to-End 통합

PoC-24에서 검증한 CAD 엔진과 운영 정책을 적용하여 MCP 기반으로 전체 자동설계 흐름을 연결한다.

주요 흐름:

L2 Source 분석 → Engineering Knowledge 승인 및 선택 → 신규 L1 사이트 분석 → 자동 패널 배치 → 신규 DXF 생성 → Authorized Delta → 수량·BOQ 검증 → CAD QA → 결과 보고

PoC-25는 문길래 PM이 총괄하고 황수아, 이상재, 조영우가 각 전문 영역을 통합한다.

Actions

Also available in: PDF Atom