Feature #881
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-14] 장애물·설치 제외영역·이격거리 모델링
0%
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
주요 처리 사항:
- 사이트 내부 설치 후보 영역 확인
- 장애물 및 금지영역 적용
- 확인된 이격거리 조건 적용
- Polygon 차집합 및 중복 영역 처리
- 남은 후보 영역의 면적·경계 계산
- 결과 Polygon의 유효성 검사
- 설치 가능한 후보 영역이 없는 경우도 정상적인 계산 결과로 처리
최종 설치 승인 전에는 이 결과를 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. 제출 산출물¶
- 장애물 및 설치 제외영역 분석 기능
- 이격거리 제약조건 모델
- Geometry Buffer 및 차집합 처리 기능
- Candidate Buildable Area 계산 결과
site_constraints.json및 JSON Schema- 제약조건별 Source 및 Evidence 연결 정보
- Golden Fixture 및 pytest 테스트
- 실제 L1 Site 분석 Evidence
- PoC-17 Solver 연계 입력 계약
- 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 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-15 — 태양광 모듈 사양 및 배치 입력 파라미터 모델링
PoC-14에서 계산한 설치 후보 영역과 PoC-15의 태양광 모듈 사양을 결합하면 신규 L1 패널 자동배치에 필요한 기본 입력 구조가 완성된다.
PoC-16에서 승인된 Engineering Knowledge의 적용 가능성을 검증하고, 이후 PoC-17에서 실제 패널 배치 좌표를 계산한다.
영조 Updated by 영우 조 22 days ago
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
- 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% 유지.