Project

General

Profile

Actions

Feature #892

open
길문 영조

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

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

[PoC-18] 부정형 사이트·모듈 회전·배치 간섭 처리

Feature #892: [PoC-18] 부정형 사이트·모듈 회전·배치 간섭 처리

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

Status:
New
Priority:
High
Assignee:
Start date:
12/07/2026
Due date:
12/18/2026 (Due in 31 days)
% Done:

0%

Estimated time:

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. 배치 불가능 및 부분 배치 처리

다음 상태를 명확히 구분한다.

  1. 정상 배치 가능
  2. 일부 영역에만 배치 가능
  3. 모듈 0개 배치 가능
  4. 사이트 Geometry 오류
  5. 장애물 또는 이격조건 충돌
  6. 모듈 규격 부적합
  7. 승인되지 않은 설계 규칙
  8. 단위·좌표계 불명확
  9. 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. 제출 산출물

  1. 부정형 사이트 자동배치 Solver
  2. 복수 Polygon 및 Hole 처리 기능
  3. 모듈 회전 및 Footprint 계산 기능
  4. 장애물·이격거리·간섭 검증 기능
  5. 복수 배치 Candidate 탐색 기능
  6. 확장된 layout_candidate.json 및 JSON Schema
  7. 정상·반례·경계조건 Golden Fixture
  8. pytest 및 Solver 성능 검증 결과
  9. 실제 배치 실행 Evidence
  10. PoC-19 DXF 출력 연계 계약
  11. 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 상세계획

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-19 — 패널 배치 결과 기반 신규 DXF 도면 생성

PoC-17~18에서 계산한 모듈 배치 좌표, 회전각 및 Footprint를 CAD 객체로 변환하여 신규 L1 DXF 도면을 생성한다.

PoC-19는 이상재님이 주담당이며, PoC-20에서 기존 Controlled Blank 보존과 Authorized Delta 적용 여부를 검증한다.

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

  • Due date changed from 12/25/2026 to 12/18/2026
  • Start date changed from 12/24/2026 to 12/07/2026
Actions

Also available in: PDF Atom