DocuSeal 전자 서명 워크플로우 도입으로 HRMS 문서 처리 자동화 달성함

Context

HRMS 플랫폼에서 채용 오퍼 LETTER, 계약서, NDA 등 문서 서명 기능을 구현해야 했음. 기존 방식은 사용자가 외부 페이지로 이동해야 하는 비효율적인 UX 문제가 있었음.

Technical Solution

• Backend API Gateway 패턴: DocuSeal API 키를 Backend 뒤에 숨기고 모든 통신을 Backend에서 처리함
• Template Management: /templates/pdf와 /templates/docx API로 계약서를 재사용 가능한 템플릿으로 변환함
• 동적 Submission 생성: template_id, signer list, prefilled field values를 Backend에서 생성하여 워크플로우 인스턴스화함
• @docuseal/react 임베딩: DocusealForm 컴포넌트로 서명 UI를 모달 내부에 내장하여 네이티브 앱 경험을 제공함
• Callback/Webhook 처리: Backend에서 DOCUSEAL_CALLBACK_EVENT_SECRET_KEY 검증 후 서명 완료 이벤트를 큐로 처리하고 서명 PDF와 감사 로그를 자체 시스템에 저장함

Impact

문서 서명 완료 후 서명된 PDF와 감사 로그가 자동으로 자체 DB에 저장됨. external_id 매핑으로 DocuSeal 서명자를 내부 사용자 레코드와 연결하여 데이터 정합성을 확보함.

Key Takeaway

DocuSeal을 서명 렌더링 레이어로만 사용하고 실제 제품 로직과 데이터 소유권은 자체 Backend와 Frontend에서 관리하는 것이 핵심 설계 원칙임.