프로젝트 소개

하루 300건 주문 + 500~600건 송장의 수기 처리를 자동화하여 업무 시간을 단축하고 오류를 방지하는 통합 업무 자동화 프로그램

프로젝트 개요

핵심 요구사항 분석

• OMS 엑셀 변환 — 지정 폴더 내 다수 OMS 엑셀 파일을 일괄 읽기하고, 헤더 분석으로 체인별 양식을 자동 식별하여 이카운트 ERP 양식으로 변환
• 매핑 테이블 관리 — OMS 거래처명↔이카운트 거래처 코드, OMS 품목명↔이카운트 품목 코드 매핑 UI 제공. 미매핑 데이터 보류 및 경고, 오류 목록 엑셀 다운로드
• 송장 자동화 — 이카운트 출고 완료 데이터를 수집하여 로젠택배 송장 발행 요청, 발행된 송장번호 저장 및 이카운트 역전송, 프린터 연동 출력
• 박스 분할 알고리즘 — 품목별 1박스당 최대 포장 수량 기준으로 필요 박스 수 자동 계산, 동일 수령인 분할 송장 자동 생성
• 비기능 — 8,000 거래처 + 2,500 품목 지연 없는 검색/매핑, 추후 택배사·OMS 양식 확장 용이한 구조

제안 포인트

웹 기반 관리 페이지 추천

PC 설치형 대비 웹 기반의 장점:

• 설치/업데이트 불필요 — 브라우저에서 바로 접속
• 다수 담당자 동시 사용 가능
• 원격 접속 지원 (재택근무 등)
• 소스코드 수정 후 즉시 반영 (빌드/배포 불필요한 핫리로드)

프린터 연동은 브라우저 인쇄 API + 로젠택배 전용 프린터 드라이버로 해결합니다.

핵심 기술 선택 근거

• Python FastAPI — pandas/openpyxl로 엑셀 파싱 최적, 빠른 API 개발, 소스코드 가독성 높아 내부 수정 용이
• React + Ant Design — 데이터 그리드(Table) 컴포넌트 특화, 대량 데이터 표시에 최적화된 가상 스크롤 내장
• MySQL 8.0 — 8,000 거래처 + 2,500 품목 고속 검색, 인덱스 최적화, 확장성 확보

유사 프로젝트 경험 기반 효율적 개발

15개 이상 외부 API 연동 경험(NICE KYC, Seyfert/PayGate 결제 등)과 80+ 엔티티 규모 대량 데이터 처리, 배치 자동화(크론잡) 경험을 바탕으로 효율적으로 진행합니다.

사용 기술 및 툴

개발 기술

협업 및 커뮤니케이션

견적서

본 견적서는 프로젝트 요구사항 분석을 기반으로 산출되었습니다.

견적 요약

상세 견적 내역

산정 근거

• 유사 프로젝트(P2P 펀딩, EZ-Approve, Series-B) 수행 경험 기반 공수 산정
• 외부 API 2종(이카운트 ERP, 로젠택배) 연동 복잡도 반영
• 다양한 OMS 엑셀 양식 자동 식별 로직 개발 공수 포함
• 박스 분할 알고리즘 설계·구현 공수 포함
• 소스코드 주석 처리 및 매뉴얼 작성 공수 포함

포함 사항

• 소스 코드 원본 전체 이관 (주석 포함)
• 개발 문서 (API 명세서, DB 스키마, 배포 가이드)
• 관리자 사용 매뉴얼 (매핑 방법 및 오류 해결 가이드)
• 1개월 무상 하자 보수
• 배포 환경 세팅 (1회)

불포함 사항

• 서버 호스팅 비용
• 이카운트 ERP API 사용료 (클라이언트 부담)
• 로젠택배 API 연동 비용 (클라이언트 부담)
• 하자 보수 기간 이후 유지보수
• 추가 택배사 연동 (확장 시 별도 견적)

공수계산서

기능별 개발 공수(Man-Day)를 산출하여 일정과 비용의 근거를 제시합니다.

공수 요약

기능별 상세 공수

산정 기준

• 1 M/D = 8시간 기준 (1인 1일 작업량)
• 주 5일 근무 기준
• 버퍼 10~15% 포함
• 유사 프로젝트 수행 경험 기반 효율적 개발

PRD (Product Requirements Document)

프로젝트 요구사항을 정의하고 기능 범위를 명확히 합니다.

1. 프로젝트 배경 및 목적

안경 체인 OMS 프로그램에서 하루 약 300건의 주문을 엑셀로 다운로드하여 이카운트 ERP에 수기로 업로드하고 있으며, 출고 처리 후 하루 500~600건의 로젠택배 송장 역시 수기 또는 엑셀로 처리하고 있습니다.

이러한 반복적인 수작업을 자동화하여 업무 시간 단축과 오류 방지를 달성하는 것이 핵심 목표입니다. 특히 거래처/품목 매핑 관리 기능과 출고 수량에 따른 택배 박스 분할 송장 발행 로직이 필수적으로 구현되어야 합니다.

운영 방식: 실시간 자동화가 아닌, 사용자가 하루 2회 정도 수동으로 실행하는 배치(Batch) 형태

2. 사용자 정의

3. 기능 요구사항

3.1 OMS 주문 엑셀 변환 및 이카운트 연동

• [필수] 지정 폴더 내 다수의 OMS 엑셀 파일 일괄 읽기 및 병합
• [필수] 업로드된 엑셀의 헤더를 분석하여 체인별 양식 자동 식별 및 표준화
• [필수] 변환된 데이터를 이카운트 주문 업로드용 엑셀 양식으로 다운로드
• [선택] 이카운트 API로 직접 전송 (API 테스트 베드 환경에서 사전 검증)

3.2 매핑 테이블 및 오류 관리

• [필수] OMS 거래처명 ↔ 이카운트 거래처 코드 매핑 UI
• [필수] OMS 품목명 ↔ 이카운트 품목 코드 매핑 UI
• [필수] 매핑 테이블에 없는 데이터 발생 시 변환 보류 및 경고 알림
• [필수] 매핑 실패 건 엑셀 다운로드
• [필수] 오류 목록에서 코드 지정 시 매핑 테이블 자동 업데이트

3.3 이카운트 출고 기반 로젠택배 송장 자동화

• [필수] 이카운트 API로 특정 일자/조건의 출고 완료 데이터 자동 수집
• [필수] 수집된 출고 데이터로 로젠택배 송장 발행 요청
• [필수] 발행된 송장번호 저장 및 이카운트 ERP 역전송
• [필수] 로젠택배 전용 프린터 연동 출력
• [필수] 일자별 송장 발행 내역, 성공/실패 여부 조회 및 재발행

3.4 포장 박스 분할 알고리즘

• [필수] 품목 마스터에 품목별 1박스당 최대 포장 수량 기준값 설정
• [필수] 출고 수량을 포장 단위로 나누어 필요 박스 수 자동 계산
• [필수] 산출된 박스 수량만큼 동일 수령인 정보로 분할 송장 자동 생성
• [필수] 동일 수령인 다품목 출고 시 수량 합산하여 박스 수 계산

4. 비기능 요구사항

5. 기술 제약사항

• 배치 처리 방식 (하루 2회 수동 실행) — 실시간 자동화 아님
• Windows OS 기반 PC 환경에서 동작
• 이카운트 ERP API 및 로젠택배 Open API 연동 필수
• 개발 완료 후 소스코드 전체 이관 및 자체 수정 권한 제공
• 소스코드 내 한국어 주석 필수

6. 범위 외 사항 (Out of Scope)

• 실시간 자동 동기화 (배치 방식으로 충분)
• 모바일 앱 개발
• 기존 OMS 시스템 수정 또는 커스터마이징
• 회계/재무 모듈 개발
• 로젠택배 외 타 택배사 연동 (확장 시 별도 견적)

일정 제안

총 60일 기준 단계별 마일스톤 및 산출물을 제안합니다. 클라이언트 요청 마일스톤(3주차/6주차)에 맞춰 구성하였습니다.

전체 일정 요약

마일스톤 체크포인트

커뮤니케이션 계획

유사 프로젝트 경험

본 프로젝트와 유사한 기능/기술 스택을 활용한 수행 경험을 소개합니다.