본문으로 건너뛰기

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

삑사리

2026.06.01

001_삼성웰스토리_구로사업소_빽사리_납품확인서.pdf (83.7KB)


**소개**

지난 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를 내리는 구조입니다.

**TEST_MODE 하나가 심리적 안전망이 된다.**
100명 발송 전에 내 메일로 먼저 받아보는 과정이 있다는 것만으로도 마음이 편했습니다.
실수로 잘못된 파일이 전송되거나, 문구에 오류가 있을 때 막아주는 마지막 방어선입니다.

---
 

2

함께 이야기해요 2

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

라면 프로필 이미지
라면2026.06.03

정해진 문서 양식에 따라 자동화 프로세스를 잘 만드시고, 이메일 발송까지 너무 잘 만드셧네요! '세부 업무마다 참고자료 넣기', '1단계- 폴더구조설계' 급하게 일하다보면 저도 맨날 놓치는데 이번 스터디 하면서 스터디장님의 가이드와 여러 분들의 사례를 접하면서 저도 체화하는데 도움이 될 것 같습니다~ 좋은 사례 공유 감사드려요.

Develiper 프로필 이미지
Develiper2026.06.01

내용을 보니 원하시는 자동화 시스템을 어느 정도 성공적으로 구축하신 것 같네요. 축하드립니다. 계속 매의 눈으로 관찰하고 이것저것 듣고 생각하고 고민하시더니 그것들을 종합해서 실행해 옮기시고 성공하신 듯합니다.

아주 잘하고 계십니다.

다른 스터디원분들에게도 자동화 시스템 만들 것을 보여주시고 어떻게 만들었는지를 알려주시면 다른 견적서 만드는 것을 하고 계신 분들에게 큰 도움이 될 것 같습니다.

시스템을 더 고도화하는 법도 지난 주에 알려드리긴 했는데 내일 오시면 같이 논의하면서 다시 알려드리도록 하겠습니다.

감사합니다. 👍 🔥 💪

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

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

이런 사례도 있어요

사례 전체 보기