【要約】FastAPI × SQLiteで作るレシートOCR履歴管理 [Zenn_Python] | Summary by TechDistill
> Source: Zenn_Python
Execute Primary Source
// Problem
OCR技術を用いてレシートの情報を読み取れるようになっても、そのデータを活用するには課題が残る。開発者は、読み取った情報の揮発性と、実用的な管理機能の欠如という問題に直面する。具体的には以下の点が挙げられる。
- ・データの揮発性：OCR処理直後のデータはメモリ上にしか存在せず、再利用が困難である。
- ・管理機能の不足：いつ、どこで、いくら使ったかという履歴を蓄積・検索する仕組みがない。
- ・信頼性の欠如：OCRの誤認識を人間が修正するプロセスが組み込まれていない。
// Approach
開発者は、FastAPIとSQLiteを組み合わせることで、軽量かつ迅速にデータ管理機能を実装するアプローチを採用した。最小限の構成で、データの保存から検索までを実現する手順を以下のステップで進めている。
- ・DB設計：sqlite3ライブラリを用い、日付、店舗名、金額等を保持するreceiptsテーブルを定義。
- ・API実装：Pydanticによる型定義を行い、POSTによる保存、GETによる一覧取得およびカテゴリ検索機能を実装。
- ・フロントエンド連携：JavaScriptのfetchを用いて、OCR結果を非同期で送信し、取得データをDOM操作で表示。
// Result
本実装により、OCRで抽出した情報を永続化し、後から検索・閲覧できる最小限の履歴管理システムが実現した。開発者は、単なる「読み取り」を超えた、実用的なアプリケーションの基盤を構築できる。具体的な成果は以下の通りである。
- ・機能的成果：データの保存、一覧表示、カテゴリによる絞り込み機能の確立。
- ・運用の利便性：人間が内容を確認してから保存するフローにより、データの正確性を担保。
- ・拡張の道筋：CSV出力や画像保存といった、実用的な機能への拡張性を確保。
Senior Engineer Insight
> 本構成はプロトタイプ開発において極めて高い生産性を発揮する。しかし、実戦投入には以下の観点での改善が不可欠だ。まず、SQLiteは単一ファイル管理のため、高頻度の同時書き込みが発生する環境ではロック競合のリスクがある。次に、生のSQL記述はスキーマ変更時の保守性を低下させるため、SQLAlchemy等のORM導入を強く推奨する。また、エラーハンドリングやトランザクション管理を強化しなければ、堅牢なシステムとは言い難い。PoCとしては優秀だが、本番環境ではアーキテクチャの再考が必要である。