Feature #877
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-10] L2 설계 규칙 및 배치 패턴 Knowledge 후보 추출
0%
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. 제출 산출물¶
- Engineering Knowledge 후보 추출 기능
rule_candidates.json및 JSON Schema- 후보별 적용 조건·파라미터·단위 정의
- 후보별 CAD·문서 Evidence 연결 정보
- 중복·충돌·미확정 후보 목록
- 과적합 및 일반화 위험 검토 결과
- Golden Fixture 및 pytest 테스트
- 실제 L2 분석 Evidence
- PoC-11 검증 대상 목록
- 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 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
기존 Approved Engineering Knowledge
8. 후속 개발 연계¶
다음 작업: PoC-11 — Engineering Knowledge 반례 테스트 및 교차검증
PoC-10에서 추출한 Engineering Knowledge 후보를 대상으로 다른 설계 사례, 예외조건 및 충돌 여부를 확인한다.
반례 검증을 통과한 후보만 PoC-12의 전문가 승인 프로세스로 전달한다.
No data to display