コンテンツハッシュファイルキャッシュパターン SHA-256コンテンツハッシュをキャッシュキーとして使用して、高コストなファイル処理結果(PDF解析、テキスト抽出、画像分析)をキャッシュします。パスベースのキャッシュとは異なり、このアプローチはファイルの移動/名前変更に対して生き残り、コンテンツが変更されたときに自動的に無効化されます。 起動条件 - ファイル処理パイプラインの構築(PDF、画像、テキスト抽出) - 処理コストが高く、同じファイルが繰り返し処理される場合 - CLIオプションが必要な場合 - 既存の純粋な関数を変更せずにキャッシュを追加したい場合 コアパターン 1. コンテンツハッシュベースのキャッシュキー パスではなくファイルコンテンツをキャッシュキーとして使用します: なぜコンテンツハッシュ? ファイルの名前変更/移動 = キャッシュヒット。コンテンツ変更 = 自動無効化。インデックスファイル不要。 2. キャッシュエントリの凍結データクラス 3. ファイルベースのキャッシュストレージ 各キャッシュエントリは として保存されます — ハッシュによるO(1)検索、インデックスファイル不要。 4. サービスレイヤーラッパー(SRP) 処理関数を純粋に保ちます。キャッシュを別のサービスレイヤーとして追加します。 主要な設計上の決定 | 決定 | 根拠 | |----…