Project

General

Profile

Actions

Feature #916

open
길문 상이

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

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

[INT-10] Deploy / Runbook / Handover — 배포·운영 인수 및 최종 승인 Gate

Feature #916: [INT-10] Deploy / Runbook / Handover — 배포·운영 인수 및 최종 승인 Gate

Added by 길래 문 22 days ago. Updated 22 days ago.

Status:
New
Priority:
High
Assignee:
Start date:
03/08/2027
Due date:
03/12/2027 (Due in about 4 months)
% Done:

0%

Estimated time:

Description

INT-10. Deploy / Runbook / Handover — 배포·운영 인수 및 최종 승인 Gate

1. 작업 개요

본 작업은 ICN Solar CAD Agent의 PoC 25개와 통합 개발 및 검증(INT-01~09) 결과를 기반으로 최종 시스템의 설치·실행·백업·복원·롤백·운영 매뉴얼을 구축하고, 운영 인수 가능 여부를 검증하는 작업이다.

기존 Python FastMCP, CAD Backend, L1 Solver, Engineering Knowledge, 사용자·관리자 기능 및 Validation & Reporting 기능을 하나의 실행 가능한 시스템으로 정리한다.

주요 목표는 다음과 같다.

  • 승인된 환경에서 시스템 설치 및 실행 재현
  • MCP 및 CAD 서비스 시작·중지·재시작
  • 자동설계 기능의 배포 후 Smoke Test
  • 데이터 백업 및 복원 절차 검증
  • 장애 발생 시 안전한 롤백 및 복구
  • 시스템 설정·인증정보·운영 로그 관리
  • 사용자·관리자 운영 매뉴얼 작성
  • 최종 릴리스 및 인수 승인 Gate 확인

본 작업에서 기술 검증과 운영 인수 준비를 수행하되, 실제 운영환경 배포 또는 고객자료 변경은 별도 명시적 승인 후 진행한다.

GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/176

상위 Redmine 일감: #867

담당: 이상재

PM 및 최종 승인: 문길래

협력: 황수아, 조영우

계획 기간: 2027-03-08 ~ 2027-03-12

선행 작업: INT-01~09

2. 세부 작업

STEP 1. 최종 개발 및 검증 산출물 확인

  • PoC-01~25 결과 확인
  • INT-01~09 결과 확인
  • 통합 E2E·회귀·성능·UAT 보고서 확인
  • 미해결 CRITICAL·MAJOR 결함 확인
  • 통합 대상 GitHub Commit·Release Candidate 확정
  • Source·Engineering Knowledge·Schema·CAD Backend 버전 확인
  • 실제 운영 적용 가능 범위와 HOLD 항목 구분

STEP 2. 시스템 배포 환경 및 범위 정의

  • 개발·테스트·운영환경 분리
  • 초기 Windows 로컬 MVP 환경 확인
  • Python 및 필수 실행 라이브러리 확인
  • FastMCP 서버 실행 방식 확인
  • CAD Reader/Writer 및 Converter 의존성 확인
  • 파일 저장 경로·권한 및 로그 경로 확인
  • 운영계정 및 인증정보 관리 방식 결정
  • 선택적 Autodesk APS 사용 조건 확인

STEP 3. 재현 가능한 설치 절차 작성

  • GitHub 저장소에서 승인된 버전 Checkout
  • Python 가상환경 생성
  • 의존성 설치
  • 환경변수 및 비밀정보 설정
  • CAD 관련 실행 도구 설치 확인
  • MCP Client 연결 설정
  • 서비스 정상 실행
  • Health Check 수행
  • Golden Fixture Smoke Test 실행

예상 산출물: installation_guide_windows.md

STEP 4. 시스템 시작·중지·재시작 검증

  • MCP Server 시작
  • MCP Tool Discovery
  • CAD Backend 초기화
  • 정상 종료
  • 서비스 재시작
  • 오류 발생 후 재기동
  • 재기동 후 기존 Run 상태 확인
  • 기본 Health Check 및 실행 로그 점검

STEP 5. 배포 후 통합 Smoke Test

다음 기본 흐름을 검증한다.

  1. MCP 연결
  2. 승인된 L2 Source 조회
  3. Approved Engineering Knowledge 조회
  4. 신규 L1 입력
  5. 자동배치 Solver 실행
  6. 신규 DXF Candidate 생성
  7. Authorized Delta 검증
  8. 수량·BOQ 분석
  9. CAD Validation 및 QA Report 생성
  10. 사용자·관리자 화면에서 결과 확인

실제 MCP 호출, 자동화 테스트 및 Mock 결과는 구분하여 기록한다.

STEP 6. 백업 및 복원 정책 정의

다음 데이터의 백업·보존 범위를 정한다.

대상 관리 방향
Source Manifest 버전·SHA 유지
Engineering Knowledge Rule·승인 이력 보존
L1 설계 입력 Site·Constraints·ModuleSpec
Layout Candidate 자동배치 결과 보존
DXF Candidate 생성 도면·SHA
Quantity / BOQ 수량 및 비교 결과
QA Evidence 검증 근거·Run Manifest
운영 설정 비밀정보 분리 및 보호

백업 및 복원 테스트는 격리된 테스트 환경에서 실시한다.

STEP 7. 롤백 및 장애 복구 검증

  • 이전 Release 버전 확보
  • Release Candidate 및 파일 SHA 기록
  • 서비스 정지·재시작
  • 승인된 이전 버전 복귀
  • 설정 및 Schema 호환성 확인
  • 기존 Source 원본 보존
  • Knowledge 승인 상태 유지
  • 결과물과 Evidence 무결성 확인
  • 장애 복구 후 Smoke Test 수행

데이터를 삭제하거나 비가역적으로 변경하는 작업은 별도 승인 대상으로 관리한다.

STEP 8. 운영 로그 및 모니터링 정책

다음 항목을 추적한다.

  • MCP 서비스 상태
  • 실행 Run ID 및 단계별 상태
  • Source·Rule·Candidate 버전
  • CAD 생성·Validation 성공 여부
  • 오류·HOLD·승인대기 현황
  • 실행시간 및 리소스 사용량
  • API 사용량·Quota·비용
  • 서비스 재시작·복구 이력
  • 사용자·관리자 감사 로그

인증정보와 고객 CAD 원문을 로그에 노출하지 않는다.

STEP 9. 사용자 운영 매뉴얼 작성

  • 시스템 실행 및 MCP 연결
  • L2 Source 선택
  • Approved Engineering Knowledge 선택
  • 신규 L1 사이트 입력
  • 설계조건 및 모듈 규격 설정
  • 자동설계 실행
  • CAD Candidate 확인
  • 수량·BOQ 및 QA 보고서 조회
  • 오류·HOLD 상태 확인
  • 재실행 및 검토 요청

STEP 10. 관리자 운영 매뉴얼 작성

  • 서비스 상태 확인
  • 실행 이력 및 장애 조회
  • Source 및 Rule 버전 관리
  • 승인대기 및 검토 이력 관리
  • 감사 로그 확인
  • API 비용·사용량 확인
  • 서비스 재시작
  • 백업 및 복원
  • 장애·오류 대응
  • 릴리스 및 롤백 절차

STEP 11. 최종 릴리스 Manifest 작성

예상 산출물: release_manifest.json

주요 필드:

  • Release ID
  • Git Commit SHA
  • Release Tag
  • MCP Tool Version
  • Schema Version
  • CAD Backend Version
  • Solver Version
  • Source / Rule Registry Version
  • Artifact SHA
  • Installation Test Result
  • E2E Smoke Result
  • Backup / Restore Result
  • Rollback Test Result
  • Security Gate Status
  • UAT Status
  • Release Approval Status
  • Approval Evidence

STEP 12. 최종 인수 Gate 검증

다음 네 가지 상태를 명확히 분리한다.

POC_COMPLETE

PoC 단계별 기술 검증 완료.

INTEGRATED_SYSTEM_VERIFIED

MCP·CAD·Knowledge·Solver·QA가 실제로 연결된 시스템의 통합 검증 완료.

REAL_SITE_UAT_PASSED

사용 승인이 확인된 대표 실제 사이트에 대한 사용자·전문가 검토 완료.

PRODUCTION_RELEASE_APPROVED

필수 보안·품질·운영·UAT Gate 및 PM 승인 조건 충족.

앞선 단계가 완료되었더라도 다음 단계가 자동 승인되는 것은 아니다.

STEP 13. 운영 인수인계 및 미해결 항목 정리

  • 운영 책임자 지정
  • 장애 대응 담당자 및 연락체계
  • Source·Knowledge 유지보수 담당
  • Solver·CAD Backend 유지보수 담당
  • 테스트 및 품질 관리 담당
  • 미해결 위험과 HOLD 항목
  • 후속 개선 Backlog
  • 운영 승인·인수 기록
  • 필요한 경우 설계 전문가 별도 승인자료 연결

STEP 14. GitHub 최종 반영 및 작업 종료

  • 설치·배포·운영 문서 작성
  • 백업·복원·롤백 절차 작성
  • Release Manifest 및 Release Notes 작성
  • 재현 가능한 설치·Smoke Test
  • 통합 복구 테스트 Evidence
  • 운영·사용자 매뉴얼 정리
  • GitHub 작업 브랜치 및 PR 생성
  • 개발자별 검토
  • PM 최종 검토
  • main 병합 및 Release Tag 준비
  • 최종 인수 상태 기록

3. 업무분장

담당자 주요 책임
이상재 설치·배포·MCP·CAD Backend·운영 Runbook
황수아 Source·Knowledge·승인 이력·Evidence 인수
조영우 QA·E2E·성능·백업 복구 검증
문길래 최종 릴리스 Gate·운영 인수 및 PM 승인

4. 제출 산출물

  1. deployment_runbook.md
  2. installation_guide_windows.md
  3. operational_checklist.md
  4. backup_restore_rollback_procedure.md
  5. release_manifest.json
  6. release_notes.md
  7. user_admin_operation_manual.md
  8. handover_acceptance_record.md
  9. 미해결 리스크 및 후속 작업 목록
  10. 설치·재시작·복구·롤백 테스트 Evidence
  11. 최종 릴리스 및 인수 Gate 판정
  12. GitHub PR 및 PM 검토 기록

5. 완료 기준 (PASS)

  • PoC 및 INT 전체 개발·검증 결과 확인
  • 릴리스 차단 결함 및 HOLD 항목 확인
  • 승인된 배포 환경·Release Version 확정
  • 재현 가능한 설치 절차 작성 및 검증
  • FastMCP·CAD Backend 정상 구동
  • 서비스 시작·중지·재시작 검증
  • 대표 E2E Smoke Test PASS
  • Source·Rule·Candidate Version 추적
  • 데이터 백업 정책 수립
  • 격리환경 백업·복원 테스트
  • 격리환경 롤백 테스트
  • Source 원본 및 승인 이력 보호
  • 운영 로그·감사·비용 Gate 점검
  • 사용자 및 관리자 운영 매뉴얼 작성
  • 운영 책임자·장애 대응 절차 확인
  • Release Manifest 및 Notes 작성
  • 미해결 결함·HOLD 항목 후속 책임 지정
  • 개발자별 전문 영역 검토 완료
  • PM 최종 인수 판정 및 GitHub PR 병합

6. 운영 및 검증 원칙

  • 테스트 환경 검증을 실제 운영 배포 승인으로 간주하지 않는다.
  • 실제 운영환경 변경은 별도 명시적 승인 후 수행한다.
  • 고객 CAD 원본과 승인된 Engineering Knowledge 이력을 보호한다.
  • 승인되지 않은 Source·Rule·Delta를 적용하지 않는다.
  • 인증정보·비밀키를 GitHub 또는 문서에 기록하지 않는다.
  • 승인되지 않은 유료 APS 호출이나 고객자료 전송을 수행하지 않는다.
  • 실제 UAT가 미완료인 경우 완료로 표시하지 않는다.
  • 백업·복원·롤백은 실제 Evidence를 확보해야 한다.
  • 최종 시공용 도면에 대한 설계 전문가 판단은 별도 승인으로 관리한다.

7. 참고 문서

GitHub Issue

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/176

전체 통합 계획

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

INT-09 통합 QA 및 UAT

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/175

INT-08 보안 및 운영

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/174

8. 후속 작업

INT-10 완료 이후 PoC 25개와 INT 10개의 전체 산출물 및 미해결 항목을 종합하여 최종 개발·운영 인수 여부를 판단한다.

별도로 전체 35개 Redmine/GitHub 일감의 담당자·일정·작업량·선행 의존성을 확인하고, 병렬 개발을 위한 최종 WBS를 관리한다.


Related issues 1 (1 open — 0 closed)

Blocked by Feature #1196: [PoC-04 후속] Ubuntu 배포환경 MCP Source 접근·파일시스템 보안 검증New수아 황

Actions

길문 Updated by 길래 문 22 days ago Actions #1

  • Parent task set to #867

수황 Updated by 수아 황 21 days ago Actions #2

  • Blocked by Feature #1196: [PoC-04 후속] Ubuntu 배포환경 MCP Source 접근·파일시스템 보안 검증 added
Actions

Also available in: PDF Atom