ERP 연동 의약품 도매 주문 플랫폼

의약품 도매용 B2B 주문 플랫폼입니다. 구매자용 미니프로그램, 운영 콘솔, Spring Boot API로 구성됩니다. 예약 작업이 유통사 ERP에서 상품과 재고를 가져오고, 주문과 고객을 재시도와 함께 ERP로 돌려보냅니다.

핵심 요약: 유통사 ERP를 기준 시스템으로 그대로 두고 의약품 도매상의 셀프서비스 주문을 만들었습니다. 예약 작업이 카탈로그와 재고를 가져오고, 주문과 고객을 재시도와 함께 돌려보내며, 상품이 출고되고 청구서가 발행될 때까지 전표 상태를 조회합니다.

개요

약국과 의원은 미니프로그램으로 주문합니다. 운영자는 웹 콘솔에서 상품, 구매자 자격, 주문, 사후 처리를 관리합니다. 상품, 재고, 청구서는 여전히 ERP에서 오며, 플랫폼은 결제와 승인이 끝난 주문과 해당 고객만 보냅니다.

연동 흐름: 구매자 미니프로그램과 운영 콘솔이 플랫폼 API를 쓴다. 예약 작업이 ERP에서 상품은 30분마다, 재고는 1분마다 가져오고, 1분마다 주문과 고객을 재시도와 함께 보내고, 5분마다 전표 상태를 조회해 전기된 출고 전표를 출고 완료 주문으로 바꾸고 청구서를 가져온다.

문제

도매 구매자는 셀프서비스 주문이 필요했지만 재고, 회계, 청구는 ERP에 남아 있어야 했습니다. 두 시스템은 ERP 쪽이 공개한 인터페이스 사양을 통해 일관성을 유지해야 했습니다.

제약

  • 상품, 재고, 전표 상태, 청구서의 기준 시스템은 ERP.
  • 구매 전에 구매자 자격을 확인해야 하며, 업로드한 허가증의 문서 인식도 포함.
  • 개발과 테스트는 실제 결제, 물류, 알림, ERP 접근 없이 돌아가야 함.

아키텍처

구성 요소구현
백엔드Java 17, Spring Boot 3.3, MySQL 8, Redis, S3 호환 오브젝트 스토리지, Flyway 마이그레이션
클라이언트구매자용 메신저 플랫폼 미니프로그램. Vue 3 운영 콘솔
ERP 어댑터주문을 ‘전기됨’까지 진행시키고 청구서를 만드는 인메모리 모의 구현과 HTTP 구현 사이를 전환 가능
일정카탈로그 가져오기 30분마다. 재고 가져오기 1분마다. 주문·고객 재시도 전송 1분마다. 전표 상태 조회 5분마다
운영동기화 상태와 로그를 보여 주는 콘솔 연동 페이지. 동기화, 전송, 조회를 수동으로도 실행 가능

핵심 결정

  1. 가져오기와 조회만, 데이터베이스 공유는 없음. 플랫폼은 공개된 인터페이스로만 ERP에 접근하므로 한쪽 스키마가 바뀌어도 다른 쪽이 깨지지 않습니다.
  2. 모의 구현 우선 어댑터. 결제, 물류, 알림, ERP마다 모의 구현이 있어서, 청구서 발행까지 포함한 주문 수명 주기 전체를 파트너 자격 증명 없이 로컬에서 돌릴 수 있습니다.
  3. 시크릿은 저장소 밖에. CI는 백엔드 검증, 콘솔 린트, 타입 검사, 테스트, 빌드와 시크릿 스캔을 실행하며, 커밋하는 것은 예제 환경 파일뿐입니다.

근거

  • 백엔드 테스트 클래스 45개와 마이그레이션 파일 56개.
  • 운영 배포 문서는 릴리스, 롤백, 시크릿 교체, 백업과 복원을 다룹니다.

한계

주문량, 구매자 수, 운영 개시일, 거래 조건은 공개하지 않습니다.

자주 묻는 질문

재고는 어떻게 ERP와 동기화되나요?

상품은 30분마다, 재고는 1분마다 가져옵니다. 주문과 고객은 재시도와 함께 보냅니다. 전표 상태는 5분마다 조회합니다.

실제 ERP에 접근하지 않고도 개발할 수 있나요?

모의 ERP 어댑터가 청구서 발행을 포함한 전표 수명 주기를 흉내 냅니다.

ERP 전송이 실패하면 어떻게 되나요?

레코드는 대기열에 남아 1분마다 도는 다음 실행에서 다시 시도됩니다. 운영자는 콘솔에서 동기화 로그를 보고 재시도를 직접 실행할 수 있습니다.