Project

General

Profile

Actions

Feature #880

closed
길문 영조

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

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

[PoC-13] 신규 L1 Site Geometry·좌표계 분석

Feature #880: [PoC-13] 신규 L1 Site Geometry·좌표계 분석

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

Status:
Closed
Priority:
High
Assignee:
Start date:
10/26/2026
Due date:
11/06/2026
% Done:

100%

Estimated time:

Description

PoC-13. 신규 L1 Site Geometry·좌표계 분석

1. 작업 개요

본 PoC는 신규 L1 태양광 설치 대상 사이트의 CAD 도면을 분석하여 설치 후보 영역의 Geometry, 경계 좌표, 면적, 도면 단위 및 좌표계 정보를 구조화하는 기능을 개발하는 작업이다.

기존 L2 설계자료를 분석하여 구축한 Engineering Knowledge를 신규 L1 사이트에 적용하기 위해서는 먼저 실제 신규 사이트의 형상과 좌표 구조를 정확하게 파악해야 한다.

본 작업에서는 PoC-05/06의 DXF Reader 및 Geometry 추출 기능을 재사용하여 새로운 L1 사이트의 입력 데이터 모델을 구축한다.

중요: L1 CAD 도면에서 특정 영역을 추출했다고 해서 해당 영역 전체가 태양광 패널 설치 가능 구역으로 승인된 것은 아니다. 실제 설치 적합성과 제약조건은 후속 PoC 및 설계 전문가 검토를 거쳐야 한다.

GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/154

상위 Redmine 일감: #867

담당: 조영우

PM 및 검토: 문길래

협력: 이상재, 황수아

계획 기간: 2026-11-23 ~ 2026-11-27

선행 작업: PoC-04, PoC-05, PoC-06

2. 세부 작업

STEP 1. 신규 L1 사이트 자료 및 기존 자산 조사

  • 신규 L1/T1 사이트 CAD 도면 확인
  • Source Manifest 및 도면 Revision 확인
  • 기존 Controlled Blank 도면과 관련 Geometry 자산 조사
  • 기존 CAD Polygon·좌표 분석 코드 확인
  • PoC-06의 Geometry 추출 계약 검토
  • 기존 기능의 REUSE / EXTEND / NEW / HOLD 분류

기존 L2 완성 도면과 신규 L1 설계 대상 도면은 명확히 구분하여 관리한다.

STEP 2. L1 CAD 도면 구조 분석

  • DXF 파일 읽기 및 Source ID 연결
  • Modelspace 및 관련 Layer 확인
  • 사이트 외곽 경계 객체 탐색
  • 설치 후보 영역 관련 Entity 식별
  • Polyline 및 Block Geometry 분석
  • CAD 도면 내 좌표 범위 확인
  • 경계 객체의 유효성 검토

STEP 3. Site Boundary 및 Polygon 추출

다음과 같은 사이트 Geometry를 분석한다.

항목 내용
Site Boundary 전체 사이트 외곽 경계
Candidate Area 설치 후보 영역
Polygon 폐합된 설치 후보 다각형
MultiPolygon 분리된 복수 설치 후보 영역
Hole 영역 내부의 제외 형상
Bounding Box 최소·최대 좌표 범위
Area Geometry 기반 면적
Source Locator CAD 원본 Entity 위치 및 식별자

열린 Polyline, 자가교차 Polygon, 중복 경계 등은 유효한 설치 영역으로 자동 확정하지 않는다.

STEP 4. CAD 좌표계 및 단위 분석

  • DXF INSUNITS 확인
  • 도면 좌표계 및 기준점 조사
  • X/Y 축 방향 및 좌표 범위 확인
  • 도면 회전 및 스케일 분석
  • Block 참조 좌표 변환 확인
  • CAD 좌표와 Site Model 좌표 간 관계 정의
  • 면적 계산 단위 검증

도면 단위나 실제 좌표계가 불분명한 경우 임의 변환하지 않고 HOLD 처리한다.

STEP 5. Site Model 데이터 구조 정의

예상 산출물: site_model.json

주요 데이터:

  • Site ID
  • Source ID 및 SHA-256
  • Source Revision
  • Geometry 유형
  • Site Boundary
  • Candidate Polygon 목록
  • Polygon Vertex 좌표
  • Bounding Box
  • 계산 면적
  • 단위 및 좌표계 상태
  • CAD Layer 및 Entity Handle
  • Source Geometry Locator
  • Geometry 검증 상태
  • Warning 및 검토 필요 항목

데이터는 후속 태양광 배치 Solver가 재사용할 수 있는 구조로 설계한다.

STEP 6. Geometry 유효성 검증

다음 테스트를 수행한다.

  1. 정상 사각형 사이트
  2. 부정형 다각형 사이트
  3. 여러 개의 독립된 설치 후보 영역
  4. 내부 Hole이 존재하는 사이트
  5. 열린 Polyline
  6. 자가교차 Polygon
  7. 중복 또는 겹치는 Polygon
  8. 단위가 확인되지 않은 DXF
  9. 잘못된 Scale 또는 회전 변환

각 사례의 기준 면적, 좌표, 경계 유효성 및 오류 처리 결과를 검증한다.

STEP 7. MCP Tool 및 Solver 입력 연계

기존 CAD 분석 모듈을 활용하여 신규 L1 사이트를 조회할 수 있는 구조를 정의한다.

예상 기능: cad_extract_site_geometry

입력:

  • Source ID
  • Site 또는 영역 선택 조건

출력:

  • 정규화된 Site Geometry
  • 경계 좌표
  • 면적 및 단위
  • 좌표계 정보
  • Source Evidence
  • 검증 상태

PoC-14의 제외영역 분석과 PoC-17의 패널 자동배치 Solver에 사용할 수 있도록 JSON Schema를 정의한다.

STEP 8. 자동 테스트 및 실제 도면 검증

  • 합성 Golden DXF 기반 경계 추출 테스트
  • Polygon 및 MultiPolygon 분석 테스트
  • Hole 처리 테스트
  • 면적 및 Bounding Box 검증
  • 좌표 변환 및 단위 테스트
  • 비정상 Geometry 검증
  • 허가된 실제 신규 L1 도면 분석
  • Source 원본 SHA-256 변경 여부 확인
  • MCP 또는 기존 분석 API 호출 테스트

STEP 9. GitHub 반영 및 결과 제출

  • L1 Site Geometry 분석 코드 작성
  • 기존 CAD 분석 코드 재사용 및 필요한 부분 확장
  • site_model.json 및 JSON Schema 작성
  • Golden Fixture 및 pytest 테스트 작성
  • 실제 L1 분석 Evidence 기록
  • Windows PowerShell 실행 가이드 작성
  • GitHub PR 생성 및 PM 검토
  • main 병합 후 후속 PoC 연계

3. 업무분장

담당자 역할
조영우 L1 Site Geometry 모델링, 경계·면적 분석 및 Solver 입력 계약
이상재 CAD 좌표·Block·Entity 추출 및 DXF 분석 기술 지원
황수아 Engineering Knowledge 적용을 위한 Source·Evidence 연계 검토
문길래 개발 범위·검증 기준·GitHub PR 최종 검토

4. 제출 산출물

  1. 신규 L1 사이트 Geometry 분석 기능
  2. Site Boundary 및 Polygon 추출 기능
  3. 좌표계·단위·면적 검증 기능
  4. site_model.json 및 JSON Schema
  5. 정상·비정상 Geometry 처리 결과
  6. 합성 Golden DXF 및 pytest 테스트
  7. 실제 L1 Site 분석 Evidence
  8. PoC-14 및 PoC-17 연계 입력 계약
  9. Windows 실행 가이드
  10. GitHub PR 및 PM 검토 결과

5. 완료 기준 (PASS)

  • 기존 L1/T1 Source 및 관련 Geometry 자산 조사
  • 허용된 Source ID 기반 사이트 도면 조회
  • Site Boundary 및 후보 Polygon 추출
  • MultiPolygon 및 Hole 처리
  • 열린 경계·자가교차·중복 Polygon 탐지
  • CAD 좌표계·단위·Scale 확인
  • Polygon 면적 및 Bounding Box 계산 검증
  • Site Model JSON Schema 작성
  • Source ID·SHA·Revision·Geometry Locator 기록
  • 미확정 단위 및 설치 영역은 HOLD 처리
  • Source 원본 변경 없음
  • Golden Geometry Fixture 테스트 PASS
  • 허가된 실제 L1 자료 분석 Evidence 확보
  • PoC-14/17 입력 계약 문서화
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

6. 개발 및 검증 원칙

  • 기존 CAD 분석 코드와 Source 관리 체계를 우선 재사용한다.
  • 기존 L2 설계도면과 신규 L1 사이트 도면을 혼동하지 않는다.
  • 도면 경계 분석 결과를 실제 설치 승인 영역으로 간주하지 않는다.
  • 불명확한 좌표계·단위는 임의로 추정하지 않는다.
  • Geometry 처리 오류를 숨기거나 임의로 보정하지 않는다.
  • 원본 DWG/DXF를 수정하지 않는다.
  • 승인되지 않은 Engineering Knowledge를 적용하지 않는다.
  • 고객 자료의 무단 클라우드 전송 및 Autodesk APS 유료 API 호출은 수행하지 않는다.
  • 모든 Geometry 분석 결과는 CAD 원본 위치로 추적 가능해야 한다.

7. GitHub 관련 문서

GitHub Issue

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/154

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-14 — 장애물·설치 제외영역·이격거리 모델링

PoC-13에서 생성한 Site Model을 바탕으로 장애물, 설치 불가 구역, 건축·전기·구조 관련 이격조건을 반영할 수 있는 제약조건 모델을 개발한다.

PoC-13의 설치 후보 영역과 PoC-14의 제외·이격조건을 결합하여 이후 패널 자동배치 Solver가 사용할 실제 배치 허용 영역을 계산하는 기반을 구축한다.


Related issues 1 (1 open — 0 closed)

Related to Feature #1313: [PoC-13 후속] 운영 Registry·MCP 연계 및 승인된 L1 도면 검증New영우 조

Actions
Actions

Also available in: PDF Atom