SYSTEM BLUEPRINT

영림원 ERP 연동 스케줄러
운영 관제 화면 설계

ERP 관리자, 운영 관리자, 의사결정자별 여정과 핵심 화면을 정리한 사전 기획서입니다.

ERP 및 DB 관리자 시나리오

ERP 데이터 매핑 여정

14개 메뉴의 쿼리와 외부 API 필드 매핑을 확정하는 흐름입니다.

1. 메뉴 목록 확인

14개 ERP 메뉴와 조회 조건 정리

2. 쿼리 검증

프로시저와 변경분 조회 기준 확인

3. 필드 매핑

API 페이로드 필드와 검증 규칙 연결

4. 샘플 전송

테스트 API로 응답 코드 확인

5. 확정

매핑표와 실행 조건 승인

ERP 및 DB 관리자 | 화면 01

연동 항목 대시보드

admin.erp-sync.local/items
연동 항목 현황
영림원 ERP 14개 메뉴 자동 전송 관제
오늘 성공 12 / 실패 2
품목 마스터
정상 전송
09:00 완료
거래처
정상 전송
09:02 완료
수주 자료
실패
API 401 인증 만료
재고 현황
재시도 대기
10분 뒤 자동 재시도
최근 전송 로그수동 재전송 가능
항목상태시각조치
수주 자료실패09:15토큰 갱신 후 즉시 재전송
재고 현황대기09:20청크 8번부터 이어서 처리

[화면 개요 및 목적]

ERP 관리자가 14개 메뉴의 전송 상태와 실패 항목을 한눈에 확인하는 화면입니다.

[핵심 기능 로직]

항목별 상태, 마지막 실행 시각, 실패 사유를 분리해 일부 실패가 전체 작업을 가리지 않게 합니다.

  • FastAPI Log API
  • MS-SQL Status Table
ERP 및 DB 관리자 | 화면 02

쿼리 및 필드 매핑 상세

admin.erp-sync.local/mapping/item-master
품목 마스터 매핑
EXEC usp_IF_ItemMaster @from='2026-08-26 00:00:00'
ERP 컬럼API 필드검증
ITEM_CDitemCode필수
ITEM_NMitemName필수
UPD_DTupdatedAt날짜 형식
전송 전 검증
조회 건수 2,430건
청크 크기 500건
필수값 누락 0건
예상 전송 시간 3분 20초

[화면 개요 및 목적]

영림원 ERP 컬럼과 외부 API 필드를 연결하고 전송 전 검증 결과를 확인합니다.

[핵심 기능 로직]

필수값, 날짜 형식, 코드 매핑 누락을 전송 전에 잡아 API 실패를 줄입니다.

  • pyodbc Query Runner
  • Payload Validator
ERP 및 DB 관리자 | 화면 03

샘플 전송 검증

품목 마스터 매핑
EXEC usp_IF_ItemMaster @from='2026-08-26 00:00:00'
ERP 컬럼API 필드검증
ITEM_CDitemCode필수
ITEM_NMitemName필수
UPD_DTupdatedAt날짜 형식
전송 전 검증
조회 건수 2,430건
청크 크기 500건
필수값 누락 0건
예상 전송 시간 3분 20초

[화면 개요 및 목적]

선택한 메뉴의 샘플 데이터를 외부 API로 전송하고 응답을 저장합니다.

[핵심 기능 로직]

응답 코드와 메시지를 원본 데이터와 함께 저장해 오류 원인을 바로 추적합니다.

  • HTTPX API Client
  • Response Logger
운영 관리자 시나리오

스케줄 운영 여정

항목별 실행 주기와 실패 재처리를 관리하는 운영 흐름입니다.

1. 주기 설정

메뉴별 실행 시간과 청크 크기 설정

2. 자동 실행

중복 실행 방지와 재시도 처리

3. 로그 확인

성공, 실패, 재시도 이력 조회

4. 수동 재전송

실패 건을 즉시 다시 전송

5. 운영 완료

일별 처리 현황 저장

운영 관리자 | 화면 01

스케줄 설정 화면

admin.erp-sync.local/schedules
항목별 스케줄 설정
품목 마스터

매일 09:00

중복 실행 잠금 켜짐
거래처

매일 09:05

실패 시 3회 재시도
수주 자료

30분마다

변경분만 조회
재고 현황

10분마다

청크 500건
중복 실행 방지 로그

현재 수주 자료 작업 실행 중입니다. 다음 스케줄은 이전 작업 종료 후 시작됩니다.

[화면 개요 및 목적]

14개 항목의 실행 주기, 변경분 기준, 재시도 횟수를 관리합니다.

[핵심 기능 로직]

설정 변경은 다음 실행부터 반영하고, 실행 중인 작업은 잠금 상태로 보호합니다.

  • APScheduler
  • Config Store
운영 관리자 | 화면 02

전송 로그 조회

admin.erp-sync.local/logs
연동 항목 현황
영림원 ERP 14개 메뉴 자동 전송 관제
오늘 성공 12 / 실패 2
품목 마스터
정상 전송
09:00 완료
거래처
정상 전송
09:02 완료
수주 자료
실패
API 401 인증 만료
재고 현황
재시도 대기
10분 뒤 자동 재시도
최근 전송 로그수동 재전송 가능
항목상태시각조치
수주 자료실패09:15토큰 갱신 후 즉시 재전송
재고 현황대기09:20청크 8번부터 이어서 처리

[화면 개요 및 목적]

날짜, 항목, 상태별로 전송 결과를 조회하고 실패 원인을 확인합니다.

[핵심 기능 로직]

응답 코드와 실패 메시지를 저장해 조치 가능한 문구로 보여줍니다.

  • Log Search API
  • Indexed Status Table
운영 관리자 | 화면 03

실패 건 재전송

admin.erp-sync.local/retry
연동 항목 현황
영림원 ERP 14개 메뉴 자동 전송 관제
오늘 성공 12 / 실패 2
품목 마스터
정상 전송
09:00 완료
거래처
정상 전송
09:02 완료
수주 자료
실패
API 401 인증 만료
재고 현황
재시도 대기
10분 뒤 자동 재시도
최근 전송 로그수동 재전송 가능
항목상태시각조치
수주 자료실패09:15토큰 갱신 후 즉시 재전송
재고 현황대기09:20청크 8번부터 이어서 처리

[화면 개요 및 목적]

실패한 항목을 선택해 토큰 갱신 또는 데이터 보정 후 즉시 재전송합니다.

[핵심 기능 로직]

재전송 결과도 별도 이력으로 남겨 자동 실행 결과와 구분합니다.

  • Data Aggregation & Visualization
  • Audit Log
의사결정자 시나리오

운영 성과 확인 여정

자동화 효과와 장애 추이를 확인하는 관리 흐름입니다.

1. 전체 현황

일별 전송 성공률 확인

2. 실패 추이

항목별 반복 실패 원인 확인

3. 처리 시간

수동 업무 절감 효과 확인

4. 장애 이력

API와 DB 오류 이력 추적

5. 보고

운영 리포트 다운로드

의사결정자 | 화면 01

운영 현황 대시보드

admin.erp-sync.local/overview
연동 항목 현황
영림원 ERP 14개 메뉴 자동 전송 관제
오늘 성공 12 / 실패 2
품목 마스터
정상 전송
09:00 완료
거래처
정상 전송
09:02 완료
수주 자료
실패
API 401 인증 만료
재고 현황
재시도 대기
10분 뒤 자동 재시도
최근 전송 로그수동 재전송 가능
항목상태시각조치
수주 자료실패09:15토큰 갱신 후 즉시 재전송
재고 현황대기09:20청크 8번부터 이어서 처리

[화면 개요 및 목적]

일별 성공률, 실패율, 재처리 건수, 평균 전송 시간을 확인합니다.

[핵심 기능 로직]

항목별 데이터를 집계해 운영 병목과 반복 실패 항목을 빠르게 찾습니다.

  • Aggregation Query
  • Daily Report
의사결정자 | 화면 02

장애 이력 상세

admin.erp-sync.local/incidents
연동 항목 현황
영림원 ERP 14개 메뉴 자동 전송 관제
오늘 성공 12 / 실패 2
품목 마스터
정상 전송
09:00 완료
거래처
정상 전송
09:02 완료
수주 자료
실패
API 401 인증 만료
재고 현황
재시도 대기
10분 뒤 자동 재시도
최근 전송 로그수동 재전송 가능
항목상태시각조치
수주 자료실패09:15토큰 갱신 후 즉시 재전송
재고 현황대기09:20청크 8번부터 이어서 처리

[화면 개요 및 목적]

인증 만료, 네트워크 오류, 필수값 누락 등 장애 원인을 유형별로 확인합니다.

[핵심 기능 로직]

오류 유형과 조치 이력을 함께 저장해 같은 문제가 반복될 때 빠르게 대응합니다.

  • Error Taxonomy
  • Action History
의사결정자 | 화면 03

운영 리포트

admin.erp-sync.local/report
연동 항목 현황
영림원 ERP 14개 메뉴 자동 전송 관제
오늘 성공 12 / 실패 2
품목 마스터
정상 전송
09:00 완료
거래처
정상 전송
09:02 완료
수주 자료
실패
API 401 인증 만료
재고 현황
재시도 대기
10분 뒤 자동 재시도
최근 전송 로그수동 재전송 가능
항목상태시각조치
수주 자료실패09:15토큰 갱신 후 즉시 재전송
재고 현황대기09:20청크 8번부터 이어서 처리

[화면 개요 및 목적]

주간 또는 월간 처리 현황을 내려받아 내부 보고에 활용합니다.

[핵심 기능 로직]

전송 건수, 실패 건수, 재처리 성공률을 자동 집계합니다.

  • CSV Export
  • Issue Tracking & Status Management