여러 Gmail 계정, 이제 하나로 관리하세요.
AI가 라벨을 분류하고, RAG가 맞춤 답장 초안을 작성해드립니다.
MailSangja.Demo.Video.mp4
| 시상식 | 수상 | 날짜 |
|---|---|---|
| 🥉 아주대학교 SOFTCON 2026-1 | 장려상 (3등) | 2026.06.11 |
| 🌟 아주대학교 SOFTCON 2026-1 | 인기상 | 2026.06.11 |
SOFTCON — 아주대학교 소프트웨어학과 졸업작품 전시회
SOFTCON 2026-1 작품 페이지
메일상자는 여러 Gmail 계정을 하나의 인박스에서 통합 관리하고, AI 기반 자동 라벨링과 RAG 기반 답장 초안 생성을 제공하는 메일 관리 자동화 서비스입니다.
사용자는 여러 계정을 오가며 메일을 확인할 필요 없이 하나의 화면에서 메일을 조회할 수 있으며, AI가 메일의 성격을 분석해 라벨을 제안하고 중요 메일 관리, 필터링, 알림 설정, 민감정보 관리까지 연결할 수 있습니다.
| 구분 | 내용 |
|---|---|
| 🎯 Target | 여러 Gmail 계정을 동시에 관리해야 하는 사용자 |
| 😣 Problem | 빠른 인박스 전환의 어려움 · 중요 메일 누락 · AI 환경설정 비용 부담 · 메일 관리 효율성 저하 |
| ✅ Solution | 다중 계정 인박스 + AI 자동 라벨링 + AI 자동 답장 |
| 💡 POD | 다중 계정·벤더 통합 인박스, RAG·LLM 기반 개인화 메일 분류·작성 자동화 |
여러 Gmail 계정을 하나의 화면에서 조회할 수 있는 통합 인박스를 제공합니다.
사용자는 계정을 반복해서 전환하지 않아도 전체 메일 흐름을 한 번에 확인할 수 있습니다.
- Gmail OAuth 기반 계정 연동 (서비스 로그인과 별도로 인박스 접근 권한 확보)
- 계정별 메일 동기화 및 통합 조회
- 메일 계정 단위 필터링 및 검색 지원
- Thread 단위 메일 묶음 보기
메일 제목, 본문, 발신자 정보를 기반으로 AI가 적절한 라벨을 자동 제안합니다.
제안된 라벨은 필터링, 알림 설정, 민감정보 관리 정책과 연결하여 메일 관리 자동화의 기준으로 활용할 수 있습니다.
- LLM 기반 메일 내용 분석 후 라벨 자동 추천
- 사용자 정의 라벨 + 라벨 그룹 관리
- 라벨 기반 필터링 및 실시간 알림 정책 연동
- 과거 메일 일괄 재분류 (Debounce + Rate Limit 제어)
사용자의 기존 메일 작성 패턴을 벡터화하고, 유사한 메일 맥락을 검색하여 개인화된 답장 초안을 생성합니다.
- 사용자 메일 패턴 기반 임베딩 → pgvector 저장
- 유사 메일 검색 기반 RAG 구성
- 대화 맥락을 반영한 답장 초안 생성 및 검토
- 2~3개 답장 옵션 제안 → 편집기에서 자유 수정 후 발송
- 프롬프트 입력 → AI가 메일 제목·본문 초안 생성
- 전송 전 AI 자동 리뷰: 오타, 첨부 누락, 맥락 적절성 팝업 알림
Google Pub/Sub과 Gmail API를 통해 신규 메일 이벤트를 수신하고, RabbitMQ 기반 비동기 처리 구조로 메일 저장, 라벨링, 알림 작업을 안정적으로 분리했습니다.
- Google Pub/Sub 기반 Gmail 변경 이벤트 수신
- RabbitMQ 기반 비동기 메일 처리 (Direct Exchange + DLX)
- Backpressure 적용을 통한 트래픽 급증 대응
- DLQ 및 Dead Letter Alert 기반 실패 메시지 추적
- FCM(Firebase Cloud Messaging) 기반 실시간 Push 알림
- Portone 연동 결제 시스템
- 플랜별 AI 기능 사용 제한 및 Rate Limit 관리
1. mail.ajou.app 에서 서비스 회원가입 / 로그인
2. 사이드바 → [계정 추가] 클릭
3. Gmail OAuth 팝업에서 연동할 Google 계정 선택 및 권한 허용
4. 통합 인박스에서 해당 계정의 메일 자동 수신 확인
Gmail OAuth는 서비스 로그인과 별개입니다. 로그인된 서비스 계정에 여러 Gmail 주소를 연결할 수 있습니다.
1. 설정 → [라벨 관리]
2. [라벨 추가] → 라벨 이름 및 분류 규칙 입력
3. [AI 제안 받기] → AI가 현재 수신 메일 기반 라벨 규칙 추천
4. 규칙 확인 후 저장 → 이후 수신 메일에 자동 적용
5. 과거 메일 재분류: [전체 재분류] 버튼 클릭 (Rate Limit 적용)
1. 메일 Thread 열기
2. [AI 답장 초안 보기] 클릭
3. AI가 제안하는 2~3개 답장 옵션 중 선택
4. 편집기에서 자유롭게 수정
5. [전송] 클릭
1. 설정 → [알림]
2. 라벨별 알림 ON/OFF 설정
3. FCM 기반 실시간 Push 알림 수신 (브라우저 권한 허용 필요)
graph TD
Client["🖥️ 클라이언트\nReact 19 · TypeScript\nTanStack Start/Router/Query \nPWA (FCM)"]
Core["⚙️ Core (HTTP API 서버)\nSpring Boot 4 · Java 21\nSpring Security · Spring MVC\n\nGmail OAuth 연동 → Pub/Sub 수신 → MQ 발행\nController → Facade → Classifier → Publisher"]
Worker["🔧 Worker (비동기 처리)\nSpring Boot 4 · Java 21\n\nListener → Handler → ApiService / CommandService\nGmail 동기화 · 라벨 분류 · 벡터 임베딩 · FCM Push"]
DB["🗄️ 데이터 레이어\nPostgreSQL (pgvector) · Redis · RabbitMQ"]
External["🌐 외부 서비스\nGmail API · Google Pub/Sub · LLM API · Portone(결제)"]
Client -- HTTPS --> Core
Core -- "RabbitMQ\n(DirectExchange + DLX)" --> Worker
Worker --> DB
Core --> DB
Core <--> External
Worker <--> External
sequenceDiagram
participant PS as Google Pub/Sub
participant C as Core (Facade)
participant MQ as RabbitMQ
participant W as Worker (Listener)
participant G as Gmail API
participant LLM as LLM API
participant DB as PostgreSQL
participant FCM as FCM
PS->>C: Gmail 변경 이벤트 (Webhook)
C->>C: Classifier — 이벤트 타입 분류
C->>MQ: Publisher — 메시지 발행
Note over C: 즉시 응답 (DB Write 없음)
MQ->>W: 큐: mailsangja.{taskName}
W->>G: Gmail API 조회
G-->>W: 메일 데이터
W->>DB: CommandService — PostgreSQL 저장
W->>LLM: 라벨 추천 / 임베딩 생성
LLM-->>W: 결과
W->>FCM: Push 알림 발송
Note over MQ,W: 실패 시 → DLQ → Dead Letter Alert
graph LR
Controller --> Facade
Facade --> CommandService
Facade --> QueryService
Facade --> ApiService
CommandService --> Repository
QueryService --> Repository
ApiService["ApiService\n(외부 API 호출)"]
Repository["Repository (Port)"]
| 레포지토리 | 역할 | 기술 |
|---|---|---|
mailsangja/docs4capstone |
User Story 이슈 관리, 기획 문서 | GitHub Projects |
mailsangja/mailsangja-server |
백엔드 서버 (core + worker + db 멀티모듈) | Spring Boot 4 / Java 21 |
mailsangja/mailsangja-frontend |
프론트엔드 웹 앱 | React 19 / TypeScript / Vite |
mailsangja/mailsangja-infra |
k3s 클러스터 GitOps 매니페스트 및 Argo CD 배포 구성 | Kubernetes / Argo CD / Sealed Secrets |
mailsangja_server/
├── db/ # JPA Entity, Repository Port/Adapter
│ └── src/main/java/com/mailsangja/db/
│ ├── entity/ # User, MailAccount, Thread, Message, Label, ...
│ └── port/ # Repository Port 인터페이스
├── core/ # HTTP API 서버 (port: 8080)
│ └── src/main/java/com/mailsangja/core/
│ ├── controller/ # REST API 엔드포인트
│ ├── facade/ # 비즈니스 흐름 조율
│ ├── handler/ # Classifier + Handler (이벤트 분류·처리)
│ ├── service/ # CommandService / QueryService
│ ├── config/ # Security, RabbitMQ, Async 설정
│ └── common/ # 인증(AuthUser/AuthAdmin), DTO, 예외 처리
├── worker/ # MQ Consumer (port: 8081)
│ └── src/main/java/com/mailsangja/worker/
│ ├── messaging/
│ │ ├── listener/ # RabbitMQ Listener (비즈니스 Facade)
│ │ └── publisher/ # MQ 발행 전용
│ ├── handler/ # 이벤트 핸들러 (전략 패턴)
│ ├── service/ # ApiService / CommandService / QueryService
│ └── scheduler/ # Cron 트리거 (Watch 갱신 등)
├── docker/ # 관측성 스택 설정 (Loki, Tempo, Alloy, Grafana)
└── compose.yaml # 로컬 개발 환경 Docker Compose
mailsangja-frontend/
├── .env.example # 로컬 환경변수 템플릿
├── .github/ # GitHub 협업 관련 템플릿 및 GitHub Actions CI/CD 워크플로우
├── components.json # shadcn/ui 설정
├── docs/ # API, 푸시 알림 등 개발 참고 문서
├── messages/ # i18n 원본 다국어 메시지
├── public/ # 정적 에셋, PWA 아이콘, CNAME, robots.txt
└── src/
├── api/ # 백엔드 API 호출 함수
├── components/ # 화면/도메인/UI 컴포넌트
├── hooks/ # 클라이언트 상태와 UI 보조 훅
├── lib/ # 공통 유틸리티, API 클라이언트, PWA/FCM/분석 연동
├── mutations/ # React Query mutation 훅
├── paraglide/ # Paraglide 생성 산출물
├── queries/ # React Query query 훅
├── routes/ # TanStack Router 파일 기반 라우트
├── service-worker/ # 서비스 워커 보조 모듈
├── types/ # 도메인 타입 정의
└── sw.ts # PWA/FCM 커스텀 서비스 워커
mailsangja-infra/
├── bootstrap/
│ └── root-app.yaml # 클러스터 최초 1회 적용용 Argo CD root Application
├── argocd/
│ └── applications/ # Argo CD child Application 선언 (sync wave 기반)
│ ├── 00-cert-manager.yaml
│ ├── 00-sealed-secrets.yaml
│ ├── 10-cert-manager-issuers.yaml
│ ├── 20-argocd-ingress.yaml
│ └── 40-mailsangja.yaml
├── platform/
│ ├── argocd-ingress/ # Argo CD Ingress 및 server 설정
│ └── cert-manager-issuers/ # Let's Encrypt ClusterIssuer
├── apps/
│ └── mailsangja/ # MailSangja 애플리케이션 워크로드
│ ├── namespace.yaml
│ ├── configmap.yaml
│ ├── sealedsecret-app.yaml
│ ├── sealedsecret-infra.yaml
│ ├── core.yaml # core Deployment/Service (GHCR 이미지)
│ ├── worker.yaml # worker Deployment/Service (GHCR 이미지)
│ ├── postgres.yaml # PostgreSQL StatefulSet
│ ├── redis.yaml # Redis StatefulSet
│ ├── rabbitmq.yaml # RabbitMQ StatefulSet
│ ├── observability.yaml # Grafana, Loki, Tempo, Alloy
│ └── ingress.yaml # 서비스 Ingress 및 TLS
├── docs/ # GitOps 아키텍처, 릴리스 운영 문서
└── scripts/ # SealedSecret 생성 등 운영 보조 스크립트
Backend
Frontend
Infra / DevOps
AI / External API
| 기술 | 선택 이유 |
|---|---|
| RabbitMQ (DirectExchange + DLX) | Gmail 이벤트 처리를 Core에서 분리하여 비동기화. DLQ로 실패 메시지 추적. Backpressure 적용으로 트래픽 급증 대응 |
| pgvector | PostgreSQL 확장으로 별도 Vector DB 없이 임베딩 저장·유사 검색 구현 (RAG 파이프라인) |
| Redis | 라벨 Debounce/Rate Limit 상태 관리, AI API Rate Limit 캐시, Gmail Thread 분산 락 |
| Google Pub/Sub | Gmail 변경 이벤트를 Webhook 방식으로 수신 (폴링 대비 지연 최소화) |
| TanStack Router/Query | 타입 안전한 라우팅과 서버 상태 관리. 캐시·재검증·낙관적 업데이트 지원 |
| Tiptap | 리치 텍스트 에디터 (Markdown / HTML 메일 작성) |
| Paraglide JS | 트리쉐이킹 지원 i18n (한국어/영어). 번들 크기 최소화 |
| PWA + FCM | 브라우저 Push 알림 + 오프라인 캐시 지원 |
[임베딩 생성]
사용자 전송 메일 → 텍스트 정제 → LLM Embedding API
→ pgvector (PostgreSQL) 저장
[답장 초안 생성 — RAG Pipeline]
수신 메일 → 임베딩 변환
→ pgvector ANN 검색 (코사인 유사도) → 유사 과거 메일 K개 검색
→ 검색 결과 + 현재 메일 → LLM 프롬프트 구성
→ LLM API → 답장 초안 2~3개 생성
PR 생성 (→ main)
└─▶ [CI: Validate]
├─ PostgreSQL 18 + Redis 8 서비스 컨테이너 기동
├─ JUnit5 테스트 실행 (core + worker)
└─ JaCoCo 커버리지 → Codecov 업로드
main 브랜치 병합
└─▶ [Build Docker Image]
├─ Gradle bootJar 빌드 (core / worker)
├─ Docker Buildx (linux/amd64 + linux/arm64 멀티플랫폼)
└─ GHCR Push (ghcr.io/mailsangja/mailsangja-core:sha-<commit>, worker)
이미지 빌드 성공
└─▶ [Create Release PR]
├─ mailsangja-infra 체크아웃
├─ apps/mailsangja/core.yaml, worker.yaml 이미지 태그 갱신
└─ automation/mailsangja → main GitOps PR 생성/갱신
GitOps PR 검토 및 머지
└─▶ [Argo CD Sync]
├─ bootstrap/root-app.yaml → argocd/applications/* App of Apps 동기화
├─ 40-mailsangja Application → apps/mailsangja 매니페스트 반영
├─ core / worker Deployment rollout
└─ 이전 sha 이미지 태그로 되돌리는 Git 변경 기반 롤백
| 구성 요소 | 역할 |
|---|---|
| Grafana Alloy | 로그 수집 에이전트 (파일 → Loki), OTLP 트레이스 수신 (→ Tempo) |
| Grafana Loki | 로그 집계 및 조회 |
| Grafana Tempo | 분산 트레이싱 (OpenTelemetry) |
| Grafana | 통합 모니터링 대시보드 |
| RabbitMQ DLQ + Discord Alert | 실패 메시지 추적 및 이상 탐지 알림 |
| Amplitude | 사용자 행동 분석, Session Replay, 히트맵 |
- Spring Security 기반 인증·인가 (
@AuthUser/@AuthAdmin어노테이션) - Gmail OAuth — 서비스 로그인과 분리된 별도 인박스 연동 흐름
- 환경 변수로 민감 정보 관리 (하드코딩 금지,
@ConfigurationProperties사용) - GitHub Secrets — Codecov Token, GitOps PR Token 관리
- Sealed Secrets — Kubernetes Secret 평문을 Git에 저장하지 않고 암호화된 매니페스트로 관리
# 전체 인프라 기동 (PostgreSQL, Redis, RabbitMQ, 관측성 스택)
docker compose up -d
# 각 모듈 빌드 및 실행
./gradlew :core:bootRun
./gradlew :worker:bootRun
# 테스트 실행
./gradlew :core:test :worker:test --no-daemon# 프론트엔드 개발 서버
npm install
npm run dev| 구분 | 성과 |
|---|---|
| 🧑💻 사용자 지표 | 실제 서비스 운영을 통해 MAU 200명 이상 확보 |
| 🧪 테스트 품질 | JUnit5 기반 Service Layer 테스트를 작성하여 테스트 커버리지 52% 달성 |
| 🔒 테스트 케이스 | 핵심 비즈니스 로직에 대해 80개 이상 Unit / 통합 테스트 작성 |
| 📈 UX 분석 | Amplitude Session Replay와 히트맵 분석을 활용해 계정 연동 및 라벨 관리 플로우 개선 |
| 🚨 장애 대응 | RabbitMQ DLQ와 Dead Letter Alert를 통해 실패 메시지 추적 및 이상 상황 탐지 |
| ⚙️ 처리 안정성 | Pub/Sub 수신 이후 메일 저장·분류·알림 작업을 비동기화하여 Backpressure 기반 처리 구조 |
| 이름 | 학과 | 이메일 | 역할 |
|---|---|---|---|
| 김휘래 (@rlagnlfo1004) | 소프트웨어학과 | hrkim2001@ajou.ac.kr | 팀장 / 백엔드 개발 |
| 천진강 (@jjjjjk12) | 소프트웨어학과 | jjjjjk12@ajou.ac.kr | 인프라 / 백엔드 개발 |
| 곽민서 (@mkms8436) | 소프트웨어학과 | mkms0222@ajou.ac.kr | 디자인 / 프론트엔드 개발 |
| 한동현 (@asitisdev) | 소프트웨어학과 | hando1220@ajou.ac.kr | 인프라 / 프론트엔드 개발 |
Sprint 단위로 작업 목표를 설정하고, STORY → TASK 두 단계로 이슈를 분리하여 관리했습니다.
- STORY (
docs4capstone): 사용자 관점의 기능 요구사항 정의 - TASK (
mailsangja-server/mailsangja-frontend): STORY를 기반으로 한 실제 구현 단위 작업
각 TASK는 GitHub Projects Board에서 Backlog → Ready → In Progress → Review → Done 단계로 진행 상태를 추적하며, PR에서 Closes #이슈번호로 자동 종료됩니다.
📖 1. STORY Issue — 사용자 관점의 기능 요구사항
컨벤션
| 구분 | 규칙 |
|---|---|
| Title 형식 | [STORY-XXX] 제목 |
| 타입 | Story |
| 작성 방식 | As a / I want to / so that 형식으로 사용자 요구사항 기술 |
예시
Title: [STORY-427] 메일 라벨 자동 분류
👤 As a (사용자 유형): 서비스 사용자
🎯 I want to (원하는 기능): 메일을 자동으로 라벨링 하고 싶다
💡 so that (기대 효과): 중요한 메일을 빠르게 찾을 수 있도록
📋 2. TASK Issue — 실제 구현 단위 작업
레포:
mailsangja/mailsangja-server/mailsangja/mailsangja-frontend
컨벤션
| 구분 | 규칙 |
|---|---|
| Title 형식 | [TASK-XXX] 제목 |
| 타입 | Task-BE / Task-FE / Task-OPS |
| STORY 연결 | 상위 STORY Issue 번호를 기준으로 앞 세 자리 공유 |
예시 — BE Task
Title: [TASK-427] 민감 라벨 추가 및 처리 로직
## 🛠️ 목적
무엇을 위한 작업인지 설명
## 📝 작업 내용
- 해야 할 일 1
- 해야 할 일 2
## ✅ 완료 조건
- [x] 어떤 상태가 되면 Done인가?
- [x] 확인 기준은 무엇인가?
## 📚 참고 자료 (선택)
- 관련 API / 참고자료 문서 링크
예시 — FE Task
Title: [TASK-919] 중요 메일 기능 및 인박스 구현
## 🛠️ 목적
무엇을 위한 작업인지 설명
## 📝 작업 내용
- 해야 할 일 1
- 해야 할 일 2
## ✅ 완료 조건
- [x] 어떤 상태가 되면 Done인가?
- [x] 확인 기준은 무엇인가?
## 📚 참고 자료 (선택)
- 관련 문서 링크
🌿 3. Branch 규칙
컨벤션
| 구분 | 규칙 |
|---|---|
| 브랜치 구조 | {이슈번호}-{작업내용} |
| 이슈번호 | TASK Issue 번호 기준 |
| 작업내용 | 영문 소문자, - 구분 |
예시
803-admin-user
201-thread-count
901-start-thread-api
616-refactor-ai
💬 4. Commit 규칙
컨벤션
| 구분 | 규칙 |
|---|---|
| 형식 | {type}: {내용} (#{TASK 이슈번호}) |
| Type | feat, fix, refactor, docs, test, chore |
| 내용 | 한글 작성, 변경 목적 중심으로 기술 |
| 이슈번호 | 관련 TASK Issue 번호 괄호로 명시 |
예시
feat: 별표 편지함 안읽은 수 반영 (#146)
fix: Inline/Attachment 구분 로직 강화 (#43)
refactor: 응답 DTO 및 Entity star 필드 추가 (#146)
test: star 토글 조회 구현 및 테스트 (#146)
🔀 5. Pull Request 규칙
컨벤션
| 구분 | 규칙 |
|---|---|
| Title | [STORY-XXX] 작업 내용 |
| User Story | docs4capstone STORY Issue 번호 연결 |
| Task | Closes #이슈번호 로 TASK Issue 자동 종료 |
| Test 결과 | API 기능별 HTTP Method · 경로 · 결과 이미지 첨부 |
PR 템플릿
## 🔗 관련 작업
### 👤 User Story
- mailsangja/docs4capstone#n
### 📌 Task
- Closes #
- Closes #
## 💡 작업 내용
-
-
## 📝 추가 설명
### 1.
-
### 2.
-
## ⚡️ Test 결과
| 기능 1 | 기능 2 |
| ---------- | ---------- |
| HTTP Method | HTTP Method |
| /api/v1/example | /api/v1/example |
| 이미지 태그 | 이미지 태그 |
아주대학교 소프트웨어학과 · 2026-1 SW캡스톤디자인 2조
