データ取得

関連: Tasker / Cloudflare / アーキテクチャ

このセクションの詳細:

リアルタイム層（主）

1. Android 通知転送（+ 位置）
   PayPay 利用速報などを Tasker + AutoNotification で検知し、
   通知直後に Tasker が端末 GPS を取得して JSON に載せる。
   Cloudflare Tunnel 経由で ingest API に HTTP POST
   （詳細: Tasker / Cloudflare）
   位置は近似値。失敗時は null で送り、支出記録自体は落とさない。
2. 利用メール取込
   楽天カード等の利用通知を IMAP で取得し、Gemini で分類・抽出
   （詳細: メール取込 / Gemini）

正確性層（週次）

• PayPay 公式 CSV（取引履歴ダウンロード）
• 楽天カード e-NAVI CSV
• Discord の #imports 添付、または Proxmox の inbox/csv/ 配置

手動・保険（Discord）

詳細は Discord。

• テキスト手打ち（現金・抜け・訂正）
• 画像・スクショ・レシート添付 → Gemini Vision でよしなに抽出
• 週次 CSV も Discord 添付可

レシート撮影は「毎回の本線」にはしないが、Discord に投げられるなら保険〜手動として採用する。

カテゴリについて

PayPay 通知や多くのスクショからは 商品内訳は基本取れない。
取れるのは金額・店名・日時が中心。
レシートで明細がはっきり読めるときだけ 内訳（line_items）を保存する。
食費 / 消耗品などは Gemini の推定、またはユーザーが Discord で一言指定・訂正する。
時間帯・店種からは「夕食」「遊び」などの場面（occasion）も推定する。
さらに 大分類（category）と 小分類（subcategories: コンビニ / コーヒー など）を自動付与する。

やらないこと（MVP）

• 銀行・PayPay・楽天の公式個人向け明細 API 直結
• 常時スクレイピング前提の完全自動取得
• LINE 通知（Notify 終了済み。Messaging API 無料枠が月200通で厳しい）

メール取込（概要）

詳細は メール取込。

1. IMAP で取得し raw を保存
2. Gemini で速報/明細/無視を分類し金額などを抽出（Gemini）
3. プログラムで金額検証・重複排除してから支出イベント化

週次 CSV

PayPay

アプリ → 取引履歴 → ダウンロード申請 → CSV 取得

楽天カード

e-NAVI → ご利用明細 → CSV ダウンロード

チャージ通知と支払い通知は両方送ってよい。
サーバ側で「支出に含めるのは支払いのみ」と判定する（アーキテクチャ）。