Skip to content

ibare/epulse

Repository files navigation

ePulse - 경제 인과관계 학습 시뮬레이터

거시경제 변수 간의 인과관계를 직관적으로 학습하기 위한 인터랙티브 시뮬레이터입니다.

학습 도구 · 투자 예측 아님

라이브 데모

주요 기능

  • 9개 입력 변수를 실제 경제 단위로 조절 (금리 %, 환율 원, 유가 $ 등)
  • 96개 인과관계 규칙에 따른 실시간 전파 시뮬레이션
  • React Flow 기반 인과관계 맵 시각화
  • 6개 상세 뷰 (금리 · 한국주식 · 미국주식 · 한국채권 · 미국채권 · 환율)
  • 6개 프리셋 시나리오 (미국 금리 인상, 한국 물가 급등, 원화 급약세 등)
  • 시간 지연(즉시/단기/중기)에 따른 전파 타임라인
  • 비현실적 입력 조합에 대한 모순 경고
  • 규칙 가중치 실시간 튜닝
  • 한국식/국제식 색상 스킴 전환

기술 스택

분류 기술
프레임워크 React 19, TypeScript 6
상태 관리 Zustand 5
시각화 React Flow (@xyflow/react)
애니메이션 Motion
스타일링 Tailwind CSS 3
번들러 Vite 8
테스트 Vitest
패키지 매니저 pnpm

실행

pnpm install
pnpm dev

빌드 및 배포

pnpm build

GitHub Pages로 자동 배포됩니다. main 브랜치에 푸시하면 .github/workflows/deploy.yml 워크플로우가 실행됩니다.

아키텍처

  • 도메인/UI 분리 — 시뮬레이션 엔진과 규칙 정의는 React에 의존하지 않는 순수 함수
  • DAG 전파 — Kahn 알고리즘 기반 위상 정렬 후 단방향 전파, 감쇠 계수 적용
  • 순수 함수 엔진runSimulation(inputValues)SimulationResult
  • 선언형 규칙/뷰 — 인과 규칙과 상세 뷰를 데이터 구조로 선언
  • 반응형 상태 — Zustand 셀렉터를 통한 세밀한 리렌더링 제어

경제 변수

입력 변수 (9개)

ID 라벨 지역 기본값 표시 범위
kr_growth 경제성장률 KR 50 -3% ~ +8%
kr_inflation 물가 KR 50 -1% ~ 5%
kr_rate 기준금리 KR 50 0.50% ~ 5.50%
usdkrw 원/달러 환율 KR 50 800원 ~ 1,800원
us_rate 기준금리 US 60 0% ~ 7%
us_inflation 물가 US 50 -1% ~ 5%
us_growth 성장률 US 50 -3% ~ +8%
oil 유가 GL 50 $20 ~ $160
risk 위험회피 심리 GL 30 VIX 8 ~ 52

내부적으로 0~100 범위의 값을 사용하며, UI에서는 실제 경제 단위로 변환하여 표시합니다.

파생 변수 (10개)

ID 라벨 지역
kr_rate_pressure 시장금리 KR
usdkrw_pressure 시장환율 기대 KR
usd_strength 달러 지수 GL
kr_bond 한국 채권 KR
kr_stock 한국 주식 KR
kr_commodity 한국 현물 KR
foreign_flow 외국인 자금 KR
us_bond 미국 채권 US
us_stock 미국 주식 US
gold 금(안전자산시장) GL

인과관계 규칙 (Ruleset v1.1)

총 96개 규칙: 거시 규칙 34개 + 상세 뷰 규칙 62개

방향: + 양의 상관, - 음의 상관
시차: 즉시 / 단기 / 중기
가중치: 0.0 ~ 1.0 (영향력 강도)

거시 규칙 (34개)

거시 뷰에서 변수 간 직접 연결되는 규칙입니다. * 표시된 규칙에는 조건부 예외가 있습니다.

물가 · 금리

ID 원인 결과 방향 가중치 시차
r02 미국 물가 미국 금리 + 0.5 즉시
r39 한국 기준금리 한국 물가 - 0.3 중기
r40 미국 금리 미국 물가 - 0.3 중기

성장률

ID 원인 결과 방향 가중치 시차
r05* 한국 성장률 한국 주식 + 0.5 단기
r06 미국 성장률 미국 주식 + 0.5 단기
r35 미국 성장률 한국 주식 + 0.2 단기
r36 한국 성장률 원/달러 환율 - 0.2 단기

금리 → 채권 · 주식 · 환율

ID 원인 결과 방향 가중치 시차
r08 시장금리 한국 채권 - 0.8 즉시
r09* 시장금리 한국 주식 - 0.3 단기
r10 미국 금리 달러 지수 + 0.7 즉시
r11 미국 금리 미국 채권 - 0.8 즉시
r32 한국 기준금리 한국 채권 - 0.5 즉시
r33 한국 기준금리 한국 주식 - 0.2 단기
r34 한국 기준금리 원/달러 환율 - 0.25 단기
r38 미국 금리 미국 주식 - 0.3 단기

환율 → 한국 시장

ID 원인 결과 방향 가중치 시차
r13 달러 지수 시장환율 기대 + 0.6 즉시
r14 원/달러 환율 시장환율 기대 + 0.5 즉시
r15 시장환율 기대 외국인 자금 - 0.7 단기
r16* 시장환율 기대 한국 주식 - 0.3 단기
r17 시장환율 기대 한국 현물 + 0.3 중기

유가

ID 원인 결과 방향 가중치 시차
r18 유가 한국 물가 + 0.4 단기
r19* 유가 한국 현물 + 0.7 즉시
r23 유가 미국 물가 + 0.3 단기
r25 유가 한국 주식 - 0.2 단기
r26 유가 미국 주식 - 0.15 단기
r27 유가 위험회피 심리 + 0.2 중기

위험회피 심리

ID 원인 결과 방향 가중치 시차
r20 위험회피 심리 외국인 자금 - 0.5 즉시
r21* 위험회피 심리 한국 주식 - 0.3 즉시
r28 위험회피 심리 미국 주식 - 0.25 즉시

외국인 자금

ID 원인 결과 방향 가중치 시차
r22 외국인 자금 한국 주식 + 0.4 단기

금 (안전자산)

ID 원인 결과 방향 가중치 시차
r41 한국 물가 + 0.35 단기
r42 미국 금리 - 0.3 즉시
r43 달러 지수 - 0.4 즉시
r44 위험회피 심리 + 0.35 즉시

조건부 예외

일부 규칙은 특정 조건에서 영향이 완화되거나 상쇄됩니다.

규칙 조건 설명
r05 한국 물가 > 20 성장이 과도한 물가와 동반되면 주식 긍정 효과가 제한됨
r09 한국 성장률 > 15 성장률이 견조하면 금리 인상의 주식 부담이 제한적
r16 한국 성장률 > 10 원화 약세에도 수출주에 우호적 환경 형성 가능
r19 시장환율 기대 < -5 원화 강세 시 유가 상승의 수입물가 부담 일부 상쇄
r21 한국 성장률 > 10 & 미국 성장률 > 5 글로벌 성장 동반 시 위험회피의 주식 부담 완화

상세 뷰 규칙 (62개)

상세 뷰는 개념 노드(중간 매개체)를 도입하여 인과관계의 메커니즘을 시각화합니다. 입력 → 개념 → 결과의 3단 구조로 전파됩니다.

금리 상세 뷰 (13개)

개념 노드: 인플레이션 압력, 경기 압력, 중앙은행 스탠스, 시장 기대

ID 원인 결과 방향 가중치 시차
rc01 한국 물가 인플레이션 압력 + 1.0 즉시
rc02 유가 인플레이션 압력 + 0.4 즉시
rc03 한국 성장률 경기 압력 + 1.0 즉시
rc04 한국 물가 중앙은행 스탠스 + 0.4 즉시
rc05 미국 금리 중앙은행 스탠스 + 0.3 즉시
rc06 한국 성장률 중앙은행 스탠스 + 0.15 즉시
rc07 한국 물가 시장 기대 + 0.6 즉시
rc08 한국 성장률 시장 기대 + 0.3 즉시
rc09 원/달러 환율 시장 기대 + 0.15 즉시
rc10 중앙은행 스탠스 기준금리 + 1.0 단기
rc11 인플레이션 압력 시장금리 + 0.42 즉시
rc12 경기 압력 시장금리 + 0.21 단기
rc13 시장 기대 시장금리 + 0.3 즉시

한국 주식 상세 뷰 (13개)

개념 노드: 기업 실적 기대, 할인율 부담, 외국인 수급, 투자 심리

ID 원인 결과 방향 가중치 시차
rsk01 한국 성장률 기업 실적 기대 + 1.0 즉시
rsk02 유가 기업 실적 기대 - 0.4 즉시
rsk03 한국 기준금리 할인율 부담 + 0.7 즉시
rsk04 한국 물가 할인율 부담 + 0.5 즉시
rsk05 원/달러 환율 외국인 수급 - 0.8 즉시
rsk06 미국 금리 외국인 수급 - 0.5 즉시
rsk07 기업 실적 기대 투자 심리 + 0.3 즉시
rsk08 외국인 수급 투자 심리 + 0.3 즉시
rsk09 할인율 부담 투자 심리 - 0.3 즉시
rsk10 기업 실적 기대 한국 주식 + 0.35 단기
rsk11 할인율 부담 한국 주식 - 0.3 단기
rsk12 외국인 수급 한국 주식 + 0.3 단기
rsk13 투자 심리 한국 주식 + 0.2 즉시

미국 주식 상세 뷰 (10개)

개념 노드: 기업 실적 기대, 할인율 부담, 투자 심리

ID 원인 결과 방향 가중치 시차
rsu01 미국 성장률 기업 실적 기대 + 1.0 즉시
rsu02 유가 기업 실적 기대 - 0.3 즉시
rsu03 미국 금리 할인율 부담 + 0.8 즉시
rsu04 미국 물가 할인율 부담 + 0.5 즉시
rsu05 위험회피 심리 투자 심리 - 0.6 즉시
rsu06 기업 실적 기대 투자 심리 + 0.3 즉시
rsu07 할인율 부담 투자 심리 - 0.3 즉시
rsu08 기업 실적 기대 미국 주식 + 0.4 단기
rsu09 할인율 부담 미국 주식 - 0.35 단기
rsu10 투자 심리 미국 주식 + 0.25 즉시

한국 채권 상세 뷰 (9개)

개념 노드: 금리 부담, 신용 상태, 외국인 수요

ID 원인 결과 방향 가중치 시차
rbk01 한국 기준금리 금리 부담 + 0.8 즉시
rbk02 한국 물가 금리 부담 + 0.5 즉시
rbk03 한국 성장률 신용 상태 + 0.7 단기
rbk04 한국 물가 신용 상태 - 0.4 즉시
rbk05 원/달러 환율 외국인 수요 - 0.7 즉시
rbk06 미국 금리 외국인 수요 - 0.5 즉시
rbk07 금리 부담 한국 채권 - 0.45 즉시
rbk08 신용 상태 한국 채권 + 0.3 단기
rbk09 외국인 수요 한국 채권 + 0.25 단기

미국 채권 상세 뷰 (8개)

개념 노드: 금리 부담, 신용 상태, 안전자산 수요

ID 원인 결과 방향 가중치 시차
rbu01 미국 금리 금리 부담 + 0.8 즉시
rbu02 미국 물가 금리 부담 + 0.5 즉시
rbu03 미국 성장률 신용 상태 + 0.7 단기
rbu04 유가 신용 상태 - 0.3 단기
rbu05 위험회피 심리 안전자산 수요 + 0.8 즉시
rbu06 금리 부담 미국 채권 - 0.45 즉시
rbu07 신용 상태 미국 채권 + 0.3 단기
rbu08 안전자산 수요 미국 채권 + 0.35 즉시

환율 상세 뷰 (9개)

개념 노드: 달러 수요, 원화 매력도, 자본 유출 압력

ID 원인 결과 방향 가중치 시차
rfx01 미국 금리 달러 수요 + 0.7 즉시
rfx02 유가 달러 수요 + 0.5 단기
rfx03 위험회피 심리 달러 수요 + 0.4 즉시
rfx04 한국 기준금리 원화 매력도 + 0.7 즉시
rfx05 한국 성장률 원화 매력도 + 0.5 단기
rfx06 위험회피 심리 자본 유출 압력 + 0.7 즉시
rfx07 달러 수요 시장환율 기대 + 0.4 즉시
rfx08 원화 매력도 시장환율 기대 - 0.35 단기
rfx09 자본 유출 압력 시장환율 기대 + 0.35 즉시

시나리오

시나리오 설명 주요 변경
미국 금리 인상 미국 금리 인상이 글로벌 시장에 미치는 영향 us_rate 85, usdkrw 72, risk 45
한국 물가 급등 한국 물가 급등이 금리와 시장에 미치는 영향 kr_inflation 82, kr_rate 70, oil 65
원화 급약세 원화 약세가 한국 시장에 미치는 영향 usdkrw 85, risk 55, us_rate 70
유가 급등 유가 급등이 물가와 시장에 미치는 영향 oil 88, kr_inflation 68, risk 50
경기 둔화 우려 글로벌 경기 둔화 시나리오 kr_growth 25, us_growth 30, risk 65
수출 호조 한국 수출 호조 시나리오 kr_growth 75, usdkrw 58, us_growth 65

모순 검사

두 입력 변수가 모두 고정(pinned)된 상태에서 비현실적 조합이 감지되면 경고를 표시합니다.

ID 조건 수준 설명
c01 한국 물가 >= 65 & 기준금리 <= 40 위험 물가가 높은데 금리가 낮은 것은 비현실적
c02 미국 물가 >= 65 & 미국 금리 <= 45 위험 물가 높은데 연준이 저금리 유지는 비일반적
c03 한국 성장률 >= 70 & 물가 <= 35 경고 경기 과열인데 물가가 낮은 것은 드문 상황
c04 유가 >= 70 & 한국 물가 <= 40 경고 유가 급등인데 물가 안정은 비현실적
c05 미국 금리 >= 75 & 환율 <= 40 위험 미국 고금리에 원화 강세는 비일반적
c06 위험회피 <= 20 & 환율 >= 70 경고 안정적 환경에서 원화 약세는 비일반적

조건의 숫자는 내부값(0~100) 기준입니다.


엔진 설정

파라미터 설명
DAMPING_FACTOR 0.7 전파 감쇠 계수
DAMPING_MIN_DEPTH 2 감쇠 적용 시작 깊이
MAX_ITERATIONS 30 최대 전파 반복 횟수
DELTA_CLAMP -50 ~ +50 delta 클램핑 범위
MAX_INTENSITY 3 최대 강도 단계
INTENSITY_THRESHOLD 4 시각적 변화 최소 임계값
STATE_THRESHOLDS +26/+11/+4/-3/-10/-25 상태 분류 구간 경계

About

경제 인과관계 학습 시뮬레이터

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages