Feature #882
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-15] 태양광 모듈 사양 및 배치 입력 파라미터 모델링
0%
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. 입력 파라미터 유효성 검증¶
다음 조건을 검증한다.
- 모듈 폭과 길이가 양수인지 확인
- 규격 및 단위 누락 여부 확인
- 정격출력 값의 형식과 단위 확인
- 잘못된 회전각 또는 배치 방향 처리
- 음수 간격 및 잘못된 수치 처리
- 중복 또는 충돌하는 모듈 사양 처리
- 승인되지 않은 모듈 사양 구분
- Source Revision 불일치 확인
- 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가 다음 데이터를 입력받을 수 있도록 정의한다.
- Site Model
- Site Constraints
- Module Specifications
- Layout Parameters
- Approved Engineering Knowledge 참조
- 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. 제출 산출물¶
- 태양광 모듈 사양 데이터 모델
- 배치 입력 파라미터 데이터 모델
module_specs.json및 JSON Schemalayout_parameters.json및 JSON Schema- 입력값 유효성 검증 기능
- Source 및 승인 상태 추적 정보
- Site·Constraints 데이터 호환성 검증 결과
- Golden Fixture 및 pytest 테스트
- PoC-17 Solver 입력 계약
- 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 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-16 — 승인된 Engineering Knowledge의 L1 적용 가능성 검증
PoC-15에서 정의한 모듈 사양 및 배치 파라미터와 PoC-12의 Approved Engineering Knowledge를 비교하여 신규 L1 사이트에 적용 가능한 규칙을 선정한다.
이후 PoC-17에서 설치 후보 영역과 배치 입력값을 활용해 실제 패널 배치 좌표를 계산한다.