Feature #912
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[INT-07] User Workflow / Admin — 실행·승인대기·도면 및 Evidence 조회
0%
Description
INT-07. User Workflow / Admin — 실행·승인대기·도면 및 Evidence 조회¶
1. 작업 개요¶
본 작업은 ICN Solar CAD Agent의 CAD 자동설계 기능을 사용자가 쉽게 실행하고 결과를 확인할 수 있도록 사용자 Workflow와 관리자 기능을 통합하는 작업이다.
MCP 기반 자동설계 기능과 기존 CAD Backend, Validation & Reporting 모듈을 연결하여 다음 기능을 제공한다.
- 신규 L1 사이트 및 설계조건 선택
- 승인된 Engineering Knowledge 버전 선택
- 태양광 자동설계 실행
- 작업 진행 상태 및 오류 확인
- 생성된 DXF Candidate 조회 및 다운로드
- CAD 품질 검증 보고서 확인
- Source·Knowledge·설계 결과 Evidence 조회
- 관리자 승인대기 및 검토 이력 관리
초기 구현은 기존 기술 스택을 최대한 재사용한 로컬 MVP를 기준으로 한다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/173
상위 Redmine 일감: #867
담당: 이상재
PM 및 검토: 문길래
협력: 조영우, 황수아
계획 기간: 2027-02-22 ~ 2027-02-26
2. 세부 작업¶
STEP 1. 기존 UI·API·MCP Workflow 조사¶
- 기존 사용자 UI 및 API 구조 확인
- 기존 FastMCP 서버와 Workflow 기능 조사
- 실행 이력 및 결과 저장 방식 확인
- 통합 Validation Report 구조 확인
- 기존 파일 관리 및 접근권한 정책 확인
- 재사용 가능한 화면·API 및 신규 개발 범위 결정
STEP 2. 사용자 기본 업무 흐름 설계¶
사용자 업무 흐름을 다음과 같이 정의한다.
- 프로젝트 또는 사이트 선택
- 허용된 L2 Source 조회
- Approved Engineering Knowledge 선택
- 신규 L1 Site Geometry 및 제약조건 확인
- 태양광 모듈 사양·배치 파라미터 설정
- 자동설계 실행 요청
- 작업 진행 상태 확인
- 배치 결과 및 CAD Candidate 조회
- QA Report 및 Evidence 확인
- 필요한 경우 검토·재실행 요청
STEP 3. 사용자 화면 구현¶
최소 화면 구성을 정의한다.
| 화면 | 주요 기능 |
|---|---|
| 프로젝트·사이트 선택 | 설계 대상 선택 |
| Source / Knowledge | 승인된 자료·규칙 버전 조회 |
| 설계조건 입력 | 모듈·배치 파라미터 확인 |
| 자동설계 실행 | MCP Workflow 실행 |
| 실행 현황 | 단계별 상태·진행 결과 확인 |
| CAD 결과 | DXF Candidate 조회·다운로드 |
| QA Report | Geometry·수량·Knowledge 검증 결과 |
| Evidence | Source·Rule·검증 근거 확인 |
STEP 4. 관리자 화면 구현¶
관리자에게 다음 기능을 제공한다.
- 전체 설계 실행 목록 조회
- 실행 상태 및 실패 원인 확인
- HOLD·NEEDS_REVIEW 목록 확인
- Engineering Knowledge 승인대기 항목 확인
- Source 및 Rule Version 확인
- CAD QA Report 조회
- 실행 이력 및 감사 기록 확인
- 승인 권한 범위 내 검토 결과 기록
- 재실행 및 후속 조치 관리
STEP 5. 실행 상태 및 데이터 모델 정의¶
다음 정보를 화면과 API에서 일관되게 제공한다.
- Run ID
- Project / Site ID
- Source SHA / Revision
- Applied Rule IDs / Versions
- Execution Stage
- Stage Status
- Layout Candidate ID
- DXF Candidate SHA
- Validation Report
- Evidence Locator
- Error / Warning
- Review Status
- Execution Timestamp
STEP 6. 상태 및 오류 표시¶
다음 상태를 명확히 구분한다.
| 상태 | 사용자 표시 의미 |
|---|---|
| NOT_STARTED | 실행 전 |
| RUNNING | 실행 중 |
| PASS | 필수 기술 검증 통과 |
| FAIL | 실행 또는 검증 실패 |
| HOLD | 필수 조건 미충족 |
| NEEDS_REVIEW | 추가 검토 필요 |
| VISUAL_PENDING | 시각 검증 미완료 |
기술 검증 통과와 설계 전문가의 최종 승인을 구분해 표시한다.
STEP 7. CAD 파일 및 보고서 조회¶
- 신규 DXF Candidate 파일 조회
- 파일 무결성 및 SHA 확인
- 사용자별 접근 가능 파일 확인
- 승인된 파일 다운로드
- 통합 JSON QA Report 조회
- Markdown/HTML 보고서 표시
- 수량·BOQ 분석 결과 확인
- Evidence 및 버전 추적 정보 조회
파일 경로 조작이나 승인되지 않은 원본 CAD 접근을 방지한다.
STEP 8. Knowledge 및 승인대기 Workflow¶
- Approved Knowledge 목록 조회
- Rule ID·Version 및 적용 범위 표시
- 승인대기 항목 확인
- 승인·보류·철회 이력 표시
- 승인자 및 판단 근거 조회
- 권한 없는 승인 처리 차단
AI 또는 일반 사용자가 전문가 승인 상태를 임의 변경할 수 없도록 한다.
STEP 9. 재실행 및 복구 기능 연계¶
INT-04의 복구 정책을 활용한다.
- 실패한 실행의 원인 확인
- 재실행 가능 여부 표시
- 중복 요청 처리
- Source·Rule·Approval Gate 재검증
- 기존 결과와 재실행 결과 비교
- 실행 이력 및 변경사항 추적
STEP 10. 사용자·관리자 권한 검증¶
- 허용된 Source만 조회 가능
- 사용자 권한에 따른 다운로드 제한
- 관리자 기능 접근 제한
- 승인 권한 검증
- 파일 경로 조작 방지
- 인증정보 및 민감정보 노출 방지
- 감사 기록 유지
STEP 11. UI 및 통합 테스트¶
다음 시나리오를 검증한다.
- 정상 프로젝트·사이트 선택
- 승인된 Rule 조회
- 신규 L1 자동설계 실행
- 실행 상태 확인
- DXF Candidate 다운로드
- QA Report 확인
- HOLD·FAIL 상태 표시
- 승인대기 상태 조회
- 권한 없는 Source 접근
- 권한 없는 승인 시도
- 잘못된 파일 경로 요청
- 재실행 및 중복 요청
실제 MCP 실행과 테스트용 Mock 결과를 구분한다.
STEP 12. GitHub 반영 및 결과 제출¶
- 사용자·관리자 Workflow 구현
- 화면 및 API 계약 작성
- 실행 상태 및 파일 조회 연계
- 승인·권한 검사 적용
- Golden Fixture 및 테스트
- 실제 실행 화면 Evidence
- Windows PowerShell 실행 가이드
- GitHub 작업 브랜치 및 PR 생성
- PM UX 검토 및 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 이상재 | 사용자·관리자 UI/API, MCP 실행·파일 조회 연계 |
| 조영우 | L1 설계 입력·Solver·수량·결과 표시 |
| 황수아 | Source·Knowledge 승인·Evidence 조회 |
| 문길래 | UX·권한·업무 흐름·PR 최종 검토 |
4. 제출 산출물¶
- 사용자 Workflow 및 기본 UI
- 관리자 실행·검토 화면
- 설계조건 입력 및 자동설계 실행 기능
- 실행 상태 및 오류 조회
- DXF Candidate 다운로드 기능
- QA Report 및 Evidence 조회
- Knowledge 승인대기·버전·이력 관리
- 접근권한 및 파일 보안 검증
- UI/API 테스트 및 화면 Evidence
- 사용 가이드 및 GitHub PR
5. 완료 기준 (PASS)¶
- 기존 UI·MCP·API 재사용 범위 조사
- 사용자 Workflow 정의
- 프로젝트·사이트 및 Knowledge 선택
- 신규 L1 자동설계 실행
- 단계별 실행 상태 표시
- DXF Candidate 및 보고서 조회
- Source·Rule·Candidate 버전 확인
- 관리자 승인대기 및 검토 상태 조회
- PASS/FAIL/HOLD/REVIEW 상태 구분
- 미완료 시각 QA를 PASS로 표시하지 않음
- 승인되지 않은 Rule 게시·도면 승격 차단
- 권한 없는 CAD 파일 접근 차단
- 재실행 및 중복 요청 처리 검증
- 사용자·관리자 Smoke Test PASS
- 실제 화면 및 실행 Evidence 확보
- 개발자별 교차검토
- GitHub PR 제출 및 PM 검토
- main 병합 및 INT-08 인계
6. 개발 및 검증 원칙¶
- 기존 MCP·CAD·Validation 기능을 우선 재사용한다.
- 복잡한 신규 프론트엔드 구축보다 최소 실행 가능한 MVP를 우선한다.
- 실제 설계 승인과 기술 검증 상태를 구분한다.
- 미승인 Engineering Knowledge를 사용하지 않는다.
- 원본 CAD와 Candidate CAD 파일을 분리한다.
- 접근권한이 없는 Source·Evidence를 노출하지 않는다.
- 파일 경로·API Token·개인정보를 보호한다.
- 고객자료를 승인 없이 외부로 전송하지 않는다.
- 유료 Autodesk APS API 호출은 승인 조건을 따른다.
- 최종 운영 배포와 설계 전문가 승인은 별도 단계에서 관리한다.
7. 참고 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/173
전체 통합 계획
INT-05 CAD Backend
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/171
INT-06 Validation & Reporting
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/172
8. 후속 작업¶
INT-08 — Auth / Security / Operations
사용자·관리자 기능을 기반으로 접근권한, 인증정보, 감사로그, 비용 통제 및 운영 보안 정책을 통합 검증한다.
No data to display