플러스프로젝트 배경
1) 예상 리스크 및 대응 계획 - 6개 보험사가 제공하는 계약 내역 엑셀의 컬럼명·인코딩·날짜 포맷이 모두 달라 공통 파서로 처리 불가 — 보험사별 컬럼 매핑 규칙을 JSON 설정으로 외부화하고 PapaParse+xlsx.js 통합 인터페이스로 CSV/엑셀 공통 처리 구조 설계 - 설계사→팀장→지점장 수수료가 계층적으로 의존하여 특정 레벨 수수료 변경 시 하위 전체를 재계산해야 하는 복잡한 의존성 문제
프로젝트 성과
3단계 수수료 트리 구조 재귀 계산 엔진 설계
설계사→팀장→지점장 오버라이딩 수수료 체계를 트리 구조로 모델링하고 Python 재귀 함수로 구현, FastAPI asyncio 병렬 배치로 850명 설계사 월 수수료 일괄 계산 처리 구조 설계
PostgreSQL 트리거 기반 결재 상태 전이 제약 구현
결재 상태 전이 5단계를 PostgreSQL ENUM과 트리거로 서버 사이드에서 강제, 잘못된 상태 전이 시도를 DB 레벨에서 차단하고 감사 로그를 불변 테이블에 자동 기록하는 금융 감사 대응 구조 구현
보험사별 JSON 매핑 규칙 기반 확장형 파서 구조 구현
6개 보험사 계약 엑셀 컬럼 패턴을 JSON 설정으로 외부화하여 신규 보험사 추가 시 코드 수정 없이 설정 파일 등록만으로 즉시 파싱 지원 가능한 확장 구조
수수료 편차 이상 감지 자동 플래그 로직 구현
이전 달 동일 설계사 수수료 대비 30% 이상 편차 건을 FastAPI 서버에서 자동 감지하여 결재 목록에 경고 플래그와 편차 비율 표시, 이상 건 우선 노출 정렬 로직으로 결재자 검토 효율성을 높이는 구조 설계
수수료 규칙 변경 영향 시뮬레이션 기능 구현
수수료 지급률 편집 시 기존 설계사 전체의 예상 변동액을 클라이언트에서 즉시 계산하여 인라인 표시, 확정 전 취소 가능한 변경 큐 구조와 수수료 규칙 버전 이력 관리로 과거 정산 재현 가능한 설계 구현
핵심 기능
수수료 정산 현황 대시보드
이번 달 지급 예정 총액, 보험사별 수수료 구성, 설계사 등급별 지급 현황, 미처리 승인 건수를 종합한 경영진·관리자용 메인 화면
진행 단계
보험사별 계약 엑셀 포맷 분석 및 수수료 규칙 모델링
2026.03.
6개 보험사 계약 내역 엑셀 샘플 수집 후 컬럼 패턴 분류, 본인→팀장→지점장 3단계 수수료 트리 구조 설계
프로젝트 상세
1) 포트폴리오 소개 보험 대리점(GA) 소속 설계사 850명의 계약 체결 수수료를 엑셀 업로드 기반으로 자동 계산하고, 지급 승인 워크플로우를 거쳐 실계좌 자동 송금까지 처리하는 핀테크 정산 플랫폼을 React + Python FastAPI로 설계·구현할 예정. 보험사별로 상이한 수수료 지급 기준과 다단계 수수료 체계(본인·팀장·지점장)를 규칙 엔진으로 통합 계산하는 구조를 구축. 2) 작업 범위
