Project

General

Profile

Actions

Feature #883

open
길문 영조

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

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

[PoC-16] 승인된 Engineering Knowledge의 L1 적용 가능성 검증

Feature #883: [PoC-16] 승인된 Engineering Knowledge의 L1 적용 가능성 검증

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

Status:
New
Priority:
High
Assignee:
Start date:
11/16/2026
Due date:
11/27/2026 (Due in 10 days)
% Done:

0%

Estimated time:

Description

PoC-16. 승인된 Engineering Knowledge의 L1 적용 가능성 검증

1. 작업 개요

본 PoC는 기존 L2 설계자료에서 추출하고 전문가 검증·승인을 거친 Approved Engineering Knowledge가 신규 L1 태양광 설치 사이트에 실제로 적용 가능한지 자동으로 판단하는 기능을 개발하는 작업이다.

PoC-12의 Approved Engineering Knowledge Registry와 PoC-13~15에서 생성한 Site Geometry, 설치 제약조건 및 태양광 모듈 사양을 연계한다.

핵심 목표는 승인된 규칙이라도 모든 신규 사이트에 무조건 적용하지 않고, 사이트 조건과 규칙의 적용 범위를 비교하여 적용 가능·적용 불가·추가 검토·보류 상태를 명확하게 구분하는 것이다.

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

상위 Redmine 일감: #867

담당: 조영우

PM 및 검토: 문길래

협력: 황수아, 이상재

계획 기간: 2026-12-03 ~ 2026-12-06

선행 작업: PoC-12, PoC-13, PoC-14, PoC-15

2. 세부 작업

STEP 1. Approved Engineering Knowledge 구조 확인

  • PoC-12의 Approved Knowledge Registry 및 승인 Gate 확인
  • 규칙별 Rule ID와 버전 구조 확인
  • 승인 상태·적용 조건·적용 범위 확인
  • 규칙의 유효성 및 철회·대체 상태 확인
  • 기존 Approved Engineering Knowledge v1 재사용 가능성 검토
  • L1 Solver에서 사용할 규칙 조회 계약 확인

STEP 2. 신규 L1 사이트 입력 데이터 확인

다음 데이터를 연계한다.

입력 데이터 연계 PoC
Site Geometry 및 좌표계 PoC-13
장애물·제외영역·이격거리 PoC-14
모듈 사양 및 배치 파라미터 PoC-15
Approved Engineering Knowledge PoC-12

각 데이터의 Source ID, Revision, 단위 및 검증 상태를 확인한다.

STEP 3. Engineering Knowledge 적용 조건 비교

규칙별 적용 조건과 L1 사이트 정보를 비교한다.

주요 비교 항목:

  1. 사이트 유형 및 설치 구역
  2. 모듈 규격 및 크기
  3. 모듈 배치 방향 및 회전각
  4. 허용 간격 및 이격조건
  5. 좌표계와 단위
  6. 장애물 및 설치 제외영역
  7. 규칙의 파라미터 허용 범위
  8. 적용 대상 Source 및 Revision
  9. 추가 설계 검토가 필요한 전제조건

단순히 규칙이 APPROVED 상태라는 이유만으로 신규 L1 사이트에 적용하지 않는다.

STEP 4. Rule Applicability Gate 구현

규칙의 적용 가능성을 다음 상태로 구분한다.

상태 의미
APPLICABLE 승인 상태가 유효하고 L1 적용 조건을 충족
NOT_APPLICABLE 해당 L1 사이트에 적용되지 않는 규칙
NEEDS_REVIEW 추가 설계 전문가 검토 필요
HOLD 필수 정보 누락·충돌 또는 검증 불가

규칙 적용 판단 시 적용 근거와 판단 이유를 함께 반환한다.

STEP 5. 승인되지 않은 규칙 및 예외 처리

다음 경우 자동 적용을 차단한다.

  • APPROVED 상태가 아닌 규칙
  • 승인이 철회된 규칙
  • 새로운 버전으로 대체되어 효력이 없는 규칙
  • L1 사이트 조건과 다른 규칙
  • 단위 또는 좌표계가 불명확한 규칙
  • 필수 설계 파라미터가 누락된 규칙
  • 다른 승인 규칙과 충돌하는 규칙
  • 필수 검증 Evidence가 확인되지 않는 규칙

필수 조건이 충족되지 않으면 임의 보정하거나 규칙을 자동 선택하지 않는다.

STEP 6. 적용 가능한 규칙 집합 생성

신규 L1 사이트에 적용 가능한 규칙을 선정하여 관리한다.

예상 산출물: rule_applicability_results.json

주요 필드:

  • Site ID
  • Site Source ID 및 Revision
  • Module Spec ID
  • Constraint Set ID
  • Rule ID
  • Rule Version
  • Rule Approval Status
  • Applicability Status
  • 적용 조건 및 비교 결과
  • 적용 파라미터
  • Evidence 및 Source Locator
  • HOLD 또는 REVIEW 사유
  • 검증 시각 및 실행 버전

PoC-17의 Solver가 사용한 규칙과 버전을 정확히 추적할 수 있도록 한다.

STEP 7. 규칙 충돌 및 우선순위 검증

  • 동일한 설계조건에 서로 다른 규칙이 적용되는지 확인
  • 규칙의 파라미터 충돌 탐지
  • 최신 버전과 과거 버전 적용 가능성 구분
  • Site 조건에 따라 규칙의 적용 범위가 달라지는지 확인
  • 우선순위 기준의 존재 여부 확인
  • 명확한 정책 없이 충돌을 임의 해결하지 않도록 처리

규칙 간 충돌이 해소되지 않으면 전문가 검토 또는 HOLD 대상으로 분류한다.

STEP 8. 자동 테스트 및 적용성 검증

다음 테스트를 수행한다.

  1. 승인되고 조건이 일치하는 규칙
  2. 승인되었으나 사이트 유형이 다른 규칙
  3. 모듈 규격이 일치하지 않는 규칙
  4. 미승인 또는 승인 철회된 규칙
  5. 적용 조건의 경계값
  6. 단위·좌표계 불일치
  7. 필수 입력값 누락
  8. 동일 설계조건의 규칙 충돌
  9. Source Revision 변경
  10. 테스트용 승인 데이터와 실제 승인 규칙의 구분

Golden Fixture와 pytest를 이용하여 결과를 재현 가능하게 검증한다.

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

PoC-17 자동배치 Solver가 사용할 데이터를 정의한다.

  • 검증된 Site Geometry
  • 설치 제약조건
  • 승인된 모듈 사양
  • Layout Parameters
  • 적용 가능한 Approved Engineering Knowledge
  • 규칙 버전과 Evidence
  • 적용 불가 및 HOLD 조건

Solver는 적용 불가능하거나 승인되지 않은 규칙을 자동으로 사용하지 않도록 설계한다.

STEP 10. GitHub 반영 및 결과 제출

  • Engineering Knowledge Applicability Evaluator 구현
  • Rule Applicability Gate 및 JSON Schema 작성
  • 정상·오류·충돌 테스트 작성
  • 실행 Evidence 및 HOLD 결과 기록
  • Windows PowerShell 실행 가이드 작성
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
조영우 L1 사이트와 Approved Knowledge 적용 조건 비교 및 Applicability Gate 구현
황수아 Approved Knowledge 구조·버전·검증 Evidence 연계
이상재 CAD Geometry·좌표계 및 Source 데이터 연동 지원
문길래 적용 정책·완료 기준·PR 최종 검토 및 전문가 검토 조정

4. 제출 산출물

  1. Approved Engineering Knowledge Applicability Evaluator
  2. 규칙 적용 가능성 판단 Gate
  3. rule_applicability_results.json 및 JSON Schema
  4. L1 사이트별 적용 가능 규칙 목록
  5. 적용 불가·충돌·추가 검토·HOLD 목록
  6. 규칙 버전 및 Evidence 추적 구조
  7. Golden Fixture 및 pytest 테스트
  8. PoC-17 Solver 입력 계약
  9. Windows 실행 가이드 및 GitHub PR

5. 완료 기준 (PASS)

  • Approved Knowledge Registry 및 승인 상태 연계
  • L1 Site·Constraints·ModuleSpec 입력 계약 확인
  • 규칙 적용 조건과 L1 사이트 조건 비교 구현
  • APPLICABLE / NOT_APPLICABLE / NEEDS_REVIEW / HOLD 상태 구분
  • 미승인·철회·대체 규칙 적용 차단
  • 단위·좌표계·Revision 검증
  • 누락값 및 규칙 충돌 처리
  • 적용 가능한 규칙과 버전 목록 생성
  • 규칙별 판단 근거 및 Evidence 추적
  • Golden Fixture 및 경계조건 테스트 PASS
  • 실제 승인 Knowledge와 테스트용 데이터 구분
  • 원본 Source 변경 없음
  • PoC-17 Solver 입력 JSON 계약 작성
  • 실행 Evidence 및 기술문서 작성
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

6. 개발 및 검증 원칙

  • 승인된 규칙이라도 모든 신규 L1 사이트에 적용 가능한 것은 아니다.
  • 규칙의 승인 상태와 신규 사이트 적용 가능성을 별도로 검증한다.
  • 미승인·철회·대체 규칙은 실제 자동설계에 적용하지 않는다.
  • 규칙 충돌을 근거 없이 임의 해결하지 않는다.
  • 단위·좌표계·Source Revision이 불명확한 경우 HOLD 처리한다.
  • 실제 설계 책임과 최종 적합성 판단은 설계 전문가의 검토를 거친다.
  • 테스트용 승인 Fixture를 실제 전문가 승인으로 표시하지 않는다.
  • 원본 DWG/DXF 및 설계문서를 임의로 수정하지 않는다.
  • 고객 자료의 무단 외부 전송 및 Autodesk APS 유료 API 호출은 수행하지 않는다.

7. GitHub 관련 문서

GitHub Issue

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

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

기존 Approved Engineering Knowledge

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/approved-engineering-knowledge-v1.md

8. 후속 개발 연계

다음 작업: PoC-17 — L1 기본 태양광 패널 자동배치 Solver 개발

PoC-16에서 검증된 적용 가능 규칙과 PoC-13~15의 L1 설계 입력 데이터를 바탕으로 패널의 실제 배치 좌표를 계산한다.

PoC-17에서는 기존 L2 도면의 모듈 객체를 단순 복사하는 방식이 아닌, 신규 L1 사이트의 Geometry와 제약조건을 반영하는 독립적인 자동배치 알고리즘을 구현한다.

Actions

Also available in: PDF Atom