QF Risk Scoring Live Lab

GitHub Pages · browser-only live demo

Click, tweak, score, export.

설치 없이 바로 체험하는 금융 리스크 스코어링 포트폴리오 데모입니다. 샘플 회사를 고르고 지표를 바꾸면 decision packet, 설명, 배치 비교, CSV 결과가 즉시 생성됩니다.

지금 바로 해보기 내 CSV 붙여넣기 데이터 근거 보기
1 회사 선택 2 시나리오 적용 3 JSON/CSV 다운로드

Synthetic example only. Not investment, lending, credit-screening, or real corporate-rating advice.

Financial risk scoring project hero image
Live risk packet 0%

리뷰어가 직접 해볼 수 있음

슬라이더, 프리셋 시나리오, 배치 비교, CSV 붙여넣기, JSON 복사/다운로드까지 전부 브라우저에서 동작합니다.

정직한 구조

GitHub Pages는 정적 사이트라 Python/FastAPI를 직접 실행하지 않습니다. 여기서는 설명 가능한 JS simulator를 쓰고, 실제 파이프라인은 저장소의 FastAPI에서 실행합니다.

포트폴리오 목적

논문식 성능 주장이 아니라 데이터 계약, 누수 방지, API, 모니터링, 리포트 산출물까지 연결하는 서비스형 ML 감각을 보여줍니다.

Evidence pack

“과거자료와 입력 데이터는 뭘로 검증하나요?”에 대한 답도 준비했습니다

현재 데모는 synthetic sample이지만, 실데이터 확장 시 OpenDART/DART, KRX, ECOS/KOSIS 같은 공식 자료로 매핑하고, Altman/Ohlson-style financial distress baseline, point-in-time validation, walk-forward backtest로 검증하도록 설계했습니다.

Official data mapping

재무제표·공시·시장자료·거시지표를 각각 공식 데이터 소스에 연결합니다.

Literature baseline

Altman, Ohlson, Fama-French, default forecasting literature를 baseline 설명 근거로 둡니다.

Leakage-aware validation

공시일과 예측일을 분리하고 시간 기준 walk-forward 검증으로 과거자료 테스트를 설계합니다.

데이터 검증 근거 페이지 열기

Live company lab

재무 지표를 바꾸면 리스크 패킷이 바로 바뀝니다

아래 값은 synthetic sample입니다. 수치 조작 → 스코어 재계산 → 설명 생성 → JSON export 흐름을 즉시 확인할 수 있습니다.

Current result

-

-

-

Risk narrative

입력값을 바탕으로 리스크 신호를 생성합니다.

Top risk factors

    Positive signals

      Feature contribution preview

      explainable heuristic
      Generated decision packet JSON 
      
            
      
              
              
            
      
          
      
        
      
      
      
    
      

    
      
      
      
        
      Batch scoring
      
        
      여러 회사를 한 번에 비교해볼 수 있습니다
      
        
      포트폴리오 리뷰어가 “서비스라면 batch도 되나?”라고 볼 때 바로 보여주는 영역입니다.
      
      
      
      
      
        
      
          
      
          
          
        
      
        
      
          
      
            
              
      
                RankCompanySectorRisk levelOverallMarginMarketLiquidityMain factor
              
      
                  
            
          
      
        
      
      
      
    
      

    
      
      
      
        
      Bring your own sample
      
        
      CSV를 붙여넣거나 업로드해서 브라우저에서 바로 스코어링
      
        
      서버 전송 없이 현재 브라우저 안에서만 파싱합니다. 공개 페이지라 실제 기업 민감 데이터는 넣지 않는 게 안전합니다.
      

        
      
          
      CSV 입력 주의
      
          
      공개 GitHub Pages 데모입니다. 실제 기업의 미공개정보, 개인정보, 영업비밀, 계정정보, 민감한 재무자료는 입력하지 마세요.
      
        
      
      
      
      
      
        
      
          
      
            
            
            
          
      
          
        
      
        
      
          
      
            
      CSV result
      
            
          
      
          
      
            
      
              
      CompanyRiskOverallTop factor
      
              
            
      
          
      
          
      
        
      
      
      
    
      

    
      
      
      
        
      API preview
      
        
      프론트 체험과 FastAPI 백엔드의 경계를 명확히 보여줍니다
      
        
      아래 request/response mock은 현재 브라우저 입력값에서 생성됩니다. 실제 실행은 저장소의 FastAPI에서 합니다.
      
      
      
      
      
        
      
          
      GitHub Pages demo
      
          
      정적 JS simulator. 설치 없이 제품 감각을 보여주기 위한 공개 체험판입니다.
      
          site/index.html + site/app.js
        
      
        
      
          
      FastAPI service
      
          
      CSV validation, feature engineering, model leaderboard, report artifact 생성을 담당합니다.
      
          app/main.py
        
      
        
      
          
      Decision artifacts
      
          
      decision packet, risk report, monitoring report, dashboard snapshot, LLM prompt packet을 생성합니다.
      
          artifacts/requests/*
        
      
      
      
      
      
        
      
        
      
      
      
    
      

    
      
      
      
        
      Pipeline and architecture
      
        
      움직이는 파이프라인 + 아키텍처 그림
      
      
      
      Animated pipeline flow
      System architecture diagram
    
      

    
      
      
      
        
      Portfolio dashboard
      
        
      로컬 파이프라인은 정적 대시보드 스냅샷도 생성합니다
      
      
      
      Dashboard preview
    
      

    
      
      
      
        
      Run the real backend
      
        
      로컬에서는 실제 Python/FastAPI 파이프라인을 실행합니다
      
      
      
      
      
        
      python -m venv .venv
# Windows: .\.venv\Scripts\Activate.ps1
source .venv/bin/activate
pip install -r requirements.txt
python run_demo.py --company-id C003
      
        
      uvicorn app.main:app --reload

curl -X POST http://127.0.0.1:8000/v1/predictions \
  -H "Content-Type: application/json" \
  -d '{"company_id":"C003","input_dir":"data/input/sample"}'