Feature #905
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[PoC-25] MCP 기반 L2 Knowledge → L1 설계 End-to-End 통합
0%
Description
PoC-25. MCP 기반 L2 Knowledge → L1 설계 End-to-End 통합¶
1. 작업 개요¶
본 PoC는 앞서 수행한 PoC-01~24의 개발 성과를 연결하여 기존 L2 설계자료에서 검증된 Engineering Knowledge를 추출하고, 신규 L1 사이트에 적용하여 태양광 패널 배치도면을 자동으로 생성·검증하는 전체 MCP 기반 End-to-End 프로세스를 완성하는 작업이다.
사용자는 VSCode Copilot 등 MCP Client에서 자연어로 CAD 분석 및 자동설계 기능을 요청할 수 있어야 한다.
시스템은 요청을 해석한 뒤 허용된 MCP Tool을 호출하여 Source 조회, Knowledge 검증, L1 분석, 배치 계산, CAD 도면 생성, 수량 분석 및 QA 결과를 제공한다.
본 PoC에서는 시스템의 기술적 통합을 검증하며, 실제 설계 전문가의 최종 승인과 운영 적용은 별도 절차로 관리한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/166
상위 Redmine 일감: #867
총괄 담당: 문길래
공동 수행: 황수아, 이상재, 조영우
계획 기간: 2027-01-18 ~ 2027-01-31
선행 작업: PoC-01~24의 관련 산출물
2. 전체 통합 업무 흐름¶
- MCP Client 연결 및 사용자 요청
- L2 Source 목록 조회 및 접근 권한 확인
- 기존 L2 DXF·계산서·BOQ 분석
- Engineering Knowledge 후보 및 Evidence 확인
- 전문가 승인된 Engineering Knowledge 조회
- 신규 L1 사이트 Geometry 및 제약조건 분석
- Approved Knowledge의 L1 적용 가능성 검증
- 태양광 모듈 사양 및 배치 파라미터 적용
- 자동배치 Solver를 통한 모듈 좌표 계산
- 신규 DXF Candidate 생성
- Authorized Delta 적용 및 원본 보존 검증
- 패널 수량·BOQ 및 변경 영향 분석
- DXF 정량 QA 및 DWG/PDF 시각 검증
- 최종 통합 검증 보고서 및 Evidence 생성
3. 세부 작업¶
STEP 1. 전체 PoC 결과 및 입력·출력 계약 점검¶
- PoC-01~24의 완료·미완료 항목 확인
- MCP Tool별 입력·출력 JSON Schema 확인
- Source 및 Knowledge 데이터 계약 확인
- Solver·CAD Writer·QA 모듈 연계 가능성 검토
- 누락된 연결 지점과 검증 필요 항목 확인
- 기술적으로 연결 가능한 범위와 HOLD 항목 구분
STEP 2. MCP 서버 및 Client 통합¶
- Python FastMCP 서버 구동
- MCP Tool 목록 및 입력 Schema 확인
- VSCode Copilot MCP 연결
- 자연어 요청에 따른 Tool 호출 검증
- Tool 입력값 및 결과 데이터 전달 확인
- 잘못된 Tool 입력 및 호출 오류 처리
- 실제 Client 호출과 테스트용 Mock 실행 구분
STEP 3. L2 Source 및 Evidence 파이프라인 연결¶
- Source Manifest 조회
- Source 권한 및 SHA-256 확인
- 기존 L2 DXF 분석
- CAD Layer·Block·Entity 추출
- 기존 모듈 배치 패턴 분석
- 계산서 및 BOQ 정보 분석
- CAD 객체와 문서 Evidence 연결
Source에 접근할 권한이 없거나 Revision이 확인되지 않으면 이후 작업을 HOLD 처리한다.
STEP 4. Engineering Knowledge 승인 및 적용¶
- L2에서 추출된 Engineering Knowledge 후보 조회
- 반례 및 교차검증 결과 확인
- 전문가 승인 상태 확인
- 규칙의 버전·효력·철회 상태 확인
- 신규 L1 적용 조건 비교
- 적용 가능한 승인 규칙 선정
- 적용 불가 및 추가 검토 규칙 구분
미승인 Knowledge의 자동 적용은 금지한다.
STEP 5. 신규 L1 사이트 설계 입력 분석¶
- 신규 L1 Source 및 사이트 정보 조회
- Site Boundary와 Polygon 분석
- 좌표계 및 단위 검증
- 장애물·제외영역·이격조건 적용
- 설치 후보 영역 계산
- 태양광 모듈 규격 확인
- 배치 파라미터 검증
STEP 6. L1 태양광 패널 자동배치¶
- Site Model과 제약조건 입력
- Approved Knowledge 적용
- 모듈 배치 방향 및 간격 설정
- 패널 Footprint 계산
- 기본·부정형 사이트 Solver 실행
- 모듈 간 충돌 및 경계 검증
- Layout Candidate JSON 생성
- 동일 입력의 반복 실행 결과 검증
기존 L2 객체 복사와 신규 L1 배치 좌표 계산을 구분한다.
STEP 7. 신규 DXF 생성 및 Authorized Delta 적용¶
- Solver 결과를 CAD Entity로 변환
- 신규 L1 DXF Candidate 생성
- DXF 재열기 및 Audit
- Controlled Blank Source 확인
- 승인된 변경 범위 확인
- Authorized Delta 적용
- 원본 보존 및 변경 전후 Diff 검증
원본 L1 Controlled Blank는 수정하지 않는다.
STEP 8. 수량·BOQ 및 설계변경 영향 분석¶
- Solver 및 DXF 모듈 수량 비교
- Authorized Delta 수량 정합성 확인
- 모듈 규격별 수량 집계
- Baseline 대비 변경 수량 계산
- BOQ 관련 항목 연결
- 불일치 및 미확정 항목 분류
- Quantity Impact Report 생성
근거가 없는 단가·비용은 임의 산출하지 않는다.
STEP 9. CAD 정량 및 시각 QA¶
- DXF Parsing 및 Audit
- Layer·Block·Entity 구조 검증
- 모듈 좌표·치수·회전각 검증
- 배치 제약조건 위반 확인
- Authorized Delta 범위 검증
- DWG/PDF 변환 및 렌더링 확인
- 시각 품질 Evidence 수집
- 정량 PASS와 시각 PASS 구분
- 설계 전문가 검토 필요사항 표시
실제 렌더링이 불가능하면 VISUAL_PENDING으로 기록한다.
STEP 10. Autodesk APS 선택적 연동¶
PoC-23~24에서 승인된 범위만 사용한다.
- Local-only 기본 경로 유지
- APS가 필요한 기능의 적용 조건 확인
- API 인증·비용·보안 Gate 검증
- 승인된 자료에 대해서만 외부 API 호출
- APS 장애 시 허용된 로컬 경로로 복귀
- 사용 여부 및 호출 Evidence 기록
APS의 실제 연동은 필수 PASS 조건이 아니라, 승인된 적용 범위에 따라 관리한다.
STEP 11. End-to-End 통합 테스트¶
정상 시나리오
- L2 Source 조회
- Approved Knowledge 확보
- 신규 L1 사이트 분석
- 배치 Solver 실행
- DXF Candidate 생성
- Authorized Delta 적용
- 수량·BOQ 분석
- CAD QA
- 통합 결과 보고
오류 및 HOLD 시나리오
- Source 접근 거부
- Source Revision 불일치
- Engineering Knowledge 승인 누락
- 규칙 적용 조건 불일치
- 단위·좌표계 미확정
- 잘못된 모듈 사양
- 설치 불가능한 사이트
- CAD 객체 생성 또는 Audit 실패
- Authorized Delta 범위 위반
- 수량 불일치
- DWG/PDF 시각 검증 미완료
- 외부 API 권한·비용 승인 누락
STEP 12. E2E Evidence 및 실행 이력 구축¶
예상 산출물: e2e_run_manifest.json
주요 필드:
- E2E Run ID
- MCP Client 및 Tool Version
- Source IDs / SHA / Revisions
- Applied Rule IDs / Versions
- L1 Site Model
- Constraint Set ID
- Module Spec ID
- Solver Version
- Layout Candidate ID
- DXF Candidate SHA
- Authorized Delta Manifest
- Quantity Impact Report
- CAD QA Report
- Stage별 PASS/FAIL/HOLD
- Execution Timestamp 및 Duration
- Evidence Locator
- Final Technical Status
- Engineering Review Status
전체 실행을 하나의 Run ID로 추적할 수 있어야 한다.
STEP 13. 통합 보고서 및 인수인계¶
- E2E 테스트 결과 요약
- 단계별 PASS/FAIL/HOLD 현황
- 미해결 결함 및 개선 필요사항
- 재현 가능한 실행 가이드
- 보안·비용·고객자료 사용 정책
- 개발자별 담당 기능과 운영 책임
- 통합 테스트 단계 INT-01~10 인계 기준
STEP 14. GitHub 반영 및 최종 PoC 검토¶
- MCP E2E Orchestration 코드 정리
- Tool Contract 및 Sequence Diagram 작성
- 통합 Fixture 및 pytest 작성
- 실제 MCP Client 호출 Evidence 확보
- E2E Run Manifest 및 QA 보고서 생성
- GitHub PR 제출
- 개발자별 결과 검토
- PM 최종 기술 검증
- main 병합 및 PoC 단계 종료 판정
4. 업무분장¶
| 담당자 | 주요 책임 |
|---|---|
| 문길래 | 전체 E2E 통합 총괄, 범위·품질·Gate·일정 및 PM 판정 |
| 황수아 | L2 Source·Evidence·BOQ·Approved Engineering Knowledge |
| 이상재 | FastMCP·CAD Reader/Writer·Authorized Delta·CAD QA·APS |
| 조영우 | L1 Site·Constraints·ModuleSpec·Solver·수량 분석 |
각 전문 영역의 검증 결과는 해당 담당자가 확인하고, 통합 판정은 PM이 수행한다.
5. 제출 산출물¶
- MCP 기반 End-to-End Orchestration
- MCP Tool별 입력·출력 계약 및 Sequence Diagram
- L2 → Knowledge → L1 전체 통합 실행 결과
- 신규 L1 Layout Candidate 및 DXF Candidate
- Authorized Delta 및 원본 보존 Evidence
- Quantity Impact Report
- CAD 정량·시각 QA Report
e2e_run_manifest.json및 JSON Schema- Golden E2E Fixture 및 pytest 결과
- 실제 MCP Client 호출 Evidence
- HOLD·REVIEW·개선 필요사항 목록
- 통합 실행 및 복구 가이드
- INT-01~10 단계 인수인계 문서
- GitHub PR 및 PM 최종 검토 결과
6. 완료 기준 (PASS)¶
- MCP Server 및 VSCode Copilot Tool 호출 검증
- L2 Source 접근·무결성 Gate 연결
- CAD·계산서·BOQ Evidence 연결
- Approved Engineering Knowledge 승인·버전 확인
- 승인 규칙의 L1 적용 가능성 검증
- 신규 L1 Site Geometry·제약조건 입력 확인
- Solver 신규 패널 배치 좌표 계산 성공
- Layout Candidate JSON 생성
- DXF Candidate 생성 및 Audit PASS
- Authorized Delta 및 원본 보존 검증
- Solver·DXF·BOQ 관련 수량 정합성 확인
- DXF 정량 QA 통과
- DWG/PDF 시각 QA 결과 또는 미검증 상태 명시
- 필수 승인·보안·비용 Gate 위반 없음
- 단계별 Evidence 및 Source·Rule Version 추적
- 동일 Golden Fixture E2E 결과 재현
- 오류·HOLD·재실행 시나리오 검증
- 개발자 3명의 전문 영역 검토 완료
- PM 최종 검토 및 INT 단계 인수인계
- GitHub PR 병합 및 PoC 종료 판정
필수 Gate가 충족되지 않은 경우에는 완료 처리하지 않고 HOLD 및 후속 조치 항목을 기록한다.
7. 개발 및 검증 원칙¶
- 기존 L2 객체 복사가 아닌 신규 L1 Solver 기반 설계를 수행한다.
- 미승인 Engineering Knowledge를 사용하지 않는다.
- 모든 Source·Rule·Candidate의 버전을 추적한다.
- 원본 CAD 및 설계자료는 임의로 수정하지 않는다.
- Authorized Delta 외 변경사항을 허용하지 않는다.
- 실제 시각 검증 없이 CAD QA PASS를 선언하지 않는다.
- APS는 승인된 경우에만 선택적으로 사용한다.
- 고객 자료를 승인 없이 외부 전송하지 않는다.
- 유료 API를 승인 없이 호출하지 않는다.
- PoC 기술 PASS와 설계 전문가의 최종 승인을 구분한다.
- Mock 결과를 실제 MCP 호출 또는 실도면 검증 결과로 표시하지 않는다.
8. 관련 GitHub 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/166
25개 PoC 상세계획
전체 업무계획
업무분장 및 시스템 통합계획
9. 후속 개발 연계¶
다음 단계: INT-01~10 — 전체 플랫폼 통합·품질·운영 검증
PoC-25에서 검증한 기술 흐름을 기반으로 전문 영역 간 통합 계약을 확정하고, 사용자 시나리오·오류 복구·보안·성능·운영 가능성을 단계별로 검증한다.
최종 통합 검증 결과와 미해결 항목을 바탕으로 실제 플랫폼 적용 및 운영 승인 여부를 결정한다.
No data to display