zioinfo-mail/manager/CLAUDE.md
DESKTOP-TKLFCPR\ython b217d101f0 feat(harness): Messenger·Manager·ITSM 하네스 확장 + 추가 개발 제안서 3종
## Messenger 하네스 확장
- agents/feature-developer.md — 신규 기능 화면 개발 전문 에이전트
  (DR·네트워크·CSAP·생체인증·오프라인·Kanban·다크모드·멀티기관·인시던트·실시간)
- skills/new-features/SKILL.md — 10가지 신규 기능 React Native 구현 가이드
- messenger-orchestrator description 확장 (신규 기능 트리거 추가)

## Manager 하네스 확장
- agents/roadmap-planner.md — Manager 추가 개발 기획 전문 에이전트
- skills/manager-roadmap/SKILL.md — MG-01~MG-09 페이지 구현 가이드
- manager-orchestrator description 확장 (로드맵/MG 트리거 추가)

## ITSM 하네스 확장
- agents/roadmap-planner.md — ITSM 추가 개발 기획 에이전트
- skills/itsm-roadmap/SKILL.md — I-01~I-10 기능 제안 카탈로그

## 추가 개발 제안서 3종 (docs/)
- MESSENGER_NEXT_FEATURES.md — 모바일 신규 기능 10종 (M-01~M-10)
- ITSM_NEXT_FEATURES.md — ITSM 신규 기능 10종 (I-01~I-10)
- MANAGER_NEXT_FEATURES.md — Manager 신규 페이지 9종 (MG-01~MG-09)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-31 09:44:52 +09:00

3.8 KiB

GUARDiA 관리자 시스템 (Manager)

Claude Code용 프로젝트 마스터 컨텍스트


프로젝트 비전

GUARDiA ITSM·홈페이지·서버 인프라·CI/CD를 단일 화면에서 통합 관제하는
경량 관리자 포털. GUARDiA ITSM API를 허브로 삼아 별도 DB 없이 운영한다.


기술 스택

레이어 기술 비고
Frontend React 18 + TypeScript + Vite 독립 SPA
Backend Python FastAPI (경량) 시스템 수준 작업 전용
인증 GUARDiA ITSM JWT 공유 별도 DB 없음
연동 GUARDiA ITSM REST API http://101.79.17.164:8001
배포 Gitea + Deploy Webhook 포트 9999

제안 기능 목록 (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 관제 연동)