연락처 검토부터 Outlook 초안까지

Excel/CSV 중심 경로와 초안 생성 상태를 원본 Git 코드에 맞춰 정리했습니다.

01 · 구성 및 역할

영업 팔로업 작업 흐름

연락처를 검토하고 행사·자료를 지정한 뒤, 사전점검을 통과한 행으로 Outlook 초안을 만듭니다.

좌우로 움직여 전체 그림을 볼 수 있습니다.
영업 팔로업 작업 흐름연락처를 검토하고 행사·자료를 지정한 뒤, 사전점검을 통과한 행으로 Outlook 초안을 만듭니다. Excel 중심 경로는 draft 모드에서만 초안을 생성하며 send 모드 요청을 거부합니다. 전역 설정의 기본값과 이 경로의 동작을 구분합니다. 이메일·중복·자료 점검과 Outlook 인증 실패는 다른 단계에서 처리합니다. 연결 상태만으로 초안 생성 성공을 보장하지 않습니다. 명함 이미지 추출은 비용·지연·사용성 검토 후 보조 입력 경로로 유지했습니다.입력 · 사람이 확인하는 단계생성 · 사전점검 후 초안으로 전달01 · Excel / CSV 업로드표 형태의 연락처 입력열 이름과 샘플 확인업로드만으로 메일 미생성02 · 컬럼 매핑 확인이름 · 회사 · 이메일 연결로컬 규칙으로 매핑 제안사용자가 매핑 확정03 · 행별 검토 · 지정연락처 수정과 제외행사 · 솔루션 · 템플릿첨부 자료와 내용 검토04 · 사전점검매핑 · 이메일 형식 확인중복 · 템플릿 · 첨부 확인통과한 행을 생성 대기로05 · 초안 생성Outlook 연결 토큰 확인Microsoft Graph 호출초안 ID와 결과 기록06 · Outlook에서 검토받는 사람 · 본문 · 첨부사용자가 최종 내용 확인이 경로는 자동 발송 차단
근거와 해석 범위
  • Excel 중심 경로는 draft 모드에서만 초안을 생성하며 send 모드 요청을 거부합니다. 전역 설정의 기본값과 이 경로의 동작을 구분합니다.
  • 이메일·중복·자료 점검과 Outlook 인증 실패는 다른 단계에서 처리합니다. 연결 상태만으로 초안 생성 성공을 보장하지 않습니다.
  • 명함 이미지 추출은 비용·지연·사용성 검토 후 보조 입력 경로로 유지했습니다.

2026.10.08 원본 Git의 표 업로드·매핑·행 검토·초안 서비스와 Microsoft Graph 호출 경로를 대조했습니다. 실제 연락처와 첨부 문서는 사용하지 않았습니다.

02 · 처리 흐름

생성 결과와 재시도 경계

초안 생성 성공, 명확한 실패, 결과가 불확실한 오류를 구분해 중복 생성을 줄이도록 구성했습니다.

좌우로 움직여 전체 그림을 볼 수 있습니다.
생성 결과와 재시도 경계초안 생성 성공, 명확한 실패, 결과가 불확실한 오류를 구분해 중복 생성을 줄이도록 구성했습니다. 아래 세 결과는 서로 다른 분기입니다. 순서대로 실행되는 단계가 아닙니다. 외부 API에서 결과가 불확실한 경우를 별도 처리하지만, 분산 환경의 완전한 중복 방지를 입증하는 시험 결과는 아닙니다.요청 전 · 매핑과 행 상태 점검요청 후 · 결과에 따른 처리매핑 · 입력값 확인확정된 컬럼 매핑이메일과 필수 지정값첨부 및 기존 작업 검사생성 대기 상태사전점검 통과 행만 진행작업 중복 키와 상태 확인이미 처리한 요청은 건너뜀Graph 초안 요청사용자 연결 정보 사용검토한 내용으로 초안 요청시도 상태와 결과 기록생성 성공초안 식별자 저장행을 완료 상태로 갱신Outlook에서 최종 검토명확한 생성 실패실패 사유를 행에 표시실패 행만 재시도 대상사전점검을 다시 수행결과 불확실외부 요청 결과 확인 필요행을 검토 필요로 전환일괄 자동 재시도에서 제외
근거와 해석 범위
  • 아래 세 결과는 서로 다른 분기입니다. 순서대로 실행되는 단계가 아닙니다.
  • 외부 API에서 결과가 불확실한 경우를 별도 처리하지만, 분산 환경의 완전한 중복 방지를 입증하는 시험 결과는 아닙니다.

원본 Git의 초안 생성 서비스에서 사전점검, 작업 점유, 성공·실패·불확실 상태와 실패 행 재시도 분기를 확인했습니다.

01요약

영업 후속 연락에 필요한 연락처 검토, 행사·솔루션·자료 지정, 이메일 초안 생성을 하나의 작업 흐름으로 구현했습니다. 현재 설명하는 주 경로는 Excel/CSV 입력부터 Microsoft Graph를 통한 Outlook 초안 생성까지입니다.

02문제와 판단

연락처를 옮기고 고객별 자료와 메일을 준비하는 작업은 반복되지만, 잘못된 수신자나 첨부 파일을 그대로 발송해서는 안 됩니다. 사람이 행별 내용을 확인한 뒤 초안을 만들도록 단계를 나눴습니다. 초기 명함 이미지 추출은 비용·지연·사용성을 검토한 후 보조 입력 경로로 남겼습니다.

03나의 역할

연락처 업로드·컬럼 매핑·행 단위 검토, 행사·솔루션·템플릿·첨부 지정, 사전점검과 Outlook 초안 생성 흐름을 설계·구현했습니다. 제 영업 업무에서 반복되는 준비 작업을 도구로 구체화한 사례입니다.

04입력부터 생성까지

업로드 단계에서는 표의 열을 해석하고 사용자가 매핑을 확정합니다. 각 행의 연락처와 지정 자료를 검토한 뒤 이메일 형식, 중복, 템플릿과 첨부를 점검합니다. 통과한 행만 초안 생성 대상으로 삼고, 사용자별 Outlook 연결 정보를 이용해 Graph에 초안을 요청합니다.

05실패와 재시도

생성 성공 시 초안 식별자와 완료 상태를 기록합니다. 명확한 실패는 실패 행을 대상으로 다시 사전점검한 후 재시도합니다. 외부 요청 결과가 불확실한 오류는 검토 필요로 전환해 일반 실패 재시도와 구분합니다.

06산출물

React·TypeScript 화면, FastAPI 처리 경로, 컬럼 매핑과 사전점검, 초안 생성 및 시도 상태 관리가 코드로 남아 있습니다. 이번 페이지에는 실제 데이터 대신 작업 흐름도와 상태 분기도를 재구성했습니다.

07검증 범위

원본 Git 코드에서 현재 Excel 경로가 draft 모드에서만 초안을 만들고 send 모드는 거부하는 것을 확인했습니다. 저장소를 검토하는 동안 실제 Graph 호출이나 메일 발송은 실행하지 않았습니다. 시간 절감률·발송 성과는 별도 측정 자료가 없어 수치로 제시하지 않습니다.

원본 Git의 처리 흐름을 공개 가능한 도식으로 재구성했습니다. 고객 데이터·내부 설정·원본 소스는 공개하지 않습니다.

검증 자료

입력·초안·재시도 근거

입력·초안·재시도 근거
항목코드·자료에서 확인한 내용해석 범위
입력Excel/CSV 업로드, 로컬 매핑 제안과 사용자 확정업로드만으로 외부 메일 생성 없음
사전점검이메일, 매핑, 필수 지정값, 중복과 첨부 검사Outlook 연결·호출 오류는 생성 단계에서 별도 처리
초안Graph 초안 생성과 식별자 기록Excel 경로의 실제 발송 요청은 차단
재시도실패 행 재점검 · 불확실 결과는 검토 필요완전한 중복 방지나 무중단 운영 보장 아님

2026.10.08 원본 Git 코드 검토 기준입니다. 실제 연락처·메일·Graph 호출을 이용한 재현 시험은 수행하지 않았습니다.

이 사례의 전체 맥락이 궁금하시면, 문의해 주세요.
gkwoghks96@gmail.com