Summary Bot Project Rules

Telegram 봇으로 URL/텍스트를 받아 LLM 요약 후 GitHub에 마크다운으로 저장하는 NestJS 앱.

기술 스택

프로젝트 구조 규칙

src/
├── app.module.ts
├── main.ts
├── telegram/       # Telegraf 봇, webhook, 메시지 핸들러
├── summary/        # 오케스트레이션 (URL파싱 -> LLM -> GitHub)
├── llm/            # LLM 호출 추상화 + providers/
├── github/         # Octokit 파일 push
├── extractor/      # URL -> 본문 추출
└── config/         # 환경변수 관리

• •각 도메인은 NestJS 모듈로 분리 (module.ts + service.ts)
• •DTO는 해당 모듈의 dto/ 하위에 배치
• •LLM 프로바이더는 llm/providers/에 추가

핵심 패턴

LLM Provider

• •LlmProvider 인터페이스 구현 (summarize(content): Promise<SummaryResult>)
• •Primary: Claude (claude-sonnet-4-20250514), Fallback: Gemini (gemini-2.0-flash)
• •LLM_PROVIDER 환경변수로 기본 프로바이더 선택
• •실패 시 자동으로 다른 프로바이더로 fallback

SummaryResult 구조

interface SummaryResult {
  title: string;           // 한글 제목
  description: string;     // 영문 kebab-case slug
  category: string;        // Tech | AI | Business | Design | Productivity | Life
  tags: string[];          // 3-5개
  summary: string;         // 마크다운 요약 본문
}

GitHub 저장 규칙

• •경로: 90-summaries/YYYY-MM-DD-{slug}.md
• •커밋 메시지: docs: add summary - {한글 제목}
• •마크다운 frontmatter 필수: title, date, category, tags, source

Telegram 핸들러

• •nestjs-telegraf 데코레이터 사용 (@Update, @On, @Action)
• •텍스트 수신 -> 요약 미리보기 + 인라인 버튼 (저장/재생성/삭제)
• •요약 결과는 메모리 캐시에 임시 저장 (TTL 10분)

환경변수

필수: TELEGRAM_BOT_TOKEN, TELEGRAM_WEBHOOK_DOMAIN, ANTHROPIC_API_KEY, GEMINI_API_KEY, GITHUB_TOKEN, GITHUB_REPO

상세 참조

• •아키텍처 상세