Feature #892
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-18] 부정형 사이트·모듈 회전·배치 간섭 처리
0%
Description
PoC-18. 부정형 사이트·모듈 회전·배치 간섭 처리¶
1. 작업 개요¶
본 PoC는 PoC-17에서 개발한 기본 태양광 패널 자동배치 Solver를 확장하여 부정형 사이트, 복수 설치 영역, 장애물, 모듈 회전 및 복잡한 배치 간섭조건을 처리하는 기능을 구현하는 작업이다.
기본 사각형 사이트에서 동작하는 자동배치 기능을 실제 신규 L1 현장의 다양한 Geometry와 설치조건에 대응할 수 있도록 개선한다.
기존 L2 도면의 패널 객체를 단순 복사하지 않고 신규 L1 사이트의 배치 가능 영역, 설치 제약조건 및 승인된 Engineering Knowledge를 기반으로 새로운 배치 좌표를 계산한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/159
상위 Redmine 일감: #867
담당: 조영우
PM 및 검토: 문길래
협력: 이상재, 황수아
계획 기간: 2026-12-14 ~ 2026-12-25
선행 작업: PoC-13~17
2. 세부 작업¶
STEP 1. 기존 Solver 및 Geometry 처리 기능 확인¶
- PoC-17 기본 자동배치 Solver 구현 확인
- 기존 Grid 배치 및 Geometry 검증 기능 재사용
- Polygon·MultiPolygon 관련 코드 조사
- PoC-14 설치 제외영역 및 이격조건 연계
- PoC-16 승인 규칙 적용성 검증 결과 확인
- 기존 Solver의 기술적 제약과 확장 필요 기능 분석
STEP 2. 부정형 사이트 자동배치 지원¶
다음과 같은 사이트 형태를 처리한다.
- L자형 사이트
- 삼각형 및 다각형 사이트
- 불규칙한 외곽 경계
- 복수의 독립된 설치 후보 영역
- 내부 Hole이 존재하는 사이트
- 좁은 구간 또는 연결 통로가 있는 사이트
Polygon의 유효성 및 좌표계를 검증한 후 배치 가능 여부를 판단한다.
STEP 3. 모듈 회전 및 배치 방향 처리¶
- 모듈의 기본 방향 적용
- 승인된 허용 회전각 적용
- 회전된 Module Footprint 계산
- 회전 후 Bounding Box 및 실제 Polygon 확인
- 배치 방향별 후보 생성
- 허용되지 않은 회전각 차단
- 회전 결과의 좌표 정밀도 검증
회전각은 모듈 사양과 승인된 설계조건을 기준으로 적용한다.
STEP 4. 장애물 및 설치 제외영역 처리¶
PoC-14의 Site Constraints를 활용한다.
- 장애물 Polygon과 모듈 충돌 검사
- 설치 제외영역 침범 확인
- 장애물 이격거리 적용
- Site Boundary 내부 포함 여부 확인
- 복수 장애물 처리
- 중첩된 제외영역 처리
- 설치 가능 영역의 변경 반영
장애물과 겹치거나 승인된 제약조건을 위반하는 배치 후보는 제외한다.
STEP 5. 모듈 간 간섭 및 간격 검증¶
다음 조건을 검증한다.
| 검증 항목 | 검증 내용 |
|---|---|
| Module Overlap | 모듈끼리 겹치는지 |
| Site Boundary | 모듈이 설치 영역 밖으로 벗어나는지 |
| Obstacle Collision | 장애물과 충돌하는지 |
| Exclusion Zone | 설치 금지영역을 침범하는지 |
| Module Spacing | 모듈 간 간격 기준을 만족하는지 |
| Setback | 경계 및 설비 이격조건을 만족하는지 |
| Rotation | 허용된 회전각으로 배치되었는지 |
모듈의 Bounding Box만으로 최종 충돌 여부를 단정하지 않고 실제 회전된 Footprint를 기준으로 검증한다.
STEP 6. 복잡한 사이트 배치 후보 탐색¶
- 복수 시작점 및 배치 방향 검토
- 회전각별 배치 후보 생성
- Row·Column 배치 확장
- 서로 다른 설치 영역의 결과 통합
- 제약조건을 충족하는 후보 선정
- 배치 수량 비교
- 동점 후보 처리 기준 정의
- 동일 입력의 반복 실행 결과 일치 확인
기본 목표는 제약조건을 충족하면서 가능한 많은 모듈을 배치하는 후보 탐색이며, 전역 최적해를 보장하지 않는다.
STEP 7. 배치 불가능 및 부분 배치 처리¶
다음 상태를 명확히 구분한다.
- 정상 배치 가능
- 일부 영역에만 배치 가능
- 모듈 0개 배치 가능
- 사이트 Geometry 오류
- 장애물 또는 이격조건 충돌
- 모듈 규격 부적합
- 승인되지 않은 설계 규칙
- 단위·좌표계 불명확
- Solver 탐색 한계 또는 실행 제한 초과
배치가 불가능한 경우에도 오류를 숨기지 않고 이유와 근거를 반환한다.
STEP 8. Layout Candidate JSON 확장¶
PoC-17의 layout_candidate.json을 확장한다.
주요 필드:
- Layout Candidate ID
- Site ID
- Source SHA 및 Revision
- Module Spec ID
- Applied Rule IDs / Versions
- Solver Version
- Placement Strategy
- Rotation Strategy
- Module Positions
- Module Footprints
- Module Count
- Constraint Validation
- Collision Validation
- Feasibility Status
- Rejection Reasons
- Execution Metrics
필요한 경우 복수의 유효 배치 후보를 보존하고 각 후보의 차이를 비교한다.
STEP 9. 자동 테스트 및 검증¶
다음 Golden Fixture를 구성한다.
- 정상 L자형 사이트
- 삼각형 사이트
- 다중 Polygon
- 내부 Hole이 있는 사이트
- 복수 장애물
- 모듈 회전 필요 사례
- 좁은 설치 통로
- 경계 접촉
- 과도한 Setback
- 모듈 0개 배치
- 불명확한 단위 및 좌표계
- 미승인·철회 Engineering Knowledge
검증 항목:
- 모듈 좌표 및 회전각
- 실제 Footprint 포함 여부
- 간섭 및 겹침 여부
- 설치 금지영역 침범 여부
- 배치 수량 및 재현성
- 실행시간 및 탐색 제한
STEP 10. 성능 및 안정성 검증¶
- 동일 입력에 대한 결정론적 결과 확인
- Geometry 계산 정밀도 테스트
- 배치 후보 탐색시간 기록
- Solver 실행 제한 설정
- 대규모 후보 생성 시 처리 방식 확인
- 비정상 입력에 대한 오류 처리
- 기존 PoC-17 기본 배치 회귀 테스트
STEP 11. PoC-19 DXF 출력 연계¶
- Module Position 및 Footprint 구조 확인
- CAD Geometry로 변환 가능한 데이터 계약 작성
- 배치 좌표·회전·레이어 정보 매핑
- 좌표계와 단위 일치 여부 확인
- 배치 Candidate와 CAD 출력 결과의 추적 관계 정의
STEP 12. GitHub 반영 및 결과 제출¶
- 복잡한 Site Solver 기능 구현
- Geometry 및 Collision 검증 코드 작성
- Layout Candidate JSON Schema 개정
- Golden Fixture 및 pytest 테스트
- 실제 실행 Evidence와 검증 보고서 작성
- Windows PowerShell 실행 가이드 작성
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 조영우 | 부정형 사이트 배치 Solver, 모듈 회전, 간섭 및 충돌 검증 |
| 이상재 | CAD Geometry 및 DXF 출력 연계 검토 |
| 황수아 | 승인된 Engineering Knowledge와 예외조건 검토 |
| 문길래 | Solver 품질·성능·완료 기준 검토 및 PR 승인 |
4. 제출 산출물¶
- 부정형 사이트 자동배치 Solver
- 복수 Polygon 및 Hole 처리 기능
- 모듈 회전 및 Footprint 계산 기능
- 장애물·이격거리·간섭 검증 기능
- 복수 배치 Candidate 탐색 기능
- 확장된
layout_candidate.json및 JSON Schema - 정상·반례·경계조건 Golden Fixture
- pytest 및 Solver 성능 검증 결과
- 실제 배치 실행 Evidence
- PoC-19 DXF 출력 연계 계약
- GitHub PR 및 PM 검토 결과
5. 완료 기준 (PASS)¶
- PoC-17 Solver 및 기존 Geometry 코드 재사용 범위 확인
- 부정형 Polygon 배치 지원
- MultiPolygon 및 Hole 처리
- 승인된 회전각에 따른 Module Footprint 계산
- 모듈 간 겹침 없음
- 설치 후보 영역 외부 배치 없음
- 장애물 및 제외영역 침범 없음
- 승인된 간격·이격조건 준수
- 복수 후보 및 배치 불가 상태 처리
- 결정론적 결과 및 재현성 검증
- Solver 실행시간 및 탐색 제한 기록
- 미확정 단위·규칙·제약조건 HOLD 처리
- Golden Fixture 및 기존 Solver 회귀 테스트 PASS
- Source·Rule·Solver Version 및 Evidence 추적
- PoC-19 DXF 출력 계약 작성
- GitHub PR 제출 및 PM 검토 완료
- main 병합 및 후속 PoC 연계 준비 완료
6. 개발 및 검증 원칙¶
- 기존 L2 설계 객체 복사가 아닌 신규 L1 배치 좌표 계산을 수행한다.
- 승인되지 않은 Engineering Knowledge를 자동 적용하지 않는다.
- 모듈의 회전 및 간격은 확인된 설계조건을 기준으로 적용한다.
- 모든 배치 모듈의 실제 Footprint가 설치 후보 영역 내에 있어야 한다.
- 장애물·제외영역·이격조건 위반을 허용하지 않는다.
- 배치 수량 최대화를 위한 탐색 결과를 전역 최적해로 보장하지 않는다.
- 배치 불가능한 경우 그 이유를 명확히 기록한다.
- 자동배치 결과는 최종 승인 도면이 아닌 Candidate로 관리한다.
- 원본 DWG/DXF 및 설계자료를 임의로 수정하지 않는다.
- 고객 자료의 무단 외부 전송 및 Autodesk APS 유료 API 호출은 수행하지 않는다.
- 최종 설계 적합성은 설계 전문가 검토를 거친다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/159
25개 PoC 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-19 — 패널 배치 결과 기반 신규 DXF 도면 생성
PoC-17~18에서 계산한 모듈 배치 좌표, 회전각 및 Footprint를 CAD 객체로 변환하여 신규 L1 DXF 도면을 생성한다.
PoC-19는 이상재님이 주담당이며, PoC-20에서 기존 Controlled Blank 보존과 Authorized Delta 적용 여부를 검증한다.