← 포트폴리오 목록
노션 이벤트 자동화 콘솔
노션 데이터베이스의 상태 변경과 마감 임박 이벤트를 실시간으로 감지해 슬랙 채널로 자동 알림을 발송하고, 작가 섭외·계약·정산 단계별 외부 이메일을 템플릿 기반으로 자동 발송하는 협업 자동화 콘솔을, 노션·슬랙·이메일 채널을 하나로 통합 연동하는 구조로 React + Node.js 기반으로 설계·구현합니다.
이벤트 중복 방지 감지 엔진 설계노션 페이지 해시 대조로 중복 이벤트를 필터링하고 재시도 큐 테이블로 실패 건을 분리 관리하는 구조를 구현합니다.
슬랙 채널 라우팅 엔진 구현이벤트 유형-채널 매핑 테이블 기반 라우팅 엔진으로 코드 수정 없이 신규 이벤트 유형을 확장할 수 있는 구조를 설계합니다.
템플릿 변수 치환 파이프라인 설계플레이스홀더 파서와 조건 빌더를 결합해 담당자가 직접 발송 시나리오를 추가할 수 있는 템플릿 엔진을 구현합니다.
Overview
프로젝트 개요
노션 데이터베이스의 상태 변경과 마감 임박 이벤트를 실시간으로 감지해 슬랙 채널로 자동 알림을 발송하고, 작가 섭외·계약·정산 단계별 외부 이메일을 템플릿 기반으로 자동 발송하는 협업 자동화 콘솔을, 노션·슬랙·이메일 채널을 하나로 통합 연동하는 구조로 React + Node.js 기반으로 설계·구현합니다. 담당자는 이벤트 로그와 재시도 현황을 사이드바 콘솔에서 실시간으로 확인할 수 있습니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
노션이 임의 DB 변경에 대한 완전한 웹훅을 제공하지 않아 폴링 주기와 API 호출량 사이의 균형을 맞추는 감지 전략 설계
동일 이벤트가 여러 트리거 조건에 동시에 매칭될 때 중복 알림·중복 발송을 방지하는 우선순위 로직 설계
작가 섭외·계약·정산 단계별 트리거 조건과 템플릿 변수 매핑이 늘어날수록 조건 빌더의 복잡도를 관리하는 구조 설계
슬랙·이메일 발송 실패 시 재시도와 실패 알림 사이의 임계치를 설정해 무한 재시도를 방지하는 정책 설계
구현 내용
핵심 기능 상세
핵심 기능 1
노션 이벤트 실시간 감지 콘솔
담당자가 노션 데이터베이스의 상태 변경, 마감 D-3·D-1 도래, 신규 항목 등록을 실시간 이벤트 로그에서 확인하고, 처리 실패 건은 재시도 대기열에서 별도로 관리할 수 있는 화면을 구현합니다
핵심 기능 2
슬랙 채널 라우팅 알림
이벤트 유형별로 지정된 슬랙 채널에 Block Kit 포맷 알림을 자동 발송하고, 알림 클릭 시 해당 노션 페이지로 바로 이동하는 딥링크를 구현합니다
핵심 기능 3
외부 이메일 자동 발송 자동화
콘텐츠 제작팀이 외부 협력 작가와 진행하는 섭외·계약·정산 단계별 트리거 조건이 충족되면 템플릿 기반 이메일을 자동으로 발송하고, 작가명·일정·금액 등 변수를 자동 치환하는 발송 파이프라인을 구현합니다
핵심 기능 4
이메일 템플릿 관리
담당자가 이메일 템플릿을 직접 등록·조회·수정·삭제하고, 템플릿별 발송 트리거 조건을 화면에서 설정할 수 있는 관리 UI를 구현합니다
구현 과정
프로젝트 진행 단계
STEP 1
이벤트 감지·알림 아키텍처 설계 및 DB 설계
노션 이벤트 유형 정의, 라우팅·트리거 테이블 설계, PostgreSQL 스키마 12개 테이블 정의
STEP 2
노션 이벤트 감지 엔진 개발
협업 도구 API 폴링·중복 방지·재시도 큐 구현, 이벤트 유형별 감지 로직 8종 개발
STEP 3
슬랙·이메일 발송 파이프라인 개발
메시징 협업 도구 Block Kit 알림, SendGrid 이메일 발송, 템플릿 변수 치환 엔진 구현
STEP 4
관리 UI 및 통합 테스트
React 기반 템플릿·라우팅 관리 화면 9개 구현, API 통합 테스트 40개 케이스 작성
프로젝트 성과
주요 성과
이벤트 중복 방지 감지 엔진 설계노션 페이지 해시 대조로 중복 이벤트를 필터링하고 재시도 큐 테이블로 실패 건을 분리 관리하는 구조를 구현합니다.
슬랙 채널 라우팅 엔진 구현이벤트 유형-채널 매핑 테이블 기반 라우팅 엔진으로 코드 수정 없이 신규 이벤트 유형을 확장할 수 있는 구조를 설계합니다.
템플릿 변수 치환 파이프라인 설계플레이스홀더 파서와 조건 빌더를 결합해 담당자가 직접 발송 시나리오를 추가할 수 있는 템플릿 엔진을 구현합니다.
재시도 큐 아키텍처 구축지수 백오프 기반 자동 재처리 워커를 설계해 슬랙·이메일 발송 실패 건을 최대 3회까지 재시도하는 구조를 구현합니다.
Review
기술적 주안점
- 폴링 기반 감지와 재시도 큐를 분리 설계하여, 이벤트 기반 워크플로우 알림 파이프라인의 처리 결과를 이벤트 로그 화면 하나에서 추적할 수 있는 구조를 구현합니다
- 채널 라우팅 규칙과 Block Kit 템플릿을 분리 설계하여, 새 이벤트 유형 추가 시 코드 수정 없이 라우팅 규칙만 등록하는 구조를 구현합니다
- 트리거 조건 → 템플릿 렌더링 → 발송 로그 기록을 하나의 파이프라인으로 연결해, 다단계 협업 이메일을 사람 개입 없이 자동 발송하는 구조를 구현합니다
