Feature #916
openFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
[INT-10] Deploy / Runbook / Handover — 배포·운영 인수 및 최종 승인 Gate
0%
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¶
다음 기본 흐름을 검증한다.
- MCP 연결
- 승인된 L2 Source 조회
- Approved Engineering Knowledge 조회
- 신규 L1 입력
- 자동배치 Solver 실행
- 신규 DXF Candidate 생성
- Authorized Delta 검증
- 수량·BOQ 분석
- CAD Validation 및 QA Report 생성
- 사용자·관리자 화면에서 결과 확인
실제 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. 제출 산출물¶
deployment_runbook.mdinstallation_guide_windows.mdoperational_checklist.mdbackup_restore_rollback_procedure.mdrelease_manifest.jsonrelease_notes.mduser_admin_operation_manual.mdhandover_acceptance_record.md- 미해결 리스크 및 후속 작업 목록
- 설치·재시작·복구·롤백 테스트 Evidence
- 최종 릴리스 및 인수 Gate 판정
- 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
전체 통합 계획
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를 관리한다.