프로젝트 개요

Gmail 수신함 데이터를 자동으로 수집·분류하여 Google Sheets에 저장하고, Next.js 기반 웹 대시보드로 시각화하는 풀스택 업무 자동화 파이프라인입니다.

Claude Code를 활용한 AI 실무 교육 Day 2 결과물로, "실제 업무 도구를 AI와 연결해 즉시 사용 가능한 시스템을 만든다"는 핸즈온 학습 목표를 달성합니다.

🔗 라이브 데모: krema-ai-edu2 Dashboard

시스템 파이프라인

Gmail 수신함 최근 메일 수집 (gws CLI) 규칙 기반 분류 엔진 유형 / 긴급도 / 감정 / 중요도 정규식 매칭 + 가중치 합산 Google Sheets 18개 컬럼 정제 데이터 저장 Next.js API Route 서비스 계정 인증 대시보드 UI 8개 탭 시각화 전역 검색 · 모달

규칙 기반 메일 분류 엔진

LLM 없이 정규식 패턴 매칭과 가중치 합산으로 구현한 분류 로직입니다.

분류 항목 방법 결과값
유형 키워드 정규식 매칭 주문/계약/문의/환불/협업/기타
긴급도 긴급·urgent·오늘까지 탐지 상/중/하
감정 감사·불만·환불 등 탐지 긍정/중립/부정
중요도 가중치 합산 1~10점
미회신 스레드 내 본인 발신 여부 Y/N 
중요도 계산 공식:
  기본 1점
  + 긴급도 '상' → +3점
  + 부정 감정 → +2점
  + 유형 식별됨 → +1점
  + SLA 초과 → +2점

대시보드 구성 (8개 탭)

메일 현황 일별 추이·히트맵 요일별 패턴 중요도 분석 중요도 분포 SLA 지연 현황 답장 필요 미회신 카드 목록 AI 회신 초안 포함 AI 요약 AI 회신 초안 전체 목록 일정 추출 메일 내 일정 항목 자동 추출 첨부파일 첨부파일 포함 메일 목록 메일 통계 분류·상태별 도넛 발신자·도메인 랭킹 채용 관리 채용 관련 메일 자동 분류

기술 스택

구분 기술
프론트엔드 Next.js 15, React 19, TypeScript
인증·API next-auth, googleapis (서비스 계정)
시각화 Recharts, 활동 히트맵
데이터 수집 gws CLI, Gmail API, Sheets API
디자인 oklch 색상 토큰, CSS 변수, 다크 테마
배포 Vercel

실무 적용 가능성

  1. 메일 트리아지 자동화 — 수백 건 수신 메일을 중요도·유형별로 자동 정렬
  2. SLA 모니터링 — 지연 메일을 시각적으로 즉시 파악
  3. AI 회신 초안 — 반복적인 답변 작성 시간 절감
  4. 팀 공유 대시보드 — Vercel 배포로 팀원 누구나 접근 가능