Project

General

Profile

Actions

Feature #899

open
길문 상이

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

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

[PoC-19] 패널 배치 결과 기반 신규 DXF 도면 생성

Feature #899: [PoC-19] 패널 배치 결과 기반 신규 DXF 도면 생성

Added by 길래 문 23 days ago.

Status:
New
Priority:
High
Assignee:
Start date:
12/14/2026
Due date:
12/23/2026 (Due in 36 days)
% Done:

0%

Estimated time:

Description

PoC-19. 패널 배치 결과 기반 신규 DXF 도면 생성

1. 작업 개요

본 PoC는 PoC-17~18에서 개발한 신규 L1 태양광 패널 자동배치 Solver의 결과를 이용하여 실제 CAD 도면(DXF)을 자동으로 생성하는 기능을 개발하는 작업이다.

Solver에서 계산한 모듈별 좌표, 크기, 회전각 및 Footprint를 CAD Entity로 변환하고, 결과를 DXF 파일로 저장한다.

기존 L2 완성 도면의 모듈 객체를 단순 복사하는 방식이 아니라, 신규 L1 사이트의 조건에 따라 계산된 배치 결과를 실제 CAD 도면으로 구현하는 것이 핵심 목표이다.

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

상위 Redmine 일감: #867

담당: 이상재

PM 및 검토: 문길래

협력: 조영우, 황수아

계획 기간: 2026-12-14 ~ 2026-12-23

선행 작업: PoC-05, PoC-06, PoC-17 및 PoC-18의 확장 결과

2. 세부 작업

STEP 1. 기존 CAD 도면 생성 자산 조사

  • 기존 DXF Writer 및 도면 생성 코드 확인
  • 기존 Layer·Block·Entity 작성 기능 조사
  • B001/B006 도면 생성 및 검증 기능 재사용 가능성 확인
  • ezdxf 기반 CAD 작성 방식 검토
  • 기존 도면 QA 및 무결성 검증 기능 확인
  • REUSE / EXTEND / NEW / HOLD 분류

STEP 2. Solver 출력 데이터 검증

PoC-17~18의 layout_candidate.json을 입력받는다.

주요 확인 항목:

  • Site ID
  • Source ID 및 SHA-256
  • Module Spec ID
  • Applied Rule ID 및 Version
  • 모듈별 배치 좌표
  • Module Footprint
  • 모듈 회전각
  • Constraint Validation 결과
  • 단위 및 좌표계
  • Solver Version
  • Layout Candidate Status

필수 입력이나 설계 검증 결과가 불명확하면 DXF 생성 작업을 HOLD 처리한다.

STEP 3. 모듈 배치 정보를 CAD Entity로 변환

다음 정보를 CAD 객체로 변환한다.

Solver 데이터 CAD 변환 내용
Module Position CAD 삽입 및 기준 좌표
Module Footprint 폐합된 Polyline 또는 적절한 Block
Module Width/Length 실제 객체 치수
Rotation CAD 객체 회전
Module ID 객체 식별 정보
Row/Column 배치 그룹 정보
Layout Candidate ID 도면 생성 이력 및 추적 정보

Polyline과 Block 중 적절한 표현 방식을 선정하고 후속 검증이 가능한 형태로 구현한다.

STEP 4. 신규 DXF 도면 생성

  • 신규 DXF 파일 생성
  • Modelspace 객체 작성
  • Layer 생성 및 설정
  • 태양광 패널 Geometry 작성
  • 모듈 좌표·치수·회전각 반영
  • 필요한 도면 메타데이터 구성
  • 신규 Candidate DXF 파일 저장

생성 파일은 기존 L1 Controlled Blank 또는 L2 원본과 별도로 관리한다.

STEP 5. CAD 좌표계 및 단위 일치 검증

  • Solver 좌표계와 CAD 좌표계 비교
  • 단위 및 치수 변환 확인
  • 회전각 처리 검증
  • Block·Polyline 좌표 변환 확인
  • 실제 Module Footprint 재현 여부 확인
  • 좌표 정밀도 및 허용오차 검증

임의의 좌표 변환이나 단위 추정으로 도면을 생성하지 않는다.

STEP 6. DXF 생성 결과 자동 검증

생성한 DXF 파일을 다시 읽어 다음 항목을 확인한다.

  1. DXF 파일 정상 생성
  2. ezdxf로 재열기 성공
  3. DXF Audit 오류 확인
  4. 생성된 모듈 객체 수 비교
  5. Solver 좌표와 CAD 좌표 비교
  6. 모듈 크기 및 회전각 비교
  7. 중복 객체 및 비정상 Geometry 확인
  8. Layer 및 Entity 구조 확인
  9. Source 및 Candidate 식별 정보 확인

중요: DXF 생성 성공만으로 도면 검증을 완료했다고 판단하지 않는다. 생성 후 다시 읽어 정량 검증을 수행해야 한다.

STEP 7. Drawing Manifest 및 생성 이력 구성

예상 산출물: generation_manifest.json

주요 필드:

  • Drawing Candidate ID
  • Layout Candidate ID
  • Site ID
  • Source SHA-256 및 Revision
  • Applied Rule IDs / Versions
  • Solver Version
  • DXF Generator Version
  • 생성 시각
  • 생성 파일 경로 및 SHA-256
  • 생성된 Entity 수
  • 생성된 모듈 수
  • DXF Audit 상태
  • Geometry 검증 상태
  • Warning 및 HOLD 사유

생성된 도면과 사용된 Solver 입력·규칙 버전을 추적할 수 있도록 관리한다.

STEP 8. Golden Fixture 테스트

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

  • 모듈 1개 배치
  • 여러 행·열에 배치된 모듈
  • 회전된 모듈
  • 서로 다른 Polygon에 배치된 모듈
  • 모듈 0개 배치
  • 경계 접촉 및 좌표 정밀도
  • 단위 또는 좌표계 불일치
  • 유효하지 않은 Module Footprint
  • 미승인 Engineering Knowledge
  • Solver 검증 결과가 HOLD인 경우

생성된 DXF 결과와 Solver 기준값을 자동으로 비교한다.

STEP 9. PoC-20 Controlled Blank 연계 준비

다음 단계에서 사용할 계약을 정리한다.

  • 신규 DXF Candidate와 L1 Controlled Blank의 관계
  • Authorized Delta로 반영할 객체 범위
  • 원본 객체 보존 정책
  • 변경 대상 Layer 및 Entity
  • 생성 결과의 Source Provenance
  • 도면 변경사항 검증 방법

이번 PoC에서는 원본 Blank 도면을 직접 변경하거나 Authorized Delta를 병합하지 않는다.

STEP 10. GitHub 반영 및 결과 제출

  • DXF Writer 및 데이터 변환 기능 구현
  • Solver 출력 입력 검증기 작성
  • DXF 생성 및 재열기 검증 코드 작성
  • JSON Schema 및 Drawing Manifest 작성
  • Golden Fixture 및 pytest 테스트
  • 실제 DXF 생성 Evidence 기록
  • Windows PowerShell 실행 가이드 작성
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
이상재 DXF 도면 생성, CAD Entity 변환, 도면 검증 구현
조영우 Solver 배치 좌표·Footprint·Rotation 출력 계약 및 결과 검증
황수아 Approved Engineering Knowledge 및 Evidence 연결 검토
문길래 도면 생성·검증 기준 및 GitHub PR 최종 검토

4. 제출 산출물

  1. 신규 L1 DXF 도면 생성 기능
  2. Solver Layout Candidate → CAD Entity 변환 기능
  3. Module Footprint 및 Rotation 변환 기능
  4. 신규 DXF Candidate 샘플
  5. generation_manifest.json 및 JSON Schema
  6. DXF 재열기·Audit·객체 수 검증 기능
  7. Golden Fixture 및 pytest 결과
  8. 실제 DXF 생성 Evidence
  9. PoC-20 Authorized Delta 연계 계약
  10. Windows 실행 가이드 및 GitHub PR

5. 완료 기준 (PASS)

  • 기존 CAD Writer 및 도면 생성 자산 조사
  • PoC-17/18 Solver 출력 데이터 계약 확인
  • 모듈 좌표·크기·회전각 CAD Entity 변환 성공
  • 신규 DXF Candidate 파일 생성
  • 생성된 DXF 정상 재열기 및 Audit PASS
  • Solver 모듈 수량과 CAD 객체 수 일치
  • Solver 좌표와 생성된 CAD 좌표 일치
  • 모듈 Footprint 및 Rotation 검증
  • 단위·좌표계 불확실성 HOLD 처리
  • Source·Rule·Solver·Generator Version 추적
  • 기존 L1 Controlled Blank 및 L2 원본 변경 없음
  • Golden Fixture 및 자동 테스트 PASS
  • DXF 실행 결과 및 Evidence 확보
  • PoC-20 Authorized Delta 계약 작성
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

6. 개발 및 검증 원칙

  • 기존 L2 객체 복사가 아닌 신규 L1 Solver 결과를 CAD 도면으로 변환한다.
  • 미승인 규칙이나 검증되지 않은 배치 결과를 최종 설계도면으로 출력하지 않는다.
  • DXF Candidate와 원본 Controlled Blank를 분리한다.
  • 원본 DWG/DXF를 수정하거나 덮어쓰지 않는다.
  • 단위 및 좌표계가 불명확한 입력은 HOLD 처리한다.
  • 생성한 DXF를 다시 읽어 정량 검증한다.
  • 생성 결과는 최종 설계 승인본이 아닌 Candidate로 관리한다.
  • 고객 자료를 무단으로 외부 클라우드에 전송하지 않는다.
  • Autodesk APS 및 유료 API 호출은 수행하지 않는다.
  • 최종 설계 적합성은 설계 전문가 검토를 거친다.

7. GitHub 관련 문서

GitHub Issue

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

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-20 — 기존 L1 Blank 보존 및 Authorized Delta 반영

PoC-19에서 생성한 신규 DXF Candidate를 기존 L1 Controlled Blank에 안전하게 반영할 수 있는지 검증한다.

PoC-20에서는 승인된 변경 범위만 적용하고 원본 도면과 변경 후 도면의 차이를 정확히 추적한다.

No data to display

Actions

Also available in: PDF Atom