﻿========================================================================
  税務ツールキット  Version 1.1.0
========================================================================

  ソフト名     : 税務ツールキット
  バージョン   : 1.1.0
  作 者        : highdefinitionaudiodriver
  動作環境     : Windows 10/11, macOS 12+, Linux / Python 3.10 以上
  ライセンス   : MIT License（フリーソフト／オープンソース）
  種 別        : フリーソフト
  作成日       : 2026-06-03

------------------------------------------------------------------------
■ ソフトの説明 / 使用方法（README より）
------------------------------------------------------------------------

確定申告統合ランチャー — Tax Toolkit

> 3 つの兄弟ツールを 1 つの GUI ウィザードで一気通貫実行するランチャー。
> 個別ツールを覚えて手打ちする必要がなくなり、確定申告書類を 1 つのウィンドウで作成できます。


[1] receipt-ocr-tool       レシート画像 → CSV
       ↓
[2] selfmed-tax-tool       購入履歴 CSV → 対象医薬品の Excel
       ↓
[3] pdf-autofill-cli       明細書 PDF 自動入力
       ↓
   税務署提出用 PDF 完成



---

🎬 デモ

<!-- docs/demo.gif に「レシートOCR → セルフメディケーション抽出 → PDF自動入力」までの30秒デモGIFを配置してください。 -->

---

🎯 これは何？（30秒で）

- 誰のため：3 つの個別ツール（receipt-ocr / selfmed-tax / pdf-autofill）を毎年手打ちで実行している個人／税理士補助
- 何が解決される：3 ツール × 別 CLI × 出力ファイル受け渡しの手作業を、1 つの GUI ウィザードで順次自動化。各ステップの出力がワークスペースに集約され、再実行・再開が容易
- なぜ既存ツールではダメか：商用確定申告ソフトはクラウド前提＋月額。本ランチャーは 完全ローカル・3 つの OSS ツールを束ねるだけで、データは外部に出ません
- 使う条件：Python 3.10+、3 兄弟ツールがインストール済み（自動検出可）

💰 想定ユースケース・価格帯

| 用途 | 形態 |
|---|---|
| 個人の確定申告 | 無料（MIT） |
| 税理士事務所向けの一括処理対応 | 応相談 |
| 業界・地域特化カスタマイズ | 応相談 |

---

📦 構成


tax-toolkit/
├── main.py                  Tkinter GUI ウィザード（単一ファイル実装）
├── README.md
├── requirements.txt         依存なし（Python 標準ライブラリのみ使用）
├── LICENSE
├── SECURITY.md
└── CHANGELOG.md


依存

- Python 3.10+ （Tkinter 同梱）
- 兄弟ツールの依存はそれぞれの requirements.txt 参照

---

🚀 使い方

0. 兄弟ツールを揃える

以下の 3 つを同じ親ディレクトリにクローンしておく（自動検出されます）：


your-projects-dir/
├── receipt-ocr-tool/        # https://github.com/highdefinitionaudiodriver/receipt-ocr-tool
├── selfmed-tax-tool/        # https://github.com/highdefinitionaudiodriver/selfmed-tax-tool
├── pdf-autofill-cli/        # https://github.com/highdefinitionaudiodriver/pdf-autofill-cli
└── tax-toolkit/             # このリポジトリ


別の場所に置きたい場合は、環境変数で指定：


$env:RECEIPT_OCR_HOME = "C:\path\to\receipt-ocr-tool"
$env:SELFMED_TAX_HOME = "C:\path\to\selfmed-tax-tool"
$env:PDF_AUTOFILL_HOME = "C:\path\to\pdf-autofill-cli"


GUI 起動前に配置を確認する場合:


python tools\check_setup.py


OK receipt-ocr-tool / OK selfmed-tax-tool / OK pdf-autofill-cli が揃えば、ランチャーから3ステップを実行できる状態です。

1. 起動

GUI モードで起動する場合

python main.py


CLI モードで一括実行する場合
GUIを起動せずに、コマンドライン引数から各パラメータを指定して一括実行（自動化やCUI環境での実行など）が可能です。

python main.py --cli \
  --workspace ./test_workspace \
  --receipts-dir ./receipts \
  --purchase-csv ./amazon_sample.csv \
  --tax-year 2025 \
  --pdf-template ./sample_template.pdf \
  --profile-json ./user_profile.json


CLI オプション一覧：
- --cli: CLIモードを有効化（必須）
- --workspace <path>: 成果物が保存されるワークスペースフォルダ（指定がない場合はデフォルトで ./test_workspace）
- --step <1|2|3>: 特定のステップのみ実行する（指定がない場合は 1〜3 を順に実行）
- --ocr-engine <tesseract|paddle>: Step 1 の OCR エンジン (デフォルト: tesseract)
- --tax-year <year>: Step 2 の対象年度
- --receipts-dir <path>: Step 1 入力となるレシート画像フォルダ
- --purchase-csv <path>: Step 2 入力となる購入履歴 CSV
- --pdf-template <path>: Step 3 入力となる PDF テンプレート
- --profile-json <path>: Step 3 入力となるプロフィール JSON
- --mapping-json <path>: Step 3 入力となるマッピング JSON (任意)


2. セットアップタブ

- 兄弟ツールのパス（自動検出済みなら表示される）
- ワークスペース — 成果物が保存されるフォルダ（例: ~/TaxToolkit）
- Step 1 入力: レシート画像フォルダ
- Step 2 入力: 購入履歴 CSV ＋ 対象年度
- Step 3 入力: PDF テンプレート＋プロフィール JSON＋マッピング JSON（任意）

「設定をワークスペースに保存」を押すと tax_toolkit_config.json が保存され、次回起動時に自動復元されます。

3. 実行タブ

各ステップを個別実行するか、「🚀 すべて順に実行」で 3 ステップ自動実行。

成果物：


ワークスペース/
├── step1_receipts_summary.csv
├── step2_selfmed_result.xlsx
├── step3_filled.pdf
└── tax_toolkit_config.json


4. ログタブ

各 CLI のリアルタイム出力を確認できます。

---

📦 Windows 配布ビルド

購入前に試せる配布物を作る場合は、PyInstaller で releases/ にビルドします。


.\scripts\build_windows.ps1


単一 EXE にまとめたい場合：


.\scripts\build_windows.ps1 -OneFile


生成物：


releases/
└── TaxToolkit/
    └── TaxToolkit.exe


GitHub Releases には releases/TaxToolkit/ を zip 化して添付してください。兄弟ツール本体は同梱せず、README の構成どおり同じ親ディレクトリへ配置してもらう想定です。

---

🔒 セキュリティ・プライバシー

- 完全ローカル動作 — 外部 API への送信なし
- 兄弟ツールも完全ローカル（receipt-ocr の PaddleOCR バックエンドを除く）
- 設定 JSON にはファイルパスのみ保存。個人情報・購入履歴は保存しない
- ワークスペースには CSV / Excel / PDF の成果物がそのまま置かれるため、家族・職場と共有しないこと

---

🛠 トラブルシュート

「receipt-ocr-tool のディレクトリが未設定です」

セットアップタブで該当ツールのパスを設定してください。
3 兄弟ツールが同じ親ディレクトリにあれば自動検出されます。

「コマンドが見つかりません」

兄弟ツール側の requirements.txt を先に pip install してください。
Step 1 で Tesseract OCR の追加インストールが必要なケースもあります（receipt-ocr-tool/README 参照）。

Step 1 が遅い

PaddleOCR エンジンを選んだ場合、初回起動でモデルダウンロードが発生します。
2 回目以降は高速化されます。Tesseract を選べば即起動です。

文字化け

Windows コマンドプロンプトの cp932 エンコーディングが原因のことが多いです。
PowerShell / Windows Terminal の利用を推奨します。

---

🎁 設計判断

- 3 兄弟リポジトリは触らない：各ツールは独立して開発・テスト・配布できる状態を維持
- subprocess で CLI を叩くだけの薄い層：兄弟ツールが更新されてもランチャー側の改修は最小限
- 設定はワークスペースに保存：「年度別ワークスペース」を切り替えるだけで複数年分を独立管理可能
- Tkinter 採用：Python に同梱・追加依存なし・Windows/macOS/Linux で動く

---

🤝 商用利用・カスタマイズ

- 個人利用は無料（MIT）
- 税理士事務所向け一括処理対応・業界特化カスタマイズは応相談
- 連絡先：highdefinitionaudiodriver@gmail.com

<!-- CODEX-CURRENT-STATUS:START -->
現状サマリ (2026-05-25)

- 対象: 確定申告統合ランチャー — Tax Toolkit
- 作業ブランチ: feat/sellable-v1
- README更新時点の参照コミット: f9ba438 docs: Windows配布ビルド手順を追加（PyInstaller実ビルド未検証）
- Python 実行環境向けに requirements.txt を同梱。
- 主要な確認コマンド: python -m pytest または README 記載の Python コマンド
- 次に進めるなら、README 内の利用手順と既存 docs / tests を起点に、未整備の検証手順・引き継ぎメモ・CI 化を補強する。
<!-- CODEX-CURRENT-STATUS:END -->

------------------------------------------------------------------------
■ 動作環境
------------------------------------------------------------------------
  Windows 10/11, macOS 12+, Linux / Python 3.10 以上
  ※ オンライン専用ソフトではありません（ローカル環境で動作します）。

------------------------------------------------------------------------
■ インストール / アンインストール
------------------------------------------------------------------------
  ・本アーカイブを任意のフォルダに展開してください。
  ・詳細な起動手順は上記「ソフトの説明」および同梱の README を参照してください。
  ・アンインストールは展開したフォルダを削除するだけです（レジストリ不使用）。

------------------------------------------------------------------------
■ 転載・再配布について
------------------------------------------------------------------------
  本ソフトは MIT License のオープンソースです。同梱の LICENSE 条文に
  従う限り、自由に利用・改変・再配布できます。
  なお Vector 以外の配布サイトへの無断転載はご遠慮ください。

------------------------------------------------------------------------
■ 免責事項
------------------------------------------------------------------------
  本ソフトの使用によって生じたいかなる損害についても、作者は一切の
  責任を負いません。利用者ご自身の責任においてご使用ください。

------------------------------------------------------------------------
■ 著作権
------------------------------------------------------------------------
  Copyright (c) 2026 highdefinitionaudiodriver
  本ソフトは MIT License の下で公開されています。

------------------------------------------------------------------------
■ 連絡先 / サポート
------------------------------------------------------------------------
  作 者        : highdefinitionaudiodriver
  E-mail       : highdefinitionaudiodriver@gmail.com
  GitHub       : https://github.com/highdefinitionaudiodriver/tax-toolkit.git
  不具合報告・ご要望は上記 E-mail もしくはリポジトリの Issues へ
  お願いいたします。

========================================================================
