냠냠위듀 — 구내식당 식단 알림 봇

프로젝트 설명

판교 이노밸리 구내식당의 주간 식단표를 자동으로 수집하여 Slack 채널에 발송하는 봇이다. Playwright 헤드리스 Chrome으로 카카오 채널 게시물에서 식단표 이미지 URL과 메타데이터를 크롤링하고, @slack/bolt Socket Mode 기반으로 지정 채널에 자동 발송한다. 매주 월요일 오전 9시(KST) node-cron으로 스케줄링하며, 발송 실패 시 1시간 간격으로 최대 6회 재시도한다. DeliveryHistory 테이블로 채널별 발송 이력을 관리하여 동일 식단표의 중복 발송을 방지하고, /식단 슬래시 커맨드로 이번 주 식단표를 즉시 조회할 수 있다. Clean Architecture로 도메인·애플리케이션·인프라 계층을 분리하고, TSyringe DI 컨테이너로 의존성을 관리하며, Result<T, E> 패턴으로 예외 대신 명시적 에러 처리를 구현했다.

주요 내용

• Playwright 헤드리스 Chrome으로 카카오 채널 크롤링
• Slack Bot Socket Mode + /식단 슬래시 커맨드 구현
• 재시도 최대 6회(1시간 간격) + DeliveryHistory 중복 방지
• Clean Architecture + TSyringe DI + Result<T, E> 패턴
• Docker 컨테이너 배포 (Playwright 브라우저 포함)

담당 기능

• 자동 발송 — 매주 월요일 09:00(KST) 카카오 채널 크롤링 후 Slack 채널 자동 발송
• Playwright 헤드리스 크롤링 — 카카오 채널 게시물에서 식단표 이미지 URL·제목·게시일 추출
• Slack Bot 슬래시 커맨드 — /식단 입력 시 이번 주 식단표 즉시 조회 (캐시 우선, 없으면 실시간 크롤링)
• 재시도 메커니즘 — 발송 실패 시 1시간 간격 최대 6회 자동 재시도
• 중복 방지 — DeliveryHistory 테이블로 채널별 발송 이력 관리, 동일 식단표 중복 발송 차단
• Clean Architecture — 도메인·애플리케이션·인프라 계층 분리, TSyringe DI, Result<T, E> 에러 처리 패턴

깨달은 점

• 💡 Playwright 헤드리스 브라우저로 JavaScript 렌더링이 필요한 카카오 채널 페이지를 크롤링하며, 동적 콘텐츠 크롤링에서의 대기 전략과 셀렉터 안정성 확보 방법을 학습
• 💡 @slack/bolt Socket Mode로 Slack Bot을 구현하며, 슬래시 커맨드 핸들링과 메시지 포맷팅(Block Kit) 등 Slack 플랫폼 연동 패턴을 경험
• 💡 DeliveryHistory 테이블 기반 멱등성 보장과 1시간 간격 최대 6회 재시도 메커니즘을 설계하며, 외부 서비스 연동에서의 신뢰성 확보 전략을 학습
• 💡 Result<T, E> 패턴으로 예외 대신 명시적 에러 타입을 반환하며, 함수형 에러 처리가 코드의 예측 가능성과 테스트 용이성을 높이는 것을 체득

기술 스택