연락처 검토부터 Outlook 초안까지
Excel/CSV 중심 경로와 초안 생성 상태를 원본 Git 코드에 맞춰 정리했습니다.
01 · 구성 및 역할
영업 팔로업 작업 흐름
연락처를 검토하고 행사·자료를 지정한 뒤, 사전점검을 통과한 행으로 Outlook 초안을 만듭니다.
근거와 해석 범위
- Excel 중심 경로는 draft 모드에서만 초안을 생성하며 send 모드 요청을 거부합니다. 전역 설정의 기본값과 이 경로의 동작을 구분합니다.
- 이메일·중복·자료 점검과 Outlook 인증 실패는 다른 단계에서 처리합니다. 연결 상태만으로 초안 생성 성공을 보장하지 않습니다.
- 명함 이미지 추출은 비용·지연·사용성 검토 후 보조 입력 경로로 유지했습니다.
2026.10.08 원본 Git의 표 업로드·매핑·행 검토·초안 서비스와 Microsoft Graph 호출 경로를 대조했습니다. 실제 연락처와 첨부 문서는 사용하지 않았습니다.
02 · 처리 흐름
생성 결과와 재시도 경계
초안 생성 성공, 명확한 실패, 결과가 불확실한 오류를 구분해 중복 생성을 줄이도록 구성했습니다.
근거와 해석 범위
- 아래 세 결과는 서로 다른 분기입니다. 순서대로 실행되는 단계가 아닙니다.
- 외부 API에서 결과가 불확실한 경우를 별도 처리하지만, 분산 환경의 완전한 중복 방지를 입증하는 시험 결과는 아닙니다.
원본 Git의 초안 생성 서비스에서 사전점검, 작업 점유, 성공·실패·불확실 상태와 실패 행 재시도 분기를 확인했습니다.
영업 후속 연락에 필요한 연락처 검토, 행사·솔루션·자료 지정, 이메일 초안 생성을 하나의 작업 흐름으로 구현했습니다. 현재 설명하는 주 경로는 Excel/CSV 입력부터 Microsoft Graph를 통한 Outlook 초안 생성까지입니다.
연락처를 옮기고 고객별 자료와 메일을 준비하는 작업은 반복되지만, 잘못된 수신자나 첨부 파일을 그대로 발송해서는 안 됩니다. 사람이 행별 내용을 확인한 뒤 초안을 만들도록 단계를 나눴습니다. 초기 명함 이미지 추출은 비용·지연·사용성을 검토한 후 보조 입력 경로로 남겼습니다.
연락처 업로드·컬럼 매핑·행 단위 검토, 행사·솔루션·템플릿·첨부 지정, 사전점검과 Outlook 초안 생성 흐름을 설계·구현했습니다. 제 영업 업무에서 반복되는 준비 작업을 도구로 구체화한 사례입니다.
업로드 단계에서는 표의 열을 해석하고 사용자가 매핑을 확정합니다. 각 행의 연락처와 지정 자료를 검토한 뒤 이메일 형식, 중복, 템플릿과 첨부를 점검합니다. 통과한 행만 초안 생성 대상으로 삼고, 사용자별 Outlook 연결 정보를 이용해 Graph에 초안을 요청합니다.
생성 성공 시 초안 식별자와 완료 상태를 기록합니다. 명확한 실패는 실패 행을 대상으로 다시 사전점검한 후 재시도합니다. 외부 요청 결과가 불확실한 오류는 검토 필요로 전환해 일반 실패 재시도와 구분합니다.
React·TypeScript 화면, FastAPI 처리 경로, 컬럼 매핑과 사전점검, 초안 생성 및 시도 상태 관리가 코드로 남아 있습니다. 이번 페이지에는 실제 데이터 대신 작업 흐름도와 상태 분기도를 재구성했습니다.
원본 Git 코드에서 현재 Excel 경로가 draft 모드에서만 초안을 만들고 send 모드는 거부하는 것을 확인했습니다. 저장소를 검토하는 동안 실제 Graph 호출이나 메일 발송은 실행하지 않았습니다. 시간 절감률·발송 성과는 별도 측정 자료가 없어 수치로 제시하지 않습니다.
원본 Git의 처리 흐름을 공개 가능한 도식으로 재구성했습니다. 고객 데이터·내부 설정·원본 소스는 공개하지 않습니다.
입력·초안·재시도 근거
| 항목 | 코드·자료에서 확인한 내용 | 해석 범위 |
|---|---|---|
| 입력 | Excel/CSV 업로드, 로컬 매핑 제안과 사용자 확정 | 업로드만으로 외부 메일 생성 없음 |
| 사전점검 | 이메일, 매핑, 필수 지정값, 중복과 첨부 검사 | Outlook 연결·호출 오류는 생성 단계에서 별도 처리 |
| 초안 | Graph 초안 생성과 식별자 기록 | Excel 경로의 실제 발송 요청은 차단 |
| 재시도 | 실패 행 재점검 · 불확실 결과는 검토 필요 | 완전한 중복 방지나 무중단 운영 보장 아님 |
2026.10.08 원본 Git 코드 검토 기준입니다. 실제 연락처·메일·Graph 호출을 이용한 재현 시험은 수행하지 않았습니다.