Project

General

Profile

Actions

Feature #884

open
길문 영조

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

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

[PoC-17] L1 기본 태양광 패널 자동배치 Solver 개발

Feature #884: [PoC-17] L1 기본 태양광 패널 자동배치 Solver 개발

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

Status:
New
Priority:
High
Assignee:
Start date:
11/30/2026
Due date:
12/11/2026 (Due in 24 days)
% Done:

0%

Estimated time:

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 입력 유효성 검증

자동배치 전에 다음을 확인한다.

  1. Site Polygon 유효성
  2. 설치 후보 영역의 좌표계와 단위
  3. 모듈 폭·길이·방향
  4. 모듈 간격 및 이격조건
  5. 장애물 및 설치 제외영역
  6. Engineering Knowledge 승인·적용 상태
  7. Source 및 규칙 버전
  8. 충돌하거나 누락된 필수 입력

필수 조건이 확인되지 않으면 임의값을 적용하지 않고 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. 정상 사각형 사이트
  2. 모듈 1개만 배치할 수 있는 사이트
  3. 여러 행·열 배치가 가능한 사이트
  4. 모듈이 하나도 들어가지 않는 사이트
  5. 모듈이 경계에 정확히 접하는 경우
  6. 모듈 간 간격 위반
  7. 설치 제외영역 침범
  8. 잘못된 모듈 치수
  9. 미확정 좌표계 또는 단위
  10. 미승인 또는 철회된 Engineering Knowledge
  11. 동일 입력 반복 실행 시 결과 일치

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. 제출 산출물

  1. L1 기본 태양광 패널 자동배치 Solver
  2. 배치 입력 데이터 검증 기능
  3. 모듈 Footprint 및 좌표 계산 기능
  4. 경계·간섭·간격 검증 기능
  5. layout_candidate.json 및 JSON Schema
  6. 배치 불가 사유 및 HOLD 결과
  7. Golden Fixture 및 pytest 테스트
  8. 실제 Solver 실행 Evidence
  9. PoC-19 DXF 출력 연계 계약
  10. 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 상세계획

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-18 — 부정형 사이트·모듈 회전·배치 간섭 처리

PoC-17의 기본 Solver를 확장하여 부정형 사이트, 복수 설치 가능 영역, 장애물, 모듈 회전 및 복잡한 간섭조건을 처리한다.

PoC-19에서는 검증된 자동배치 결과를 실제 DXF 도면으로 생성한다.

Actions

Also available in: PDF Atom