Feature #874
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
PoC-07 — L2 태양광 모듈 배치 객체 및 패턴 분석
0%
Description
PoC-07. L2 태양광 모듈 배치 객체 및 패턴 분석¶
1. 작업 개요¶
본 PoC는 기존 L2 태양광 설계도면에서 태양광 모듈 객체를 식별하고, 모듈의 배치 좌표, 크기, 방향, 간격, 수량 및 반복 패턴을 분석하는 기능을 개발하는 작업이다.
PoC-06에서 추출한 CAD Layer, Block, Entity 및 Geometry 데이터를 재사용하며, 향후 Engineering Knowledge 후보를 도출하기 위한 객관적인 설계 관찰 데이터를 확보하는 것이 목적이다.
특히 기존 B001 모듈배치도 분석 결과를 재사용하되, 기존 도면의 객체를 그대로 복사한 사례와 새로운 배치 규칙을 도출하는 작업은 구분한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/148
상위 Redmine 일감: #867
담당: 황수아
PM 및 검토: 문길래
협력: 이상재, 조영우
계획 기간: 2026-11-12 ~ 2026-11-20
선행 작업: PoC-04, PoC-05, PoC-06
2. 세부 작업¶
STEP 1. 기존 L2 모듈배치도 및 분석 자산 조사¶
- L2 대표 모듈배치도
B1D2E102/B301의 기존 분석 결과 확인 - B001/B006 도면 작성 및 검증 Evidence 조사
- 모듈 객체 식별에 사용한 Layer·Entity 조건 확인
- 기존 Geometry 분석 코드 및 테스트 재사용 가능성 검토
- 분석 대상 Source의 버전·승인 상태·무결성 확인
기존 B001 분석에서 확인된 RCEP 레이어의 모듈 객체 20,952개는 해당 사례의 관찰 결과이며, 신규 L1 설계의 일반 배치 규칙으로 직접 사용하지 않는다.
STEP 2. 태양광 모듈 객체 식별¶
다음 정보를 조합하여 태양광 모듈 객체 후보를 식별한다.
- Layer 이름 및 속성
- Entity 종류
- 폐합된 Polyline의 형태
- Block 정의 및 INSERT 참조
- 객체 크기와 반복 구조
- 동일 구역 내 Geometry 관계
모듈이 아닌 도면 요소와 중복·겹침 객체를 구분한다.
중요: Layer 이름만으로 모든 객체를 실제 태양광 모듈로 확정하지 않는다.
STEP 3. 모듈 Geometry 정보 추출¶
식별한 모듈 객체에서 다음 정보를 추출한다.
| 항목 | 추출 내용 |
|---|---|
| Source | Source ID, SHA-256, Revision |
| Entity | 객체 유형, Handle, Layer |
| 좌표 | 중심점 및 Vertex 좌표 |
| 크기 | 폭, 길이 및 Bounding Box |
| 방향 | 객체 회전각 및 배치 방향 |
| 상태 | 폐합 여부, 중복·겹침 여부 |
| 근거 | Geometry Locator 및 측정 방식 |
단위가 명확하지 않은 도면은 임의로 mm 또는 m로 확정하지 않는다.
STEP 4. 태양광 모듈 배치 패턴 분석¶
다음과 같은 배치 특성을 분석한다.
- 전체 및 구역별 모듈 수량
- 모듈의 크기별 분포
- 배치 방향 및 회전각 분포
- 행(Row)·열(Column) 반복 패턴
- 모듈 간 간격과 인접 거리
- 구역별 배치 차이
- 동일한 배치 그룹의 반복 구조
- 예외적이거나 불규칙한 배치 구간
측정된 간격이나 방향은 관찰 결과(Observation)로 기록하며, 관련 설계기준이 확인되기 전까지 확정된 Engineering Knowledge로 판단하지 않는다.
STEP 5. 기존 모듈배치도 기준값 교차검증¶
- 기존 B001 분석 결과와 객체 수량 비교
- Layer별 모듈 후보 집합 비교
- Geometry 좌표와 객체 형태 확인
- 중복 및 비모듈 객체 포함 여부 검토
- 기존 검증 결과와 차이가 발생한 원인 분석
- 필요 시 실제 CAD Viewer를 통한 시각 검증
검증 가능한 근거가 부족하면 결과를 HOLD 또는 HUMAN_REVIEW_REQUIRED로 분류한다.
STEP 6. 관찰 데이터 JSON 구조 정의¶
후속 Engineering Knowledge 추출에 사용할 공통 데이터를 정의한다.
예상 산출물: module_observations.json
주요 필드:
- Source ID 및 Revision
- 객체 식별자 및 Geometry Locator
- 모듈 후보 유형 및 판단 근거
- 좌표 및 치수
- 배치 방향
- 모듈 간격
- 그룹 및 구역 정보
- 측정 결과와 불확실성
- 검증 Evidence
해당 JSON은 확정 설계 규칙이 아닌 관찰 데이터로 관리한다.
STEP 7. 자동 테스트 및 검증¶
- 합성 DXF를 이용한 모듈 객체 식별 테스트
- 모듈 및 비모듈 객체 구분 테스트
- 객체 크기·좌표·회전값 검증
- 모듈 수량 계산 테스트
- 행·열 반복 패턴 분석 테스트
- 모듈 간격 계산 테스트
- Block 참조 및 중복 객체 처리 테스트
- 원본 파일 SHA-256 불변 확인
- 허가된 실제 L2 도면 분석 및 결과 비교
테스트 결과는 실제 실행 로그와 Evidence를 기준으로 기록한다.
STEP 8. GitHub 반영 및 결과 제출¶
- 기존 분석 코드 재사용 또는 필요한 기능 확장
- 모듈 객체 식별 및 패턴 분석 코드 작성
- 관찰 데이터 JSON 및 Schema 제출
- 테스트 코드와 검증 결과 작성
- Windows 실행 방법 문서화
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 황수아 | 모듈 객체 식별, 배치 패턴 분석 및 관찰 데이터 정리 |
| 이상재 | CAD Geometry 추출·좌표 분석 기술 지원 |
| 조영우 | 신규 L1 배치 Solver에서 사용할 입력 데이터 계약 검토 |
| 문길래 | 분석 범위·PASS 기준 및 GitHub PR 최종 검토 |
4. 제출 산출물¶
- 태양광 모듈 후보 객체 식별 기능
- 모듈 좌표·크기·방향·간격 분석 기능
- 구역별 수량 및 반복 배치 패턴 통계
module_observations.json및 JSON Schema- Source별 분석 Evidence 및 한계사항
- 합성 Golden DXF 테스트 및 실제 분석 결과
- 자동 테스트 코드 및 실행 로그
- GitHub PR 및 PM 검토 결과
5. 완료 기준 (PASS)¶
- 기존 L2 모듈배치도 분석 자산 조사 완료
- 모듈 후보 객체 및 비모듈 객체 구분
- 모듈별 좌표·크기·방향 정보 추출
- 전체 및 구역별 모듈 수량 분석
- 행·열 반복 패턴과 간격 통계 산출
- 중복 객체 및 Block 참조 처리 검증
- 기존 B001 관찰값과 교차검증
- Source·Revision·SHA·Geometry Locator 기록
- 관찰 데이터와 승인된 설계 규칙 구분
- 미확정 설계 의미와 단위의 불확실성 표시
- 원본 Source 변경 없음
- 합성 Golden DXF 및 실제 실행 테스트 Evidence 확보
- PoC-09/10 연계 JSON 계약 작성
- GitHub PR 제출 및 PM 검토 완료
- main 병합 및 후속 PoC 연계 준비 완료
6. 개발 및 검증 원칙¶
- 기존 CAD 분석 및 Engineering Knowledge 자산을 우선 재사용한다.
- 모듈 수량과 Geometry를 확인했다고 설계 적합성이 승인된 것은 아니다.
- 배치 패턴의 반복이 곧 공식 설계기준이라는 의미는 아니다.
- 단일 L2 도면의 배치 특성을 다른 사이트에 무조건 적용하지 않는다.
- 객체의 Layer, Block 및 Geometry를 조합해 판단한다.
- 불확실한 설계 의미는 전문가 검토 대상으로 분류한다.
- 원본 DWG/DXF를 임의로 수정하지 않는다.
- 고객 설계자료를 외부 클라우드에 전송하지 않는다.
- Autodesk APS 및 유료 API는 사용하지 않는다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/148
25개 PoC 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
기존 B001/B006 도면 작성 근거
8. 후속 개발 연계¶
PoC-09 — CAD 도면과 계산서·BOQ 간 Evidence 연결
PoC-07의 Geometry 및 모듈 관찰 데이터를 계산서·수량산출서 등의 분석 결과와 연결한다.
PoC-10 — L2 설계 규칙 및 배치 패턴 Knowledge 후보 추출
검증된 관찰 데이터와 설계 근거를 바탕으로 Engineering Knowledge 후보를 도출한다.
PoC-08에서 생성되는 계산서·BOQ 분석 결과도 후속 단계에서 함께 활용한다.
수황 Updated by 수아 황 20 days ago
- Status changed from New to In Progress
[2026-10-29 합성 데이터 구현·리뷰 반영·증빙 제출]
RESULT=REVIEW / SYNTHETIC_ONLY / R01=NOT_RUN
PoC-06 geometry/occurrence 데이터를 재사용한 패널 후보·좌표·크기·방향·간격·행 패턴·정확 중복/겹침 관찰 기능을 구현했습니다. 상재님 PR 리뷰 P2-1~3(가로 배치, 작은 위치 오차, 비폴리라인 윤곽 REVIEW)을 반영했습니다.
PR: https://github.com/GilbertMoon/icn-solar-cad-agent/pull/199 (Draft, 미병합)
[PM 지시 반영한 증빙]
코드 커밋 f21fbebdc818877ecdb5ed64ab5eb8416e98dbb2를 고정하고 별도 clean clone에서 합성 데모와 PoC-05/06/07 관련 단위 시험 실행. 실행 전후 git status에 변경/미추적 파일 없음, 입력 파일 SHA256 불변 확인.
112 passed / 0 failed / 1 skipped, PoC-07 49개 포함. Windows symlink 생성 권한 시험 1개는 미검증으로 남깁니다. 실제 MCP stdio 통합 시험을 이번 명령으로 다시 실행한 것은 아닙니다.
증빙 전용 커밋 94b6fd6d9506d3e3534a861eba7a1f4eece9cde9: result.json, JUnit, 합성 DXF, 관찰 JSON/schema, 실행 로그. 코드 커밋 이후 증빙 경로만 추가했으며 커밋된 산출물 10개 SHA256을 대조했습니다.
https://github.com/GilbertMoon/icn-solar-cad-agent/tree/94b6fd6d9506d3e3534a861eba7a1f4eece9cde9/pocs/poc_07_module_observations/evidence
[남은 사항과 다음 행동]
상재님 수정본 재검토 및 PM 최종 검토 후 PR Ready 전환. 실제 L2/B001 비교는 보안 승인 전 NOT_RUN, 고객 CAD/Source 미사용. Revision 미검증, 구역/설계 의미 승인·운영 registry 연결·P3 각도 경계/float 중복/대형 도면 성능 한계는 남아 있습니다. 코드/검증 입력이 변경되면 증빙을 재생성합니다.
작업 착수 사실을 반영하여 New→In Progress로 변경합니다. 전체 완료율에 대한 합의된 산정 기준이 없어 진척률은 기존 0%를 임의 상향하지 않고, 실제 완료 내용은 위 근거로 기록합니다. 담당자·상위 일감·계획 일정은 유지하며 100%/Closed로 처리하지 않습니다.