eee934391a
Phase 5-3 모니터링 강화 작업의 통합을 완료했습니다. 변경사항: - Logger 통합: console.log를 구조화된 로깅으로 전환 (9개 파일) - JSON 기반 로그, 환경별 자동 전환 (개발/프로덕션) - 타입 안전성 보장, 성능 측정 타이머 내장 - Metrics 통합: 실시간 성능 모니터링 시스템 연결 (3개 파일) - Circuit Breaker 상태 추적 (api_call_count, error_count, state) - Retry 재시도 횟수 추적 (retry_count) - OpenAI API 응답 시간 측정 (api_call_duration) - 알림 통합: 장애 자동 알림 시스템 구현 (2개 파일) - Circuit Breaker OPEN 상태 → 관리자 Telegram 알림 - 재시도 실패 → 관리자 Telegram 알림 - Rate Limiting 적용 (1시간에 1회) - 문서 업데이트: - CLAUDE.md: coder 에이전트 설명 강화 (20년+ 시니어 전문가) - README.md, docs/: 아키텍처 문서 추가 영향받은 파일: 16개 (수정 14개, 신규 2개) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
106 lines
3.5 KiB
Markdown
106 lines
3.5 KiB
Markdown
# 🤖 텔레그램 봇 사용자 가이드
|
|
|
|
이 문서는 봇의 주요 기능과 사용법, 명령어에 대해 설명합니다.
|
|
|
|
## 📋 목차
|
|
1. [기본 사용법](#기본-사용법)
|
|
2. [기능 상세](#기능-상세)
|
|
3. [예치금 시스템](#예치금-시스템)
|
|
4. [도메인 관리](#도메인-관리)
|
|
|
|
---
|
|
|
|
## 기본 사용법
|
|
|
|
### 봇 명령어
|
|
| 명령어 | 설명 |
|
|
|--------|------|
|
|
| `/start` | 봇 시작 및 기능 소개 |
|
|
| `/help` | 도움말 확인 |
|
|
| `/profile` | 내 프로필(AI가 분석한 정보) 보기 |
|
|
| `/reset` | 대화 내용 초기화 (새로운 주제로 시작하고 싶을 때) |
|
|
|
|
### AI와의 대화
|
|
이 봇은 GPT-4o-mini를 기반으로 동작하며, 대화 맥락을 기억합니다.
|
|
- 궁금한 점을 자연스럽게 물어보세요.
|
|
- 날씨, 시간, 계산, 검색 등의 기능은 대화 중에 자동으로 실행됩니다.
|
|
|
|
---
|
|
|
|
## 기능 상세
|
|
|
|
봇은 대화 내용을 분석하여 다음과 같은 도구를 자동으로 호출합니다.
|
|
|
|
| 기능 | 예시 질문 |
|
|
|------|-----------|
|
|
| **날씨** | "오늘 서울 날씨 어때?", "비 오나?" |
|
|
| **검색** | "최신 아이폰 가격 검색해줘", "파이썬이 뭐야?" |
|
|
| **시간** | "지금 뉴욕 몇 시야?" |
|
|
| **계산** | "123 * 456은?", "5만원의 10%는?" |
|
|
| **문서** | "React hooks 사용법 알려줘" (개발자용) |
|
|
|
|
---
|
|
|
|
## 예치금 시스템
|
|
|
|
도메인 등록 등에 사용되는 예치금을 충전하고 관리합니다.
|
|
|
|
### 1. 입금 계좌 정보
|
|
> **하나은행 427-910018-27104 (주식회사 아이언클래드)**
|
|
|
|
"입금 계좌 알려줘" 또는 "충전할래"라고 말하면 언제든 확인할 수 있습니다.
|
|
|
|
### 2. 입금 및 충전 방법
|
|
두 가지 방법으로 충전이 가능합니다.
|
|
|
|
**방법 A: 입금 후 봇에게 말하기 (가장 빠름)**
|
|
입금자명과 금액을 봇에게 말하면 즉시 처리됩니다.
|
|
```
|
|
사용자: "홍길동 5만원 입금했어"
|
|
봇: "✅ 입금 확인 완료! 현재 잔액: 50,000원"
|
|
```
|
|
|
|
**방법 B: 은행 SMS 자동 인식**
|
|
은행 입금 문자가 수신되면(관리자), 자동으로 매칭되어 알림이 옵니다.
|
|
별도로 봇에게 말하지 않아도 됩니다.
|
|
|
|
### 3. 기타 기능
|
|
- **잔액 조회**: "잔액", "내 돈 얼마 있어?"
|
|
- **거래 내역**: "거래 내역 보여줘"
|
|
- **취소**: 잘못 말했을 경우 "취소해줘"라고 하면 최근 대기 건이 취소됩니다.
|
|
|
|
---
|
|
|
|
## 도메인 관리
|
|
|
|
도메인을 검색하고, 등록하고, 관리할 수 있습니다.
|
|
|
|
### 1. 도메인 검색 및 추천
|
|
원하는 도메인이 있는지 확인하거나, 아이디어를 얻으세요.
|
|
|
|
- **가용성 확인**: "example.com 등록 가능한가요?"
|
|
- **가격 조회**: ".com 가격 얼마야?", "가장 싼 도메인 보여줘"
|
|
- **도메인 추천**: "커피숍 도메인 추천해줘" (AI가 창의적인 이름을 제안합니다)
|
|
|
|
### 2. 도메인 정보 조회 (WHOIS)
|
|
도메인의 상세 정보를 조회합니다. 내 도메인이 아니어도 조회 가능합니다.
|
|
|
|
- "naver.com 정보"
|
|
- "google.com whois"
|
|
|
|
### 3. 도메인 등록
|
|
**주의:** 등록 시 예치금이 차감되며, 등록 후에는 취소가 불가능합니다.
|
|
|
|
```
|
|
사용자: "my-startup.com 등록해줘"
|
|
봇: (가격과 잔액 확인 후 등록 버튼 표시)
|
|
사용자: [등록하기] 버튼 클릭
|
|
봇: "✅ 등록 완료!"
|
|
```
|
|
|
|
### 4. 내 도메인 관리
|
|
등록한 도메인을 관리합니다.
|
|
|
|
- **목록**: "내 도메인 목록"
|
|
- **네임서버 변경**: "example.com 네임서버를 ns1.example.com으로 바꿔줘"
|