Feature #872
closedFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-05] L2 DXF 파일 읽기 및 오류 처리 자동화
100%
Description
PoC-05. L2 DXF 파일 읽기 및 오류 처리 자동화¶
1. 작업 개요¶
본 PoC는 기존 L2 태양광 설계도면의 DXF 파일을 안전하게 읽고, 파일 구조와 기본 메타데이터를 추출하며, 손상·누락·형식 오류를 자동으로 분류하는 기능을 구축하는 작업이다.
기존 GitHub 저장소에 확보된 DWG→DXF 변환 및 ezdxf 분석 기능을 우선 조사하고 재사용한다.
PoC-04의 Source ID 기반 파일 접근 및 무결성 검증 기능을 연계하여 검증된 DXF 분석본만 읽는 구조를 구현한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/146
상위 Redmine 일감: #867
담당: 이상재
PM 및 검토: 문길래
협력: 황수아, 조영우
계획 기간: 2026-11-09 ~ 2026-11-13
선행 작업: PoC-01 기존 자산 조사, PoC-04 Source 조회·권한·무결성 검증
2. 세부 작업¶
STEP 1. 기존 DXF 처리 자산 조사¶
- 기존 DWG→DXF 변환 스크립트 및 실행환경 확인
ezdxf기반 파일 분석 코드 조사- 기존 Parser Validation 및 CAD Audit 테스트 확인
- DWG 원본과 DXF 분석본의 관계 및 파일 버전 관리 방식 확인
- 기존 기능의 REUSE / EXTEND / NEW / HOLD 분류
기존 변환 및 파서 검증 이력은 재사용하되, 이번 PoC의 테스트를 실제 실행하지 않았다면 신규 PASS 결과로 기록하지 않는다.
STEP 2. DXF 파일 읽기 기능 구현¶
- Source ID를 이용해 허용된 DXF 파일 조회
- Python
ezdxf기반 파일 열기 - DXF 버전 및 기본 헤더 정보 추출
- Modelspace 객체 수 확인
- DXF 단위 정보 확인
- 파일을 수정하지 않는 읽기 전용 분석 수행
단위 정보가 없거나 불명확한 경우 임의로 mm 또는 m로 확정하지 않는다.
STEP 3. DXF 기본 정보 반환 기능¶
다음 조회 기능을 구현하거나 기존 MCP 도구를 확장한다.
cad_read_source
입력:
source_id: 조회 대상 Source 식별자
출력:
- Source ID
- 파일 SHA-256
- DXF 버전
- 단위 코드 및 확인 상태
- Modelspace 객체 수
- DXF Audit 오류 수
- Parsing 상태
- Warning 및 오류 정보
임의의 파일 경로를 직접 받아 접근하는 방식보다 PoC-04에서 검증한 Source ID 접근 방식을 우선 적용한다.
STEP 4. 오류 및 예외 처리¶
다음 상황을 명확하게 구분한다.
- 정상 DXF 파일
- 존재하지 않는 Source ID
- DXF 파일 누락
- DXF 형식이 아닌 파일
- 손상된 DXF 파일
- DXF Audit 오류
- 지원되지 않는 DXF 버전 또는 객체
- 접근 권한이 없는 파일
- 단위 정보가 불명확한 파일
오류가 발생하더라도 MCP 서버가 비정상 종료되지 않도록 통제된 응답을 반환한다.
STEP 5. 보안 및 안정성 검증¶
- 허용된 Source만 DXF 분석 수행
- 원본 DWG/DXF 파일 수정 금지
- 분석 전후 SHA-256 비교
- 비정상적으로 큰 파일에 대한 처리 제한 검토
- 파일 읽기 실패 시 예외 메시지 처리
- 고객 파일 내용 및 민감 경로의 불필요한 노출 방지
- 외부 클라우드 업로드 및 Autodesk APS 호출 금지
STEP 6. 자동 테스트 및 실제 실행 검증¶
- 정상 DXF Golden Fixture 테스트
- 손상 파일 및 빈 파일 테스트
- 누락 파일 테스트
- 접근 권한 위반 테스트
- 단위 정보 불명확 사례 테스트
- DXF Audit 및 Parsing 상태 검증
- MCP Tool 호출 테스트
- 원본 파일 SHA 변경 여부 확인
합성 테스트 파일과 실제 L2 분석본의 검증 결과는 구분하여 보고한다.
STEP 7. GitHub 반영¶
- DXF Reader 및 MCP Tool 코드 반영
- 테스트 코드와 샘플 입력·출력 작성
- Windows PowerShell 실행 가이드 작성
- 실제 실행 로그 및 Evidence 제출
- GitHub PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 이상재 | DXF Reader, MCP Tool 연동, 오류 처리, 테스트 |
| 문길래 | 기술 범위 및 PASS 기준 검토, PR 승인 |
| 황수아 | Source ID, Manifest, 무결성 검증 기능 연계 |
| 조영우 | 후속 L1 설계 입력 및 Geometry 데이터 구조 검토 |
4. 제출 산출물¶
- DXF 파일 읽기 및 기본 메타데이터 추출 기능
- Source ID 기반 DXF 조회 Tool
- DXF 오류 유형 및 상태 분류 규격
- 입력·출력 JSON Schema 및 예시
- pytest 자동 테스트와 실제 실행 Evidence
- Source 무결성 검증 결과
- Windows 실행 가이드
- GitHub PR 및 검토 결과
5. 완료 기준 (PASS)¶
- 기존 DXF 파서 및 변환 자산 조사 완료
- Source ID 기반 정상 DXF 조회 성공
- DXF 버전·단위·기본 객체 수 추출 성공
- DXF Audit 결과 정상 반환
- 파일 누락·손상·형식 오류 구분
- 접근 권한 위반 차단
- 미확정 단위 및 버전 정보 명시
- DXF 원본 변경 없음
- 합성 Golden Fixture 테스트 PASS
- 허가된 실제 DXF 실행 결과 확인(자료가 제공되는 경우)
- MCP Tool 실제 호출 검증
- 실행 Evidence 및 가이드 작성
- GitHub PR 생성 및 PM 검토 완료
- main 병합 및 PoC-06 연동 준비 완료
6. 개발 및 검증 원칙¶
- 기존 코드 재사용을 우선한다.
- 원본 DWG는 변경하지 않는다.
- DXF는 허용된 분석본만 사용한다.
- 단위와 좌표계가 불명확할 경우 추측하지 않는다.
- DXF를 정상적으로 읽었다는 사실만으로 설계 적합성을 승인하지 않는다.
- Autodesk APS 및 외부 유료 API는 사용하지 않는다.
- 테스트 결과와 기존 저장소에 기록된 과거 검증 결과를 구분한다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/146
25개 PoC 상세 로드맵
전체 업무계획서
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-06 — CAD Layer·Block·Entity·좌표 정보 추출
PoC-05에서 검증한 DXF Reader를 재사용하여 CAD 객체, 레이어, 블록, 좌표 및 Geometry를 구조화된 데이터로 추출한다.