Project

General

Profile

Actions

Feature #877

open
길문 수황

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

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

[PoC-10] L2 설계 규칙 및 배치 패턴 Knowledge 후보 추출

Feature #877: [PoC-10] L2 설계 규칙 및 배치 패턴 Knowledge 후보 추출

Added by 길래 문 23 days ago.

Status:
New
Priority:
High
Assignee:
Start date:
11/25/2026
Due date:
12/01/2026 (Due in 14 days)
% Done:

0%

Estimated time:

Description

PoC-10. L2 설계 규칙 및 배치 패턴 Knowledge 후보 추출

1. 작업 개요

본 PoC는 기존 L2 태양광 설계도면과 설계계산서·수량산출서·BOQ에서 분석한 데이터를 바탕으로 재사용 가능한 Engineering Knowledge 후보(Rule Candidate)를 도출하고 구조화하는 기능을 구축하는 작업이다.

PoC-07의 CAD 배치 관찰 데이터, PoC-08의 설계문서 분석 결과 및 PoC-09의 Evidence Crosswalk를 활용한다.

단순한 CAD 객체의 반복 패턴을 넘어 설계 규칙으로 활용할 가능성이 있는 조건과 관계를 찾되, 이 단계에서는 확정된 설계 규칙이 아닌 후보만 생성한다.

후보에 대한 반례 검증은 PoC-11에서, 전문가 승인 및 적용 통제는 PoC-12에서 별도로 수행한다.

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

상위 Redmine 일감: #867

담당: 황수아

PM 및 검토: 문길래

협력: 이상재, 조영우

계획 기간: 2026-11-25 ~ 2026-12-01

선행 작업: PoC-07, PoC-08, PoC-09

2. 세부 작업

STEP 1. 기존 Engineering Knowledge 자산 조사

  • 기존 Approved Engineering Knowledge 구조 확인
  • Engineering Knowledge 운영 가이드 및 승인 기준 검토
  • 기존 Rule Candidate 또는 Evidence 관리 코드 조사
  • 기존 설계 규칙과 신규 후보 간 중복 가능성 확인
  • REUSE / EXTEND / NEW / HOLD 분류

STEP 2. L2 설계 관찰 데이터 분석

다음 정보를 분석한다.

  • 태양광 모듈 크기 및 형태
  • 모듈 배치 방향과 회전각
  • 모듈 간 거리 및 반복 간격
  • Row/Column 배치 패턴
  • 설치 구역별 배치 차이
  • CAD 모듈 수량과 계산서·BOQ 간 관계
  • 반복적으로 관찰되는 설계 파라미터

관찰된 특성과 실제 설계기준의 차이를 명확히 구분한다.

STEP 3. Engineering Knowledge 후보 도출

다음 유형의 규칙 후보를 도출할 수 있도록 구성한다.

① 모듈 배치 관련 후보

  • 모듈의 배치 방향
  • 모듈 간 반복 간격
  • 행·열 배열 패턴
  • 특정 설치 구역의 배치 특성

② 설계 제약조건 관련 후보

  • 설치 제외 영역과의 관계
  • 구조물 및 장애물과의 거리
  • 구역별 배치 제한 가능성
  • 설계 변경 시 영향을 받는 조건

③ 수량 및 계산 관련 후보

  • CAD 모듈 수량과 산출물 수량의 연결 관계
  • 모듈 사양과 전력용량 계산의 관계
  • 설계 범위별 수량 집계 방식

각 항목은 근거가 확인되는 경우에만 후보로 등록하며, 설계기준으로 일반화하려면 별도의 검증이 필요하다.

STEP 4. Rule Candidate 데이터 모델 정의

예상 산출물: rule_candidates.json

주요 필드:

필드 내용
rule_id 규칙 후보 고유 식별자
title 후보 이름
hypothesis 설계 규칙에 대한 가설
condition 적용 조건
scope 적용 가능 범위
parameters 수치 및 설계 파라미터
units 단위
evidence CAD·계산서·BOQ 근거
source_revision 원본 버전
confidence 후보 신뢰도 또는 근거 수준
status 후보 검증 상태
limitations 한계와 예외조건

모든 후보는 출처와 검증 상태를 추적할 수 있어야 한다.

STEP 5. 후보 중복 및 충돌 분석

  • 동일하거나 유사한 설계 규칙 후보 탐지
  • 다른 Source에서 반복 관찰된 후보 비교
  • 설계 Revision에 따른 차이 확인
  • 후보 간 파라미터 충돌 탐지
  • 적용 구역 및 조건의 불일치 확인
  • 근거가 부족한 후보와 추가 검증 대상을 구분

중요: 서로 다른 도면에서 유사한 배치가 발견되었다는 사실만으로 공식 설계기준이라고 판단하지 않는다.

STEP 6. 후보 상태 및 승인 전 통제

초기 후보는 다음 상태로 관리한다.

  • PROPOSED: 신규 후보 등록
  • NEEDS_EVIDENCE: 추가 근거 필요
  • REVIEW: 검토 필요
  • HOLD: 근거 충돌 또는 검증 불가

승인 전 후보가 자동으로 APPROVED 상태로 변경되지 않도록 처리한다.

또한 승인되지 않은 후보는 신규 L1 설계에 직접 적용할 수 없도록 구분한다.

STEP 7. 과적합 및 일반화 위험 검토

다음 항목을 확인한다.

  • 특정 L2 사이트에서만 성립하는 배치 패턴인지
  • 하나의 도면 또는 구역에 편중된 후보인지
  • 모듈 규격이나 설치 조건 변화에 영향을 받는지
  • 전기·구조·시공 관련 제약조건이 확인되었는지
  • 단위 및 좌표 기준이 검증되었는지
  • 실제 설계기준이 아닌 단순 반복 관찰인지

확인되지 않은 항목은 전문가 검토 또는 추가 Evidence 수집 대상으로 분류한다.

STEP 8. 자동 테스트 및 검증

  • 정상 Observation 데이터 입력 테스트
  • Evidence와 규칙 후보 연결 검증
  • Rule Candidate JSON Schema 검증
  • 적용 조건·단위·버전 누락 테스트
  • 후보 중복 및 충돌 처리 테스트
  • 근거 부족 후보의 REVIEW/HOLD 처리 검증
  • 승인되지 않은 후보의 자동 적용 차단 확인
  • 실제 L2 자료 기반 후보 추출 결과 검토

합성 테스트와 실제 자료 분석 결과를 구분하여 기록한다.

STEP 9. GitHub 반영 및 결과 제출

  • 기존 Knowledge 처리 코드 재사용 또는 확장
  • Rule Candidate 추출 기능 구현
  • JSON Schema 및 후보 샘플 작성
  • 검증·충돌·미확정 목록 작성
  • pytest 및 실행 Evidence 제출
  • Windows 실행 가이드 작성
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
황수아 Engineering Knowledge 후보 추출 및 데이터 모델 구현
이상재 CAD Geometry 및 도면 Evidence 연계 검토
조영우 신규 L1 설계에서의 규칙 적용 조건 및 파라미터 검토
문길래 후보 분류·검증 기준 및 GitHub PR 최종 검토

4. 제출 산출물

  1. Engineering Knowledge 후보 추출 기능
  2. rule_candidates.json 및 JSON Schema
  3. 후보별 적용 조건·파라미터·단위 정의
  4. 후보별 CAD·문서 Evidence 연결 정보
  5. 중복·충돌·미확정 후보 목록
  6. 과적합 및 일반화 위험 검토 결과
  7. Golden Fixture 및 pytest 테스트
  8. 실제 L2 분석 Evidence
  9. PoC-11 검증 대상 목록
  10. GitHub PR 및 PM 검토 결과

5. 완료 기준 (PASS)

  • 기존 Engineering Knowledge 자산 조사 완료
  • L2 CAD 및 설계문서 관찰 데이터 연계
  • Evidence 기반 Rule Candidate 생성
  • 후보별 적용 조건·범위·단위 정의
  • Source ID·SHA·Revision·Locator 기록
  • 후보 중복 및 충돌 탐지
  • 미확정·근거 부족 후보 분류
  • 단일 사례 일반화 위험 검토
  • 승인 전 후보의 자동 적용 차단
  • Rule Candidate JSON Schema 검증
  • 자동 테스트 및 실제 실행 Evidence 확보
  • PoC-11 반례 검증 대상 및 우선순위 정리
  • GitHub PR 제출 및 PM 검토 완료
  • main 병합 및 후속 PoC 연계 준비 완료

6. 개발 및 검증 원칙

  • 관찰된 설계 패턴과 검증된 설계 규칙을 구분한다.
  • AI의 추론 결과만으로 Engineering Knowledge를 승인하지 않는다.
  • 모든 규칙 후보에 출처·적용 조건·불확실성을 기록한다.
  • 단일 L2 사례의 조건을 신규 L1에 무조건 일반화하지 않는다.
  • 근거가 부족한 규칙 후보는 HOLD 또는 REVIEW로 처리한다.
  • 승인되지 않은 후보는 실제 설계 생성에 적용하지 않는다.
  • 원본 설계도면 및 산출물은 임의로 수정하지 않는다.
  • 고객 자료의 무단 외부 업로드 및 Autodesk APS 유료 API 호출은 수행하지 않는다.

7. GitHub 관련 문서

GitHub Issue

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

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-11 — Engineering Knowledge 반례 테스트 및 교차검증

PoC-10에서 추출한 Engineering Knowledge 후보를 대상으로 다른 설계 사례, 예외조건 및 충돌 여부를 확인한다.

반례 검증을 통과한 후보만 PoC-12의 전문가 승인 프로세스로 전달한다.

No data to display

Actions

Also available in: PDF Atom