wealth-forge 시스템 구조

wealth-forge 시스템 구조 An architecture diagram generated by Archify. KIS OpenAPI · openapi.koreainvestment.com · Architecture component · OAuth 토큰 KIS OpenAPI openapi.koreainvestment.com OAuth 토큰 Toss OpenAPI · openapi.tossinvest.com · Architecture component · client_credentials Toss OpenAPI openapi.tossinvest.com client_credentials 공공데이터포털 · 청약홈 · LH · 아파트 실거래가 · Architecture component 공공데이터포털 청약홈 · LH · 아파트 실거래가 entry-signal · 낙폭 · 인트라데이 트리거 · k3s prod · namespace wf · NodePort 30080 entry-signal 낙폭 · 인트라데이 트리거 NodePort 30080 portfolio-advisor · 잔고 합산 · 브리프 · 주문 승인 · k3s prod · namespace wf · NodePort 30083 portfolio-advisor 잔고 합산 · 브리프 · 주문 승인 NodePort 30083 housing-alert · 공고 수집 · 적합도 평점 · k3s prod · namespace wf · NodePort 30081 housing-alert 공고 수집 · 적합도 평점 NodePort 30081 Redis · OAuth 액세스 토큰 캐시 · k3s prod · namespace wf Redis OAuth 액세스 토큰 캐시 PostgreSQL · 주문 제안 (JPA · Flyway) · k3s prod · namespace wf PostgreSQL 주문 제안 (JPA · Flyway) SQLite · 공고 중복 기록 · PVC /data · k3s prod · namespace wf SQLite 공고 중복 기록 · PVC /data Anthropic API · claude-opus-4-8 · Architecture component · 기본 비활성 Anthropic API claude-opus-4-8 기본 비활성 Telegram Bot · 알림 발송 · 승인 응답 · Architecture component Telegram Bot 알림 발송 · 승인 응답 시세 조회 국내 잔고 해외 잔고 · 주문 공고 · 실거래가 조회 토큰 캐시 토큰 캐시 주문 제안 저장 중복 공고 판정 브리프 요약 요청 승인 요청 · 응답 폴링 공고 알림 발송 k3s prod · namespace wf Legend Backend Database External

런타임

  • • Spring Boot 3 · Java 21 pod 3개, Gradle 멀티모듈 apps:*
  • • k3s prod 2노드, Kustomize base + dev/prod 오버레이
  • • Redis는 KIS·Toss 액세스 토큰 캐시(single-flight 재발급)

데이터와 전달

  • • PostgreSQL: portfolio-advisor 주문 제안(Flyway V1)
  • • SQLite on PVC: housing-alert 공고 중복 기록
  • • Telegram: 청약 공고 알림, 주문 승인 요청과 응답 폴링

안전장치와 운영

  • • 주문은 사람 승인 후에만 진행, 기본값 DRY-RUN·자동 발주 없음
  • • GitHub Actions → GHCR → ArgoCD 동기화, 시크릿은 Sealed Secrets
  • • VictoriaMetrics + Grafana 스크랩, Postgres 백업은 restic → Cloudflare R2