개발 과정 - Notipy-DiscordBot/Notipy GitHub Wiki

🛠 개발 과정

Notipy는 2025년 4월부터 개발을 시작하여 Discord와 Notion 간의 실시간 통합 알림 기능을 중심으로 확장되었습니다.
아래는 개발 과정에서 이뤄진 주요 기능 도입과 개선 작업의 타임라인입니다.

📅 개발 타임라인 요약

✅ 2025년 4월

  • 프로젝트 초기화 및 구조 설계

    • FastAPI + Discord봇 + MySQL 기반 구조 설정
    • .env 기반 환경변수 분리
    • 기본 Discord 슬래시 명령어 설정

  • Notion 연동 시작

    • Notion Integration 토큰 처리 로직 개발
    • 노션 페이지 이벤트 추적 로직 초안 작성

✅ 2025년 5월

  • 웹훅 기반 알림 시스템 완성

    • Notion → Discord 메시지 전송 구현
    • 포럼 채널에 스레드 자동 생성 기능 도입
    • 내부 요청 검증(X-Internal-Request) 기능 추가

  • GitHub 프로필 분석 기능 도입

    • GitHub API + LLM 기반 요약 기능 개발
    • Llama3 기반 요약 엔진 적용
    • 사용자 깃허브 연결 및 공유 기능 추가

  • 다국어 지원 시작

    • ko.json, en-US.json로 문자열 리소스 분리
    • 페이지별 다국어 구조로 HTML/CSS 리팩토링

✅ 2025년 6월

  • 프론트엔드 개선

    • 홈페이지 다국어 구성 (/ko, /en 디렉토리 구조 적용)
    • 팝업 기반 언어 전환 기능 (htmx 기반)

  • 활용 사례 탭 추가

    • case.html 탭 및 이미지 기반 설명 UI 구성
    • HTML, CSS, 이미지 리팩토링 및 디자인 개선

  • Docker 실행 환경 완비

    • docker-compose.yml, Dockerfile 정비
    • .env 자동 연동 및 내부 네트워크 구성 문서화

  • GitHub Actions 도입

    • PR 시 코드 포맷 자동화 (black) 구성
    • CI 대상은 코드 스타일 검사에 한정

📌 향후 계획 (예정)

  • Notion 자동 등록 기능 (OAuth 및 Database 탐색 기반)
  • Discord ↔ Notion 간 상호작용 확대 (댓글 생성 등)
  • 사용 로그 기반 추천 시스템 시범 적용

🔗 관련 문서