SpreadJS 블로그 MESCIUS 기술 블로그 ·

SpreadJS로 대출 심사 웹앱 개발하기: 신용평가·DSR 자동화 완전 가이드

웹 프론트엔드 개발자가 '엑셀처럼 동작하는 대출 심사 화면'을 처음 맡았을 때 가장 막히는 지점은 수식 자동 계산·조건부 색상 경고·입력값 제한을 단일 컴포넌트 안에서 처리하는 것입니다. SpreadJS는 MESCIUS가 개발한 JavaScript 엔터프라이즈 스프레드시트 라이브러리로, 커스텀 함수 엔진·조건부 서식·데이터 유효성 검사를 Excel과 동일한 방식으로 브라우저에서 네이티브로 실행합니다.

React·Vue·Angular는 물론 Vanilla JS 환경에서도 CDN 한 줄로 시작할 수 있어, 기존 프레임워크 선택에 제약이 없습니다. 별도 서버나 플러그인 없이 new GC.Spread.Sheets.Workbook(container) 한 줄로 Excel 호환 그리드가 즉시 렌더링됩니다.

이 가이드에서는 금융 대출 심사에 필요한 네 가지 핵심 기능—신용평가 커스텀 함수 등록, 위험 등급 색상 자동화, DSR·LTV 수식 연동, PDF 심사서 즉시 출력—을 단계별 코드와 함께 소개합니다. 각 섹션은 독립적으로 적용할 수 있어 기존 화면에 부분 도입도 가능합니다.

⭐ Key Points
이 글에서 다루는 핵심 내용
01 SpreadJS 커스텀 함수(CREDITSCORE)로 소득·부채·담보 가중합산 신용평가 스코어링 모델을 셀 수식으로 구현
02 3단계 색상 스케일 조건부 서식으로 신용점수에 따라 적색/황색/녹색 위험 지표 자동 표시
03 createNumberValidator 로 소득·대출금액 입력 범위를 사전 제한하여 심사 오류 데이터 원천 차단
04 spread.savePDF() 로 심사 결과를 PDF 보고서로 즉시 다운로드 — 서버 사이드 렌더링 불필요
SpreadJS로 대출 심사 웹앱 개발하기: 신용평가·DSR 자동화 완전 가이드 — 대표 이미지

SpreadJS가 금융 대출 심사 시스템에 적합한 이유

SpreadJS는 MESCIUS가 개발한 JavaScript 기반 엔터프라이즈 스프레드시트 컴포넌트로, 500개 이상의 Excel 호환 내장 수식과 커스텀 함수 엔진을 브라우저에서 네이티브로 실행합니다. 금융 대출 심사 시스템에 특히 적합한 이유는 Excel 심사표의 수식·서식·유효성 검사 규칙을 코드로 100% 재현할 수 있어 UI 재개발 비용 없이 웹 전환이 가능하기 때문입니다.

↗
500+
내장 수식
Excel 호환 계산 엔진
↗
3단계
색상 스케일 서식
신용등급 위험 자동 시각화
↗
savePDF()
심사 보고서 출력
서버리스 PDF 생성
ⓘ NOTE
SpreadJS는 React·Vue·Angular 등 모든 프레임워크와 통합 가능하며, 순수 VanillaJS만으로도 완전한 대출 심사 시스템을 구축할 수 있습니다.

JavaScript 커스텀 함수로 신용평가 스코어링 모델 구현하기

신용평가 점수 산출은 소득·부채비율·담보가치에 가중치를 적용해 100점 만점으로 환산하는 구조입니다. SpreadJS의 GC.Spread.CalcEngine.Functions.Function 을 상속해 CREDITSCORE 커스텀 함수를 정의하면, =CREDITSCORE(소득, 부채비율, 담보가치) 수식을 셀에 직접 입력해 점수를 실시간으로 계산할 수 있습니다.

STEP 1: CDN 참조

STEP 2: HTML 구조

STEP 3: CREDITSCORE 커스텀 함수 등록 및 수식 적용

실행 결과
💡 TIP
spread.addCustomFunction() 으로 등록된 함수는 워크북 내 모든 시트에서 수식으로 호출 가능합니다. 가중치를 evaluate() 외부에서 파라미터로 주입하면 금융사별 스코어링 모델을 손쉽게 교체할 수 있습니다.

신용점수를 색상으로 자동 구분하는 조건부 서식 적용 방법

sheet.conditionalFormats.addRule() 에 ScaleRule 객체를 전달하면, 신용점수 열의 수치에 따라 빨강(위험)→노랑(보통)→초록(우량) 그라데이션이 자동 적용됩니다. 심사 담당자가 숫자를 일일이 해석하지 않고도 한눈에 위험 등급을 파악할 수 있습니다.

STEP 2: HTML 구조

STEP 3: 대출 심사 현황판 — 신용점수 3색 조건부 서식 적용

실행 결과
⭐ BEST PRACTICE
threeScaleRule 중간값( midValue )을 60으로 설정하면 금융권 일반 기준선(60점 이상 합격)을 반영합니다. 내부 심사 기준이 다를 경우 midValue 하나만 변경하면 전체 색상 분기점이 자동으로 재조정됩니다.
신용점수를 색상으로 자동 구분하는 조건부 서식 적용 방법 — SpreadJS 개념도

DSR·LTV 자동 계산과 대출 입력값 유효성 검사를 동시에 처리하는 방법

GC.Spread.Sheets.DataValidation.createNumberValidator() 로 연소득·대출금액 입력 셀에 허용 범위를 설정하고, sheet.setFormula() 로 DSR(총부채원리금상환비율)과 LTV(담보인정비율) 계산 수식을 연결하면 — 심사 담당자가 값을 입력하는 순간 오류를 즉시 경고하고 지표를 실시간 갱신합니다.

STEP 2: HTML 구조

STEP 3: 데이터 유효성 검사 + DSR·LTV 실시간 계산

실행 결과
⭐ IMPORTANT
spread.options.highlightInvalidData = true 활성화 시 유효성 검사에 실패한 셀에 빨간색 타원이 표시됩니다. B2, B4 셀 값을 직접 수정해 DSR·LTV가 실시간으로 갱신되는 것을 확인하세요.
DSR·LTV 자동 계산과 대출 입력값 유효성 검사를 동시에 처리하는 방법 — SpreadJS 개념도

서버 없이 PDF 심사 결과 보고서를 브라우저에서 바로 출력하는 방법

spread.savePDF() 는 현재 스프레드시트를 서버 없이 브라우저에서 즉시 PDF로 변환·다운로드합니다. Print 플러그인과 PDF 플러그인을 순서대로 로드한 후, 콜백에서 Blob URL을 생성해 다운로드를 트리거하면 됩니다.

실행 결과
⚠ WARNING
Print 플러그인( gc.spread.sheets.print )을 PDF 플러그인보다 반드시 먼저 로드해야 합니다. 순서가 바뀌면 spread.savePDF is not a function 오류가 발생합니다.

개발자가 자주 하는 질문

Q01

SpreadJS로 대출 심사 시스템을 처음 개발할 때 어디서부터 시작해야 하나요?

addCustomFunction() 으로 신용평가 수식을 등록하는 것이 첫 단계입니다. 이후 createNumberValidator() 로 입력 범위를 제한하고 sheet.setFormula() 로 DSR·LTV 실시간 계산을 연결합니다. conditionalFormats.addRule() 로 점수를 색상으로 시각화하고 savePDF() 로 심사서를 출력하면, 스프레드시트 컴포넌트 하나로 전체 심사 파이프라인이 완성됩니다.

Q02

브라우저에서 신용평가 점수를 자동으로 계산하려면 어떤 API를 써야 하나요?

GC.Spread.CalcEngine.Functions.Function 을 상속한 클래스를 작성하고 evaluate() 메서드 안에 스코어링 로직을 구현합니다. spread.addCustomFunction() 으로 등록하면 =CREDITSCORE(소득, 부채비율, 담보가치) 형태로 셀 수식에서 직접 호출해 점수를 실시간으로 계산할 수 있습니다.

Q03

JavaScript 스프레드시트에서 DSR과 LTV 계산을 자동화하는 방법이 있나요?

sheet.setFormula(row, col, '=B3/B2*100') 메서드로 DSR·LTV 수식을 셀에 등록하면 사용자가 입력값을 변경할 때마다 SpreadJS 계산 엔진이 셀 의존 관계를 자동으로 추적해 연쇄 재계산합니다. 별도 이벤트 핸들러를 작성하지 않아도 됩니다.

Q04

기존 Excel 대출 심사표 파일을 웹 앱으로 변환하려면 어떻게 하면 되나요?

spread.open() 으로 기존 Excel 파일을 직접 불러오면 수식·서식·유효성 검사 규칙이 그대로 보존됩니다. 이후 필요한 커스텀 함수나 이벤트 핸들러를 JavaScript로 추가 연결하면 완전한 웹 심사 시스템으로 전환됩니다. 별도 UI 컴포넌트를 처음부터 개발할 필요가 없습니다.

Q05

SpreadJS에서 금융 계산 로직을 커스텀 함수로 등록하는 코드 패턴은 어떻게 되나요?

GC.Spread.CalcEngine.Functions.Function 을 상속해 constructor() 에서 함수명과 인수 개수를 선언하고, evaluate() 메서드 안에 원하는 JavaScript 계산 로직을 작성합니다. spread.addCustomFunction(new MyFunction()) 으로 등록하면 워크북 전체에서 =MYFUNC(...) 수식으로 호출할 수 있습니다.

MESCIUS SpreadJS

지금 바로 SpreadJS 를 무료로 체험해 보세요

30일 무료 체험판으로 모든 기능을 직접 확인하세요.

SpreadJS 무료 체험판 다운로드