📢 2026.05.13 追記: この記事をちょこちょこ見ていただけているようなので、リポジトリを公開しました。
https://github.com/Oakums/receipt-reader-public
リファクタリングを行いGASにパラメータを持たせる形に変更しています。

1. はじめに

既存の家計簿アプリでは痒い所に手が届かず、年末休暇を利用して「わが家専用」の精算システムを構築しました。解決したかったのは以下の3点です。

手計算の排除
レシートから個人分を抜き出す作業の自動化。
転記の自動化
スプレッドシート（GSS）への自動入力。
運用負荷の軽減
LINEで写真を送るだけで完結させる。

当初はネイティブアプリを作る気満々でGeminiに相談したのですが、そこで思わぬ 「逆提案」 を食らいました。
Gemini：「UIの実装やストア公開は面倒ですよ。LINE Bot + GAS + Gemini APIの構成なら、今すぐ無料で実用的なものが作れます。それで十分じゃないですか？」

正直、意表を突かれましたが、AIに開発の方向性を論破されるのも面白いなと思い、その提案に乗っかることにしました。

2. システム構成と開発環境

「サクッと作る」とはいえ、後で自分が苦しまないように開発環境はモダンに整えました。GASのエディタは使わず、VSCodeでガシガシ書いています。

設計やプロンプトの叩き台は Gemini 1.5 Pro と対話し、実際のコーディングやユニットテストの量産には VSCode + GitHub Copilot を活用しました。
「AIに設計を相談し、AIに実装を補完させる」というフローにより、年末年始の数日間で使えるくらいのものにはなりました。

3. AIとの責任分界点

AI（Gemini）には 「人間が読み取るのが面倒な情報の構造化」 に専念させ、計算などの 「決定的な算術処理」 はプログラム（GAS）側で行うよう責務を厳密に分離しました。

コンポーネント	役割 (Responsibility)	設計のポイント
Gemini API	画像 → JSONへの構造化	OCR結果から「品目」「単価」「割引」を抽出。
GAS (Logic層)	ビジネスロジック (案分)	抽出データから「特定商品の除外」や「割引の案分」を算術計算。
Google Sheets	永続化層 (Database)	`LockService` を活用し、同時実行時の競合（Race Condition）を防止

4. 実装のキモ-共同作業-

AIには「レシートの各行に番号を振ったJSON」を返させ、ユーザーが特定の番号を指定して「このお酒分だけ引いておいて」とGAS側に計算させる仕組みにしました。
これにより機能追加をプロンプト(ガチャ)ではなく関数で実装できるようにしました。

プロンプトの工夫（System Instruction）

Geminiには、計算をさせず「抽出」に徹するように以下のニュアンスで指示を出しています。

「レシート画像を解析し、各商品に1から順に番号を振ったリストを作成してください。また、レシート全体の『小計』『割引額』も個別に抽出してJSON形式で返してください。計算は不要です。」

案分計算のロジック（抜粋）

全体の割引額（クーポンなど）を考慮し、特定の商品を除外した際の実質価格を算出するロジックです。ここはハルシネーションを防ぐため、敢えてGAS側でガチガチに計算しています。

/**
 * 商品価格から、全体割引の比率を考慮して実質価格を算出する
 * 外部APIに依存しない純粋関数のため、Jestでのテスト対象とする
 */
export function calculateActualPrice(itemPrice: number, subtotal: number, totalDiscount: number): number {
    if (subtotal <= 0) return itemPrice;
    
    // 割引率を算出して適用（端数は四捨五入）
    const discountAmount = Math.round(itemPrice * (totalDiscount / subtotal));
    return itemPrice - discountAmount;
}

5. 今後の課題：あえて「完璧」を目指さない

実際に運用してみると、いくつか技術的な限界も見えてきました。

重複登録防止の精度
LockService.getScriptLock().waitLock(30000) を使用していますが、GSS側の反映遅延により稀に動作が不安定になることがあります。
例外フォーマットへの対応
店舗ごとに異なるレシートレイアウトや、税率混在（8%/10%）への対応はプロンプトの調整が必要です。

「仕様書をガチガチに固めて、一度作ったら不変！」みたいな堅苦しい開発は、もうやめました。
家族の要望が変わったら、またGeminiとあーだこーだ言いながらコードを書き換える。
そんな、AIと「二人三脚でゆるく育てていく」くらいのスタンスが、個人開発にはちょうどいいみたいです。

6. 結び

導入後、レシートの写真を撮って送るだけでよくなり、レシートはその場で捨てられるようになりました。
「もしバグが出て困るなら、またGeminiと対話してその場でロジックを直してもらえばいい」という緩いスタンスで、今後も「わが家専用」をアップデートし続けていきます。