CC-my-Jira: Agentic JIRA Ticketing via Postmark

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴, 인공지능, DevOps

대상자

- JIRA와 이메일 통합을 필요로 하는 개발 팀 및 프로젝트 관리자

- AI 기반 자동화 도구 사용에 관심 있는 개발자 및 DevOps 엔지니어

- 이메일을 통해 요청/피드백을 받는 비개발 부서 직원

핵심 요약

• AI 에이전트는 GPT-4.1을 사용하여 이메일의 내용, 의도, 기술적 세부사항을 이해하고 JIRA 티켓을 생성합니다.
• Postmark 웹훅을 통해 이메일을 즉시 처리하고, AI 및 JIRA 연동 작업은 BullMQ/Redis 백그라운드 워커에 의해 처리되어 지연 없이 수행됩니다.
• 다중 테넌트 SaaS 구조를 통해 Atlassian OAuth, Supabase RLS를 활용한 데이터 분리 및 사용자 관리가 가능합니다.

섹션별 세부 요약

1. 문제 정의 및 솔루션 개요

• 이메일을 통해 전달된 요청, 버그 리포트, 피드백이 수동 처리로 인해 손실되거나 오해될 수 있음.
• CCMyJira는 이메일을 자동으로 JIRA 티켓으로 변환하여 프로젝트 팀의 작업 효율성 향상에 기여.
• AI 에이전트를 통해 이메일 내용 및 의도 분석, 중복 티켓 방지, 첨부 파일 자동 업로드 등의 기능 제공.

2. 핵심 기능

• 🧠 AI Agents: GPT-4.1 기반의 이메일 분석 및 티켓 생성.
• 🎟️ Intelligent Ticket Management: 기존 JIRA 티켓과 중복 여부 확인 후, 새 티켓 생성 또는 기존 티켓 업데이트.
• 📎 Seamless Attachment Handling: 이메일 첨부 파일 및 이미지 자동 업로드.
• 🎯 Smart Assignee Suggestions: 팀워크, 역할, 이메일 내 @멘션 등을 고려한 할당자 제안.

3. 아키텍처 및 기술적 구현

• -multi-tenant SaaS 아키텍처: Atlassian OAuth, Supabase RLS 활용.
• Postmark 웹훅으로 이메일을 즉시 처리 (50ms 내 응답).
• BullMQ/Redis를 사용한 백그라운드 처리로 AI 및 JIRA 연동 작업 수행.
• Frontend/Backend 분리: Next.js/React 기반의 프론트엔드 및 NestJS 기반의 백엔드.
• GitHub에서 제공되는 리포지토리 및 환경 설정 가이드.

4. 사용법 및 테스트 팁

• 데모 모드에서는 공유 JIRA 보드를 통해 즉시 테스트 가능.
• 인증 모드에서는 Atlassian 계정 로그인 후 조직 생성 및 도메인 인증이 필요.
• 테스트 시 복잡한 이메일 (이미지, 첨부파일, HTML, 다중 쓰레드)을 사용하거나, 우선순위 키워드 ("urgent", "critical")를 포함하여 테스트.
• @멘션을 사용하거나, 이메일 회신을 통해 기존 티켓 업데이트 기능 확인.

결론

CCMyJira는 Postmark 웹훅을 활용한 이메일 처리와 AI 기반의 자동화를 결합하여, 이메일을 JIRA 티켓으로 변환하는 효율적인 플랫폼을 제공합니다. 이메일 기반 요청을 자동으로 처리하여 개발 팀의 작업 효율성을 높이고, DevOps 팀은 이메일 처리 및 티켓 관리 프로세스를 자동화할 수 있습니다. 실무에서는 이메일과 JIRA 간의 간극을 줄이고, 팀 협업 향상을 위해 CCMyJira를 도입하는 것을 권장합니다.