Project

General

Profile

Actions

Feature #900

open
길문 상이

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

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

[PoC-20] 기존 L1 Blank 보존 및 Authorized Delta 반영

Feature #900: [PoC-20] 기존 L1 Blank 보존 및 Authorized Delta 반영

Added by 길래 문 23 days ago.

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

0%

Estimated time:

Description

PoC-20. 기존 L1 Blank 보존 및 Authorized Delta 반영

1. 작업 개요

본 PoC는 PoC-19에서 생성한 신규 L1 태양광 패널 배치 DXF Candidate를 기존 L1 Controlled Blank 도면에 안전하게 반영하는 기능을 구현하는 작업이다.

핵심은 Authorized Delta(승인된 변경 범위)만 적용하고, 변경이 허용되지 않은 기존 CAD 객체, Layer, Block 및 Geometry가 그대로 유지되는지 검증하는 것이다.

기존 L2 도면에서 객체를 복사했던 B001/B006 PoC의 검증 방식은 참고하되, 이번에는 신규 L1 Solver가 계산한 배치 결과를 적용한다.

원본 도면은 수정하지 않으며, 변경 결과는 반드시 별도의 Candidate 파일로 생성한다.

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

상위 Redmine 일감: #867

담당: 이상재

PM 및 검토: 문길래

협력: 조영우, 황수아

계획 기간: 2026-12-21 ~ 2026-12-30

선행 작업: PoC-19, PoC-04~06

2. 세부 작업

STEP 1. 기존 Controlled Blank 및 Authorized Delta 자산 조사

  • 기존 L1/T1 Controlled Blank 도면 확인
  • B001/B006 도면 작성 및 검증 Evidence 확인
  • Authorized Delta 정의 및 관리 정책 검토
  • 원본 보존 및 변경 범위 검증 코드 조사
  • 기존 도면의 Layer·Block·Entity 구조 분석
  • 재사용 가능한 기능과 신규 구현 필요 기능 구분

STEP 2. 기준 도면 및 변경 승인 정보 확인

다음 정보를 검증한다.

  • L1 Controlled Blank Source ID
  • Source Revision 및 SHA-256
  • 기준 도면의 좌표계와 단위
  • 적용할 Layout Candidate ID
  • Candidate DXF의 SHA-256
  • 변경 허용 Layer 및 Entity 유형
  • 변경 허용 영역
  • 승인된 추가·수정·삭제 작업 범위
  • 변경 승인자 및 승인 근거

필수 승인 정보가 없으면 변경 적용을 HOLD 처리한다.

STEP 3. 변경 전 기준 도면 스냅샷 생성

변경 전 도면에서 다음 정보를 기록한다.

항목 기록 내용
Source SHA 원본 도면 해시
Layer Inventory 기존 Layer 목록 및 속성
Block Inventory Block 정의 및 참조
Entity Inventory Entity 유형 및 개수
Protected Geometry 변경 금지 객체 및 좌표
Revision 기준 도면 버전
Units / CRS 단위 및 좌표계

해당 스냅샷을 변경 후 도면 검증의 기준으로 사용한다.

STEP 4. Authorized Delta 적용 기능 구현

PoC-19의 신규 DXF Candidate에서 승인된 객체만 선택해 반영한다.

처리 내용:

  1. Candidate의 배치 결과 검증
  2. Authorized Delta 범위 확인
  3. 추가 가능한 Module Entity 식별
  4. 변경 허용 Layer 및 Geometry 확인
  5. 기존 원본 도면을 읽기 전용으로 로드
  6. 별도 출력 파일에 승인된 변경사항 반영
  7. 변경 내역 및 Source Provenance 기록

승인되지 않은 객체의 수정·삭제는 자동 차단한다.

STEP 5. 원본 도면 보존 검증

다음 조건을 검증한다.

  • 원본 Controlled Blank 파일 SHA-256 불변
  • 보호 대상 Layer 및 Block 보존
  • 기존 보호 Entity의 Geometry 및 속성 보존
  • 허용 범위 외 객체 추가 없음
  • 허용되지 않은 객체 수정·삭제 없음
  • 좌표계 및 단위 변경 없음
  • 기존 CAD 구조와 신규 패널 객체 간 정합성 확인

DXF 저장 과정에서 내부 Handle 등이 달라질 수 있으므로 객체 식별자뿐 아니라 Geometry 및 속성에 기반한 비교도 수행한다.

STEP 6. Authorized Delta Manifest 정의

예상 산출물: authorized_delta_manifest.json

주요 필드:

  • Delta ID
  • Controlled Blank Source ID
  • Controlled Blank SHA-256 및 Revision
  • Layout Candidate ID
  • Candidate DXF SHA-256
  • 승인된 변경 범위
  • 승인 주체 및 승인 근거
  • 적용 Rule ID 및 Version
  • 추가·수정·삭제 Entity 목록
  • 변경 전후 Entity 수
  • 출력 DXF 경로 및 SHA-256
  • 검증 상태
  • Warning 및 HOLD 사유

STEP 7. 변경 전후 Diff 검증

예상 산출물: diff_report.json

주요 검증 항목:

  • 추가된 Entity 목록
  • 수정된 Entity 목록
  • 삭제된 Entity 목록
  • 허용 범위 외 변경사항 수
  • 기존 보호 Entity 보존 여부
  • Solver Candidate와 출력 DXF의 모듈 수량 비교
  • 모듈 좌표·치수·회전각 비교
  • Source 및 변경 이력 추적 결과

PASS 조건: 승인되지 않은 변경사항이 0건이어야 한다.

STEP 8. 중복 적용 및 재실행 안정성 검증

다음 상황을 검증한다.

  1. 동일 Candidate 최초 적용
  2. 동일 Candidate 반복 적용
  3. 이미 추가된 모듈의 중복 삽입 방지
  4. 서로 다른 Candidate 적용 시 충돌 처리
  5. Source Revision 불일치
  6. 변경 허용 범위 밖 객체 삽입 시도
  7. 승인되지 않은 변경 요청
  8. DXF 생성 또는 검증 실패
  9. 실패 후 재시도 및 결과 복구

동일한 Authorized Delta를 반복 실행했을 때 중복 모듈이 생성되지 않도록 한다.

STEP 9. 생성 DXF 자동 검증

  • DXF 파일 재열기
  • ezdxf Audit 수행
  • Layer·Block·Entity 수 확인
  • 신규 모듈 좌표 및 회전각 검증
  • 변경 허용 범위 내 객체만 반영되었는지 확인
  • 기준 도면 보존 여부 확인
  • Solver 입력 및 적용 규칙 버전 추적

DWG/PDF 시각 검증과 최종 CAD 품질 검토는 PoC-22에서 추가 수행한다.

STEP 10. Golden Fixture 및 오류 테스트

다음 테스트를 구성한다.

  • 정상 Authorized Delta 적용
  • 승인 범위 외 Layer 변경
  • 보호 Entity 삭제 시도
  • 원본 Revision 불일치
  • Candidate SHA 불일치
  • 중복 모듈 삽입
  • 승인 정보 누락
  • 잘못된 좌표계 또는 단위
  • DXF 구조 오류
  • 동일 Delta 반복 적용

합성 테스트와 허가된 실제 L1 도면의 검증 결과는 구분한다.

STEP 11. 후속 CAD QA 연계

PoC-22에서 검증할 수 있도록 다음 자료를 인계한다.

  • 기준 도면 및 생성 도면 정보
  • Authorized Delta Manifest
  • 변경 전후 Diff Report
  • 출력 DXF SHA-256
  • CAD 객체 수 및 Geometry 검증 결과
  • 미확정 항목 및 전문가 검토 필요사항

STEP 12. GitHub 반영 및 결과 제출

  • Authorized Delta 적용 기능 구현
  • 변경 승인 Gate 구현
  • 기준 도면 보존 검증 코드 작성
  • Manifest 및 Diff Report JSON Schema 작성
  • Golden Fixture 및 pytest 테스트
  • 실제 실행 및 원본 보존 Evidence 기록
  • Windows PowerShell 실행 가이드 작성
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
이상재 Controlled Blank 보존, Authorized Delta 적용, CAD Diff 검증
조영우 Solver Candidate·Module Footprint·좌표·회전값 검증
황수아 적용 규칙 및 승인 근거·Evidence 연계 검토
문길래 변경 승인 정책·검증 결과·GitHub PR 최종 검토

4. 제출 산출물

  1. Authorized Delta 적용 및 승인 Gate
  2. Controlled Blank 원본 보존 검증 기능
  3. 신규 L1 Candidate DXF
  4. authorized_delta_manifest.json 및 Schema
  5. diff_report.json 및 Schema
  6. 변경 전후 CAD 객체 및 Geometry 비교 결과
  7. 중복 적용 방지·오류 처리 테스트
  8. Golden Fixture 및 pytest 결과
  9. 원본 SHA-256 불변 Evidence
  10. PoC-22 CAD QA 인계 자료
  11. Windows 실행 가이드 및 GitHub PR

5. 완료 기준 (PASS)

  • 기존 Controlled Blank 및 Authorized Delta 자산 조사
  • 기준 Source·Revision·SHA 검증
  • 변경 허용 범위 및 승인 근거 확인
  • 변경 전 Layer·Block·Entity 스냅샷 생성
  • 승인된 Delta만 별도 DXF Candidate에 반영
  • 원본 Controlled Blank SHA-256 불변
  • 보호 대상 CAD 객체 및 Geometry 보존
  • 허용되지 않은 변경사항 0건
  • 모듈 수량·좌표·회전각 정합성 확인
  • 동일 Delta 반복 적용 시 중복 객체 0건
  • 잘못된 승인·Revision·SHA 처리 검증
  • DXF 재열기 및 Audit PASS
  • Manifest 및 Diff Report 작성
  • Golden Fixture·pytest 및 실행 Evidence 확보
  • PoC-22 검증 입력 계약 작성
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

6. 개발 및 검증 원칙

  • 기준 L1 Controlled Blank는 절대 덮어쓰지 않는다.
  • 승인되지 않은 CAD 객체 추가·수정·삭제를 허용하지 않는다.
  • 실제 변경 작업은 별도의 Candidate 사본에서만 수행한다.
  • 기존 L2 객체 복사 방식과 신규 Solver 기반 배치 생성을 구분한다.
  • Source Revision 또는 SHA가 다르면 임의로 변경사항을 적용하지 않는다.
  • 변경 검증에 실패하면 결과 파일을 승인·승격하지 않는다.
  • 생성된 도면은 최종 납품 승인본이 아닌 Candidate로 관리한다.
  • 고객 자료를 외부 클라우드에 무단 전송하지 않는다.
  • Autodesk APS 및 유료 API 호출은 수행하지 않는다.
  • 최종 설계 적합성은 설계 전문가 검토를 거친다.

7. GitHub 관련 문서

GitHub Issue

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

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

기존 B001/B006 도면 작성 근거

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/workspaces/w0/t1-drawing-pilot-phase1/B001_B006_DRAWING_DECISION_BASIS_20260929.md

8. 후속 개발 연계

다음 작업: PoC-21 — 패널 수량·BOQ 및 설계변경 영향 분석

PoC-20에서 검증한 신규 L1 Candidate 도면과 Solver 배치 결과를 활용하여 모듈 수량, 관련 BOQ 항목 및 설계변경 영향 정보를 분석한다.

후속 PoC-22에서는 CAD 도면의 정량·시각 품질을 종합적으로 검증한다.

No data to display

Actions

Also available in: PDF Atom