コストコのレシートアプリを Muse のスペースに移した

前回、📄Arrow icon of a page linkコストコのレシート取り込みを Cursor から切り離してアプリにした で、Astro + Supabase のアプリを作った話を書きました。

あのアプリ自体は気に入っていました。画像を選べば OCR して、行を確認して、表記ゆれを直してから登録する。やりたかった流れはそのままできていました。

ただ、使っているうちに別の面倒が出てきました。

localhost 専用なので、登録するには自宅の PC でアプリを起動しないといけません。コストコから帰って、荷物を冷蔵庫に入れて、ひと息ついてから PC の前に座る。レシートは財布の中。……その時点で、もう登録が翌日になる日もありました。

スマホで撮った写真は手元にあるのに、登録だけ PC 待ちになるのが、どうにも引っかかっていました。

そこで今回は、そのアプリを Muse の「スペース」に移しました。作り直しというより、置き場所を変えた、という感覚に近いです。

Image in a image block

移すときに崩したくなかったこと

中身の考え方は、前回のアプリから変えていません。

  • OCR の結果を、そのまま DB に入れない
  • 登録前に、商品名・単価・値引きを必ず自分で確認する
  • 表記ゆれが残っていたら登録できない
  • CPN / IRC のような値引き行は、直前の商品の値引きとして扱う
  • 2.398 のように読まれた金額は、2,398円として直す

特に表記ゆれは地味に効きます。スペースが1つ違うだけで別商品になって、価格推移のグラフが途切れる。前回あれだけ手間をかけた部分なので、ここを自動で適当に流すくらいなら移行しない方がいい、と思っていました。

逆に、捨ててもいいと思ったのは「Supabase に直接つなぐこと」そのものです。データが残って、後から取り出せれば、置き場所は Supabase でもスペース側の DB でも構わない。そう割り切ると話が早くなりました。

実際にやった順番

1. 最初はテーマだけ伝えた

Muse への最初の頼み方は、拍子抜けするくらい短いものでした。

GitHub で作っているコストコのレシートアプリと同じ流れで、スペースで使えるアプリを作りたい。テーマは「コストコアプリ」

これで、GitHub のリポジトリの中身を確認してもらうところから始まりました。

ゼロから説明し直さなくて済んだのは助かりました。前回のアプリで決めた業務ルールが、リポジトリと前回の記事に残っていたからです。

返ってきた提案を確認して、「実際に使えるアプリとして作る」という方向で進めました。デモ画面だけ作って終わり、にはしたくなかったので。

2. 画面は5つのタブに絞った

出来上がったスペースは、次の5タブ構成です。前回の5画面とほぼ対応しています。

タブやること
ホーム購入件数、支出合計、値引き合計、直近の購入を見るダッシュボード
レシート取り込み写真から AI で読み取る。手入力もここから
レシート履歴登録済みのレシートを日付順に見る
商品検索商品名で探して、価格推移をグラフで比べる
管理表記ゆれ(エイリアス)の統合と、CSV ダウンロード

凝ったことはしていません。

私が毎回使うのは取り込みとホームくらいで、商品検索は「前回いくらだったっけ?」と思ったときに開く程度です。

そのくらいの頻度なら、この構成で十分でした。

3. まずはスペースの中だけで動かした

ここで一度、つまずきました。

スペース版は Supabase を使っていません。

データはスペース専用の DB に入ります。API キーの設定もありません。起動も不要で、開けばすぐ使えます。

その代わり、最初は空っぽです。

GitHub 版で登録してきたデータが当然引き継がれるものだと思い込んでいたので、開いた直後に「あれ、データがない」と確認のために聞き直しました。

別物として分かれている、というのが正解でした。

ただ、裏を返せばこれは楽な面でもあります。前回は service_role キーを .env に置く関係で、公開デプロイはしない前提でした。スペース版では、そのキー自体を扱わなくて済みます。

気にするところが1つ減りました。

4. カメラ撮影を後から足した

最初のスペース版は、写真を選んで取り込む形でした。それでも PC よりは楽だったのですが、iPhone で使うなら、やっぱりその場で撮りたい。

そこで後日、こう足しました。

  • 取り込み画面の目立つところに、横幅いっぱいの「カメラで撮る」ボタンを置く
  • アプリの中でカメラを起動する。背面カメラ優先
  • 撮ったあとにプレビューを出して、撮り直せるようにする
  • カメラが使えない環境では、通常の写真選択に逃がす
  • 画像は長辺 1,600px の JPEG に縮小してから、いつもの OCR に渡す
  • 読み取り後は、今までどおり「確認 → 確定 → 保存」。写真自体もレシートに紐づけて残す

手順を増やしたくなかったので、新しい画面は作っていません。

入り口が「写真を選ぶ」から「撮る」に変わっただけです。

5. 既存データは後から寄せた

空のスペースに新規登録だけしていく手もありましたが、これまでの購入履歴がないと価格推移も値引きチェックも意味がありません。

なので 11月14日に、既存の Supabase 側のデータをスペースへ取り込みました。あわせて、置き場所を株主番号アプリでも使っている washo-home の Supabase プロジェクトに寄せて、スペースと Supabase の間で1時間ごとに双方向で同期する形にしています。

同期はスペースが直接 Supabase につないでいるわけではなく、Muse が間に入っています。削除を検出するための台帳ファイルを持っていて、明細の同一性は「購入日・正規化した商品名・単価・値引き額」の組み合わせで見ています。

正直、この仕組みは表からは見えません。私が見るのは結果だけです。初回同期のあと、両側が 487行・¥897,853 で一致したこと。変更があったときだけ知らせが来て、何もなければ静かなこと。その2点が確認できれば十分でした。

数量の扱いだけ、少し無理があります。Supabase 側に数量の項目がないので、2個買ったものは明細を2行に分けて表現しています。

見た目はきれいではないけれど、合計金額と件数が合う方を優先しました。

6. 実物のレシートで試したのは、だいぶ後になってから

カメラ機能を足してからも、実物のレシートで通しで試す機会がなかなかなくて、内心ずっと「本当に読めるのか」が残っていました。

試せたのは 11月21日、コストコ店舗へ行った日です。

帰宅後に iPhone でスペースを開いて、「カメラで撮る」からその日のレシートを撮影。

12品、合計 ¥23,417、値引きは7品で合計 ¥3,029 でした。

博多もつ鍋セットの −¥600、GLAD PRESS'N SEAL の −¥560 あたりも、値引きとしてちゃんと拾えていました。

写真付きで保存まで終わったので、この日をもって「移行できた」と言っていいかな、と思っています。

机の上で作ったものと、買い物帰りに実際に使えたものは、やっぱり違います。

Image in a image block

iPhoneでの登録は、今はこの順番です

  1. Muse のスペース「コストコアプリ」を開く
  2. 「レシート取り込み」タブで「カメラで撮る」を押す
  3. レシートを撮る。曲がっていたら撮り直す
  4. 読み取られた行を確認する。商品名、単価、値引き、ここだけは目で見る
  5. 表記ゆれが出たら、既存の商品に寄せるか、新規として確定する
  6. 確認して保存する

PC を起動する工程も、Supabase のコンソールを開く工程もありません。買い物から帰って、荷物を片づけながらでも終わります。

もちろん手入力も残してあります。OCR が読みにくいレシートは今でもありますし、無理に写真で通そうとすると、かえって直す箇所が増えるので。

移行前と後で変わったこと

Astro + Supabase 版Muse スペース版
起動自宅 PC で localhost を立ち上げる不要。開けば使える
登録する場所PC の前だけiPhone でも、PC でも
API キー.env に service_role キーを置く扱わない
データSupabaseスペースの DB。Supabase とは1時間ごとに同期
登録前の確認行確認と表記ゆれの二重確認同じ。ここは変えていない

表にすると移行の話に見えますが、体感で一番大きいのは最初の行です。「起動しなくていい」だけで、登録のハードルが一段下がりました。

残っている割り切り

良いことばかり書くと嘘になるので、割り切っている点も書いておきます。

同期は Muse 経由なので、即時ではありません。

スペースで登録したものが Supabase に出るまで、最大で1時間ほど間が空きます。家計簿代わりに月末に見る使い方なら困りませんが、「今すぐ両方で見たい」用途には向きません。

それと、OCR は相変わらず間違えます。これは移行で直るものではありませんでした。

だからこそ、確認を挟む仕様は残しています。自動化したいのは入力の手間であって、確認まで無くしたいわけではない、というのが使ってみての結論です。

まとめ

前回のアプリで作った「撮る → 確認する → 登録する」という流れはそのままに、置き場所を localhost から Muse のスペースに移しました。

結果として、登録は Muse の中で完結するようになり、iPhone で撮ってそのまま保存できるようになりました。

これまでの購入履歴も同期で引き継げているので、価格推移も、買ったことのある商品が値引きされたときのチェックも、そのまま続けて使えています。

大げさな作り替えをしたつもりはありません。ただ、使う場所が PC の前からポケットの中に移った。それだけで、レシートを溜め込むことがなくなりました。

同じように、PC でしか動かない小さな自作ツールを抱えている方の参考になれば。