B2G 납품확인서 문서 자동화하기-2주차 :실행 편
삑사리
2026.05.30
B2G 납품확인서 문서 자동화하기 — 2주차: 실행 편
**소개**
지난 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를 내리는 구조입니다.001_삼성웰스토리_구로사업소_빽사리_납품확인서.pdf (83.7KB)

안녕하세요, 삑사리님! 지피터스에 오신 걸 환영해요 😊
가입인사 게시판에 B2G 문서 자동화 사례까지 공유해주셨네요! Claude에게 원본 파일을 직접 던져주는 Reference 전략, 그리고 PDF 생성과 메일 발송을 단계별로 분리해 사람이 중간에 검토하는 구조가 인상적이에요. 실무에 바로 쓸 수 있는 탄탄한 접근이에요.
앞으로도 이런 사례들 많이 공유해주세요! 궁금한 점이 있으시면 Q&A 게시판도 편하게 활용해주세요. 함께해서 반가워요!