Project

General

Profile

Actions

Feature #881

open
길문 영조

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

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

[PoC-14] 장애물·설치 제외영역·이격거리 모델링

Feature #881: [PoC-14] 장애물·설치 제외영역·이격거리 모델링

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

Status:
In Progress
Priority:
High
Assignee:
Start date:
11/02/2026
Due date:
11/13/2026 (4 days late)
% Done:

0%

Estimated time:

Description

PoC-14. 장애물·설치 제외영역·이격거리 모델링

1. 작업 개요

본 PoC는 PoC-13에서 구축한 신규 L1 사이트의 Geometry 정보를 기반으로 장애물, 설치 제외영역 및 이격거리 제약조건을 분석·구조화하고, 태양광 패널 배치 후보 영역을 계산하는 기능을 개발하는 작업이다.

신규 L1 사이트에는 건축물, 구조물, 설비, 유지관리 통로 및 기타 설치 제약조건이 존재할 수 있다. 이러한 정보를 CAD 도면과 설계자료에서 추출하여 패널 자동배치 Solver가 활용할 수 있는 공통 데이터 모델을 구축한다.

단, 도면에서 관찰된 장애물과 실제 설치 금지조건은 구분해야 하며, 이격거리 등 설계기준은 확인된 자료 또는 승인된 Engineering Knowledge에 근거하여 적용한다.

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

상위 Redmine 일감: #867

담당: 조영우

PM 및 검토: 문길래

협력: 이상재, 황수아

계획 기간: 2026-11-26 ~ 2026-12-02

선행 작업: PoC-13, PoC-04~06

2. 세부 작업

STEP 1. 신규 L1 사이트의 설치 제약조건 조사

  • PoC-13의 site_model.json 확인
  • L1 CAD 도면의 장애물 및 구조물 관련 Layer 분석
  • 설치 제외영역과 제한영역 관련 설계자료 확인
  • 유지관리 통로 및 설비 접근 공간 확인
  • 기존 Engineering Knowledge의 이격조건 확인
  • 제약조건의 출처·Revision·승인 여부 검토

확인되지 않은 현장 조건은 미확정 항목으로 관리한다.

STEP 2. 장애물 Geometry 분석

다음과 같은 장애물 및 설치 제한 요소를 표현할 수 있도록 구성한다.

구분 분석 대상
구조물 기둥, 벽체, 장비 기초 등
설비 기존 전기·기계 설비
통로 유지관리 및 접근 통로
설치 제외영역 도면 또는 요구사항에서 지정한 금지구역
경계 제약 사이트 외곽 및 인접 영역
기타 장애물 추가 설계 검토가 필요한 객체

도면에서 객체가 발견되었다는 사실만으로 해당 객체의 실제 설치 제한 범위를 확정하지 않는다.

STEP 3. 제약조건 데이터 모델 정의

다음과 같은 제약조건 유형을 정의한다.

① Obstacle

실제 또는 후보 장애물의 위치와 형상을 나타낸다.

② Exclusion Zone

태양광 패널을 설치할 수 없도록 지정된 영역을 나타낸다.

③ Setback Constraint

경계, 장애물 또는 설비로부터 확보해야 하는 이격거리를 나타낸다.

각 제약조건에는 다음 정보를 포함한다.

  • Constraint ID
  • Constraint Type
  • Source ID 및 Revision
  • CAD Geometry Locator
  • Polygon 또는 Line Geometry
  • 이격거리 값 및 단위
  • 적용 조건
  • 근거 문서
  • 승인 상태
  • 검증 및 불확실성 정보

STEP 4. 이격거리 및 Buffer 처리

  • 장애물 기준 이격거리 적용
  • Site Boundary 내부 이격 영역 계산
  • Line 및 Polygon Buffer 연산
  • 동일 영역에 적용되는 복수 제약조건 처리
  • 경계 접촉 및 중첩 영역 검증
  • 이격 적용 전후 면적 비교
  • 단위와 좌표계 일치 여부 확인

중요: 문서 또는 승인된 규칙에 없는 이격거리 수치를 임의로 설정하지 않는다.

STEP 5. 설치 후보 영역 계산

PoC-13에서 생성한 Site Boundary와 이번 PoC의 제약조건을 결합하여 패널 배치 후보 영역을 계산한다.

계산 개념:

Candidate Buildable Area = Site Candidate Area - Exclusion Zones - Applicable Setback Areas

주요 처리 사항:

  1. 사이트 내부 설치 후보 영역 확인
  2. 장애물 및 금지영역 적용
  3. 확인된 이격거리 조건 적용
  4. Polygon 차집합 및 중복 영역 처리
  5. 남은 후보 영역의 면적·경계 계산
  6. 결과 Polygon의 유효성 검사
  7. 설치 가능한 후보 영역이 없는 경우도 정상적인 계산 결과로 처리

최종 설치 승인 전에는 이 결과를 Approved Buildable Area로 표시하지 않는다.

STEP 6. Site Constraints JSON 정의

예상 산출물: site_constraints.json

주요 필드:

  • Site ID
  • Source ID / SHA-256 / Revision
  • Obstacle 목록
  • Exclusion Zone 목록
  • Setback Constraint 목록
  • Geometry 좌표 및 단위
  • 적용 근거 및 승인 상태
  • Candidate Buildable Area
  • 제외 전후 면적
  • Validation Status
  • Warning 및 HOLD 항목

후속 Solver가 제약조건의 출처와 적용 여부를 확인할 수 있어야 한다.

STEP 7. Geometry 및 예외 처리 테스트

다음 테스트를 수행한다.

  • 장애물이 없는 정상 사이트
  • 사이트 내부 장애물 존재
  • 사이트 경계에 접하는 장애물
  • 복수의 중첩 제외영역
  • 내부 Hole이 있는 Polygon
  • 과도한 이격거리
  • 결과 후보 영역이 없는 경우
  • 잘못된 Polygon 또는 자가교차 Geometry
  • 단위 또는 좌표계가 불명확한 경우
  • 근거가 없는 이격거리 입력
  • 음수 이격거리 또는 필수값 누락

불확실한 조건을 임의로 보정하여 정상 결과로 처리하지 않는다.

STEP 8. MCP 및 후속 Solver 연계

다음 기능을 구현하거나 계약을 정의한다.

예상 기능: cad_analyze_site_constraints

입력:

  • Site ID
  • Site Model
  • 장애물 및 제외영역 데이터
  • 승인된 이격조건

출력:

  • 적용 제약조건 목록
  • Exclusion 및 Setback Geometry
  • 설치 후보 영역
  • 적용 전후 면적
  • 원본 Evidence
  • 검증 상태 및 Warning

PoC-17 자동배치 Solver에 바로 전달할 수 있는 JSON 구조로 제공한다.

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

  • 합성 Golden Geometry Fixture 테스트
  • Polygon Buffer 및 차집합 검증
  • 경계·중첩·Hole 처리 검증
  • 면적 및 좌표 계산 검증
  • 미확정 이격조건 HOLD 처리
  • 허가된 실제 L1 사이트 도면 분석
  • Source SHA-256 변경 여부 확인
  • 기존 CAD 분석 기능 회귀 테스트

STEP 10. GitHub 반영 및 결과 제출

  • 제약조건 모델 및 Geometry 연산 코드 구현
  • site_constraints.json 및 JSON Schema 작성
  • Golden Fixture 및 pytest 자동 테스트 작성
  • 실제 L1 분석 Evidence 기록
  • Windows PowerShell 실행 가이드 작성
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
조영우 장애물·제외영역·이격거리 모델 및 후보 설치 영역 계산
이상재 CAD 객체·Layer·Geometry 추출 및 좌표 처리 지원
황수아 Engineering Knowledge 기반 제약조건·근거·승인 상태 검토
문길래 개발 범위·기술 검증·PM 승인 및 GitHub PR 검토

4. 제출 산출물

  1. 장애물 및 설치 제외영역 분석 기능
  2. 이격거리 제약조건 모델
  3. Geometry Buffer 및 차집합 처리 기능
  4. Candidate Buildable Area 계산 결과
  5. site_constraints.json 및 JSON Schema
  6. 제약조건별 Source 및 Evidence 연결 정보
  7. Golden Fixture 및 pytest 테스트
  8. 실제 L1 Site 분석 Evidence
  9. PoC-17 Solver 연계 입력 계약
  10. Windows 실행 가이드 및 GitHub PR

5. 완료 기준 (PASS)

  • PoC-13 Site Model 입력 계약 확인
  • 장애물 및 설치 제외영역 모델 구현
  • 이격거리 제약조건과 출처 관리
  • Polygon Buffer 및 차집합 연산 검증
  • 복수·중첩 제외영역 처리
  • Candidate Buildable Area 계산
  • 빈 설치 후보 영역 처리
  • 미확정 단위·좌표계·이격거리 HOLD 처리
  • 제약조건의 Source·Revision·SHA·Locator 기록
  • 승인된 조건과 관찰된 조건 구분
  • Golden Geometry Fixture 테스트 PASS
  • 허가된 실제 L1 도면 실행 Evidence 확보
  • Source 원본 변경 없음
  • PoC-17 Solver 연계 JSON Schema 작성
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

6. 개발 및 검증 원칙

  • 기존 L1 Site Geometry 및 CAD 분석 기능을 재사용한다.
  • 설치 후보 영역과 공식 설치 승인 영역을 명확히 구분한다.
  • 근거 없는 이격거리 값을 임의 적용하지 않는다.
  • 규정 및 설계기준의 최종 적용 판단은 설계 전문가 검토를 거친다.
  • 도면에 표현되지 않은 장애물을 임의로 생성하지 않는다.
  • 좌표계와 단위가 확정되지 않은 경우 계산 결과를 최종 승인하지 않는다.
  • 빈 후보 영역은 자동 오류가 아니라 유효한 분석 결과일 수 있다.
  • 승인되지 않은 Engineering Knowledge는 적용하지 않는다.
  • 원본 DWG/DXF 및 설계문서는 임의로 수정하지 않는다.
  • 고객 자료의 무단 외부 업로드 및 Autodesk APS 유료 API 호출은 수행하지 않는다.

7. GitHub 관련 문서

GitHub Issue

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

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-15 — 태양광 모듈 사양 및 배치 입력 파라미터 모델링

PoC-14에서 계산한 설치 후보 영역과 PoC-15의 태양광 모듈 사양을 결합하면 신규 L1 패널 자동배치에 필요한 기본 입력 구조가 완성된다.

PoC-16에서 승인된 Engineering Knowledge의 적용 가능성을 검증하고, 이후 PoC-17에서 실제 패널 배치 좌표를 계산한다.

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

  • Due date changed from 12/02/2026 to 11/13/2026
  • Start date changed from 11/26/2026 to 11/02/2026

영조 Updated by 영우 조 22 days ago Actions #2

2026-10-27 조영우 — 선행 준비와 본 일감 진척 구분

PoC-13(#880)의 합성 Site Model·직선 Polygon/hole/분리 영역·단위·면적 검증을 선행 기반으로 작성했습니다. 허용오차·경계 접촉·최소 영역 정책 초안 및 D1~D12 OPEN 목록도 있습니다. 이는 본 일감의 장애물·이격거리 모델 또는 Buildable Area 구현 완료가 아닙니다. 모듈/장애물 관계의 정책은 아직 검토 대상이며 운영값은 미승인입니다.

본 일감의 site_constraints.json/Schema, 장애물 Source locator, Buffer/차집합, 중첩 제외·빈 결과 처리, PoC-17 연계 및 실제 L1 검증은 이번 작업에서 수행하지 않았습니다. 따라서 New/0%를 유지하고 PoC-13의 40%와 중복 집계하지 않습니다.

다음 조치: A/B/C Site 입력 계약 확인, 권한 있는 이격·제외 조건과 출처 확보, 미확정 조건 HOLD 정책 합의 후 본 일감의 합성 구현 범위를 착수합니다. 일정·담당·시간은 변경하지 않습니다. 관련 진행 근거는 #880의 진척률 보고를 참고해 주세요.

영조 Updated by 영우 조 14 days ago Actions #3

  • Status changed from New to In Progress

2026-11-03 PoC-14 합성 초기 착수. #880은 PM 범위 조정 후 Closed이며 #1313의 실제 도면/Registry Gate와 분리합니다. 합성 영역에 대한 exclusion 합집합·차집합, 경계 setback, 빈 결과, 입력 단위·근거 불명확 HOLD의 초기 함수를 작성했습니다. 합성 pytest 17 passed / 0 failed. 이는 초기 개발 결과이며 전체 #881 PASS가 아닙니다.

미완료: PoC-13 site_model 직접 인수 및 상세 Schema·출처 SHA 검증, 합성 fixture/Evidence 확장, 소비자 계약, 운영 MCP/Registry, 실제 L1·공학 승인 및 PR/PM 검토. 고객 Source 사용 금지/HOLD 유지.

작업 경로: C:\Users\dkrak\Documents\Codex\2026-09-29\c-dev-t1-drawing-pilot-t1\poc14-work; branch task/w2/poc14-synthetic-20261103. 로컬 미커밋이며 원격 반영하지 않았습니다. 작업시간은 WORKLOG, 이번 작업 토큰은 확인 불가로 기록했습니다. 진척률은 객관적 산정 전 기존 0% 유지.

Actions

Also available in: PDF Atom