NotificationChecker – 곳곳의 여러 공지를 Discord로 한번에 즉시 알려줍니다

한줄 슬로건

필요한 새 글만, 제때 Discord로.

🎯 Executive Summary

• 문제: 여러 사이트·API·피드의 업데이트를 사람 손으로 순회 확인하기 어렵고, 놓침/중복/지연이 발생함.
• 해결: 키워드 필터링·중복 방지·스케줄러를 갖춘 Discord 봇(또는 Webhook) 기반 알림 파이프라인. 외부 소스 → 정규화 → 중복 필터 → 큐잉/속도제어 → Discord 전송(채널/스레드 라우팅). Discord Gateway Intents/Rate Limit 준수를 기본 전제. (Discord)
• 결과(목표 KPI 안):
  • 평균 지연(p50) ≤ 5초, p95 ≤ 20초(소스 API 응답 포함)
  • 중복 전송률 ≤ 0.5%
  • 전송 실패(429/네트워크) 재시도 누락률 ≤ 0.1%
• 다음 단계:
  • 2주: 에러/지연 메트릭 로깅, 큐·백오프 정교화, 키워드 룰 관리 UI 초안, 채널 정교화를 통한 선택적 정보 습득 강화
  • 2개월: 소스 확장(Naver/News API, RSS, GitHub 릴리스 등) + 관리자 대시보드
  • 2분기: 다중 인스턴스 수평 확장, 메시지 템플릿 국제화, 권한 분리/감사 로그

1. 배경·목표

• 사용자/페르소나:
  • 키워드 기반 이슈/뉴스를 추적하는 개인·소규모 팀
  • 서비스 운영팀(상태 변경/배포 알림), 학습/리서치 그룹(논문/공지)
• 성공 기준(KPI): 지연(p50/p95), 중복률, 전송 성공률, 재시도 성공률
• 범위(Out of scope): 토큰/권한을 노출할 수 있는 클라이언트 사이드 호출, 대규모(100+ 길드) 검증·승인 프로세스까지의 자동화는 제외(추후).

2. 역할·스택·기간

• 역할/기여: 전과정 단독개발
• 스택:
  • Runtime: Python(discord.py)
  • 알림 전송: Discord Bot(Gateway + REST)
• 기간: 2024.10.13. - PRESENT

3. 데모 & 링크

• Demo: 소개 포스트 참고
• Repo: https://github.com/MelonChicken/NotificationChecker
• 문서: 없음

4. 아키텍처 요약

• 다이어그램(개념):

  Sources(Naver/RSS/기타 API) → 수집(Extractor) → 정규화(Normalizer) → 중복/필터(해시·윈도우) → 큐/속도제어(레이트리미터) → 전송 어댑터(Bot/Webhook, 채널 라우팅) → Discord