Feature #873
closedFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-06] CAD Layer·Block·Entity·좌표 정보 추출
100%
Description
PoC-06. CAD Layer·Block·Entity·좌표 정보 추출¶
1. 작업 개요¶
본 PoC는 PoC-05에서 읽기 및 무결성 검증을 완료한 기존 L2 DXF 도면으로부터 CAD Layer, Block, Entity, 좌표 및 Geometry 데이터를 구조화된 JSON으로 추출하는 기능을 구현하는 작업이다.
향후 L2 모듈 배치 패턴 분석, Engineering Knowledge 추출, 신규 L1 태양광 패널 자동설계에 필요한 CAD 데이터 분석 기반을 구축한다.
기존 저장소의 CAD 분석 코드와 검증 자산을 우선 재사용하고, 필요한 기능만 확장한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/147
상위 Redmine 일감: #867
담당: 이상재
PM 및 검토: 문길래
협력: 황수아, 조영우
계획 기간: 2026-11-09 ~ 2026-11-20
선행 작업: PoC-04 Source 접근·무결성 검증, PoC-05 DXF Reader 구축
2. 세부 작업¶
STEP 1. 기존 CAD 분석 자산 조사¶
- 기존 Layer·Block·Entity 분석 스크립트 확인
- DXF Parser 및 Geometry 관련 테스트 코드 조사
- CAD 좌표·단위 변환 기능 확인
- 기존 코드의 재사용·확장·신규 구현 범위 구분
- PoC-05의 DXF Reader 및 Source ID 연계 방식 확인
STEP 2. Layer 정보 추출¶
다음 정보를 추출한다.
- Layer 이름 및 목록
- Layer별 Entity 수
- Layer 색상 및 선종류 등 주요 속성
- Layer 표시 및 잠금 상태
- Modelspace와 Paperspace 구분
- Layer별 사용 객체 유형
예상 기능: cad_list_layers
STEP 3. Block 정보 추출¶
- Block 정의 목록 조회
- INSERT를 통한 Block 참조 확인
- Block 삽입 좌표 추출
- Scale 및 Rotation 속성 확인
- 중첩 Block 및 내부 객체 구조 분석
- Block 정의와 실제 배치된 참조 인스턴스 구분
- Block 참조의 좌표 변환 검증
예상 기능: cad_list_blocks
STEP 4. Entity 및 Geometry 추출¶
다음과 같은 대표 CAD 객체를 분석한다.
| Entity 유형 | 주요 추출 정보 |
|---|---|
| LINE | 시작점, 끝점, 길이 |
| LWPOLYLINE | Vertex, 폐합 여부, 형상 |
| INSERT | Block 이름, 삽입점, 회전, 크기 배율 |
| TEXT / MTEXT | 문자 내용, 위치, 회전 |
| HATCH | 패턴 및 경계 관련 정보 |
| 기타 Entity | 객체 유형, Layer, 식별자 및 지원 가능한 속성 |
공통적으로 Entity 유형, Layer, Handle, 좌표, Bounding Box 등을 추출할 수 있는 범위를 정의한다.
예상 기능: cad_extract_entities
STEP 5. 좌표계·단위 및 변환 검증¶
- DXF 단위 정보 확인
- 객체별 좌표와 도면 내 위치 확인
- Block 삽입·회전·스케일 변환 적용
- 중첩 Block의 좌표 변환 검증
- 좌표 정밀도 및 허용오차 정의
- 단위나 좌표계가 불명확한 경우 경고 또는 HOLD 처리
임의로 좌표계나 단위를 추정하여 확정하지 않는다.
STEP 6. MCP Tool 연동¶
다음 세 가지 조회 Tool을 구현하거나 기존 기능과 연결한다.
① cad_list_layers
Source ID로 DXF 도면의 Layer 목록과 주요 속성을 조회한다.
② cad_list_blocks
Block 정의 및 삽입 참조 정보를 조회한다.
③ cad_extract_entities
Entity 유형, Layer, 조회 개수 등 조건을 지정하여 객체 및 Geometry 정보를 조회한다.
모든 Tool은 PoC-04의 접근 권한과 PoC-05의 DXF Reader 계약을 준수한다.
STEP 7. 자동 테스트 및 검증¶
- Layer별 Entity 수 검증
- Block 정의와 INSERT 참조 수 비교
- LINE 및 LWPOLYLINE 좌표 검증
- Rotation·Scale 적용 결과 검증
- 중첩 Block 좌표 변환 테스트
- Modelspace/Paperspace 구분 테스트
- 오류 및 지원하지 않는 Entity 처리 테스트
- 원본 SHA-256 변경 여부 확인
- MCP Tool 실제 호출 테스트
합성 Golden DXF와 허가된 L2 실제 분석본의 테스트 결과를 구분하여 기록한다.
STEP 8. GitHub 반영 및 결과 제출¶
- CAD 분석 코드 및 MCP Tool 작성
- JSON Schema 및 실행 예시 문서화
- pytest 자동 테스트 작성
- 실행 로그, 테스트 결과 및 Evidence 기록
- Windows PowerShell 실행 가이드 작성
- GitHub PR 생성 및 PM 검토
- main 병합 후 PoC-07 연계 준비
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 이상재 | CAD Layer·Block·Entity·Geometry 분석 기능 구현 및 테스트 |
| 문길래 | 전체 기술 범위·품질 검증, PR 승인 |
| 황수아 | Engineering Knowledge 추출에 필요한 CAD 데이터 구조 검토 |
| 조영우 | L1 사이트 및 배치 Solver와 연결할 Geometry 계약 검토 |
4. 제출 산출물¶
- CAD Layer 분석 기능
- CAD Block 정의·참조 분석 기능
- CAD Entity 및 Geometry 추출 기능
- MCP 조회 Tool 3개
- CAD 분석 JSON Schema 및 샘플 결과
- Golden DXF 테스트 Fixture 및 pytest 결과
- 실제 DXF 분석 실행 Evidence
- Windows 환경 실행 가이드
- GitHub PR 및 PM 검토 결과
5. 완료 기준 (PASS)¶
- 기존 CAD 분석 자산 조사 및 재사용 범위 확정
- Layer 목록·주요 속성 및 Entity 수 정상 추출
- Block 정의·INSERT 참조 분석 성공
- 주요 Entity 유형 및 Geometry 추출 성공
- Modelspace/Paperspace 구분
- Block 회전·스케일·중첩 참조 좌표 변환 검증
- Golden DXF의 객체 수와 좌표가 기준값과 일치
- 미지원 객체 및 불명확한 단위·좌표계 처리
- MCP Tool 3개 실제 호출 검증
- Source 접근 권한 검증 및 원본 변경 없음
- pytest 및 오류 테스트 PASS
- 실행 Evidence와 JSON Schema 문서 작성
- GitHub PR 생성 및 PM 검토 완료
- main 병합 및 PoC-07 연동 준비 완료
6. 개발 및 검증 원칙¶
- 기존 저장소에 구현된 CAD 분석 기능을 우선 재사용한다.
- 원본 DWG 및 DXF 분석본을 임의로 수정하지 않는다.
- Block 정의 수와 실제 배치된 객체 수를 혼동하지 않는다.
- Layer 이름만으로 객체의 설계 의미를 단정하지 않는다.
- 정확히 확인되지 않은 좌표·단위·참조 관계를 추정하지 않는다.
- CAD 객체 추출에 성공했다고 설계 규칙까지 검증되었다고 판단하지 않는다.
- 고객 설계자료의 외부 클라우드 전송과 Autodesk APS 유료 API 호출은 수행하지 않는다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/147
25개 PoC 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
기존 B001/B006 도면 작성·검증 근거
8. 후속 개발 연계¶
다음 작업: PoC-07 — L2 태양광 모듈 배치 객체 및 패턴 분석
PoC-06에서 추출한 Layer, Entity 및 Geometry 데이터를 기반으로 L2 태양광 모듈 배치의 반복 패턴, 객체 속성 및 설계 관련 관찰 정보를 분석한다.
관찰된 배치 패턴은 곧바로 Approved Engineering Knowledge로 승격하지 않고 후속 PoC에서 추가 검증한다.