# Money Forward + Vertex AI 재무 분석 도구

TypeScript + pnpm으로 작성된 자동 재무 분석 도구입니다.

## 🌟 주요 기능

- Money Forward OAuth 2.0 인증
- 거래 내역 자동 수집
- Vertex AI (Gemini)를 활용한 AI 분석
- 리포트 자동 생성

## 📋 요구사항

- Node.js v18 이상
- pnpm
- Money Forward 계정 및 API 애플리케이션
- Google Cloud 계정 및 Vertex AI 접근 권한

## 🚀 시작하기

### 1. 의존성 설치

\`\`\`bash
pnpm install
\`\`\`

### 2. 환경 설정

\`\`\`bash
cp .env.example .env
# .env 파일에 실제 API 키 입력
\`\`\`

### 3. 테스트 실행

\`\`\`bash
pnpm dev
\`\`\`

## 📚 사용 가능한 스크립트

- `pnpm auth` - Money Forward OAuth 인증
- `pnpm test:api` - Money Forward API 테스트
- `pnpm analyze` - 전체 분석 실행 (Money Forward + Vertex AI)
- `pnpm build` - TypeScript 컴파일
- `pnpm start` - 빌드된 파일 실행

## 🔧 사용 방법

### 1단계: OAuth 인증
```bash
pnpm run auth
```
브라우저에서 Money Forward 로그인 후 인증 완료

### 2단계: API 테스트
```bash
pnpm run test:api
```
Tenant 정보 조회 확인

### 3단계: AI 분석 실행
```bash
pnpm run analyze
```
Money Forward 데이터를 Vertex AI로 분석

## 🏗️ 프로젝트 구조

\`\`\`
src/
├── moneyforward/       # Money Forward API 클라이언트
├── vertexai/           # Vertex AI 클라이언트
├── utils/              # 유틸리티 함수
├── types/              # TypeScript 타입 정의
└── index.ts            # 메인 엔트리 포인트
\`\`\`

## 📝 진행 상황

- [x] 프로젝트 초기화 (v3)
- [x] OAuth 인증 구현 (v4)
- [x] Money Forward API 클라이언트 구현 (v5)
- [x] Vertex AI 클라이언트 구현 (v6-v7)
- [x] Money Forward + Vertex AI 통합 (v8-v9)
- [ ] Google Cloud 프로젝트 설정 (배포 전 필요)
- [ ] 추가 scope 설정으로 거래 데이터 확장

## 📖 블로그 시리즈

상세한 구현 과정은 `post-money-forward-vertex-ai-v1.md` ~ `v10.md` 파일을 참고하세요.

## 📝 라이선스

MIT