Project

General

Profile

Actions

Feature #912

open
길문 상이

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

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

[INT-07] User Workflow / Admin — 실행·승인대기·도면 및 Evidence 조회

Feature #912: [INT-07] User Workflow / Admin — 실행·승인대기·도면 및 Evidence 조회

Added by 길래 문 22 days ago.

Status:
New
Priority:
High
Assignee:
Start date:
02/22/2027
Due date:
02/26/2027 (Due in about 3 months)
% Done:

0%

Estimated time:

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. 사용자 기본 업무 흐름 설계

사용자 업무 흐름을 다음과 같이 정의한다.

  1. 프로젝트 또는 사이트 선택
  2. 허용된 L2 Source 조회
  3. Approved Engineering Knowledge 선택
  4. 신규 L1 Site Geometry 및 제약조건 확인
  5. 태양광 모듈 사양·배치 파라미터 설정
  6. 자동설계 실행 요청
  7. 작업 진행 상태 확인
  8. 배치 결과 및 CAD Candidate 조회
  9. QA Report 및 Evidence 확인
  10. 필요한 경우 검토·재실행 요청

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 및 통합 테스트

다음 시나리오를 검증한다.

  1. 정상 프로젝트·사이트 선택
  2. 승인된 Rule 조회
  3. 신규 L1 자동설계 실행
  4. 실행 상태 확인
  5. DXF Candidate 다운로드
  6. QA Report 확인
  7. HOLD·FAIL 상태 표시
  8. 승인대기 상태 조회
  9. 권한 없는 Source 접근
  10. 권한 없는 승인 시도
  11. 잘못된 파일 경로 요청
  12. 재실행 및 중복 요청

실제 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. 제출 산출물

  1. 사용자 Workflow 및 기본 UI
  2. 관리자 실행·검토 화면
  3. 설계조건 입력 및 자동설계 실행 기능
  4. 실행 상태 및 오류 조회
  5. DXF Candidate 다운로드 기능
  6. QA Report 및 Evidence 조회
  7. Knowledge 승인대기·버전·이력 관리
  8. 접근권한 및 파일 보안 검증
  9. UI/API 테스트 및 화면 Evidence
  10. 사용 가이드 및 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

전체 통합 계획

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-team-knowledge-integration-plan-20261025.md

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

Actions

Also available in: PDF Atom