Project

General

Profile

Actions

Feature #872

closed
길문 상이

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

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

[PoC-05] L2 DXF 파일 읽기 및 오류 처리 자동화

Feature #872: [PoC-05] L2 DXF 파일 읽기 및 오류 처리 자동화

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

Status:
Closed
Priority:
High
Assignee:
Start date:
11/09/2026
Due date:
11/13/2026
% Done:

100%

Estimated time:

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. 오류 및 예외 처리

다음 상황을 명확하게 구분한다.

  1. 정상 DXF 파일
  2. 존재하지 않는 Source ID
  3. DXF 파일 누락
  4. DXF 형식이 아닌 파일
  5. 손상된 DXF 파일
  6. DXF Audit 오류
  7. 지원되지 않는 DXF 버전 또는 객체
  8. 접근 권한이 없는 파일
  9. 단위 정보가 불명확한 파일

오류가 발생하더라도 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. 제출 산출물

  1. DXF 파일 읽기 및 기본 메타데이터 추출 기능
  2. Source ID 기반 DXF 조회 Tool
  3. DXF 오류 유형 및 상태 분류 규격
  4. 입력·출력 JSON Schema 및 예시
  5. pytest 자동 테스트와 실제 실행 Evidence
  6. Source 무결성 검증 결과
  7. Windows 실행 가이드
  8. 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 상세 로드맵

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-06 — CAD Layer·Block·Entity·좌표 정보 추출

PoC-05에서 검증한 DXF Reader를 재사용하여 CAD 객체, 레이어, 블록, 좌표 및 Geometry를 구조화된 데이터로 추출한다.

상이 Updated by 상재 이 21 days ago Actions #1

  • % Done changed from 0 to 90

상이 Updated by 상재 이 21 days ago Actions #2

[PoC-05] 개발 완료 — PR #187 리뷰 대기 (진척도 90%)

■ 결과 (Windows .venv Python 3.14.6, ezdxf 1.4.4)

  • PR: https://github.com/GilbertMoon/icn-solar-cad-agent/pull/187
  • 코드 9cdd7d9 / Evidence 3c782fe (pocs/poc_05_dxf_read/result.json)
  • automated_status=PASS. 실제 stdio MCP 호출로만 판정
  • 케이스 21/21 PASS: 정상(ASCII/binary/R12), 단위 미지정·잘못된 단위, audit 오류, 미지원 엔티티,
    손상, DXF 아님, DWG, 빈 파일, 파일 없음, 미등록 ID, 경로 이탈, ACL 없음, 비합성 자료, SHA 불일치, 크기·객체 제한
  • 원본 SHA 전후 일치(변경 0건), 경로·비밀정보 누출 0건, 출력 스키마 고정(PoC-06 입력 계약)
  • pytest 94 passed / 1 skipped. skip은 Windows symlink 권한 문제로 허용했고, Linux에서는 95/95 통과

■ 구현 방식

  • MCP tool cad_read_source(source_id): 파일 경로는 받지 않고 등록된 ID만 받음, read-only
  • 기존 reader 재사용(EXTEND): validate_single_dxf.fingerprint, extract_dxf_scoped_text.classify
  • 단위($INSUNITS)는 추정하지 않음: DECLARED / UNSPECIFIED / INVALID로 구분

■ 예외·미결

  • PoC-04 미병합 → Source-ID gate는 로컬 stub(내 제안). PoC-04 병합 후 교체 필요
  • 실제 L2 허가본 실행: NOT_RUN (PM 10/27 합성 데이터 전용 규칙)
  • 입력 제한 50 MiB / 50만 객체는 내 제안(이슈에 수치 없음)
  • Codex 독립 리뷰 → PM 검토·squash 병합 후 100%

■ 다음: PoC-06(#873) 레이어·블록·좌표·단위 변환

상이 Updated by 상재 이 21 days ago Actions #3

[PoC-05] Codex 리뷰 반영 — PR #187 재리뷰 대기 (진척도 90% 유지)

■ Codex 1차 리뷰: REQUEST_CHANGES (P2 3건) → 모두 수정

  • P2-1: 등록 SHA와 실제로 파싱한 바이트가 분리될 수 있었음 → 파일을 한 번만 읽고, SHA 비교·판별·파싱을 모두 그 바이트로 수행. 파싱 중 파일을 교체했다가 원복해도 원본 SHA·geometry 유지 회귀 추가
  • P2-2: 권한·I/O 오류를 FORMAT_NOT_DXF로 오분류 → SOURCE_READ_DENIED / SOURCE_IO_ERROR 코드 신설
  • P2-3: 파서 오류 원문(경로 포함 가능)이 응답에 노출 → 메시지는 예외 타입·행 번호만, redact 적용. 합성 경로 probe 케이스 C22 추가, 누출 검사를 모든 tool 출력으로 확대

■ 결과 (Windows .venv Python 3.14.6)

  • 코드 5b67c85 / Evidence 3e4fd1a
  • automated_status=PASS, 케이스 22/22, pytest 111 passed / 1 skipped(Windows symlink 권한 문제로 허용)
  • 기존 fixture 바이트 변경 없음, 고객 자료 사용 없음

■ 대기: Codex 재리뷰 → PM 검토·squash 병합 후 100%

상이 Updated by 상재 이 21 days ago Actions #4

  • % Done changed from 90 to 100

[PoC-05] PM 승인·병합 완료 (진척도 100%)

■ 결과

  • PR #187 squash merge: 97feab0 (PM 판정 APPROVED_FOR_POC / MERGED)
  • 자동 검증 22/22 PASS, pytest 111 passed / 1 skipped (Windows symlink 권한 문제로 허용)
  • Codex P2 3건 수정 후 재리뷰 APPROVE

■ PM 조건부 승인 사항

  • PoC-04 Source Registry stub: 합성 데이터 기반 1차 PoC 용도로 조건부 승인
  • SOLAR_MCP_SOURCE_REGISTRY로 CAD 도구를 켜는 방식 승인
  • 입력 제한 50 MiB / 50만 객체: 1차 PoC 임시값

■ 후속

  • 실제 L2 도면 검증: NOT_RUN 유지, 후속 통합 검증 대상
  • PoC-04 병합 후 실제 Source Registry 연동 및 회귀 검증 별도 진행
  • 별도 보안 승인 전까지 고객 CAD·Source 자료 사용 금지, 합성 데이터만 사용
  • 다음: PoC-06(#873)을 병합된 main 기준으로 진행

상이 Updated by 상재 이 20 days ago Actions #5

  • Status changed from New to Closed
Actions

Also available in: PDF Atom