Project

General

Profile

Actions

Feature #882

open
길문 영조

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

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

[PoC-15] 태양광 모듈 사양 및 배치 입력 파라미터 모델링

Feature #882: [PoC-15] 태양광 모듈 사양 및 배치 입력 파라미터 모델링

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

Status:
New
Priority:
High
Assignee:
Start date:
11/09/2026
Due date:
11/20/2026 (Due in 3 days)
% Done:

0%

Estimated time:

Description

PoC-15. 태양광 모듈 사양 및 배치 입력 파라미터 모델링

1. 작업 개요

본 PoC는 신규 L1 사이트에 태양광 패널을 자동 배치하기 위해 필요한 태양광 모듈 사양, 배치 방향, 회전각, 간격 및 기타 배치 입력 파라미터를 구조화하고 검증하는 기능을 개발하는 작업이다.

PoC-13에서 생성한 Site Model과 PoC-14의 설치 제약조건 모델에 연결할 수 있도록 공통 데이터 구조를 정의한다.

향후 PoC-17 태양광 패널 자동배치 Solver가 모듈 규격과 설계 파라미터를 정확하게 처리할 수 있는 기반을 구축하는 것이 목적이다.

GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/156

상위 Redmine 일감: #867

담당: 조영우

PM 및 검토: 문길래

협력: 황수아, 이상재

계획 기간: 2026-11-30 ~ 2026-12-04

선행 작업: PoC-13, PoC-14의 데이터 계약

2. 세부 작업

STEP 1. 기존 태양광 모듈 사양 및 설계자료 조사

  • 기존 L2 태양광 모듈 사양 자료 확인
  • 설계계산서 및 수량산출서의 모듈 관련 정보 조사
  • 모듈 모델명·규격·용량·치수 확인
  • 기존 Engineering Knowledge에서 관련 파라미터 확인
  • 승인된 사양과 후보·미확정 사양 구분
  • 기존 관련 코드의 REUSE / EXTEND / NEW / HOLD 분류

STEP 2. 태양광 모듈 사양 데이터 모델 정의

다음 정보를 구조화한다.

항목 설명
Module Spec ID 모듈 사양 식별자
Manufacturer 제조사
Model 모듈 모델명
Width 모듈 폭
Length 모듈 길이
Thickness 모듈 두께
Rated Power 정격출력
Unit 치수 및 출력 단위
Orientation 허용 배치 방향
Revision 사양 버전
Source 사양의 근거자료
Approval Status 사양 승인 상태

모든 필드가 실제 자료에 존재하는 것은 아니므로, 미확정 정보와 필수 정보를 구분한다.

STEP 3. 배치 입력 파라미터 정의

자동배치 Solver에서 사용할 다음 파라미터를 구조화한다.

  • 모듈 배치 방향
  • 모듈 허용 회전각
  • 모듈 간 가로·세로 간격
  • 행(Row) 간격
  • 열(Column) 간격
  • 배치 시작 기준점
  • 정렬 및 그룹 구성 방식
  • 배치 목표조건
  • 적용 Site ID 및 제약조건 버전
  • 적용할 Engineering Knowledge 참조 정보

간격 등 설계기준 값은 확인된 자료 또는 승인된 Engineering Knowledge를 근거로 적용한다.

STEP 4. ModuleSpec JSON 정의

예상 산출물: module_specs.json

주요 필드:

  • spec_id
  • manufacturer
  • model
  • width
  • length
  • thickness
  • rated_power
  • dimension_unit
  • power_unit
  • allowed_orientations
  • source_id
  • source_sha256
  • revision
  • approval_status
  • validation_status

실제 사양과 테스트용 가상 사양은 명확히 구분한다.

STEP 5. LayoutParameters JSON 정의

예상 산출물: layout_parameters.json

주요 필드:

  • layout_id
  • site_id
  • module_spec_id
  • orientation
  • allowed_rotation_angles
  • module_spacing_x
  • module_spacing_y
  • row_spacing
  • column_spacing
  • alignment
  • placement_objective
  • constraint_set_id
  • knowledge_rule_refs
  • unit
  • validation_status

후속 Solver가 입력값의 출처와 검증 상태를 확인할 수 있도록 한다.

STEP 6. 입력 파라미터 유효성 검증

다음 조건을 검증한다.

  1. 모듈 폭과 길이가 양수인지 확인
  2. 규격 및 단위 누락 여부 확인
  3. 정격출력 값의 형식과 단위 확인
  4. 잘못된 회전각 또는 배치 방향 처리
  5. 음수 간격 및 잘못된 수치 처리
  6. 중복 또는 충돌하는 모듈 사양 처리
  7. 승인되지 않은 모듈 사양 구분
  8. Source Revision 불일치 확인
  9. Site Model과 모듈 치수 단위 호환성 검사

미확정 사양이나 근거가 없는 설계 파라미터는 자동으로 보정하지 않고 HOLD 처리한다.

STEP 7. L1 Site 및 제약조건 모델 연계

PoC-13의 site_model.json 및 PoC-14의 site_constraints.json과 연결한다.

  • Site 좌표계 및 단위 호환성 확인
  • 모듈 Geometry와 설치 후보 영역 관계 확인
  • 제약조건별 참조 구조 정의
  • Site·Constraint·ModuleSpec의 버전 연결
  • 입력 조합의 유효성 검사
  • Solver에서 사용할 공통 입력 계약 정의

이 단계에서는 실제 태양광 패널 배치 좌표를 계산하지 않는다.

STEP 8. 자동 테스트 및 검증

다음 시나리오를 검증한다.

  • 정상 모듈 사양 입력
  • 가로형 및 세로형 모듈 배치 방향
  • 단위 변환 필요 사례
  • 규격 누락
  • 폭·길이가 0 또는 음수인 경우
  • 정격출력 정보 미확정
  • 지원하지 않는 회전각
  • Source Revision 불일치
  • 승인되지 않은 모듈 사양
  • Site·Constraint 데이터와의 단위 불일치

Golden Fixture를 작성하여 테스트 결과를 재현 가능하게 관리한다.

STEP 9. PoC-17 Solver 입력 계약 작성

자동배치 Solver가 다음 데이터를 입력받을 수 있도록 정의한다.

  1. Site Model
  2. Site Constraints
  3. Module Specifications
  4. Layout Parameters
  5. Approved Engineering Knowledge 참조
  6. Source 및 검증 상태

필수 입력과 선택 입력, 오류 발생 시 처리 기준을 명시한다.

STEP 10. GitHub 반영 및 결과 제출

  • ModuleSpec 및 LayoutParameters 모델 구현
  • JSON Schema 및 입력 검증기 작성
  • 정상·오류 Golden Fixture 작성
  • pytest 자동 테스트 구현
  • 실제 사양과 테스트 자료 구분 및 Evidence 기록
  • Windows PowerShell 실행 가이드 작성
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
조영우 모듈 사양·배치 파라미터 모델링, 입력 검증, Solver 연계
황수아 Engineering Knowledge 및 모듈 사양 근거 검토
이상재 CAD Geometry·단위·좌표 처리 계약 검토
문길래 기술 범위·완료 기준 및 GitHub PR 최종 검토

4. 제출 산출물

  1. 태양광 모듈 사양 데이터 모델
  2. 배치 입력 파라미터 데이터 모델
  3. module_specs.json 및 JSON Schema
  4. layout_parameters.json 및 JSON Schema
  5. 입력값 유효성 검증 기능
  6. Source 및 승인 상태 추적 정보
  7. Site·Constraints 데이터 호환성 검증 결과
  8. Golden Fixture 및 pytest 테스트
  9. PoC-17 Solver 입력 계약
  10. Windows 실행 가이드 및 GitHub PR

5. 완료 기준 (PASS)

  • 기존 모듈 사양 및 관련 설계자료 조사
  • ModuleSpec 데이터 모델 정의
  • LayoutParameters 데이터 모델 정의
  • 모듈 크기·출력·단위·버전 정보 구조화
  • 배치 방향·회전각·간격 입력 구조 정의
  • 잘못된 치수·음수·누락값 검증
  • 미확정·미승인 사양 HOLD 처리
  • Source·Revision·SHA·Locator 기록
  • Site Model 및 Constraints 계약 호환성 확인
  • JSON Schema 유효성 테스트 PASS
  • Golden Fixture 및 자동 테스트 PASS
  • 실제 사양과 테스트용 데이터를 구분
  • PoC-17 Solver 입력 예시 작성
  • 실행 Evidence 및 가이드 작성
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

6. 개발 및 검증 원칙

  • 기존 설계자료와 Engineering Knowledge를 우선 재사용한다.
  • 확인되지 않은 모듈 사양을 실제 제품 사양으로 임의 확정하지 않는다.
  • 모듈 규격과 배치 조건의 단위를 명확히 관리한다.
  • 근거가 없는 이격거리·배치 간격을 임의의 설계기준으로 사용하지 않는다.
  • 승인되지 않은 모듈 사양과 Knowledge는 실제 자동설계에 적용하지 않는다.
  • 단순히 입력 데이터가 유효하다는 이유로 설계 적합성이 승인되었다고 판단하지 않는다.
  • 원본 DWG/DXF 및 설계 산출물을 변경하지 않는다.
  • 고객 자료의 무단 외부 전송 및 Autodesk APS 유료 호출은 수행하지 않는다.

7. GitHub 관련 문서

GitHub Issue

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/156

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-16 — 승인된 Engineering Knowledge의 L1 적용 가능성 검증

PoC-15에서 정의한 모듈 사양 및 배치 파라미터와 PoC-12의 Approved Engineering Knowledge를 비교하여 신규 L1 사이트에 적용 가능한 규칙을 선정한다.

이후 PoC-17에서 설치 후보 영역과 배치 입력값을 활용해 실제 패널 배치 좌표를 계산한다.

Actions

Also available in: PDF Atom