Project

General

Profile

Actions

Feature #902

open
길문 영조

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

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

[PoC-22] DXF 정량 검증 및 DWG/PDF 시각 품질 검증

Feature #902: [PoC-22] DXF 정량 검증 및 DWG/PDF 시각 품질 검증

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

Status:
New
Priority:
High
Assignee:
Start date:
01/04/2027
Due date:
01/13/2027 (Due in 57 days)
% Done:

0%

Estimated time:

Description

PoC-22. DXF 정량 검증 및 DWG/PDF 시각 품질 검증

1. 작업 개요

본 PoC는 신규 L1 태양광 자동설계 과정에서 생성된 DXF 도면의 구조와 Geometry를 정량적으로 검증하고, DWG/PDF 변환 결과의 시각적 품질을 검토하는 CAD Drawing Quality Assurance(QA) 기능을 구축하는 작업이다.

PoC-19의 신규 DXF Candidate, PoC-20의 Authorized Delta 검증 결과 및 PoC-21의 수량·BOQ 분석 결과를 종합적으로 활용한다.

핵심 목표는 DXF 파일 생성 성공, CAD 객체 정합성, 시각적 품질 및 설계 전문가의 최종 승인 여부를 명확하게 분리해 관리하는 것이다.

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

상위 Redmine 일감: #867

담당: 이상재

PM 및 검토: 문길래

협력: 조영우, 황수아

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

선행 작업: PoC-19, PoC-20, PoC-21

2. 세부 작업

STEP 1. 기존 CAD QA 자산 조사

  • 기존 DXF Parser Validation 기능 확인
  • CAD Audit 및 객체 수량 검증 코드 조사
  • B001/B006 도면 생성·검증 Evidence 확인
  • 기존 DXF/DWG/PDF 변환 및 비교 기능 조사
  • 도면 시각 검증 도구 및 실행환경 확인
  • 기존 기능의 REUSE / EXTEND / NEW / HOLD 분류

STEP 2. 검증 대상 도면 및 Evidence 확인

다음 입력 정보를 확인한다.

  • L1 Controlled Blank Source ID 및 SHA-256
  • 신규 DXF Candidate ID 및 SHA-256
  • Solver Layout Candidate ID
  • Applied Engineering Knowledge ID 및 Version
  • Authorized Delta Manifest
  • 변경 전후 CAD Diff Report
  • 패널 수량 및 BOQ 영향 분석 결과
  • CAD Generator Version 및 실행 Commit SHA

검증 대상 도면과 Source Revision이 일치하지 않으면 QA를 HOLD 처리한다.

STEP 3. DXF 파일 정량 검증

다음 항목을 자동 검증한다.

검증 항목 검증 내용
DXF Parsing DXF 재열기 및 구조 분석 성공
DXF Audit 파일 오류 및 구조적 이상 확인
Layer Layer 목록·속성·개수 검증
Block Block 정의 및 참조 검증
Entity 객체 유형 및 개수 검증
Geometry 좌표·형상·치수 검증
Rotation 모듈 회전각 검증
Module Count Solver와 DXF 모듈 수 일치
Units / CRS 단위 및 좌표계 일치
Authorized Delta 승인 범위 외 변경사항 없음

DXF 파일을 정상적으로 읽을 수 있다는 사실만으로 설계 결과가 올바르다고 판단하지 않는다.

STEP 4. Solver 및 DXF 배치 결과 교차검증

  • Solver Module Position과 CAD 좌표 비교
  • Module Footprint 크기 비교
  • 모듈 회전각 비교
  • 전체 및 구역별 모듈 수량 비교
  • 배치 누락·중복 객체 확인
  • 사이트 경계 및 제외영역 침범 확인
  • 승인된 이격거리 위반 여부 확인
  • Solver 결과와 생성 도면의 정합성 판정

좌표 및 Geometry 비교에는 명시된 허용오차를 적용한다.

STEP 5. Authorized Delta 및 원본 보존 검증

PoC-20의 결과를 재확인한다.

  • Controlled Blank 원본 SHA 불변
  • 기존 보호 Layer 및 Block 보존
  • 기존 보호 Entity 속성 및 Geometry 보존
  • 승인된 추가·수정·삭제 범위 준수
  • 승인되지 않은 변경사항 0건
  • 변경 전후 Diff Report 검증
  • 생성 DXF와 Authorized Delta Manifest 일치

STEP 6. DWG/PDF 변환 및 렌더링 검증

승인된 로컬 도구와 환경을 이용하여 다음을 검증한다.

  1. DXF → DWG 변환
  2. DXF 또는 DWG → PDF 출력
  3. 변환된 CAD 파일 재열기
  4. PDF 정상 출력 여부 확인
  5. 도면 전체 영역 표시 여부 확인
  6. 축척 및 좌표 표현 검토
  7. 주요 Layer·Line·Text 표시 상태 확인
  8. 객체 누락 및 잘림 여부 확인
  9. 변환 전후 모듈 위치와 수량의 시각적 일치 확인

실제 렌더링이 불가능한 경우 시각 QA를 PASS로 표시하지 않고 VISUAL_PENDING 또는 HOLD로 기록한다.

STEP 7. 시각 품질 검증

다음 사항을 확인한다.

  • 도면 전체 배치 상태
  • 모듈 정렬 및 회전 표시
  • 사이트 경계와 패널 간 관계
  • 장애물 및 제외영역 표현
  • Layer별 선종류 및 표현
  • 텍스트·주석·도면 표기
  • 출력 축척 및 페이지 배치
  • 누락·중복·잘림 객체 여부
  • 주요 구역 확대 화면 검토

자동 이미지 비교와 시각적 확인을 활용할 수 있으나, 이미지 비교만으로 엔지니어링 적합성을 승인하지 않는다.

STEP 8. QA 상태 및 판정 기준 정의

검증 상태는 다음과 같이 분리한다.

상태 의미
QUANT_PASS DXF 정량 검증 통과
QUANT_FAIL 정량 검증 실패
VISUAL_PASS 실제 시각 검증 통과
VISUAL_FAIL 시각 검증 실패
VISUAL_PENDING 시각 검증 미수행 또는 결과 미확정
ENGINEERING_REVIEW_REQUIRED 설계 전문가 검토 필요
HOLD 필수 검증 조건 미충족

PoC 최종 PASS는 사전에 정의한 필수 검증 Gate가 모두 충족된 경우에만 부여한다.

STEP 9. QA Report 데이터 모델 구축

예상 산출물: qa_report.json

주요 필드:

  • QA Run ID
  • Drawing Candidate ID
  • Source ID / SHA-256 / Revision
  • Applied Rule IDs / Versions
  • Solver Version
  • CAD Generator Version
  • DXF Parsing Status
  • DXF Audit Status
  • Layer / Block / Entity Validation
  • Geometry / Rotation Validation
  • Module Count Validation
  • Authorized Delta Validation
  • DWG Conversion Status
  • PDF Rendering Status
  • Visual QA Status
  • Engineering Review Status
  • Overall QA Status
  • Evidence Locator
  • Warning / HOLD Reason

사람이 확인할 수 있는 Markdown 또는 HTML 요약 보고서도 함께 작성한다.

STEP 10. 오류 및 경계조건 테스트

다음 테스트를 수행한다.

  1. 정상 DXF Candidate
  2. 누락된 CAD Entity
  3. 잘못된 모듈 회전각
  4. Layer 속성 이상
  5. Source Revision 불일치
  6. 모듈 수량 불일치
  7. 승인 범위 외 CAD 변경
  8. PDF 출력 시 객체 잘림
  9. DWG/PDF 렌더링 도구 사용 불가
  10. 모듈 0개 배치
  11. 좌표계 및 단위 불명확
  12. Geometry 허용오차 초과

정량 QA 실패와 시각 QA 실패를 구분하여 기록한다.

STEP 11. 실제 도면 검증 및 전문가 검토 자료 준비

  • 허가된 실제 L1 Candidate DXF 분석
  • CAD 객체 및 Geometry 검증 결과 기록
  • 주요 도면 화면 및 PDF Evidence 수집
  • 검증 불가 또는 추가 확인 항목 분류
  • Engineering Knowledge 및 Source 버전 추적
  • 전문가 검토가 필요한 설계조건 정리

실제 설계 전문가의 최종 승인과 PoC 기술 검증 결과는 별도로 관리한다.

STEP 12. GitHub 반영 및 결과 제출

  • CAD 정량 QA 코드 구현
  • DWG/PDF 변환 및 시각 검증 가이드 작성
  • QA Report 및 JSON Schema 작성
  • Golden Fixture 및 pytest 테스트
  • 실제 정량·시각 Evidence 기록
  • Windows PowerShell 실행 가이드 작성
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
이상재 CAD 정량 검증, DWG/PDF 변환·시각 품질 검증
조영우 Solver 배치 결과·수량·Geometry 정합성 검토
황수아 Source·Rule·Evidence 추적 및 승인 상태 검토
문길래 최종 QA Gate·품질·GitHub PR 검토 및 전문가 검수 조정

4. 제출 산출물

  1. DXF 정량 QA 기능
  2. CAD Layer·Block·Entity·Geometry 검증 결과
  3. Solver/DXF/Authorized Delta 정합성 검증
  4. DWG/PDF 변환 및 시각 QA 결과
  5. qa_report.json 및 JSON Schema
  6. Markdown 또는 HTML QA 요약 보고서
  7. Golden Fixture 및 pytest 테스트
  8. 실제 CAD/PDF 화면 Evidence
  9. HOLD·실패·전문가 검토 필요 목록
  10. PoC-23~25 연계 QA 계약
  11. Windows 실행 가이드 및 GitHub PR

5. 완료 기준 (PASS)

  • 기존 CAD QA 자산 조사 완료
  • DXF Parsing 및 Audit 검증
  • Layer·Block·Entity 구조 검증
  • Solver와 CAD 모듈 수량 일치
  • 모듈 좌표·Footprint·Rotation 검증
  • 사이트 경계·장애물·이격조건 위반 없음
  • Authorized Delta 및 원본 보존 검증
  • DWG/PDF 변환 및 실제 렌더링 확인
  • 도면 전체 및 주요 구역 시각 검증
  • 객체 누락·중복·잘림 여부 확인
  • QUANT/VISUAL/ENGINEERING 검증 상태 분리
  • 렌더링 불가 시 VISUAL_PENDING/HOLD 처리
  • Source·Rule·Solver·Generator Version 추적
  • Golden Fixture 및 pytest 테스트 PASS
  • 실제 도면 QA Evidence 확보
  • QA Report 및 검토 필요 목록 작성
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

6. 개발 및 검증 원칙

  • DXF 파일 생성 성공만으로 CAD QA가 완료되었다고 판단하지 않는다.
  • 정량 검증과 시각 검증을 별도로 수행한다.
  • 실제 시각 검증 없이 PASS로 표시하지 않는다.
  • DXF/DWG/PDF 변환 과정의 오류와 누락을 명확히 기록한다.
  • 승인되지 않은 CAD 변경사항을 허용하지 않는다.
  • CAD 객체 수량과 실제 설계 승인 수량을 혼동하지 않는다.
  • QA PASS를 최종 설계 납품 승인으로 간주하지 않는다.
  • 원본 DWG/DXF 및 설계자료를 임의로 수정하지 않는다.
  • 고객 자료를 외부 클라우드에 무단 업로드하지 않는다.
  • 승인되지 않은 Autodesk APS 유료 API 호출은 수행하지 않는다.
  • 최종 설계 적합성은 설계 전문가 검토를 거친다.

7. GitHub 관련 문서

GitHub Issue

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

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-23 — Autodesk APS 인증·API 비용·보안 검증

PoC-22의 로컬 CAD 검증 결과를 기준으로 Autodesk APS 인증 및 클라우드 CAD 기능의 보안·비용·기술적 적용 가능성을 검토한다.

PoC-24에서는 Autodesk APS와 로컬 CAD 엔진의 변환 결과 및 검증 정확도를 비교하고, PoC-25에서 전체 MCP 워크플로를 통합 검증한다.

길문 Updated by 길래 문 22 days ago Actions #1

  • Assignee changed from 상재 이 to 영우 조

길문 Updated by 길래 문 22 days ago Actions #2

  • Priority changed from Normal to High
Actions

Also available in: PDF Atom