공급사 종속 입고·반품 연동을 공통 백엔드 구조로 확장한 사례

백엔드·2026-08-31 기준
항목기록
문제입고·반품·재고 업무가 특정 공급사 구현에 강하게 의존해 신규 공급사를 추가하거나 데이터 차이를 처리할 때 서비스별 수정 범위가 커질 위험이 있었다.
기존 방식과 비용특정 공급사 중심의 연동 구조는 공급사별 식별자·입고 형식·반품 흐름 차이를 공통 서비스에서 흡수하기 어려웠다. 비용·오류율의 정량 기준선은 아직 수집하지 않았다.
제안/판단공급사별 API·스크래핑 수집과 공통 도메인 모델·매핑을 분리해, 공급사 추가 시 업무 서비스의 변경을 줄이는 방향을 택했다.
기술 선택외부 API 어댑터, 입고 일련번호 매핑, 공급사별 수집 모듈, 공통 입고·반품 도메인 모델. 외부 공급사 API 와 공급사 3곳의 연동을 개별 처리 경로로 두되 핵심 업무 모델은 공유하도록 설계했다.
구현 범위외부 공급사 API 연동, 주요 공급사 계열의 입고·반품 흐름, 공급사 스크래핑과 일련번호 매핑, 공급사 공통 사용을 위한 구조 정리를 포함한다.
내 기여연동 요구를 분석하고 API 계약·매핑·입고 기반 서비스의 백엔드 구현과 운영 이슈 대응을 수행했다. 정확한 PR·커밋 단위 근거는 각 기능별로 추가 수집한다.
정량 결과공급사별 처리량·실패율·추가 비용의 검증 완료 기준선은 아직 없다. 의약품 코드 매핑 65,000행 · 일치율 96.7% · 예외 261건은 검증 대상·기간·코드 버전을 다시 확인할 때까지 검증 대기로 둔다. 커밋 수는 활동량이므로 개선 효과에서 제외한다.
연결 데이터의약품 코드 매핑 후보 (DATA-PENDING-MAPPING)
공개 주의사항공급사명은 싣지 않는다. API URL, 인증 방식, 실제 품목·거래처·약국 데이터, 스크래핑 대상 상세 경로는 제외한다.
남은 검증공급사별 처리량, 실패율, 신규 공급사 추가 시 변경 파일 수 같은 효과 지표를 추가로 측정한다. 특정 공급사 V1→V2 개선 주장은 차이를 재확인하기 전까지 사용 금지다.

검증 대기

기존 기록에서 찾았지만 같은 조건의 실행 기록을 다시 확인하지 못한 값이다. 확정 지표와 섞지 않는다.

공개 범위

이 글은 포트폴리오 정본의 공개 요약이다. 원본 업무 데이터와 회사·약국·서버·공급사 식별정보는 뺐다. 공급사명은 싣지 않는다. API URL, 인증 방식, 실제 품목·거래처·약국 데이터, 스크래핑 대상 상세 경로는 제외한다.