개발 개요/01 — 07/2026-09-02

고객이 PDF를 올리면, 건별로 쪼개 저장하고, 읽고, 검산하고, 엑셀에 시트가 늘어난다

고객사(KPF)가 팩스 스캔 PDF(커머셜 인보이스 + 인보이스 상세 + 패킹리스트 + 패킹리스트 상세, 여러 건이 한 덩어리)를 올리면, 건별 PDF로 쪼개 저장하고, OCR로 읽어 칸을 뽑고, 스스로 검산한 뒤, 자신 없는 칸만 사람이 확인하고, 고객사 엑셀 파일 하나에 시트 한 장을 추가한다.

KPF 통관서류 포털 · kpf.dreamcustomsservice.com · 상태: 설계 확정 중 (구현 전) · 2026-09-02


올린다 → 나눈다 → 쪼갠다 → 읽는다 → 검산한다 → 쌓는다

고객이 PDF를 올리면, 건별로 쪼개 저장하고, 읽고, 검산하고, 자신 없는 값만 사람이 보고, 엑셀에 시트가 늘어난다 KPF 통관서류 포털 · 전체 그림 v0.2 · 파랑 = 시스템이 하는 일 · 금색 = 사람이 확인 · 빨강 = 위험 · 회색 점선 = 바깥 ① 올린다 고객이 PDF를 올린다 kpf.dreamcustomsservice.com · 여러 건이 한 덩어리로 와도 된다 ② 나눈다 페이지를 종류별로 나눈다 ‘COMMERCIAL INVOICE’ 큰 제목 = 새 건 시작 · 인보이스·상세·패킹·패킹상세 ③ 쪼개 저장 건별 PDF로 쪼개서 이름 붙여 창고에 넣는다 KPF_인보이스번호_수입자_#건번호.pdf · 원본 덩어리도 보관 · 몇 쪽에서 왔는지 장부에 ④ 읽는다 건마다 글자를 읽고 칸을 뽑는다 스캔본이라 OCR + AI 비전 · 부품번호·사이즈·수량·단가·금액·무게·포장수 ⑤ 검산한다 맞는지 스스로 검산한다 수량×단가=금액? 합계? 인보이스와 패킹 수량 같나? 부품번호가 기준표에 있나? 다 맞으면 바로 자신 없는 칸만 사람이 그 칸만 확인 원본 그림 옆에 값 보여 주고 고친다 고친 값 ⑥ 쌓는다 엑셀 파일 하나에 시트 한 장 추가 고객사 엑셀 1개 · 올릴 때마다 시트가 늘어난다 · 열 17개는 ‘데이터 정의’ 그림대로 내려받기 고객이 받아 간다 같은 페이지에서 기록 페이지 (사이트 안) · 데이터 정의 · 데이터 흐름 · 시스템 구조도 · OCR 리서치 · 개발 이력 → 사람이든 AI든 잊어도 여기 보고 이어간다 범례: 실선 = 확정 · 점선 = 미확정 · 화살표 = 파일·데이터가 흐르는 방향 · 상자 안은 ‘구조도’·‘데이터 정의’ 그림에서 확대 버전 v0.2 · 2026-09-02 · 확인 상태: 미확인 · 가장 큰 위험 = ④ 읽기가 100%가 아니다 → ⑤ 검산 + 사람 확인으로 막는다
전체 그림 v0.2 — 여섯 단계. 상자 안은 ‘데이터 흐름’, ‘시스템 구조도’, ‘데이터 정의’ 페이지에서 확대한다.

이 사이트는 두 페이지다. (1) 작업대 — 고객(KPF)이 인보이스·패킹리스트 PDF를 올리고 엑셀을 받아 가는 곳. (2) 개발 — 이 시스템을 만드는 기록(개요·흐름·구조·정의·리서치·질의응답·이력·규칙). 사람이든 AI든 맥락을 잊어도 여기 보고 이어간다.

지시자의 요구 (2026-09-02, 원문 요지)

번호요구
R-01kpf.dreamcustomsservice.com 에 페이지를 만들어 고객사 하나(KPF)를 관리한다
R-02PDF(인보이스 1장 + 패킹리스트 1장이 기본, 10장이면 2장씩 5벌이거나 한 장이 아닐 수도)를 등록하면 OCR로 읽어 정보를 뽑는다
R-03뽑은 정보를 정해진 칼럼 배치의 엑셀로 만든다. 엑셀 파일은 1개이고 시트를 계속 추가한다
R-04앞으로는 고객이 직접 PDF를 올리면 시트가 자동으로 추가된다
R-05OCR이 100%가 아닌 것이 가장 큰 위험. 해결법을 리서치해 서브 페이지로 정리한다
R-06데이터 정의, 데이터 흐름, 시스템 구조도, 개발 이력 페이지를 두어 맥락이 끊겨도 유지 가능하게 한다
R-07덩어리 PDF는 먼저 건별 PDF 1개 단위로 쪼개 저장한다. 파일명 규칙은 추후 통보, 그전까지는 임시 규칙
R-08모델 배정: 설계·구상·지시 = Fable 5.1, 복잡한 구현 = Opus, 단순 코딩 = Sonnet (토큰 절약)

페이지 안내

미확정인 것은 질의응답에서

정해지지 않은 것(포장수량 단위, 파일명 규칙, 일부 규격의 HS 값, 공유폴더 경로, 텔레그램, 패스코드)은 전부 질의응답에 질문으로 올라가 있다. AI가 묻고 사람이 답하면, 답은 주기적으로 읽혀 판독기·분류기·엑셀 입력기에 반영되고 "반영됨"으로 바뀐다.