Feature #902
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-22] DXF 정량 검증 및 DWG/PDF 시각 품질 검증
0%
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 변환 및 렌더링 검증¶
승인된 로컬 도구와 환경을 이용하여 다음을 검증한다.
- DXF → DWG 변환
- DXF 또는 DWG → PDF 출력
- 변환된 CAD 파일 재열기
- PDF 정상 출력 여부 확인
- 도면 전체 영역 표시 여부 확인
- 축척 및 좌표 표현 검토
- 주요 Layer·Line·Text 표시 상태 확인
- 객체 누락 및 잘림 여부 확인
- 변환 전후 모듈 위치와 수량의 시각적 일치 확인
실제 렌더링이 불가능한 경우 시각 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. 오류 및 경계조건 테스트¶
다음 테스트를 수행한다.
- 정상 DXF Candidate
- 누락된 CAD Entity
- 잘못된 모듈 회전각
- Layer 속성 이상
- Source Revision 불일치
- 모듈 수량 불일치
- 승인 범위 외 CAD 변경
- PDF 출력 시 객체 잘림
- DWG/PDF 렌더링 도구 사용 불가
- 모듈 0개 배치
- 좌표계 및 단위 불명확
- 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. 제출 산출물¶
- DXF 정량 QA 기능
- CAD Layer·Block·Entity·Geometry 검증 결과
- Solver/DXF/Authorized Delta 정합성 검증
- DWG/PDF 변환 및 시각 QA 결과
qa_report.json및 JSON Schema- Markdown 또는 HTML QA 요약 보고서
- Golden Fixture 및 pytest 테스트
- 실제 CAD/PDF 화면 Evidence
- HOLD·실패·전문가 검토 필요 목록
- PoC-23~25 연계 QA 계약
- 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 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-23 — Autodesk APS 인증·API 비용·보안 검증
PoC-22의 로컬 CAD 검증 결과를 기준으로 Autodesk APS 인증 및 클라우드 CAD 기능의 보안·비용·기술적 적용 가능성을 검토한다.
PoC-24에서는 Autodesk APS와 로컬 CAD 엔진의 변환 결과 및 검증 정확도를 비교하고, PoC-25에서 전체 MCP 워크플로를 통합 검증한다.