# Zaim家計簿連携

## 概要

家計簿サービスZaimとの連携機能。OAuth1.0認証によるAPI連携とWebスクレイパーの2モードで、取引・カテゴリ・口座データを取得・管理する。

## 使い方

1. `/zaim` にアクセス
2. OAuth認証またはスクレイパーモードを選択
3. Zaimアカウントと連携
4. 取引履歴・カテゴリ・口座情報を閲覧

### 連携モード

- **OAuth1.0モード**: API経由で公式にデータ取得
- **Webスクレイパーモード**: ブラウザ自動操作でデータ取得

## 技術構成

### Controllers

- `ZaimController` - OAuth認証、データ取得、スクレイパー制御

### Views

- `zaim/index.blade.php` - 家計簿データ表示UI

### 主要機能

- OAuth1.0認証フロー
- Webスクレイピングによるデータ取得
- 取引（transaction）データ管理
- カテゴリデータ取得
- 口座（account）データ取得

## 必要な環境変数

| 変数名 | 説明 |
|--------|------|
| `ZAIM_CONSUMER_KEY` | Zaim OAuth コンシューマーキー |
| `ZAIM_CONSUMER_SECRET` | Zaim OAuth コンシューマーシークレット |
| `ZAIM_EMAIL` | Zaimアカウントメール（スクレイパー用） |
| `ZAIM_PASSWORD` | Zaimアカウントパスワード（スクレイパー用） |