Feature #880
closedFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-13] 신규 L1 Site Geometry·좌표계 분석
100%
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 유효성 검증¶
다음 테스트를 수행한다.
- 정상 사각형 사이트
- 부정형 다각형 사이트
- 여러 개의 독립된 설치 후보 영역
- 내부 Hole이 존재하는 사이트
- 열린 Polyline
- 자가교차 Polygon
- 중복 또는 겹치는 Polygon
- 단위가 확인되지 않은 DXF
- 잘못된 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. 제출 산출물¶
- 신규 L1 사이트 Geometry 분석 기능
- Site Boundary 및 Polygon 추출 기능
- 좌표계·단위·면적 검증 기능
site_model.json및 JSON Schema- 정상·비정상 Geometry 처리 결과
- 합성 Golden DXF 및 pytest 테스트
- 실제 L1 Site 분석 Evidence
- PoC-14 및 PoC-17 연계 입력 계약
- Windows 실행 가이드
- 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 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-14 — 장애물·설치 제외영역·이격거리 모델링
PoC-13에서 생성한 Site Model을 바탕으로 장애물, 설치 불가 구역, 건축·전기·구조 관련 이격조건을 반영할 수 있는 제약조건 모델을 개발한다.
PoC-13의 설치 후보 영역과 PoC-14의 제외·이격조건을 결합하여 이후 패널 자동배치 Solver가 사용할 실제 배치 허용 영역을 계산하는 기반을 구축한다.