# GUARDiA 프로젝트 세션 전체 작업 요약

> **세션 날짜**: 2026-05-30 ~ 2026-05-31  
> **작성 목적**: clear 전 중요 내용 및 스킬 보존

---

## 1. 서버 구성 (zioinfo.co.kr)

### 설치 완료 SW

| 카테고리 | SW | 포트 |
|----------|-----|------|
| 웹 서버 | Nginx 1.24 | 80/443 |
| 홈페이지 | Spring Boot 3.2.5 | 8082 |
| ITSM | GUARDiA FastAPI v2.0 | 8001/8443 |
| 관리자 | GUARDiA Manager | 8090/8002 |
| DB | PostgreSQL 16.11 | 5432 |
| AI | Ollama + Llama3:8b + nomic-embed-text | 11434 |
| AI 프레임워크 | LangChain 1.3.2 + ChromaDB 1.5.9 | - |
| Git | Gitea 1.22.3 | 3000 |
| CI/CD | Jenkins 2.555 + Deploy Webhook | 8080/9999 |
| 메일 | Postfix + Dovecot | 25/587/143/993 |

### Gitea 저장소

```
http://zioinfo.co.kr:3000
├── zio/zioinfo-web       ← 홈페이지 (Spring Boot + React)
├── zio/guardia-itsm      ← GUARDiA ITSM (FastAPI)
└── zio/guardia-messenger ← GUARDiA Messenger (React Native)
```

### CI/CD 흐름

```
git push gitea main
  → Gitea Webhook → Deploy Server(9999)
  → git pull → 빌드 → systemctl restart
```

---

## 2. 개발 완료 시스템

### 2-1. GUARDiA ITSM (기존 + 추가)

- **개방망 지원**: HTTPS 8443, API Key 인증, CORS 외부 허용
- **라이선스**: TRIAL/COMMUNITY/STANDARD/ENTERPRISE 관리
- **Export/Import**: 폐쇄망 데이터 번들 (HMAC-SHA256 서명)
- **AI 프레임워크**: LangChain + ChromaDB + 코드베이스 임베딩
- **datetime 버그 수정**: timezone-aware/naive 충돌 → .replace(tzinfo=None)

### 2-2. GUARDiA Manager (신규)

```
http://zioinfo.co.kr:8090
```

| 화면 | 기능 |
|------|------|
| 대시보드 | SR 통계, 리소스 게이지, 배포 타임라인 |
| 서버/CMDB | 자산 목록, 서비스 재시작 |
| 배포/CI-CD | 배포 이력, 수동 트리거 |
| 보안 | API Key 발급/관리, 감사 로그 |
| 라이선스 | 에디션 관리, 체험판 발급, 이력 |
| 데이터 연동 | Export/Import (폐쇄망 연동) |
| LLM | Ollama 모델 현황 |
| 설정 | .env 뷰어, Nginx 리로드 |

### 2-3. GUARDiA Messenger (신규)

```
패키지: kr.co.zioinfo.guardia
EAS 계정: zioinfo / 프로젝트: ca2f72d6-...
성공 빌드: 51096ada (Android APK)
```

**⚠️ EAS 빌드 필수 원칙**:
1. `.easignore`: android/, ios/ 반드시 포함
2. `plugins/withGradleProps.js`: `enablePngCrunchInReleaseBuilds=false`
3. `expo-notifications`: app.json plugins 등록 금지
4. `babel.config.js`: `babel-preset-expo`만 사용

**알림 연동**:
- WebSocket: `wss://zioinfo.co.kr:8443/ws/events?token={jwt}`
- 채널: sr, deploy, sla, incident
- `hooks/useWebSocket.ts` 구현 완료

### 2-4. 홈페이지 관리자시스템 (신규)

```
http://zioinfo.co.kr/admin
계정: admin / Admin@2026!
```

- JWT 인증 (GUARDiA ITSM 공유)
- 뉴스/채용/문의 CRUD
- Spring Security + jjwt 0.12.3

---

## 3. SMTP 메일 서버

```
도메인: @zioinfo.co.kr
서버: mail.zioinfo.co.kr (zioinfo.co.kr)
```

| 항목 | 값 |
|------|-----|
| 계정 | info, admin, ythong, choyounbun, guardia |
| 비밀번호 | 1q2w3e!Q (모두 동일) |
| SMTP | :25 / :587 (STARTTLS) |
| IMAP | :143 / :993 (SSL) |
| SPF | v=spf1 ip4:zioinfo.co.kr ~all (가비아) |
| DKIM | mail._domainkey.zioinfo.co.kr (가비아) |
| DMARC | _dmarc.zioinfo.co.kr (가비아) |

**스팸 방지 중요사항**:
- 이메일 본문에 `http://zioinfo.co.kr:8001` 같은 IP 직접 링크 금지 → 피싱 경고 발생
- PTR 역방향 DNS 없음 → Gmail 스팸 가능성 → NCloud 지원에 PTR 설정 요청 필요

---

## 4. 하네스 구조

### C:\GUARDiA\itsm (GUARDiA ITSM)

```
.claude/agents/: sr-manager, deploy-engineer, incident-responder, sla-guardian
.claude/skills/: guardia-orchestrator, deploy-pipeline, sr-lifecycle, code-review
```

### C:\GUARDiA\manager (GUARDiA Manager)

```
.claude/agents/: ux-architect, backend-engineer, integration-specialist, security-engineer, devops-engineer
.claude/skills/: manager-orchestrator, manager-ui, manager-api, manager-integration, manager-security, manager-deploy
```

### C:\GUARDiA\app (GUARDiA Messenger)

```
.claude/agents/: rn-developer, eas-engineer, store-publisher, doc-writer
.claude/skills/: messenger-orchestrator, rn-screen-dev, eas-build-deploy, store-publish, doc-generator
  └── rn-screen-dev/references/build-issues.md  ← EAS 빌드 이슈 이력 (매우 중요)
```

### C:\GUARDiA\workspace\zioinfo-web (홈페이지)

```
트리거: workspace-analyzer 스킬
```

---

## 5. 매뉴얼 파일 목록 (C:\GUARDiA\manual)

| 번호 | 파일 | 내용 |
|------|------|------|
| 18 | zio서버_설치SW_목록.md | 전체 SW 목록 |
| 19 | zio서버_운영가이드.md | 운영 절차 |
| 20 | zio서버_CICD_가이드.md | CI/CD 흐름 |
| 21 | zio서버_장애대응_가이드.md | Runbook |
| 22 | GUARDiA_개방망_운영가이드.md | 개방망 설정 |
| 23-24 | 개방망 PDF/PPTX | - |
| 25 | Manager 라이선스 가이드.md | 라이선스 관리 |
| 26-27 | 라이선스 PDF/PPTX | - |
| 28 | 폐쇄망_데이터연동_가이드.md | Export/Import |
| 29-30 | 데이터연동 PDF/PPTX | - |
| 31 | AI_플랫폼_제안서.md | LangChain/ChromaDB 제안 |
| 32 | 벡터DB_제안서.md | ChromaDB 상세 |
| 33 | Messenger_스토어_등록_가이드.md | Play Store/App Store |
| 34 | Messenger_개발_배포_가이드.md | EAS 빌드 가이드 |
| 35-36 | Messenger PDF/PPTX | - |

---

## 6. 주요 계정 정보

| 서비스 | ID | PW |
|--------|----|----|
| SSH | root | 1q2w3e!Q |
| GUARDiA ITSM | admin | 1111 |
| GUARDiA Manager | admin | Admin@zioinfo2026! |
| 홈페이지 관리자 | admin | Admin@2026! |
| Gitea | zio | Zio@Admin2026! |
| PostgreSQL | guardia | G@urd1a_2026! (URL: G%40urd1a_2026%21) |
| SMTP 계정 | *@zioinfo.co.kr | 1q2w3e!Q |
| Expo EAS | zioinfo | expo.dev 로그인 |

---

## 7. 알림 테스트 결과

### ITSM → Messenger (8/8 PASS)
JWT → WebSocket 연결 → SR 이벤트 브로드캐스트 → 앱 알림탭 수신

### Messenger → ITSM (10/10 PASS)
앱 SR탭 등록 → POST /api/tasks → ITSM SR 생성 확인  
AI챗봇 → "nginx 재시작해줘" → AI가 SR 자동 생성 응답

---

*GUARDiA 프로젝트 세션 정리 | 2026-05-31*