Fund Dashboard

개인 투자 포트폴리오 분석 플랫폼: 펀드/주식 보유 관리, 순자산가치 추적, XIRR 연환산 수익률, 최대 낙폭(MDD), 관통 분석, DCA 적립식 투자 백테스트, 몬테카를로 시뮬레이션, 그리고 AI 에이전트를 위한 MCP 서버.

순수 Go 백엔드 + React 프론트엔드, 단일 컨테이너 배포, SQLite 영속화(선택적으로 PostgreSQL).

기능

• 보유 관리: 펀드 + 주식(A주 / 홍콩주 / 미국주) 통합 관리, 거래 CRUD, 자동 스냅샷 재계산

• 정량 분석: XIRR 연환산 수익률, 최대 낙폭, 포트폴리오 순자산가치 추이, 손익 분포, 몬테카를로 시뮬레이션, 상관관계 히트맵, 펀드 비교 레이더, DCA 적립식 투자 백테스트

• 관통 분석: 펀드 보유 종목을 기초 주식까지 관통하여 업종별로 집계

• MCP 서버: AI 에이전트 도구(portfolio / transactions / admin / market / analysis / report), Streamable HTTP 전송, Bearer key 인증

• 이중 테마: 라이트 / 다크 테마, 상승 시 빨간색 / 하락 시 초록색

Related MCP server: FinanceKit MCP

기술 스택

빠른 시작

# 测试
go test ./... -count=1
npm ci && npm test

# 构建
go build -o bin/fund-dashboard ./cmd/fund-dashboard
npm run build --workspace packages/web

# 容器
docker build -f deploy/Dockerfile -t fund-dashboard:local .

문서

릴리스

이 프로젝트는 시맨틱 버전을 따릅니다. 릴리스는 Git 태그로 트리거됩니다:

./scripts/release.sh 2.0.0   # 归并 CHANGELOG + 打 tag v2.0.0 + 推送

태그를 푸시하면 GitHub Actions가 다중 아키텍처 이미지(GHCR)를 자동으로 빌드하고 Release를 생성하며, 릴리스 노트는 CHANGELOG.md에서 가져옵니다. 이미지 풀:

docker pull ghcr.io/deliciousbuding/fund-dashboard:latest

기여

Issue와 PR을 환영합니다. 개발 프로세스: main에서 feature/* 브랜치를 만들고, 변경 후 main으로 PR을 제출합니다. 자세한 내용은 CONTRIBUTING.md를 참조하세요.

License: Apache-2.0