smart-categorize

スマートなカテゴリ分類

概要

既知のルールに対して業者名や説明のパターンを照合し、カテゴリ未設定の取引を自動的に分類します。まず既存のカテゴリ分類ルールを適用し、その後、一般的な業者名をもとに、一致しない取引に対する新しいルールを提案します。

使用する Wilson ツール

• categorize — パターンベースのカテゴリ分類ルールを取引に適用します
• transaction_search — カテゴリ未設定の取引を検索します

ワークフロー

1. transaction_search を使って、category が null または空の取引をすべて検索します。
2. categorize を実行して、既存のカテゴリ分類ルール（説明フィールドに対するパターン照合）を適用します。
3. 既存のルールで分類された取引の件数を報告します。
4. 残りのカテゴリ未設定の取引を、業者名や説明の類似性に基づいてグループ化します。
5. 業者グループごとにカテゴリの割り当てを提案します（例：「SPOTIFY」→エンターテインメント、「SHELL OIL」→交通）。
6. 提案したカテゴリを確定するか、変更するか、ユーザーに確認します。
7. 確定したカテゴリを適用し、必要に応じて今後のインポート用に新しいカテゴリ分類ルールを保存します。

Wilson を使わない場合

スプレッドシートで取引を手動で分類できます。

Excel／Sheets でカテゴリルールを設定する

1. 「Rules」という名前の参照シートを作成し、Pattern と Category の2列を用意します。

2. 業者名のパターンを追加します：

   パターン	カテゴリ
   AMAZON	ショッピング
   WHOLE FOODS	食料品
   SHELL	交通
   NETFLIX	エンターテインメント
   STARBUCKS	外食

3. 取引シートの Category 列で、検索式を使用します：

   • Excel：=IFERROR(INDEX(Rules!B:B,MATCH("*"&"AMAZON"&"*",Rules!A:A,0)),"Uncategorized") — ただし、完全一致の場合にしか機能しません。
   • Excel でのより良い方法：補助列と =SUMPRODUCT、または VBA マクロを使って部分一致を行います。
   • Google Sheets：=IFERROR(VLOOKUP("*"&A2&"*",Rules!A:B,2,FALSE),"Uncategorized") は VLOOKUP のワイルドカードをサポートしていません。
   • Google Sheets での実用的な方法：

     =IF(REGEXMATCH(A2,"(?i)amazon"),"Shopping",
      IF(REGEXMATCH(A2,"(?i)whole foods|trader joe"),"Groceries",
      IF(REGEXMATCH(A2,"(?i)shell|chevron|exxon"),"Transportation",
      "Uncategorized")))
     

一般的なカテゴリ対応表

業者名のパターン	推奨カテゴリ
AMAZON, TARGET, WALMART	ショッピング
WHOLE FOODS, TRADER JOE, KROGER, SAFEWAY	食料品
UBER EATS, DOORDASH, GRUBHUB	外食
NETFLIX, SPOTIFY, HULU, DISNEY+	エンターテインメント
SHELL, CHEVRON, BP, EXXON	交通
AT&T, VERIZON, T-MOBILE, COMCAST	公共料金
CVS, WALGREENS, PHARMACY	ヘルスケア
VENMO, ZELLE, PAYPAL（個人間）	振替

重要な注意事項

• パターン照合では大文字と小文字を区別せず、取引の説明のどの部分にも一致します。
• ルールは作成された順に適用されます。取引が複数のルールに一致する場合は、最初に一致したルールが適用されます。
• 明示的に依頼されない限り、すでにカテゴリが設定されている取引を上書きすることはありません。
• Wilson はルールを categorization_rules テーブルに保存するため、セッションをまたいで保持され、今後のインポートにも自動的に適用されます。