From c6ef15a107c89455e5e9aebf485d611f53b2725c Mon Sep 17 00:00:00 2001 From: "DESKTOP-TKLFCPR\\ython" Date: Sun, 31 May 2026 23:43:45 +0900 Subject: [PATCH] docs: add CLAUDE.md for standalone repo context --- CLAUDE.md | 93 +++++++------------------------------------------------ 1 file changed, 12 insertions(+), 81 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 119204d..317f343 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,86 +1,17 @@ -# GUARDiA 관리자 시스템 (Manager) +# GUARDiA Manager -> **Claude Code용 프로젝트 마스터 컨텍스트** - ---- - -## 프로젝트 비전 - -GUARDiA ITSM·홈페이지·서버 인프라·CI/CD를 단일 화면에서 통합 관제하는 -**경량 관리자 포털**. GUARDiA ITSM API를 허브로 삼아 별도 DB 없이 운영한다. - ---- +**저장소**: http://101.79.17.164:3000/zio/guardia-manager +**배포**: git push origin main → Gitea webhook → 자동 배포 +**라이브**: https://zioinfo.co.kr:8090 +**서버 경로**: /opt/manager/ ## 기술 스택 +- Frontend: React 18 + TypeScript + Vite (Variant 디자인) +- Backend: Python FastAPI (포트 8002) -| 레이어 | 기술 | 비고 | -|--------|------|------| -| Frontend | React 18 + TypeScript + Vite | 독립 SPA | -| Backend | Python FastAPI (경량) | 시스템 수준 작업 전용 | -| 인증 | GUARDiA ITSM JWT 공유 | 별도 DB 없음 | -| 연동 | GUARDiA ITSM REST API | http://zioinfo.co.kr:8001 | -| 배포 | Gitea + Deploy Webhook | 포트 9999 | +## 로그인 +- ITSM과 동일 계정 사용 (admin / 1111) +- JWT 공유 secret: GUARDIA_JWT_SECRET ---- - -## 제안 기능 목록 (M-01 ~ M-08) - -| 코드 | 기능 | 우선순위 | 연동 대상 | -|------|------|---------|---------| -| **M-01** | 통합 운영 대시보드 (**메인화면 — 차트 중심**) | ⭐ 필수 | ITSM API, 서버 SSH | -| **M-02** | 테넌트/사용자 관리 | ⭐ 필수 | ITSM /api/auth, /api/tenant | -| **M-03** | CMDB/서버 자산 관리 | ⭐ 필수 | ITSM /api/cmdb, /api/ssh | -| **M-04** | 배포/CI-CD 관리 | ⭐ 필수 | Gitea API, Deploy Webhook | -| **M-05** | 보안/API Key 관리 | ⭐ 필수 | ITSM /api/external/keys, /api/audit | -| **M-06** | LLM/AI 엔진 관리 | 🔵 권장 | Ollama API (localhost:11434) | -| **M-07** | 시스템 설정 관리 | 🔵 권장 | .env 편집, Nginx 리로드 | -| **M-08** | 알림/리포트 | 🟡 선택 | ITSM /api/report, 이메일 | - ---- - -## 디렉터리 구조 - -``` -C:\GUARDiA\manager\ -├── CLAUDE.md ← 이 파일 -├── frontend/ ← React SPA -│ ├── src/ -│ │ ├── pages/ ← 각 기능 페이지 -│ │ ├── components/ ← 공통 컴포넌트 -│ │ ├── hooks/ ← 커스텀 훅 -│ │ └── api/ ← API 클라이언트 -│ └── package.json -├── backend/ ← FastAPI (시스템 작업 전용) -│ ├── main.py -│ ├── routers/ -│ │ ├── system.py ← 서버 상태, 서비스 제어 -│ │ ├── deploy.py ← 배포 트리거, 이력 -│ │ └── config.py ← 설정 관리 -│ └── requirements.txt -└── .claude/ - ├── agents/ ← 에이전트 정의 - └── skills/ ← 스킬 파일 -``` - ---- - -## 하네스: GUARDiA Manager - -**목표:** 관리자 시스템 전체 구현 — UI 설계 → API 연동 → 보안 → 배포까지 자동화 - -**UI 참조:** 네이버 클라우드 콘솔(console.ncloud.com) 디자인 패턴 적용 필수. -좌측 사이드바 서비스 트리 + 상단 GNB 레이아웃, 리소스 상태 배지, NCloud 스타일 테이블. - -**메인화면:** 대시보드 차트 중심 구성 — SR 추이(꺾은선), 서버 상태(도넛), 리소스(게이지), 배포 이력(타임라인). -→ `references/dashboard-charts.md` 참조. - -**트리거:** 관리자 시스템 관련 작업 요청 시 `manager-orchestrator` 스킬을 사용하라. -`M-01 대시보드 만들어줘`, `M-03 CMDB 페이지 구현`, `배포 관리 기능 추가` 등. -다시 실행, 재실행, 업데이트, 수정, 보완 요청 시에도 이 스킬을 사용하라. - -**변경 이력:** -| 날짜 | 변경 내용 | 대상 | 사유 | -|------|----------|------|------| -| 2026-05-30 | 초기 하네스 구성 | 전체 | GUARDiA Manager 신규 구축 | -| 2026-05-30 | M-01~M-08 전체 구현 + 서버 배포 | frontend/, backend/, deploy_server.py | 단계별 전체 구현 완료 | -| 2026-05-31 | roadmap-planner 에이전트 + manager-roadmap 스킬 추가 | agents/, skills/ | MG-01~MG-09 추가 개발 제안 (DR·네트워크·CSAP 관제 연동) | +## 하네스 +- Manager UI: `manager-orchestrator` 스킬