本アプリは、レシートの写真から購入した商品と価格を自動で読み込み、素早く家計簿を作成することで利用者の負担を軽減することを目的として開発しています。
まず、IntelliJ IDEAのプロジェクト選択画面でREADME.mdやpom.xmlが配置されているディレクトリを選択して本プロジェクトを開いてください。
次に、src/main/java/adv1b/group06/kakeibo/Kakeibo.javaを実行してください。
依存パッケージが存在しないことなどでエラーなどが発生してアプリが正常に動作しない場合には、Ctrl Shift Aを押してMaven Reloadと検索する。そして、候補として示されたすべてのMavenプロジェクトを再ロードを選択してください。これにより、依存ファイルが一括でダウンロードされます。
-
パスに日本語などのUnicode文字が含まれている場合にOCR機能を利用すると、tess4jのバグでアプリがクラッシュします。
-
解像度の高い画像を読み込むと、一時的にアプリの応答がなくなりますが、数十秒で何らかの応答が得られます。この時、エラーが発生した場合にはエラーメッセージが出力される仕様です。
-
読み込むレシート画像は、次の要件を満たしていることを想定しています。
- レシートの外に無関係な文字が無いこと
- レシートが中央に真っ直ぐ配置されていること
- 画像から文字が読み取り可能な明度、解像度であること
- 芝浦工業大学の生協もしくは学食のレシートであること
-
カテゴリーの自動振り分け機能の利用にはOpenAIのAPI keyが必要です(有料)。
-
API keyは実行ファイルのあるディレクトリにkeyというファイルを作成してその中に記述してください。
-
API keyが設定されていない場合、自動振り分けは未割当となります。
OCRに利用できるサンプル画像はプロジェクトのルートディレクトリ直下のimagesフォルダ内に配置されています。
家計簿データを保存するJSONファイルについては同じくルート直下のdataフォルダに配置されます。
Tesseractに利用する学習データについては、src/main/resources/adv1b/group06/kakeibo/traineddataに配置されているため、個人の環境で学習データをダウンロードして環境変数を通す必要はないです。
IntelliJ IDEAでプロジェクトをインポートします。その後、File>Project Structure>Project Settings>Artifactsで設定画面を開きます。
+マークを押して、JAR>From modules with dependencies...を押して、Main ClassにはKakeiboを設定します。
Jar files from librariesはextract to the target JARを選択してOKを押します。Applyしてから設定画面を閉じます。
Build>Build Artifacts...>Kakeibo:jar>ReBuildを実行すると、out\artifacts\Kakeibo_jar\Kakeibo.jarが生成されます。
通常のjarファイルと同様java -jar Kakeibo.jarで起動できます。