概要

これはTataruBookのサポートファイルです。

TataruBookとは？

TataruBookは、SQLのテーブルとビューに基に、コマンドラインで実行され、容易化された複式簿記を使用した個人あるいは家族向けの簿記および金融収益計算ツールです。このツールを使って、資産やアカウント名、取引の詳細などのデータをデータベースファイルに入力し、純資産や分類された収支、ROI（投資収益率）などのさまざまな統計データを計算できます。

どうやってダウンロードやインストールする？

２つの方法があります:

（推奨）まずPython 3.8 以上のバージョンをインストールし、次にGithubリポジトリまたはGiteeリポジトリからtatarubook.pyというスクリプトをダウンロードし、python tatarubook.pyというマンドで実行します。この方法では、Pythonを対応しているすべてのオペレーティングシステムで使用できます。
GithubまたはGiteeのリリースからtatarubook.zipというパッケージをダウンロードし、任意のフォルダーに展開してからtatarubook.exeというプログラムを実行します。この方法では、Python をインストールする必要はありませんが、Windows 10以降のオペレーティングシステムでのみ動作します。

TataruBookはコマンドラインプログラムです。Windowsでtatarubook.exeプログラムを直接ダブルクリックすると、黒いウィンドウが一瞬表示され、その後は何も起こらないことがあります。コマンドラインプログラムを実行する正しい方法は、まずコマンドラインターミナルを開き (Windowsではcmd.exeというプロンプトを実行する)、次にプログラム名やサブコマンド、引数を入力 (または貼り付け) します。

１つ目の方法が推奨される理由は、この方法でtatarubook.pyを実行すると、最新のPythonインタープリターやSQLiteなどの依存ライブラリがランタイムがランタイム環境で直接使用され、ディスク容量をほとんど消費しないためです。２つ目の方法では、PythonインタープリターやSQLite、およびその他の依存ライブラリがダウンロードされ、ディスク容量を使用しますが、これらのライブラリがランタイム環境で欠落している場合でも、 TataruBookソフトの動作には影響がありません。

注：２つ目の方法でこのソフトウェアをインストールした後は、tatarubook.exeを実行する際に、zipパッケージ内の他のファイルが必要になります。したがって、tatarubook.zip内のすべてのファイルを同じフォルダーに展開し、フォルダー内の構造をzipパッケージ内と同じに保ってください。

TataruBookを簿記に使うには？

まずいくつかの概念を理解する必要があります:

TataruBookは単なるプログラム (技術的には Python スクリプト) であり、財務データ自体は含まれていません。すべてのデータは、ユーザーが命名した拡張子が.dbのデータベースファイルに保存されます。TataruBookは、コマンドラインで指定されたデータベースファイルを操作します。

データベースファイルとは?

TataruBookのデータベースファイルは、財務データと関連する財務諸表を保存するファイルです。各データベースファイルはSQLiteファイル形式で保存されており、SQLite形式を対応している任意のソフトウェアで検索や編集が可能です。

TataruBookが生成したデータベースファイルを他のソフトウェアで検索や編集するには、そのソフトウェアが SQLiteの新機能の一部 (たとえば　STRICT 属性) に対応している必要があります。たとえば、 DB Browser for SQLiteでデータベースファイルを操作する場合、STRICT属性をサポートするDB Browser for SQLiteのナイトリーバージョンを使用する必要があります。

注：他のソフトウェアでデータベースファイルを変更する際は、記録の追加、削除、変更のみが可能であり、テーブルやビューの定義を変更することはできません。そうしないと、TataruBookでそのデータベースファイルを正しく操作できなくなる可能性があります。

通常、ユーザーやその家族、または組織の過去の財務データは、すべて同じデータベースファイルに保存されます。このデータベースファイルには、すべての内部アカウントがポートフォリオ（portfolio）として扱われ、そのポートフォリオの純資産、収益率、キャッシュフローを示す財務諸表がいくつ含まれています。したがって、統計に含めるアカウントデータはすべて同じデータベースファイルに保存する必要があります。 TataruBookは異なるデータベースファイル間の計算をサポートしていません。

一部のユーザーは、毎年の財務データを個別のデータベースファイルに保存するなど、期間ごとに財務データを分割していますが、TataruBookでは、任意の期間 (日単位) の財務諸表を表示できるため、この操作はふようです。すべての過去の財務データを１つのデータベースファイルに保存すると、一貫性のある正確な財務記録を維持できるだけでなく、新しいデータベースファイルを作成し各アカウントの残高を入力する手間も省けます。

どこから始めればいいでしょうか?

TataruBookを初めて使用する場合は、まずクイックスタートを確認してください。クイックスタートでは、簡単な使用例から詳細な使用例までを取り上げ、初心者がTataruBookの主な使用方法を理解できるようにします。

テーブルとビューでは、データベースファイル内のすべてのテーブルやビュー、およびそれらに関する情報を説明します。特定のテーブルまたはビューのフィールドに疑問がある場合は、このドキュメントを参照してください。

コマンドマニュアルでは、TataruBookのすべてのコマンドの使用方法と注意事項について説明します。

既存のビューでは不十分だと感じ、SQL言語の使用方法を知っている場合は、SQLite 形式を対応している他のソフトウェア (SQLiteの最新機能の一部を対応していることを確認してください) でデータベースファイルを開き、自分で作成したSQLステートメントを使用してデータを検索および編集できます。ただし、既存のテーブルとビューの定義は変更しないようにしてください。

投資者にとって、ROIは大きな関心事であり、 TataruBookにはROIを示すビューがいくつか存在します。収益率の計算方法さまざまな収益率の計算方法と、それをTataruBookのビューでどのように使用するのかを詳しく説明します。

外部データのインポートの効率化は、実際の簿記における重要な問題です。データインポートガイドでは、効率的なデータ処理およびインポートの方法を参考になる情報を提供します。

質問やニーズをどのようにフィードバックすればいいでしょうか?

GithubまたはGiteeリポジトリのissuesを通してフィードバックしてください。拝読の上、返信させていただきます。