← 포트폴리오 목록
컨테이너 보관 통합 운영 ERP
컨테이너 보관 사업의 고객·계약·컨테이너 정보를 하나의 마스터-디테일 화면에서 관리하고, 은행 거래내역 업로드만으로 입금을 자동 대조하는 통합 ERP를 구현합니다.
입금 자동 매칭 알고리즘 설계계약자명 유사도와 예상 입금액 스코어링으로 자동 매칭 로직 구현, 미매칭 건 학습 테이블 설계
창고×고객유형 안내문 템플릿 엔진 구축9종 양식 조합을 계약 데이터로 자동 채우는 템플릿 엔진 구현, 다채널 발송 폴백 구조 설계
마스터-디테일 데이터 조인 구조 설계고객-계약-컨테이너 3단 관계를 단일 쿼리로 조회하는 Prisma include 구조 설계
Overview
프로젝트 개요
컨테이너 보관 사업의 고객·계약·컨테이너 정보를 하나의 마스터-디테일 화면에서 관리하고, 은행 거래내역 업로드만으로 입금을 자동 대조하는 통합 ERP를 구현합니다. 창고별·법인/개인/법원 양식에 맞는 계약 안내문을 자동 생성하고 카카오 알림톡으로 발송하는 흐름까지 하나의 워크플로우로 설계합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
동명이인·유사 입금자명이 반복되는 다수 계약 환경에서 자동 매칭 정확도를 유지하는 스코어링 기준 설계가 필요합니다
분할 입금이 여러 건에 걸쳐 발생할 때 합산 판정과 계약 만료일 자동 연장 로직의 동시성 처리가 필요합니다
창고·고객유형 조합별 안내문 양식이 늘어날 경우에도 템플릿 유지보수 부담을 낮추는 구조 설계가 필요합니다
카카오 알림톡 발송 실패를 즉시 감지해 문자로 폴백하는 재시도 타이밍 설계가 필요합니다
구현 내용
핵심 기능 상세
핵심 기능 1
고객·계약 마스터-디테일 관리
개인·법인 고객 정보와 계약 조건을 좌측 리스트-우측 상세 패널 구조로 한 화면에서 조회·수정할 수 있습니다
핵심 기능 2
입금 자동 대조 및 동명이인 판정
은행 거래내역 엑셀을 업로드하면 계약자명·금액 기준으로 입금 건을 자동 매칭하고, 동명이인 발생 시 후보를 제시해 담당자가 확정할 수 있습니다
핵심 기능 3
연체 판정 및 정산 관리
계약별 입금 이력을 기준으로 연체를 자동 판정하고 연체료·초과 정산 금액을 계산해 청구 조정 사유와 함께 기록할 수 있습니다
핵심 기능 4
계약 안내문 자동 생성 및 알림톡 발송
창고별·개인/법인/법원 양식에 맞는 계약 안내문을 계약 정보로 자동 채워 생성하고, 카카오 알림톡으로 발송할 수 있습니다
구현 과정
프로젝트 진행 단계
STEP 1
업무 프로세스 분석 및 ERD 설계
고객·계약·컨테이너·입출고 프로세스 분석, PostgreSQL 테이블 20여개 정의 및 관계 매핑
STEP 2
입금 대조·정산 엔진 개발
엑셀 파싱·자동 매칭·연체 판정 로직을 Express API 25개 엔드포인트로 구현
STEP 3
마스터-디테일 UI 및 안내문 발송 구현
React 마스터-디테일 화면과 계약 안내문 템플릿·카카오 알림톡 연동 UI 구현
STEP 4
통합 테스트 및 데이터 이관 검증
기존 엑셀 장부 1,500명 데이터 이관 스크립트 검증, API-프론트엔드 통합 테스트
프로젝트 성과
주요 성과
입금 자동 매칭 알고리즘 설계계약자명 유사도와 예상 입금액 스코어링으로 자동 매칭 로직 구현, 미매칭 건 학습 테이블 설계
창고×고객유형 안내문 템플릿 엔진 구축9종 양식 조합을 계약 데이터로 자동 채우는 템플릿 엔진 구현, 다채널 발송 폴백 구조 설계
마스터-디테일 데이터 조인 구조 설계고객-계약-컨테이너 3단 관계를 단일 쿼리로 조회하는 Prisma include 구조 설계
연체 정산 규칙 엔진 설계창고별 요율 변경에 대응하는 규칙 기반 정산 계산 로직과 조정 이력 테이블 구조 구축
Highlights
기술적 주안점
- 마스터-디테일 패턴으로 리스트 탐색과 상세 확인을 한 화면에서 처리하는 구조를 구현하여 페이지 전환 없이 고객·계약·컨테이너 정보를 연결해 조회할 수 있도록 설계합니다
- 엑셀 업로드 한 번으로 대량 입금 건을 자동 매칭하고, 동명이인·미매칭 건만 담당자가 확인하도록 예외 처리 중심 워크플로우를 설계합니다
- 연체 판정부터 정산 계산, 수동 조정 이력까지 하나의 파이프라인으로 연결해 청구 근거를 추적할 수 있는 구조를 구현합니다
