2bd7d876cc
- 37개 파일 IP → zioinfo.co.kr 치환 (소스/매뉴얼/설정/하네스) - Manager DrConsole/NetworkConsole/CsapConsole 빌드 + /var/www/manager/ 배포 - 테스트: Manager HTTP 200, ITSM 신규 API 7개 전체 200 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
207 lines
6.1 KiB
Markdown
207 lines
6.1 KiB
Markdown
# 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*
|