4. 가맹 모집 서비스 개선: 파일 유실률 100% → 0%, CS 월 3건 → 0건

배경

가맹점 접수 피크 시간대 SFTP 파일 업로드 실패로 인하여 파일 유실로 인한 CS가 월 평균 3건 발생

사용자는 성공 응답을 받았지만 실제 파일은 미전달되는 구조적 문제를 식별하여 개선 주도

문제 1: SFTP 세션 고갈로 인한 파일 업로드 실패

• 접수 1건당 SFTP 세션 1개를 생성하는 구조 및 서버 접속 계정 동시 세션이 10개로 제한
• 동시 접수 요청 10건 초과 시 세션 고갈로 파일 업로드 실패 및 파일이 유실 발생

AS-IS

TO-BE

---
config:
  theme: mc
---
sequenceDiagram
    participant U as User
    participant W as Was
    participant R as RDB
    participant F as File Server

    U->>W: 1. 가맹점 접수 신청
    W-->>R: 2. DB 저장
    W-->>U: 3. 성공 응답

    W-)F: 4. 비동기 파일 업로드 이벤트 발행
    Note over F: ❌ SFTP 세션 연결 실패<br/>1. 업로드 파일 유실<br/>2. 파일 유실로 인한 가맹점 심사 실패<br/>→ CS 증가

---
config:
  theme: mc
---
sequenceDiagram
    participant U as User
    participant W as Was
    participant R as RDB
    participant F as File Server

    U->>W: 1. 가맹점 접수 신청
    W->>R: 2. DB 저장 + Outbox 저장(PENDING)<br/>단일 트랜잭션
    W-->>U: 3. 접수 성공 응답
    W-)F: 4. 비동기 파일 업로드 (로컬 임시저장 후 전송)

    alt ✅ 업로드 성공
        F-->>W: 완료
        W->>R: Outbox status = COMPLETED
    else ❌ 업로드 실패 (5회 지수 백오프)
        W->>R: Outbox status = FAILED
        Note over W,R: 30분 배치: PENDING/FAILED 자동 재처리<br/>최종 실패 시 운영팀 알림
    end

해결 1: SFTP 세션 풀링 도입

• Apache Commons Pool2 기반 SFTP 세션 풀(5개)을 구성, 사전 생성 후 재사용으로 세션 고갈 원천 차단
• 풀에서 꺼낸 세션의 유효성, Dead 세션은 즉시 재생성
• 파일 서버 일시 장애 시 지수 백오프 기반 최대 5회 재시도

문제 2: 비동기 업로드 실패 시 복구 메커니즘 부재

• 업로드 실패 시 재처리 로직 없이 파일 유실, 사용자는 성공 응답 수신 후 문제 인지 불가

해결 2: 로컬 임시 저장소 + 트랜잭셔널 아웃박스 패턴

• S3 등 외부 저장소 의존 없이 인프라 변경을 최소화하기 위해 로컬 임시 디렉토리 파일 선저장 (업로드 성공 시 즉시 삭제 방식 구성)
• DB 저장 + Outbox(PENDING) 단일 트랜잭션 처리 (이벤트 유실 방지)