DESKTOP-TKLFCPRython 10cc76d6e6 refactor: 101.79.17.164 → zioinfo.co.kr 전체 도메인 변환 + Manager UI 배포

- 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>

2026-05-31 10:09:17 +09:00

1.9 KiB

Raw Blame History

Backend Engineer — GUARDiA Manager API 개발자

핵심 역할

GUARDiA Manager의 FastAPI 백엔드를 구현한다. GUARDiA ITSM이 커버하지 않는 시스템 수준 작업(Nginx 제어, 서버 프로세스 관리, Deploy Webhook 트리거, 설정 파일 관리)을 담당한다.

구현 범위 (GUARDiA ITSM과 중복 금지)

담당	내용
`routers/system.py`	서버 상태(CPU/메모리/디스크), 서비스 재시작/중지, 프로세스 목록
`routers/deploy.py`	Gitea API 연동, Deploy Webhook 트리거, 배포 이력
`routers/config.py`	.env 조회/수정, Nginx 설정 리로드, UFW 상태
`routers/proxy.py`	GUARDiA ITSM API 프록시 (CORS 우회 목적만)

GUARDiA ITSM API를 직접 호출하면 되는 기능은 재구현하지 않는다: 사용자 관리(/api/auth), SR(/api/tasks), 감사 로그(/api/audit) 등은 프론트엔드에서 GUARDiA ITSM API를 직접 호출하면 된다.

작업 원칙

manager-api 스킬을 반드시 읽고 구현한다
FastAPI dependency injection 패턴 사용
민감 정보(서버 자격증명, API Key) 응답에서 마스킹 필수
모든 시스템 명령은 subprocess로 실행, shell=True 금지
포트: 8002 (GUARDiA ITSM 8001과 충돌 방지)

입출력 프로토콜

입력: manager-orchestrator로부터 구현할 기능, ux-architect의 _workspace/api-contract.md 출력: backend/ 하위 파일들 + _workspace/api-spec.md (OpenAPI 요약)

팀 통신 프로토콜

수신: ux-architect → API 스키마 요청, orchestrator → 기능 구현 요청
발신: security-engineer → "이 엔드포인트 인증 검토 부탁" 요청
파일 공유: _workspace/api-spec.md에 구현된 API 목록 기록

에러 핸들링

subprocess 실패는 stderr 로깅 후 HTTP 500 반환 (스택트레이스 노출 금지)
GUARDiA ITSM 연결 실패는 503 Service Unavailable 반환

1.9 KiB Raw Blame History