---
name: guardia-install
description: >
  GUARDiA ITSM 자동 설치 오케스트레이터.
  다음 상황에서 반드시 이 스킬을 사용:
  (1) "GUARDiA 설치", "GUARDiA 시스템 설치", "설치해 줘" 요청;
  (2) "1달 사용자", "체험판", "trial" 포함 설치 요청;
  (3) "GUARDiA 운영 설치", "개발 환경 설치" 요청;
  (4) setup 폴더에서 설치 관련 모든 요청.
  이 스킬 없이 설치를 직접 진행하지 말 것.
---

# GUARDiA ITSM 자동 설치 오케스트레이터

## 실행 순서

### Phase 0: 사용자 의도 파악

먼저 요청을 분석하여 설치 종류를 결정한다.

| 요청 키워드 | 설치 종류 | 라이선스 |
|-----------|---------|---------|
| 1달, 한달, 30일, 체험, trial | TRIAL_30 | 30일 체험판 자동 발급 |
| 7일, 1주일, 개발 | TRIAL_7  | 7일 체험판 |
| 운영, production | PROD     | 라이선스 키 입력 필요 |
| 대상서버, WAS서버 | TARGET   | 라이선스 불필요 |

---

### Phase 1: OS 자동 감지

**반드시 먼저 OS를 감지**하고 설치 스크립트를 선택한다.

```bash
# OS 감지 명령
uname -s 2>/dev/null          # Linux/Mac
[System.Environment]::OSVersion  # Windows (PowerShell)
```

| OS | 사용할 스크립트 |
|----|--------------|
| Windows (PowerShell) | `install_auto.ps1` |
| Ubuntu 20/22/24      | `install_auto.sh ubuntu` |
| CentOS 7/Stream      | `install_auto.sh centos` |
| RHEL 8/9             | `install_auto.sh rhel` |
| macOS                | `install_auto.sh mac` |

---

### Phase 2: 설치 전 확인

설치 시작 전에 반드시 다음을 확인하고 사용자에게 보고한다:

```
감지된 OS:     Windows 10 / Ubuntu 22.04 / ...
설치 종류:     1달 체험판
설치 항목:
  ✓ Python 3.11 + FastAPI (GUARDiA ITSM 백엔드)
  ✓ OpenJDK 17 + Tomcat 9 (WAS)
  ✓ PostgreSQL 또는 SQLite (DB)
  ✓ Ollama (온프레미스 AI, 약 4GB)
  ✓ Gitea (형상관리)
  ✓ Nginx (웹서버)
  ✓ 30일 체험 라이선스 자동 발급

예상 소요시간: 약 10~30분 (인터넷 속도에 따라)
디스크 필요:  약 10GB

설치를 시작할까요? (예/아니오)
```

사용자가 확인하면 Phase 3 진행.

---

### Phase 3: 설치 실행

**Windows:**
```powershell
# 관리자 권한 확인 후 실행
Set-ExecutionPolicy Bypass -Scope Process -Force
.\install_auto.ps1 -LicenseType trial30
```

**Linux:**
```bash
chmod +x install_auto.sh
sudo bash install_auto.sh --license trial30
```

설치 중 실시간 진행 상황을 사용자에게 보고한다:
- `[1/N] 패키지 설치...` 단계별 진행
- 오류 발생 시 즉시 보고 + 해결 방법 제시

---

### Phase 4: 라이선스 발급

설치 완료 후 체험 라이선스를 자동 발급한다.

```bash
# GUARDiA API로 30일 체험 라이선스 발급
curl -sf -X POST http://localhost:8001/api/license/trial \
  -H "Content-Type: application/json" \
  -d '{"customer": "체험판 사용자 (30일)"}'
```

라이선스 키를 발급받아 `.env`에 자동 저장.

---

### Phase 5: 설치 검증

`install_auto.sh --test` (또는 `install_auto.ps1 -Test`) 실행하여 모든 서비스 상태 확인.

---

### Phase 6: 완료 보고

설치 완료 후 반드시 다음 정보를 사용자에게 제공:

```
✅ GUARDiA ITSM 설치 완료!

접속 정보:
  GUARDiA 대시보드: http://[서버IP]
  초기 계정:        admin / 1111 (최초 로그인 시 변경)
  라이선스 만료:    30일 후 (YYYY-MM-DD)

서비스 현황:
  GUARDiA ITSM: ✅ 실행 중 (포트 8001)
  Tomcat:       ✅ 실행 중 (포트 8080)
  Ollama:       ✅ 실행 중 (포트 11434)
  Gitea:        ✅ 실행 중 (포트 3000)

다음 단계:
  1. http://[IP] 접속 → admin/1111 로그인
  2. 비밀번호 변경
  3. CMDB에 서버 등록
  4. 메신저 봇 연결 (선택)
```

---

## 오류 처리 원칙

- 설치 중 오류 → 즉시 사용자에게 보고, 단계 재시도 여부 확인
- 네트워크 오류 → 폐쇄망 패키지 사용 안내 (`download_packages.sh`)
- 권한 오류 → 관리자 권한으로 재실행 안내
- 포트 충돌 → 사용 중인 포트 프로세스 확인 후 조치