← 포트폴리오 목록
지오매치 배정 관제 콘솔
기업과 전문가를 거리 기반으로 자동 배정하는 B2B 매칭·배정 플랫폼의 핵심 엔진을 구현한 프로젝트입니다.
거리 기반 근접 묶음 알고리즘 설계Haversine 거리 계산과 스코어링 함수로 반경 내 기업 2~3곳을 자동 클러스터링하는 배정 후보 산출 로직을 구현합니다.
동시 배정 요청 트랜잭션 제어 구현PostgreSQL 행 단위 잠금과 격리 수준 설계로 동시 신청 처리 시 배정 중복을 데이터베이스 레벨에서 차단합니다.
주소 정제-지오코딩 캐시 파이프라인 구축정규식 기반 주소 정제 규칙과 좌표 캐시 테이블을 설계하여 지오코딩 API 재호출 없이 재사용 가능한 구조를 구현합니다.
Overview
프로젝트 개요
기업과 전문가를 거리 기반으로 자동 배정하는 B2B 매칭·배정 플랫폼의 핵심 엔진을 구현한 프로젝트입니다. 주소 지오코딩, 근접 묶음, 권역별 균등 배분 알고리즘을 실시간 배정 관제 지도로 시각화하며, 동시성 제어로 배정 중복을 방지하는 구조를 React + Node.js 기반으로 설계·구현합니다.
요구사항 정의
프로젝트 핵심 과제
프로젝트 진행 시 해결한 핵심 기술 과제입니다.
근접 묶음 반경과 균등 배분 판정 주기 등 핵심 설계 파라미터는 착수 단계 협의로 확정되므로
설정값으로 분리해 유연하게 조정 가능한 구조 설계가 필요합니다
동시에 접수되는 다건의 신청을 처리할 때 배정 중복과 균등 배분 어긋남을 데이터베이스 수준에서 차단하는 동시성 제어 설계가 필요합니다
도로명·지번 혼재
구주소, 표기 오류 등 실제 주소 데이터의 정제 규칙과 지오코딩 실패 건 보정 경로 설계가 필요합니다
기존 시스템 연동
Oracle 기반 테이블 구조를 최대한 유지하면서도 신규 좌표·묶음 정보 테이블을 안전하게 매핑하는 스키마 설계가 필요합니다
핵심 기능 1
거리 기반 배정 관제 지도
기업과 전문가의 좌표를 지도 위에 표시하고, 근접 묶음과 배정 상태를 색상 마커로 구분하여 한눈에 확인할 수 있는 관제 화면을 제공합니다
핵심 기능 2
주소 정제 & 지오코딩 파이프라인
도로명·지번이 혼재된 실제 주소 데이터를 정제하고 외부 지오코딩 API로 좌표를 변환하여 재사용 가능한 형태로 저장합니다
핵심 기능 3
근접 묶음 & 균등 배분 엔진
좌표 기준으로 가까운 기업 2~3곳을 하나의 배정 단위로 묶고, 같은 권역 전문가들 사이에서 배정 건수가 고르게 분산되도록 배분합니다
핵심 기능 4
동시성 제어 & 배정 상태 전환
신청 접수부터 배정 대상 선별, 묶음, 전문가 지정, 배정 확정, 진행 중까지 상태 전환 이력을 기록하고 동시 신청 처리 시 배정 중복을 방지합니다
구현 과정
프로젝트 진행 단계
STEP 1
주소 데이터 정제 및 지오코딩 파이프라인 구축
도로명·지번 혼재 주소 정제 규칙 설계, 외부 지오코딩 API 연동 및 좌표 캐싱 테이블 설계
STEP 2
거리 기반 배정 엔진 및 균등 배분 알고리즘 개발
Haversine 거리 계산 기반 근접 묶음 로직과 권역 단위 균등 배분 스코어링 알고리즘 구현
STEP 3
배정 관제 지도 UI 개발
React 기반 맵 캔버스, 플로팅 상세 카드, 배정 상태 범례 등 화면 요소 구현
STEP 4
동시성 제어 및 데이터 정합성 테스트
PostgreSQL 트랜잭션 격리 수준 설계, 동시 배정 요청 충돌 테스트 및 데이터 정합성 검증
프로젝트 성과
거리 기반 근접 묶음 알고리즘 설계Haversine 거리 계산과 스코어링 함수로 반경 내 기업 2~3곳을 자동 클러스터링하는 배정 후보 산출 로직을 구현합니다.
동시 배정 요청 트랜잭션 제어 구현PostgreSQL 행 단위 잠금과 격리 수준 설계로 동시 신청 처리 시 배정 중복을 데이터베이스 레벨에서 차단합니다.
주소 정제-지오코딩 캐시 파이프라인 구축정규식 기반 주소 정제 규칙과 좌표 캐시 테이블을 설계하여 지오코딩 API 재호출 없이 재사용 가능한 구조를 구현합니다.
권역별 균등 배분 스코어링 함수 설계진행 중 배정 건수와 거리 조건을 함께 반영하는 스코어링 함수를 구현하여 전문가 간 배정 편차를 최소화하는 구조를 설계합니다.
Review
기술적 주안점
- 풀블리드 SVG 맵 캔버스 위에 플로팅 drawer·상세 카드·범례를 겹쳐 배정 흐름 전체를 하나의 화면에서 파악할 수 있는 관제 인터페이스를 구현합니다
- 주소 정제부터 좌표 캐싱까지 이어지는 파이프라인을 구현하여 지오코딩 API 호출을 최소화하고 변환 실패 건을 추적 가능하게 설계합니다
- 거리와 균등 배분 두 조건을 동시에 만족하는 배정 후보를 산출하는 알고리즘을 설계하고, 배정 기준 파라미터를 재조정 가능한 구조로 구현합니다
