sam-react-prod/claudedocs/[PLAN-2026-01-23] vendor-credit-analysis-modal.md

신규 거래처 신용분석 모달

개요

• 목적: 신규 거래처 등록 시 국가관리 API를 통해 받아온 기업 신용정보를 표시
• 위치: 거래처 등록 완료 후 모달로 표시
• 현재 단계: 목업 데이터로 UI 구현 (추후 API 연동)

화면 구성

1. 헤더

• 로고 + "SAM 기업 신용분석 리포트"
• 조회일시 표시

2. 기업 정보

• "신규거래 신용정보 조회" 뱃지
• "기업 신용 분석" 제목
• 사업자번호, 법인명 (대표자명), 평가기준일 정보

3. 자료 효력기간 안내

• 노란 배경의 알림 박스
• 데이터 유효기간 및 면책 안내

4. 종합 신용 신호등

• 5단계 신호등 표시 (Level 1~5)
• 현재 레벨 강조 (예: 양호 Level 4)
• 신용 등급 설명 텍스트
• "유료 상세 분석 제공받기" 버튼

5. 신용 리스크 프로필

• 오각형 레이더 차트
  • 한국신용평가등급
  • 금융 종합 위험도
  • 매입 결제
  • 매출 결제
  • 저당권설정

6. 신용 상세 정보

• 신용채무정보 버튼
• 신용등급추이정보 버튼
• 정보 없음 안내 텍스트

7. 하단 거래 승인 판정

• 안전/위험 배지
• 신용등급 (Level 1~5)
• 거래 유형 (계속사업자/신규거래 등)
• 외상 가능 여부
• "거래 승인 완료" 버튼

데이터 구조

interface CreditAnalysisData {
  // 기업 정보
  businessNumber: string;      // 사업자번호
  companyName: string;         // 법인명
  representativeName: string;  // 대표자명
  evaluationDate: string;      // 평가기준일

  // 신용 등급
  creditLevel: 1 | 2 | 3 | 4 | 5;  // 1: 위험, 5: 최우량
  creditStatus: '위험' | '주의' | '보통' | '양호' | '우량';

  // 리스크 프로필 (0~100)
  riskProfile: {
    koreaCreditRating: number;    // 한국신용평가등급
    financialRisk: number;        // 금융 종합 위험도
    purchasePayment: number;      // 매입 결제
    salesPayment: number;         // 매출 결제
    mortgageSetting: number;      // 저당권설정
  };

  // 거래 승인 판정
  approval: {
    safety: '안전' | '주의' | '위험';
    level: number;
    businessType: string;         // 계속사업자, 신규거래 등
    creditAvailable: boolean;     // 외상 가능 여부
  };
}

파일 구조

src/components/accounting/VendorManagement/
├── CreditAnalysisModal.tsx      # 신용분석 모달 컴포넌트
└── CreditAnalysisModal/
    ├── index.tsx                # 메인 모달
    ├── CreditSignal.tsx         # 신용 신호등 컴포넌트
    ├── RiskRadarChart.tsx       # 레이더 차트 컴포넌트
    └── types.ts                 # 타입 정의

src/app/[locale]/(protected)/dev/
└── credit-analysis-test/
    └── page.tsx                 # 테스트 페이지

구현 순서

1. 계획 md 파일 작성
2. CreditAnalysisModal 컴포넌트 생성
3. 테스트 페이지 생성
4. dev/test-urls에 URL 추가