Files

kappa eee934391a feat(phase-5-3): Logger, Metrics, 알림 시스템 통합

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>

2026-01-19 21:23:38 +09:00

3.5 KiB

Raw Permalink Blame History

🤖 텔레그램 봇 사용자 가이드

이 문서는 봇의 주요 기능과 사용법, 명령어에 대해 설명합니다.

📋 목차

기본 사용법
기능 상세
예치금 시스템
도메인 관리

기본 사용법

봇 명령어

명령어	설명
`/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으로 바꿔줘"

3.5 KiB Raw Permalink Blame History