zioinfo-mail/manual/37_세션_전체_작업_요약.md

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