Feature #884
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-17] L1 기본 태양광 패널 자동배치 Solver 개발
0%
Description
PoC-17. L1 기본 태양광 패널 자동배치 Solver 개발¶
1. 작업 개요¶
본 PoC는 신규 L1 태양광 설치 사이트의 Geometry, 장애물·이격거리 제약조건, 태양광 모듈 사양 및 Approved Engineering Knowledge를 입력받아 태양광 패널의 배치 좌표를 자동으로 계산하는 기본 Solver를 개발하는 작업이다.
PoC-13~16에서 구축한 데이터를 통합하여 신규 사이트의 조건에 맞는 배치 결과를 생성한다.
본 PoC의 핵심은 기존 L2 완성 도면의 패널 객체를 단순 복사하는 것이 아니라, 신규 L1 사이트의 실제 형상과 검증된 설계조건에 따라 새로운 패널 배치 좌표를 계산하는 것이다.
초기 단계에서는 단순한 사각형 설치 영역을 대상으로 결정론적(Deterministic) 배치 알고리즘을 구현하고, 부정형 사이트와 복잡한 장애물 처리는 PoC-18에서 확장한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/158
상위 Redmine 일감: #867
담당: 조영우
PM 및 검토: 문길래
협력: 이상재, 황수아
계획 기간: 2026-12-07 ~ 2026-12-16
선행 작업: PoC-12, PoC-13, PoC-14, PoC-15, PoC-16
2. 세부 작업¶
STEP 1. 기존 개발 결과 및 입력 계약 확인¶
다음 데이터를 연결한다.
site_model.json— L1 설치 후보 영역site_constraints.json— 장애물·제외영역·이격조건module_specs.json— 태양광 모듈 사양layout_parameters.json— 배치 입력 파라미터rule_applicability_results.json— L1에 적용 가능한 Approved Engineering Knowledge
각 데이터의 Source ID, Revision, 단위, 승인 상태 및 규칙 버전을 확인한다.
STEP 2. Solver 입력 유효성 검증¶
자동배치 전에 다음을 확인한다.
- Site Polygon 유효성
- 설치 후보 영역의 좌표계와 단위
- 모듈 폭·길이·방향
- 모듈 간격 및 이격조건
- 장애물 및 설치 제외영역
- Engineering Knowledge 승인·적용 상태
- Source 및 규칙 버전
- 충돌하거나 누락된 필수 입력
필수 조건이 확인되지 않으면 임의값을 적용하지 않고 HOLD 처리한다.
STEP 3. 기본 자동배치 알고리즘 설계¶
첫 번째 Solver는 단순한 사각형 설치 영역을 기준으로 구현한다.
주요 기능:
- 배치 시작 기준점 결정
- 모듈 Footprint 계산
- Row 및 Column 좌표 생성
- 모듈 간 간격 적용
- 허용된 배치 방향 적용
- 설치 영역 내부 포함 여부 검사
- 배치 순서 및 기준 고정
동일한 입력에서 항상 동일한 결과가 생성되는 결정론적 알고리즘을 우선 적용한다.
STEP 4. 태양광 패널 좌표 계산¶
각 모듈에 대해 다음 정보를 계산한다.
| 항목 | 계산 내용 |
|---|---|
| Module ID | 배치된 모듈 식별자 |
| Position | 모듈 기준 좌표 |
| Footprint | 모듈의 실제 점유 영역 |
| Width / Length | 모듈 치수 |
| Rotation | 배치 회전각 |
| Row / Column | 배치 행·열 |
| Site ID | 적용 사이트 |
| Rule Version | 적용 설계 규칙 버전 |
좌표와 Footprint는 동일한 좌표계 및 단위로 처리한다.
STEP 5. 기본 배치 목표함수 정의¶
PoC 단계에서는 단순하고 재현 가능한 목표함수를 사용한다.
예시:
- 제약조건을 만족하는 모듈 수 최대화
- 동일 결과에 대한 일정한 우선순위 적용
- 배치 시작 방향 및 순서 명시
- 동일한 모듈 수가 가능한 경우 결정 기준 정의
이 단계에서 전체 사이트에 대한 전역 최적해를 보장하지 않는다.
STEP 6. 배치 결과 Geometry 검증¶
각 패널에 대해 다음 조건을 검증한다.
- 모든 모듈 Footprint가 설치 후보 영역 내부에 위치
- 모듈 간 겹침 없음
- 확인된 최소 간격 조건 충족
- 장애물 및 제외영역 침범 없음
- 사이트 경계 외부 배치 없음
- 회전각 및 치수 조건 충족
- 배치 결과의 좌표 및 면적 유효성 확인
배치 불가능한 사이트에서는 모듈 수가 0개인 결과도 정상적인 비배치 결과로 표현한다.
STEP 7. 배치 결과 JSON 모델 구현¶
예상 산출물: layout_candidate.json
주요 필드:
- Layout Candidate ID
- Site ID
- Source ID / SHA-256 / Revision
- Module Spec ID
- Constraint Set ID
- Applied Rule IDs / Versions
- Solver Version
- Placement Objective
- Module Count
- Module Positions
- Module Footprints
- Rotation
- Row / Column
- Feasibility Status
- Rejection Reasons
- Validation Status
후속 PoC-19에서 DXF 도면으로 변환할 수 있는 구조로 정의한다.
STEP 8. 오류 및 경계조건 테스트¶
다음 테스트를 수행한다.
- 정상 사각형 사이트
- 모듈 1개만 배치할 수 있는 사이트
- 여러 행·열 배치가 가능한 사이트
- 모듈이 하나도 들어가지 않는 사이트
- 모듈이 경계에 정확히 접하는 경우
- 모듈 간 간격 위반
- 설치 제외영역 침범
- 잘못된 모듈 치수
- 미확정 좌표계 또는 단위
- 미승인 또는 철회된 Engineering Knowledge
- 동일 입력 반복 실행 시 결과 일치
STEP 9. 성능 및 재현성 검증¶
- Golden Fixture의 예상 모듈 좌표와 비교
- 예상 모듈 수와 실제 결과 비교
- Geometry 허용오차 검증
- 동일 입력 반복 실행 결과 비교
- Solver 실행시간 기록
- 입력 데이터 및 규칙 버전 추적
- 기존 L2 객체 복사와 신규 배치 계산 결과 구분
STEP 10. GitHub 반영 및 결과 제출¶
- 기본 태양광 패널 자동배치 Solver 구현
- 입력 검증 및 Geometry 검증 코드 작성
layout_candidate.json및 JSON Schema 작성- Golden Fixture 및 pytest 테스트 작성
- 실제 실행 결과 및 Evidence 기록
- Windows PowerShell 실행 가이드 작성
- PoC-19 DXF 출력 연계 계약 작성
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 조영우 | 기본 자동배치 Solver 및 Geometry 검증 구현 |
| 이상재 | CAD Geometry 연계 및 DXF 출력 데이터 계약 검토 |
| 황수아 | Approved Engineering Knowledge 규칙·버전·근거 연계 |
| 문길래 | Solver 범위·품질·테스트 결과 검토 및 PR 승인 |
4. 제출 산출물¶
- L1 기본 태양광 패널 자동배치 Solver
- 배치 입력 데이터 검증 기능
- 모듈 Footprint 및 좌표 계산 기능
- 경계·간섭·간격 검증 기능
layout_candidate.json및 JSON Schema- 배치 불가 사유 및 HOLD 결과
- Golden Fixture 및 pytest 테스트
- 실제 Solver 실행 Evidence
- PoC-19 DXF 출력 연계 계약
- Windows 실행 가이드 및 GitHub PR
5. 완료 기준 (PASS)¶
- Site·Constraints·ModuleSpec·Rule 입력 계약 확인
- 승인된 Engineering Knowledge만 적용
- 기본 사각형 사이트의 모듈 자동배치 성공
- 모듈별 위치·Footprint·회전각 계산
- Row·Column 반복 배치 구현
- 모든 모듈이 설치 후보 영역 내부에 배치
- 모듈 간 겹침 및 간격 위반 없음
- 제외영역 및 경계 침범 없음
- 동일 입력 반복 실행 결과 일치
- 0개 배치 결과 정상 처리
- 미확정 단위·규칙·입력은 HOLD 처리
- Source·규칙·Solver 버전 추적
- Golden Fixture 테스트 PASS
- 실제 배치 실행 및 검증 Evidence 확보
- PoC-19 DXF 생성 입력 계약 작성
- GitHub PR 제출 및 PM 검토 완료
- main 병합 및 후속 PoC 연계 준비 완료
6. 개발 및 검증 원칙¶
- 기존 L2 도면의 패널 객체를 복사하는 대신 신규 L1 배치 좌표를 계산한다.
- 승인되지 않은 Engineering Knowledge를 사용하지 않는다.
- 유효하지 않은 좌표계·단위·설계조건을 임의 보정하지 않는다.
- 배치 가능 영역에 모든 패널의 Footprint가 포함되어야 한다.
- 겹침·장애물 침범·확인된 간격조건 위반을 허용하지 않는다.
- 기본 Solver의 결과를 전체 설계의 전역 최적해라고 주장하지 않는다.
- 자동배치 결과는 최종 승인 도면이 아닌 Candidate로 관리한다.
- 원본 DWG/DXF 및 설계문서를 변경하지 않는다.
- 고객 자료의 무단 클라우드 전송 및 Autodesk APS 유료 API 호출은 수행하지 않는다.
- 설계 적합성의 최종 판단은 설계 전문가 검토를 거친다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/158
25개 PoC 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-18 — 부정형 사이트·모듈 회전·배치 간섭 처리
PoC-17의 기본 Solver를 확장하여 부정형 사이트, 복수 설치 가능 영역, 장애물, 모듈 회전 및 복잡한 간섭조건을 처리한다.
PoC-19에서는 검증된 자동배치 결과를 실제 DXF 도면으로 생성한다.
영조 Updated by 영우 조 22 days ago
2026-10-27 조영우 — Geometry 기반 준비와 Solver 진척 구분¶
PoC-13(#880)의 합성 경계·면적·단위·입력 Schema와 34개 테스트는 Site 입력의 선행 기반입니다. 기본 사각형 모듈 자동배치, Row/Column, footprint/회전 좌표, module 간격·장애물 침범 검증, layout_candidate.json/Schema 또는 Solver 실행 Evidence를 만든 것은 아닙니다.
본 일감은 New/0% 유지입니다. PoC-13/14/15/16 계약과 승인된 Rule을 연결한 뒤 별도 Solver 산출물로 진척을 인정합니다. 미승인 규칙·치수·이격값을 임의 적용하지 않고, 실제 배치·수량·수익 개선을 완료로 표시하지 않습니다. 관련 선행 준비는 #880의 40%에만 반영했습니다. 담당자·일정·시간 변경 없음.