본문으로 건너뛰기
가입했어요

B2G 납품확인서 문서 자동화하기 — 2주차: 실행 편

삑사리

2026.05.30

소개

지난 1주차에서 Claude Plan Mode로 기획서와 프로세스 구조도를 완성했습니다.
이번 2주차에서는 기획을 실제 동작하는 코드로 구현하고, 테스트 발송까지 완료했습니다.
"기획이 탄탄하면 실행은 빠르다"는 걸 이번 주에 몸소 체감했습니다.

---

**이번 주 목표**

- 납품확인서 양식을 그대로 재현한 PDF 자동 생성
- 서명 이미지 자동 삽입
- Gmail을 통한 개별 메일 자동 발송
- 사람이 각 단계를 검토·승인하는 구조 구현

---

**핵심 원칙 재확인 — Reference 넣기**

1주차에서 세운 3가지 원칙 중 이번 주 가장 효과를 본 것은 "세부 업무마다 참고 자료(Reference) 넣기" 였습니다.

Claude에게 납품확인서 양식을 그냥 설명하는 게 아니라, 실제 파일 자체를 던져줬습니다.

제공한 Reference:
- 납품확인서 양식.pdf — 실제 사용 중인 양식 원본
- 납품확인서 양식.xlsx — 동일 양식의 엑셀 버전
- 서명.jpg — 납품 담당자 서명 이미지

Claude가 PDF를 직접 읽고 레이아웃, 색상, 테이블 구조, 서명 위치까지 분석한 뒤
동일한 디자인의 PDF를 생성하는 코드를 작성했습니다.
설명으로 지시하는 것보다 훨씬 정확하고 빠르게 결과가 나왔습니다.

---

**실행 과정**

**1단계 — 폴더 구조 설계**

Claude가 제안한 파일 구조는 아래와 같습니다.

```
delivery-note/
├── data/
│   └── recipients.xlsx        ← 수신자 목록 (사람이 직접 관리)
├── output/pdf/                ← 생성된 PDF 저장
├── logs/
│   └── send_log.csv           ← 발송 결과 로그
├── config.py                  ← 이메일 계정, 경로 설정
├── step1_generate_pdf.py      ← PDF 생성
└── step2_send_email.py        ← 메일 발송
```

파일을 단계별로 분리한 덕분에 PDF 생성과 메일 발송을 독립적으로 실행·검토할 수 있었습니다.
이게 바로 사람이 주도권을 갖는 구조입니다.

---

**2단계 — PDF 생성**

수신자 목록 엑셀(`recipients.xlsx`)을 읽어 담당자별 납품확인서를 자동으로 PDF로 생성합니다.

실행 명령어는 단 한 줄입니다.

```
python step1_generate_pdf.py
```

생성 결과:

```
[1] 001_삼성웰스토리_구로사업소_빽사리_납품확인서.pdf
PDF 1건 생성 완료 → output/pdf/
```

생성된 PDF를 열어보니 원본 양식과 거의 동일하게 재현되었고,
서명 이미지도 검수담당자 서명란 정확한 위치에 자동으로 들어갔습니다.

*[PDF 생성 결과 — 원본 양식과 동일한 레이아웃, 서명 이미지 자동 삽입]*

---

**⏸ 사람 검토 ① — PDF 샘플 육안 확인**

전체 발송 전에 생성된 PDF를 직접 열어 확인했습니다.

체크한 항목:
- 납품처명, 담당자명 정확히 들어갔는지
- 품목·수량·금액 오류 없는지
- 서명 이미지 위치와 크기
- 전체 레이아웃 깨짐 없는지

문제 없으면 다음 단계로 진행, 문제 있으면 양식 수정 후 재생성합니다.
**이 검토 단계가 있어서 100건을 발송해도 실수가 없습니다.**

---

**3단계 — Gmail 연동 설정**

일반 Gmail 비밀번호는 Python 코드에서 직접 사용할 수 없습니다.
Google이 프로그램의 직접 접속을 보안상 막아두기 때문입니다.

해결 방법은 Gmail App Password(앱 비밀번호) 발급입니다.

```
① myaccount.google.com/security 접속
② 2단계 인증 활성화 확인
③ myaccount.google.com/apppasswords 접속
④ 앱 이름 입력 → [만들기] → 16자리 비밀번호 복사
⑤ config.py 에 붙여넣기
```

발급된 비밀번호를 config.py에 한 줄 입력하면 설정 완료입니다.

```python
SENDER_APP_PASSWORD = "발급받은 16자리 비밀번호"
TEST_MODE = True   # 테스트 중엔 True 유지
```

`TEST_MODE = True` 상태에서는 모든 메일이 지정된 테스트 주소로만 발송됩니다.
실수로 100명에게 테스트 메일을 보내는 사고를 방지하는 안전장치입니다.

---

**4단계 — 테스트 발송**

```
python step2_send_email.py
```

실행하면 아래처럼 발송 진행 상황이 실시간으로 출력됩니다.

```
=== STEP 2: 납품확인서 메일 발송 [테스트 모드] ===
  모든 메일 → [email protected] 으로만 발송됩니다.
 
발송 건수: 1건

  계속하려면 Enter 를 누르세요 (Ctrl+C 로 취소) ...
  Gmail 연결 성공

  [1] 삼성웰스토리 구로사업소 빽사리 → [email protected]  [OK]

발송 완료: 성공 1건 / 실패 0건
로그 저장 완료 → logs/send_log.csv
```

---

**⏸ 사람 검토 ② — 수신 메일 최종 확인**

네이버 메일로 수신된 테스트 메일을 직접 확인했습니다.

확인 항목:
- 제목: [납품확인] 삼성웰스토리 구로사업소 납품확인서 송부의 건
- 본문: 담당자명·부대명·납품일자가 개별화된 메일 문구
- 첨부파일: 납품확인서 PDF 정상 첨부

*[수신 메일 화면 — 개별화된 제목, 본문, PDF 첨부 확인]*

---

**결과물**

이번 주에 완성된 산출물입니다.

- step1_generate_pdf.py — 수신자 목록에서 개인별 납품확인서 PDF 자동 생성
- step2_send_email.py — Gmail을 통한 개별 메일 자동 발송 (첨부 포함)
- config.py — 발송 계정, 경로, 메일 문구 템플릿 통합 관리
- logs/send_log.csv — 발송 성공/실패 자동 기록

---

**배운 점**

**Reference를 파일로 직접 제공하면 설명이 필요 없다.**
납품확인서 디자인을 말로 설명하는 대신, 실제 PDF 파일을 Claude에게 주었습니다.
Claude가 레이아웃부터 색상, 서명 위치까지 직접 분석해서 완벽하게 재현했습니다.
앞으로 자동화할 문서가 있다면 원본 파일을 먼저 챙기는 게 핵심이라는 걸 배웠습니다.

**단계를 쪼개면 사람이 통제권을 갖는다.**
PDF 생성과 메일 발송을 별도 스크립트로 분리했습니다.
덕분에 PDF를 검토한 뒤 발송하고, 발송 전에 목록을 다시 한 번 확인하는 흐름이 자연스럽게 만들어졌습니다.
AI가 다 처리하는 게 아니라 사람이 각 단계의 OK를 내리는 구조입니다.

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

뽀짝이 프로필 이미지
뽀짝이2026.06.10

안녕하세요, 삑사리님! 지피터스에 오신 걸 환영해요 😊

가입인사 게시판 첫 글로 B2G 납품확인서 자동화 2주차 기록을 남겨주셨네요 — "기획이 탄탄하면 실행은 빠르다", 멋진 정리예요. 이런 실전 사례글은 참여 중인 스터디 게시판에 올리시면 스터디 동료들 피드백도 받고 주차 활동으로도 인정되니, 다음 글은 스터디 게시판에 올려보세요!

함께해서 반가워요!

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요