💰 가계부 & 투자 관리 시스템 (FinanceManager)

개인 재무 관리와 주식 포트폴리오를 하나의 프로그램으로! 기능 소개 • 설치 방법 • 사용 가이드 • 스크린샷

---

📋 프로젝트 소개

FinanceManager는 일상적인 수입 / 지출 관리부터 주식 포트폴리오 추적까지, 개인의 재무 상태를 한눈에 파악할 수 있는 통합 금융 관리 데스크톱 애플리케이션입니다.

✨ 왜 이 프로그램인가요?

• 🎯 올인원 솔루션: 가계부와 투자 관리를 하나의 프로그램에서 통합 관리
• 📊 시각화된 인사이트: LiveCharts 기반의 직관적인 차트와 그래프
• 💾 로컬 데이터베이스: 개인정보 외부 유출 걱정 없는 로컬 저장 구조
• 🔄 실시간 주가 조회: 한국투자증권 Open API 연동
• 📈 상세 리포트: CSV / HTML 형식으로 데이터 내보내기 지원

---

🚀 주요 기능

💵 가계부 관리

• 수입 / 지출 거래 내역 등록 및 관리
• 커스터마이징 가능한 카테고리 시스템
• 기간별 / 카테고리별 필터링 및 검색
• 월별 / 연간 통계 및 지출 추이 분석

📈 투자 포트폴리오

• 보유 주식 종목 관리
• 실시간 시세 조회 (한국투자증권 API)
• 수익률 및 평가손익 자동 계산
• 포트폴리오 분산 현황 시각화

📑 리포트 & 분석

• 월별 / 연간 수입·지출 보고서
• 카테고리별 지출 분석
• 예산 대비 실적 분석
• CSV / HTML 형식 내보내기

💡 추가 기능

• 카테고리별 색상 커스터마이징
• 예산 설정 및 모니터링
• 대시보드 기반 한눈에 보는 재무 현황
• 데이터 백업 및 복원 기능

---

🛠️ 기술 스택

Core Technologies

• .NET Framework 4.7.2
• C# Windows Forms
• SQL Server LocalDB

Libraries & APIs

라이브러리 / API	용도	버전
LiveCharts	데이터 시각화	0.9.7
System.Data.SqlClient	데이터베이스 연결	4.9.0
한국투자증권 Open API	실시간 주가 조회	-

---

💻 설치 방법

📋 필수 요구사항

• Windows 10 이상
• .NET Framework 4.7.2 이상
• SQL Server LocalDB
• Visual Studio 2019 이상 (개발 시)

🔧 설치 단계

1️⃣ 레포지토리 클론

git clone https://github.com/yourusername/FinanceManager.git
cd FinanceManager

2️⃣ NuGet 패키지 복원

nuget restore FinanceManager.sln

3️⃣ 데이터베이스 초기화

• 최초 실행 시 LocalDB 자동 생성
• 또는 Scripts/SQLQuery1.sql 파일 실행

4️⃣ API 설정 (선택)

App.config

<add key="KIS_APP_KEY" value="YOUR_APP_KEY" />
<add key="KIS_APP_SECRET" value="YOUR_APP_SECRET" />

5️⃣ 빌드 및 실행

dotnet build
dotnet run

---

📖 사용 가이드

🏠 대시보드

• 이번 달 수입 / 지출 / 잔액
• 포트폴리오 평가액
• 최근 거래 내역
• 카테고리별 지출 차트

💰 거래 내역 관리

1. 거래 추가: 날짜 / 유형 / 카테고리 / 금액 / 설명 입력
2. 거래 수정 및 삭제 지원
3. 기간 / 카테고리 / 키워드 검색 필터

📊 포트폴리오 관리

• 종목 검색 및 추가
• 실시간 시세 갱신
• 자동 수익률 계산

📑 보고서 생성

• 월별 / 연간 보고서 생성
• CSV / HTML 형식 데이터 내보내기

---

🗂️ 프로젝트 구조

FinanceManager/
├── Data/        # 데이터베이스 연결 및 초기화
├── Forms/       # UI 폼
├── Models/      # 데이터 모델
├── Services/    # 비즈니스 로직
├── Utils/       # 유틸리티
├── Scripts/     # SQL 스크립트
└── App.config   # 앱 설정

---

🔐 데이터베이스 스키마

주요 테이블

Users           -- 사용자 정보
Categories      -- 카테고리 (수입 / 지출)
Transactions    -- 거래 내역
Stocks          -- 주식 종목
Portfolio       -- 포트폴리오
MonthlyBudgets  -- 월별 예산

ERD

Users ──1:N─→ Transactions ──N:1─→ Categories
  │
  └──1:N─→ Portfolio ──N:1─→ Stocks
  │
  └──1:N─→ MonthlyBudgets ──N:1─→ Categories

---

🔧 설정

App.config 주요 설정

<!-- 한국투자증권 API -->
<add key="KIS_APP_KEY" value="YOUR_KEY" />
<add key="KIS_APP_SECRET" value="YOUR_SECRET" />
<add key="KIS_API_URL" value="https://openapi.koreainvestment.com:9443" />

<!-- 차트 설정 -->
<add key="ChartAnimationSpeed" value="500" />
<add key="ChartRefreshInterval" value="60000" />

<!-- 백업 설정 -->
<add key="BackupPath" value="Backups" />
<add key="AutoBackupEnabled" value="true" />

---

🤝 기여하기

1. Fork the Project
2. Feature Branch 생성 (git checkout -b feature/AmazingFeature)
3. Commit (git commit -m 'Add some AmazingFeature')
4. Push (git push origin feature/AmazingFeature)
5. Pull Request 생성

---

📝 로드맵

• 다중 사용자 지원
• 클라우드 백업 기능
• 모바일 앱 연동
• 자동 거래 분류 (AI)
• 예산 알림 기능
• 다국어 지원
• 암호화폐 포트폴리오 추가

---

⚠️ 면책 조항

• 본 프로그램은 개인 재무 관리 목적으로만 사용하세요.
• 모든 투자 결정은 사용자 본인의 책임입니다.
• 실시간 주가 정보는 참고용이며 실제 거래 가격과 다를 수 있습니다.
• 데이터 백업을 정기적으로 수행하시기 바랍니다.

---

📄 라이선스

본 프로젝트는 MIT License를 따릅니다.

---

🙏 감사의 말

• LiveCharts – 데이터 시각화 라이브러리
• 한국투자증권 – Open API 제공
• 모든 기여자분들께 감사드립니다

⭐ 이 프로젝트가 유용하다면 Star를 눌러주세요! ⭐ Made with ❤️ by FinanceManager Team