플러스프로젝트 배경
관공서·금융기관이 발송하는 고지서·납부확인서를 PDF로 자동 생성하고 이메일·웹팩스·카카오알림톡으로 다채널 발송하는 시스템을, 지자체·공공기관의 고지 업무 디지털 전환 수요를 배경으로 파일럿으로 구현했습니다. 문서 생성부터 채널별 발송, 이력 추적, 브랜드 설정까지 전체 워크플로우를 단기간에 구현하고 즉시 확장·운영 가능한 상태임을 검증하는 것이 목표였습니다.
프로젝트 성과
PDF 고지서·납부확인서 자동 생성 완성
PDFKit + AppleGothic 한글 폰트로 A4 고지서·납부확인서 동적 생성. 회사 로고·서명 포함, JWT query token 폴백으로 브라우저 직접 다운로드 지원
ISender 어댑터 패턴으로 3채널 통합
이메일(Nodemailer)·웹팩스·카카오알림톡을 단일 인터페이스로 통합. 채널 추가 시 어댑터 1개 구현만으로 확장 가능한 플러그인 구조
API 82개 97.74% + E2E 22개 전 통과
vitest + supertest로 API statement 97.74% 달성. Playwright E2E 22개 시나리오 6개 페이지 골든패스 전부 통과. in-memory SQLite 격리 테스트 환경 구축
발송 이력 다중 필터 조회
채널·날짜·수신자·상태 기준 복합 필터. 발송 건당 성공/실패·응답 코드 기록으로 재발송 대상 즉시 식별 가능
관리자 브랜드 설정 → PDF 즉시 반영
회사명·로고·서명 이미지를 관리자 페이지에서 수정하면 다음 PDF 생성에 즉시 반영. JWT 인증 기반 관리자 전용 API로 보호
핵심 기능
PDF 고지서·납부확인서 자동 생성
PDFKit으로 A4 레이아웃 고지서·납부확인서 동적 생성. AppleGothic 한글 폰트 내장, 회사 로고·서명 이미지 포함. JWT query token 폴백으로 브라우저 직접 다운로드 지원
진행 단계
1단계: 아키텍처 설계 + 인증 API
2026.04.
ISender·IInvoiceRepository 인터페이스 설계, Express 라우터 구조화, SQLite 스키마 정의. JWT 인증 미들웨어 + query token 폴백 구현
프로젝트 상세
고지서·납부확인서를 PDF로 자동 생성하고 이메일·웹팩스·카카오알림톡으로 발송하는 통합 관리 시스템 파일럿입니다. React + Node.js + Express 기반으로 ISender 어댑터 패턴을 적용해 채널별 발송을 단일 API로 통합했으며, API 82개(statement 97.74%)와 E2E 22개 테스트를 완비한 상태입니다.
