Feature #879
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-12] Approved Engineering Knowledge 등록·승인 Gate 구현
0%
Description
PoC-12. Approved Engineering Knowledge 등록·승인 Gate 구현¶
1. 작업 개요¶
본 PoC는 PoC-10에서 추출하고 PoC-11에서 검증한 Engineering Knowledge 후보를 설계 전문가의 승인 절차를 거쳐 정식 Approved Engineering Knowledge로 등록·관리하는 기능을 구축하는 작업이다.
자동화 시스템이 추출한 설계 규칙은 충분한 Evidence와 검증 결과가 있더라도 자동으로 승인하지 않는다.
전문가 승인, 규칙 버전 관리, 적용 조건 및 철회 절차를 명확히 하여 신규 L1 사이트의 태양광 자동설계에 검증된 지식만 적용할 수 있도록 통제한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/153
상위 Redmine 일감: #867
담당: 황수아
PM 및 검토: 문길래
협력: 이상재, 조영우
계획 기간: 2026-12-01 ~ 2026-12-06
선행 작업: PoC-10, PoC-11
2. 세부 작업¶
STEP 1. 기존 Approved Engineering Knowledge 구조 조사¶
- 기존 Approved Engineering Knowledge v1 문서 확인
- 기존 Knowledge JSON 및 등록 구조 확인
- Engineering Knowledge 운영 가이드 검토
- 기존 승인 상태 및 Evidence 연결 방식 조사
- 규칙의 수정·대체·폐기 정책 확인
- 기존 기능의 REUSE / EXTEND / NEW / HOLD 분류
STEP 2. Engineering Knowledge 승인 상태 정의¶
다음과 같은 상태를 관리할 수 있도록 구현한다.
| 상태 | 의미 |
|---|---|
| PROPOSED | 신규 규칙 후보 |
| VALIDATED_CANDIDATE | 정의된 검증 범위에서 테스트를 통과한 후보 |
| REVIEW_PENDING | 전문가 승인 대기 |
| APPROVED | 권한 있는 전문가가 승인한 규칙 |
| REJECTED | 반려된 규칙 |
| HOLD | 근거 부족 또는 검토 보류 |
| SUPERSEDED | 새로운 버전으로 대체된 규칙 |
| REVOKED | 사용 승인이 철회된 규칙 |
실제 상태 코드와 전이 정책은 기존 저장소 정책을 우선 확인하여 호환되도록 구현한다.
STEP 3. 승인 전 필수 검증 Gate 구현¶
규칙 승인 전에 다음 조건을 확인한다.
- Rule Candidate ID 존재
- Source ID 및 SHA-256 확인
- 관련 설계도면 및 문서 Evidence 연결
- 적용 조건과 범위 정의
- 파라미터 및 단위 확인
- PoC-11 검증 결과 확인
- 미해결 반례 및 충돌 여부 확인
- 전문가 검토에 필요한 자료 완비
필수 검증 조건이 충족되지 않으면 승인 요청을 HOLD 또는 반려 처리한다.
STEP 4. 전문가 승인 및 감사 이력 구현¶
- 승인 요청 생성
- 승인 권한 확인
- 승인·보류·반려 처리
- 승인자 및 승인 시각 기록
- 승인 사유 및 검토 의견 보존
- 승인 당시 Evidence 및 규칙 버전 기록
- 승인 이후 변경 이력 추적
중요: PM의 개발 완료 승인과 설계 전문가의 기술적 설계 규칙 승인은 별도의 절차로 관리한다.
AI Agent 또는 권한이 없는 사용자가 단독으로 승인 상태를 변경하지 못하도록 제한한다.
STEP 5. Approved Knowledge Registry 구축¶
승인된 규칙을 버전 단위로 조회하고 관리할 수 있도록 한다.
예상 기능
- 규칙 ID 기반 조회
- 승인 규칙 목록 조회
- 규칙별 적용 조건 확인
- 규칙 버전 조회
- 출처 및 Evidence 조회
- 대체·철회 상태 확인
- 신규 L1 설계에 적용 가능한 규칙 조회
예상 산출물: 버전이 관리되는 Approved Engineering Knowledge Registry
STEP 6. 승인 규칙 버전 관리¶
- 신규 규칙 등록 및 버전 생성
- 기존 규칙 변경 시 신규 버전 발행
- 승인된 과거 버전의 불변 이력 보존
- 이전 규칙과 변경사항 비교
- 최신 유효 버전 식별
- 과거 설계 실행에 사용한 규칙 버전 추적
- 승인 철회 시 영향받는 설계의 재검토 필요성 표시
승인된 기존 기록을 임의로 덮어쓰지 않는다.
STEP 7. 미승인 규칙 자동 적용 차단¶
신규 L1 설계 실행 시 다음을 확인한다.
- Approved 상태 여부
- 승인 철회 또는 대체 여부
- 실제 설계 입력 조건에 대한 적용 가능성
- 규칙 버전 및 적용 범위
- 검증 Evidence 유효성
미승인·보류·반려·철회 규칙은 실제 설계 생성에 적용하지 않는다.
승인 상태와 별개로 신규 사이트에 적용 가능한지도 PoC-16에서 추가 검증한다.
STEP 8. 오류 및 보안 테스트¶
- 승인 권한 없는 사용자의 승인 시도
- 검증 결과가 없는 후보 승인 시도
- Source Revision 불일치
- 필수 Evidence 누락
- 승인된 규칙의 무단 수정
- 철회된 규칙의 적용 시도
- 서로 다른 사용자의 동시 승인 요청
- 승인 이력 누락 또는 변경 시도
- 승인 상태 우회 및 잘못된 버전 적용
테스트용 가상 승인과 실제 설계 전문가의 승인 결과를 명확히 구분한다.
STEP 9. 자동 테스트 및 운영 가이드¶
- Rule Lifecycle 단위 테스트
- 승인 권한 및 상태 전이 테스트
- 승인 전 필수조건 검증 테스트
- 버전 변경 및 이력 보존 테스트
- 철회·대체 규칙 차단 테스트
- 신규 L1 적용 조회 계약 테스트
- Windows 개발환경 실행 가이드 작성
- 승인자 및 PM 업무 절차 문서화
STEP 10. GitHub 반영 및 결과 제출¶
- Approved Knowledge Registry 및 Approval Gate 구현
- 규칙 상태 및 버전 관련 JSON Schema 작성
- 승인·반려·철회 테스트 코드 작성
- 실행 결과 및 Evidence 정리
- 개발·운영 가이드 작성
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 황수아 | Approval Gate, Knowledge Registry, 버전·상태 관리 및 검증 |
| 문길래 | 전체 승인 정책, PM 검토 및 설계 전문가 승인 절차 조정 |
| 이상재 | MCP Tool 및 향후 API 연동 계약 검토 |
| 조영우 | 신규 L1 Solver의 승인 규칙 조회·적용 조건 검토 |
4. 제출 산출물¶
- Engineering Knowledge Approval Gate
- Approved Knowledge Registry
- 규칙 상태 및 버전 관리 기능
- 승인·보류·반려·철회 처리 기능
- 승인자·시각·사유·Evidence 감사 이력
- 승인 전 필수 검증 정책 및 테스트
- 미승인·철회 규칙 적용 차단 테스트
- Knowledge JSON Schema 및 샘플 데이터
- PoC-16용 승인 규칙 조회 계약
- GitHub PR 및 PM 검토 결과
5. 완료 기준 (PASS)¶
- 기존 Approved Engineering Knowledge 정책 및 구현 조사
- 규칙 후보와 검증 결과의 연결 구조 확인
- 승인 상태 및 상태 전이 관리 구현
- 필수 Evidence 및 검증 결과 누락 시 승인 차단
- 승인 권한 없는 사용자 및 AI Agent 단독 승인 차단
- 전문가 승인자·시각·사유 기록
- 승인 규칙 버전 및 변경 이력 관리
- 과거 승인 규칙의 불변 기록 보존
- 승인 철회 및 대체 규칙 처리
- 미승인·철회 규칙의 신규 설계 적용 차단
- 보안·권한·오류·동시 승인 테스트 PASS
- 자동 테스트 및 실제 실행 Evidence 확보
- 운영 및 승인 절차 문서 작성
- PoC-16 연계 Knowledge 조회 계약 준비
- GitHub PR 제출 및 PM 검토 완료
- main 병합 및 후속 PoC 연계 준비 완료
6. 개발 및 검증 원칙¶
- AI는 Engineering Knowledge 후보를 제안하고 검증을 지원하지만 최종 승인하지 않는다.
- 승인 책임과 승인 주체를 명확히 기록한다.
- PM 개발 완료 판단과 엔지니어링 규칙 승인 판단을 혼동하지 않는다.
- 검증 Evidence가 부족한 후보는 승인하지 않는다.
- 승인된 규칙의 기존 버전을 임의로 수정하거나 삭제하지 않는다.
- 철회된 규칙은 후속 설계에 자동 적용하지 않는다.
- Approval Gate 테스트 PASS를 실제 설계 적합성 승인으로 간주하지 않는다.
- 원본 DWG/DXF 및 설계문서를 임의로 수정하지 않는다.
- 고객 설계자료를 무단으로 외부 클라우드에 전송하지 않는다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/153
기존 Approved Engineering Knowledge v1
Approved Engineering Knowledge JSON
25개 PoC 상세계획
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-13 — 신규 L1 Site Geometry·좌표계 분석
PoC-12에서 승인된 Engineering Knowledge를 활용하기 위한 다음 단계로, 조영우 담당의 신규 L1 사이트 분석 PoC를 진행한다.
PoC-13에서는 신규 사이트의 설치 가능 영역, 좌표계 및 Geometry 입력 구조를 정의하고, 이후 PoC-16에서 승인된 규칙의 적용 가능성을 검증한다.
No data to display