From 23e3972fbbc43ffe5126d7708a88590b46ccd2a2 Mon Sep 17 00:00:00 2001 From: kappa Date: Tue, 27 Jan 2026 14:31:42 +0900 Subject: [PATCH] docs: add TODO for Anvil troubleshooting enhancement Co-Authored-By: Claude Opus 4.5 --- TODO.md | 83 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 TODO.md diff --git a/TODO.md b/TODO.md new file mode 100644 index 0000000..ccafb5c --- /dev/null +++ b/TODO.md @@ -0,0 +1,83 @@ +# TODO - Anvil 트러블슈팅 강화 + +> 생성일: 2026-01-27 +> 목표: Anvil 관리 도메인/서버에 대한 실제 진단 및 조치 기능 추가 + +## 태스크 목록 + +### Phase 1: 기반 작업 (병렬 가능) + +- [ ] **#1 Anvil 리소스 감지 로직 구현** + - user_domains 테이블에서 도메인 조회 + - Cloud Orchestrator API로 서버 목록 조회 + - 사용자 ID와 매칭하여 소유권 확인 + - 결과를 troubleshoot session에 저장 + +- [ ] **#7 Cloudflare API 인증 설정** + - Cloudflare API Token 발급 (Zone:Read, DNS:Edit, SSL:Read) + - wrangler secret 설정 (CLOUDFLARE_API_TOKEN) + - Zone ID 관리 방법 결정 (user_domains 테이블에 추가?) + - API 래퍼 유틸리티 작성 + +- [ ] **#4 서버 진단 도구 구현 (Cloud Orchestrator)** + - 서버 상태 조회 (running/stopped/error) + - 리소스 사용량 (CPU, 메모리, 디스크, 네트워크) + - 최근 에러 로그 조회 + - 서비스 상태 확인 (nginx, node, mysql 등) + - Cloud Orchestrator API 연동 + - 진단 결과를 구조화된 형식으로 반환 + +### Phase 2: 진단 도구 + +- [ ] **#2 도메인 진단 도구 구현 (Cloudflare API)** ← blocked by #7 + - DNS 레코드 조회 (A, CNAME, MX, TXT 등) + - SSL 인증서 상태 확인 (만료일, 유효성) + - DNS 전파 상태 확인 (여러 지역에서) + - Cloudflare API 연동 필요 + - 진단 결과를 구조화된 형식으로 반환 + +- [ ] **#5 서버 조치 도구 구현 (Cloud Orchestrator)** ← blocked by #4 + - 서버 재시작 (soft/hard) + - 특정 서비스 재시작 (nginx, node, mysql 등) + - 임시 스케일업 제안 + - 사용자 확인 후 실행 (인라인 버튼) + - 조치 결과 알림 + +### Phase 3: 조치 도구 + +- [ ] **#3 도메인 조치 도구 구현 (Cloudflare API)** ← blocked by #2, #7 + - DNS 레코드 수정/추가/삭제 + - SSL 인증서 갱신 트리거 + - Cloudflare 캐시 퍼지 + - 사용자 확인 후 실행 (인라인 버튼) + - 조치 결과 알림 + +### Phase 4: 통합 + +- [ ] **#6 트러블슈팅 AI에 진단/조치 도구 통합** ← blocked by #1, #2, #3, #4, #5 + - Anvil 리소스 감지 시 자동 진단 실행 + - 진단 결과를 AI 컨텍스트에 포함 + - AI가 조치 필요 판단 시 버튼 제안 + - 버튼 클릭 핸들러 (callback_query) 구현 + - 조치 완료 후 재진단으로 확인 + +## 의존성 다이어그램 + +``` +#7 Cloudflare API 인증 ─┬─→ #2 도메인 진단 ─→ #3 도메인 조치 ─┐ + │ │ +#1 리소스 감지 ─────────┼────────────────────────────────────┼─→ #6 통합 + │ │ +#4 서버 진단 ──────────┴─→ #5 서버 조치 ────────────────────┘ +``` + +## 구현 원칙 + +- **진단 (읽기)**: 자동 실행, 안전 +- **조치 (쓰기)**: 사용자 확인 후 실행 (인라인 버튼) + +## 관련 파일 + +- `src/troubleshoot-agent.ts` - 트러블슈팅 에이전트 메인 +- `src/tools/troubleshoot-tool.ts` - 도구 정의 +- `src/tools/index.ts` - 도구 레지스트리