Project

General

Profile

Actions

Feature #873

closed
길문 상이

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

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

[PoC-06] CAD Layer·Block·Entity·좌표 정보 추출

Feature #873: [PoC-06] CAD Layer·Block·Entity·좌표 정보 추출

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

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

100%

Estimated time:

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. 제출 산출물

  1. CAD Layer 분석 기능
  2. CAD Block 정의·참조 분석 기능
  3. CAD Entity 및 Geometry 추출 기능
  4. MCP 조회 Tool 3개
  5. CAD 분석 JSON Schema 및 샘플 결과
  6. Golden DXF 테스트 Fixture 및 pytest 결과
  7. 실제 DXF 분석 실행 Evidence
  8. Windows 환경 실행 가이드
  9. 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 상세계획

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

기존 B001/B006 도면 작성·검증 근거

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/workspaces/w0/t1-drawing-pilot-phase1/B001_B006_DRAWING_DECISION_BASIS_20260929.md

8. 후속 개발 연계

다음 작업: PoC-07 — L2 태양광 모듈 배치 객체 및 패턴 분석

PoC-06에서 추출한 Layer, Entity 및 Geometry 데이터를 기반으로 L2 태양광 모듈 배치의 반복 패턴, 객체 속성 및 설계 관련 관찰 정보를 분석한다.

관찰된 배치 패턴은 곧바로 Approved Engineering Knowledge로 승격하지 않고 후속 PoC에서 추가 검증한다.

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

  • Priority changed from Normal to High

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

  • % Done changed from 0 to 90

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

  • % Done changed from 90 to 50

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

  • % Done changed from 50 to 90

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

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

  • PR: https://github.com/GilbertMoon/icn-solar-cad-agent/pull/197
  • 코드 64c8fba / Evidence c90db6d (pocs/poc_06_cad_inventory/result.json)
  • automated_status=PASS 17/17, pytest 153 passed / 1 skipped (Windows symlink 권한 문제로 허용)
  • world occurrence 78개(3단 중첩 INSERT, 회전, 비균일·미러 스케일, base point, MINSERT, extrusion, inch 블록, paperspace)가 독립 계산 golden과 오차 1e-6 이내로 모두 일치
  • 정의(cad_list_blocks)와 배치(cad_extract_entities)를 구분하고, 레이어·블록·유형별 개수가 golden과 일치

■ 구현

  • MCP tool: cad_list_layers / cad_list_blocks / cad_extract_entities (read-only, source_id만, 페이지 나누기)
  • 재사용: PoC-05 reader, ezdxf Insert.matrix44·multi_insert, extract_dxf_scoped_text.classify
  • 단위 fail closed: $INSUNITS가 선언되고 블록 단위 충돌이 없을 때만 미터 환산. require_meters=true는 환산할 수 없으면 거부

■ 예외·미결

  • 분석 대상은 PoC-05 읽기 결과가 OK 계열인 경우만, 중첩 깊이 16 / 배치 20만 한도 (내 제안)
  • HATCH·SPLINE 등 기하와 XREF는 추출하지 않고 경고로 보고
  • 실제 L2 허가본: NOT_RUN (합성 데이터 전용)
  • PoC-04 실제 Source Registry 연동은 별도 작업 (PM 지시)
  • Codex 독립 리뷰 → PM 검토·squash 병합 후 100%

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

[PoC-06] Codex 독립 리뷰 APPROVE — PM 검토 대기 (진척도 90% 유지)

■ 리뷰 경과 (PR #197)

  • 1차: REQUEST_CHANGES P2 4건 (엔티티 OCS, MINSERT ATTRIB, golden 비교, MINSERT 예산) → 7c525af 수정
  • 재리뷰 #1: MTEXT extrusion P2 → f4056fd 수정
  • 재리뷰 #2: MTEXT 기본 방향 P2 → 94c4b1a 수정
  • 재리뷰 #3: APPROVE (HEAD 4043dd5), 회귀·병합 차단 결함 없음

■ 최종 결과 (Windows .venv Python 3.14.6)

  • automated_status=PASS 17/17, pytest 159 passed / 1 skipped(Windows symlink 권한 문제로 허용)
  • world occurrence 98개가 독립 계산 golden과 오차 1e-6 이내로 일치
  • PoC-05 회귀 22/22 PASS

■ 후속

  • 실제 PoC-04 Source Registry 연동, 허가 L2 검증(NOT_RUN)은 후속 범위
  • PM 검토·squash 병합 후 100%

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

  • Status changed from New to Closed
  • % Done changed from 90 to 100

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

■ 결과

  • PR #197 squash merge: c12e170 (PM 판정 APPROVE_WITH_CONDITIONS)
  • 최종 HEAD 4043dd5 / 검증 코드 94c4b1a: automated_status=PASS 17/17, pytest 159 passed / 1 skipped(Windows symlink 권한 문제, PASS로 집계하지 않음)
  • world occurrence 98개가 독립 계산 golden과 일치, PoC-05 회귀 22/22 PASS
  • Codex 리뷰: 1차 P2 4건 + MTEXT 관련 2건 반영 후 재리뷰 #3 APPROVE
  • PM 요청 문서 보완 2건(최종 수치 통일, HEAD-Evidence 연결)은 PR 본문에 반영됨

■ 승인 범위 / 후속 Gate

  • 승인 범위: 합성 데이터 기반 PoC-06 (SYNTHETIC_ONLY)
  • 후속: 실제 L2 도면 검증(R01=NOT_RUN), PoC-04 실제 Source Registry 통합, 운영 Ubuntu 보안 검증
  • 별도 보안 승인 전까지 고객 CAD·Source 자료 사용 금지

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

[PoC-06] PM 최종 승인·병합 완료 — 1차 PoC 완료 (진척도 100%)

■ 결과

  • PM 최종 판정: APPROVED_FOR_POC / MERGED
  • PR #197 squash merge, Merge SHA: c12e1704f11fa14968a7a6ef783046a47e945cf4
  • 실제 MCP stdio 17/17 PASS, pytest 159 passed / 1 skipped, PoC-05 회귀 22/22 PASS
  • 독립 계산 Golden 98개 배치 일치, Codex 최종 재리뷰 APPROVE

■ 승인 범위

  • cad_list_layers / cad_list_blocks / cad_extract_entities의 합성 데이터 기반 기술 검증
  • 중첩 INSERT·MINSERT 좌표 변환, 단위 불확실 시 fail-closed 처리

■ 후속 Gate

  • 실제 L2 도면 검증: NOT_RUN 유지
  • PoC-04 실제 Source Registry 연동 + PoC-05·06 회귀 검증
  • Ubuntu 배포 보안 검증
  • Windows symlink SKIP은 PASS로 집계하지 않음
  • PoC-13(조영우)에 poc06.v1 Geometry 계약·출력 Schema 공유
Actions

Also available in: PDF Atom