ローカル会計アプリ trebuchet は帳簿をどう保存し、なぜ暗号化しているのか

未分類

ローカル会計アプリ trebuchet は帳簿をどう保存し、なぜ暗号化しているのか

g-hayashi/trebuchet は、個人事業主が自分の Mac の中だけで使う会計アプリである。 複式簿記の仕訳から青色申告決算書までを、1つのアプリで作る。 アカウント登録も外部のサーバーもなく、帳簿は暗号化したファイルとして Mac に置き、パスキー(Touch ID)で解錠する。

このリポジトリを、クローンも実行もせずに、GitHub 上の設計文書(ADR)とコードで読んだ。 知りたかったのは、会計帳簿のデータをどういう形で持っているのかと、なぜわざわざ暗号化しているのかの二つである。 読んだのは 2026-11-15 時点の main(コミット d9608815)で、筆者の見立てと断った箇所を除き、以下は文書とコードの記述に基づく。 動かして確かめたものではない。

結論

  • 帳簿は、事業体(帳簿をつける単位)ごとに SQLite のファイルを1本ずつ作って持つ。1本の DB に事業体の ID 列で同居させる形をとらない
  • 仕訳は「仕訳の見出し」と「借方と貸方の行」の2つの表で持ち、金額は円の整数で入れる
  • 仕訳は物理削除しない。訂正や取消をする前の内容は、追記しかできない監査ログの表に残す
  • 試算表、損益計算書、貸借対照表は保存せず、そのつど仕訳から集計する
  • 帳簿の DB と領収書のファイルは暗号化する。その鍵は、パスキーか回復キーがなければ取り出せない形でしかディスクに置かない
  • 暗号化の理由は、ファイルを直接読まれる場面(盗難、バックアップ先の漏れ、同じ Mac で動く別のプロセス)でも中身を見せないためである
  • 代償として、パスキーと回復キーの両方を失うと、バックアップを含めて帳簿は読めなくなり、戻す手段はない
  • 暗号化したバックアップを Dropbox や Google Drive の同期フォルダに置く運用は想定している。帳簿を GitHub やクラウドの DB に置く運用は想定していない

ファイルの置き方

データの置き場所(既定はリポジトリ直下の data/)には、次のファイルができる。

ファイル暗号化中身
auth.sqliteしないパスキーの公開鍵、包んだデータ鍵、セッション(トークンのハッシュ)、認証の記録
registry.sqliteする事業体の一覧、アプリの設定、バックアップの実行記録、AI の設定
tenants/<事業体ID>.sqliteする帳簿そのもの(事業体ごとに1本)
receipts/<事業体ID>/<SHA-256>.trcする領収書やレシートの画像と PDF(1件1ファイル)

帳簿の本体は tenants/ の下にある事業体ごとのファイルで、registry.sqlite は帳簿の内容を持たない。 認証用の auth.sqlite だけは暗号化しない。 解錠する前に読む必要があるからで、その代わりに秘密の値を入れない(入っているのは公開鍵、包んだ鍵、ハッシュ、操作の記録)。

事業体ごとにファイルを分ける理由

Web サービスでは、1つの DB に全利用者のデータを入れ、各表に持たせた利用者の ID 列で区別する形が多い。 trebuchet はこの形をとらない。 ADR 0002 によると、ID 列で区別するとすべてのクエリに条件が必要になり、付け忘れを機械的に防ぐ仕組みがないからである。

ファイルを分けておけば、別の事業体の仕訳はそもそも同じファイルにないので、SQL の条件漏れでは読めない。 帳簿の表に事業体の ID 列が要らなくなり、テーブル定義とクエリも単純になる。 事業体単位のバックアップ、削除、移動も、ファイルの操作で済む。 1回のリクエストで開く事業体の DB は1つだけと決めてある。

帳簿の中身

事業体の DB には、今のスキーマ定義で55の表がある(仕訳、勘定科目、会計期間、取引先、固定資産、請求書、明細の取込、証憑など)。 中心は仕訳の2表で、マイグレーションの SQL から主な列を抜き出すと次の形になる。

-- 仕訳の見出し(1つの仕訳に1行)
CREATE TABLE journals (
  id                  TEXT PRIMARY KEY,
  journal_no          INTEGER NOT NULL UNIQUE,
  date                TEXT NOT NULL,
  fiscal_period_id    TEXT NOT NULL REFERENCES fiscal_periods(id),
  memo                TEXT,
  status              TEXT NOT NULL CHECK (status IN ('active', 'voided')),
  corrects_journal_id TEXT REFERENCES journals(id),  -- 訂正仕訳が指す元の仕訳
  source              TEXT NOT NULL DEFAULT 'manual',
  version             INTEGER NOT NULL DEFAULT 1
  -- created_at, updated_at は省略
) STRICT;

-- 仕訳の行(借方と貸方を1行ずつ持つ)
CREATE TABLE journal_lines (
  id             TEXT PRIMARY KEY,
  journal_id     TEXT NOT NULL REFERENCES journals(id),
  line_no        INTEGER NOT NULL,
  side           TEXT NOT NULL CHECK (side IN ('debit', 'credit')),
  account_id     TEXT NOT NULL REFERENCES accounts(id),
  sub_account_id TEXT REFERENCES sub_accounts(id),
  amount         INTEGER NOT NULL CHECK (amount > 0 AND amount < 1000000000000),
  tax_category   TEXT NOT NULL REFERENCES tax_categories(code),
  tax_amount     INTEGER NOT NULL CHECK (tax_amount >= 0),
  partner_id     TEXT REFERENCES partners(id),
  description    TEXT
) STRICT;

金額は INTEGER の円で、1円以上1兆円未満を CHECK 制約で縛る。 プロジェクトの原則を定めた文書(constitution)は、浮動小数点で金額を計算することも保存することも禁じている。 2つの表は STRICT で、列の型に合わない値を入れるとエラーになる。 借方か貸方かは行ごとの side 列で区別するので、行を増やせば複合仕訳になる。

貸借一致をどこで守るか

借方合計と貸方合計の一致は、DB の制約ではなく、アプリのドメイン層で検証する。 一致しなければ「借方合計と貸方合計が一致しません」というエラーで保存を止める。 DB の側に貸借の不一致を止めるトリガーはなく、一致していない有効な仕訳を洗い出すビュー(v_unbalanced_journals)を置いている。 原則の文書は、一致しない仕訳を永続化層に到達させないことと、この性質をプロパティベーステスト(fast-check)で確かめることを求めている。

仕訳の訂正と取消の扱い

仕訳の誤りの直し方は、年度を締めたかどうかで分かれる(ADR 0003)。

  • 締めていない年度の仕訳は、その場で書き換える。変更前の内容(日付、メモ、行、タグ)と理由を、監査ログの before_json に丸ごと残す
  • 締めた年度の仕訳は書き換えない。今の年度に、元の仕訳を指す訂正仕訳(corrects_journal_id)を起票する
  • 取消は status を voided にするだけで、行は残す

仕訳の削除と監査ログの書き換えは、アプリの規約ではなく DB のトリガーで止めている。

CREATE TRIGGER journals_no_delete BEFORE DELETE ON journals
BEGIN
  SELECT RAISE(ABORT, 'journals cannot be deleted');
END;

CREATE TRIGGER audit_log_no_update BEFORE UPDATE ON audit_log
BEGIN
  SELECT RAISE(ABORT, 'audit_log is append-only');
END;
-- audit_log の DELETE も同じ形で止める

仕訳の変更と監査ログへの追記は、同じトランザクションで行う。 ADR は、電子帳簿保存法の訂正と削除の履歴の要件を、この履歴の保持で満たす方針だとしている(法令の解釈そのものは ADR の対象外と断っている)。

試算表と決算書の出し方

試算表、損益計算書、貸借対照表は、保存も編集もせず、仕訳から導出する。 家事按分や少額減価償却資産の償却も、決算書の出力だけで調整しない。 年度末の日付の仕訳として、利用者が確かめてから登録する(ADR 0005)。 こうすると、決算書、帳簿の損益計算書と貸借対照表、事業主貸の残高の三つが、同じ仕訳から出るので一致する。

暗号化の仕組み

SQLite のドライバーには better-sqlite3-multiple-ciphers を使う。 better-sqlite3 と同じ API で、SQLCipher 方式の暗号を持つ。 DB を開いた直後に PRAGMA cipher='sqlcipher' と PRAGMA key で鍵を渡し、ファイル全体を暗号化する。

鍵の中心にあるのはデータ鍵(DK)という32バイトの乱数で、DB ごとの鍵はすべてここから作る。 鍵の関係は次のとおりである。

データ鍵(DK): 32バイトの乱数。初回の設定で1回だけ作り、以後は変えない
  │  ディスクには平文で置かない。解錠中のサーバーのメモリーにだけ持つ
  │
  ├─ HKDF-SHA256 → registry.sqlite の鍵
  ├─ HKDF-SHA256 → 事業体ごとの DB の鍵(事業体の ID を入れて、事業体ごとに別の鍵にする)
  ├─ HKDF-SHA256 → 証憑ファイルの鍵(ファイルごとに乱数の salt を持つ)
  └─ HKDF-SHA256 → バックアップの鍵

DK の保存のしかた(auth.sqlite の key_wraps 表)
  パスキー1本ごとに1行: パスキーの PRF の出力から作った鍵で、DK を AES-256-GCM で暗号化したもの
  回復キーで1行      : 回復キー(160ビットの乱数)から作った鍵で、DK を暗号化したもの

ディスクに残るのは「包んだ DK」だけで、DK そのものはどこにもない。 包みを開く材料は、パスキーの PRF の出力か、利用者が紙に控えた回復キーである。

PRF は WebAuthn の拡張機能で、認証のときに、サーバーが渡した入力に対してパスキーごとに決まった値を認証器が返す。 trebuchet は、パスキーごとに32バイトの乱数をこの入力として保存しておき、返ってきた値から包みを開く鍵を作る。 ADR 0011 の言葉では、鍵の素材は認証器の中にあり、サーバーは認証のたびにしか得られない。 PRF に対応していないパスキーは登録できない。 対応するものとして、README は iCloud キーチェーンや 1Password などのパスキーを挙げている。

解錠は次の順に進む。

  1. サーバーは起動時に auth.sqlite だけを開く。この時点では帳簿を読めない
  2. 利用者がパスキーで認証すると、PRF の出力で包みを開き、DK をメモリーに置く
  3. DK から鍵を導出して、registry.sqlite と事業体の DB を開く
  4. 30分操作がないか、サインアウトすると施錠する。DB を閉じ、DK のメモリーを0で埋めて捨てる

鍵が違うまま DB を開こうとすると SQLITE_NOTADB の例外になり、空の DB として作り直すことはしない。 回復キーは作成時と再発行時に1回だけ表示し、キーそのものもハッシュも保存しない。 回復キーが正しいかどうかは、包みが開けたか(AES-GCM の検証が通ったか)だけで判断する。

パスキーの出力から DB の鍵を直接作らず、間に DK を挟んで包む理由も、ADR 0011 に書いてある。 パスキーの追加や削除、回復キーの再発行は、包みの行の出し入れだけで済み、DB を暗号化し直す必要がない。

証憑のファイル

領収書の画像と PDF は、DB に入れず、1件1ファイルで別に置く(ADR 0014)。 年1,000枚なら年3GB前後、7年で約20GB になるという見積もりがある。 DB に入れると、バックアップのたびにこれを全部写すことになる。

ファイルは AES-256-GCM で暗号化し、事業体の ID と内容の SHA-256 を認証の対象(暗号化はしないが、改ざんを検出する部分)に含める。 別の事業体のフォルダや別の名前に差し替えたファイル、1バイトでも書き換えたファイルは、復号の時点で失敗する。

ファイル名は、平文の内容の SHA-256 そのものである。 ADR は、データの置き場所ではこれでよいと判断している。 ハッシュの名前から漏れるのは、「同じファイルを持つ相手が、利用者もそれを持っているか確かめられる」ことだけである。 置き場所を読める者は DB の大きさや更新日時も読めるので、追加の害は小さいという理由である。 クラウドの同期フォルダへ写すときは、名前を鍵つきのハッシュ(HMAC)に替え、平文のハッシュを見せない。

バックアップの形式

バックアップは .tbk という1つのファイルで、平文の JSON のヘッダーと暗号化した本体からなる(ADR 0007、0011)。 暗号は AES-256-GCM で、ヘッダー全体も認証の対象に含める。 途中で切れたファイルや書き換えたファイルは、復号の時点で失敗する。

ヘッダーには、作った時点の「回復キーで包んだ DK」を入れておく。 そのため、新しい Mac でも、バックアップのファイルと回復キーだけで帳簿を戻せる。 復元はサーバーを止めて行うコマンドで、回復キーは引数ではなく標準入力から受け取る。 auth.sqlite はバックアップに含めないので、復元した後はパスキーを登録し直す。

証憑のファイルは .tbk に入れず、バックアップの置き場所へ増分で写す。 定期バックアップと、家賃などの定期仕訳の自動登録は、解錠している間だけ動く。

なぜ暗号化しているのか

ADR 0011 の書き出しが、そのまま理由になっている。 暗号化を入れる前の版では、帳簿の DB は平文でディスクにあり、守っていたのはサーバーの認証だけだった。 ファイルを直接読まれると(盗難、バックアップ先の漏れ、他のプロセス)、中身が見える。 かといって、DB の鍵をキーチェーン、環境変数、ファイルに平文で置くと、鍵の置き場所が新しい弱点になる。

サーバーの認証が止めるのは、アプリの画面と API を通ってくるアクセスだけである。 ファイルは画面を通らずに読める。 同じ Mac で動く別のプログラムは data/ を直接開けるし、クラウドの同期フォルダに置いたバックアップは Mac の外にある。 ローカルで動くアプリでも、ファイルそのものを守る仕組みは別に要る。

ADR は、検討して退けた案も並べている。

  • DB の鍵をキーチェーンに置く案は、鍵が平文で端末にあり、同じ端末のプロセスが読めるので退けた
  • パスキーで認証だけして DB は平文のままにする案(以前の方式)は、ファイルを読まれたら終わるので退けた
  • パスワードから鍵を作る案(Argon2id など)は、弱いパスワードと保管の負担が生じるので退けた
  • 回復キーのハッシュを保存して照合する案は、DB が見える相手に総当たりの手がかりを渡すので退けた

採った方式なら、鍵を平文で置く場所がなくなる。 サーバーのプロセスが止まれば鍵は消え、次に帳簿を読むにはパスキーか回復キーで解錠し直すしかない。 利用者が覚えておくものや保管しておくものは、回復キー1つに集まる。

なお、リポジトリには、Mac のディスク暗号化(FileVault)が有効な Mac に置く想定の記述もある(証憑の設計の調査メモに「データ場所は利用者の Mac(FileVault)にあり」とある)。

ここからは筆者の見立てで、リポジトリの文書には書かれていない。 FileVault が主に守るのは、電源が切れた Mac のディスクを読まれる場面である。 ログインしている間に同じ利用者の権限で動くプロセスや、Mac の外へ出たバックアップの写しには、基本的に効かない。 アプリ側の暗号化は、そこを埋めていると読める。

クラウドに置く運用は想定しているか

暗号化しているなら、パスキーと回復キーだけを手元に持ち、帳簿のファイルは GitHub やクラウドの DB に置いてもよいのではないか、という疑問が湧く。 文書を読む限り、帳簿をクラウドで扱う運用は想定していない。 Mac の外に出すのは、暗号化したバックアップだけである。

GitHub やクラウドの DB に置く運用

リポジトリの .gitignore は data/、*.sqlite、*.tbk(バックアップ)を除外しており、原則の文書にも、帳簿データを Git にコミットしないと書いてある。 筆者の見立てでは、バックアップのファイルは回復キーがなければ開けないので、暗号の上では公開の場所に置いても中身は読めないはずである。 ただし、ヘッダーは平文で、作成日時や Mac の ID が見える。 差分ではなく毎回まるごとのファイルなので、Git に入れると履歴が膨らむ一方になる。

Turso のようなクラウドの DB も外している。 SQLite のドライバーを選んだ ADR 0001 は、Turso のクライアント(@libsql/client)を検討し、非同期の API でトランザクションの扱いが複雑になることと、リモートとの同期が要らないことを理由に退けた。 原則の文書は、アプリとデータを利用者の Mac で動かして保存し、ホスティングはしないと定めている。 証憑の ADR も、他社のクラウドに保存する案を、この原則に反するとして退けている。

ここも筆者の見立てだが、仕組みの上でも合わない。 この暗号化は、Mac の中でファイルを開くときに鍵で復号する方式である。 クラウドの DB にクエリを実行させるには、サービスの側が鍵を持つ必要があり、鍵を平文で置かないという前提が崩れる。

Dropbox や Google Drive へのバックアップ

想定しているのはこちらで、バックアップの置き場所に Dropbox や Google Drive の同期フォルダを指定する運用である。 ADR 0007 は、置き場所として外付けのドライブやクラウドの同期フォルダを挙げ、そこが漏れても読めないようにすることを暗号化の目的にしている。

書き出しはアプリが自動で行う。

  • 動いている間は1時間ごとに確認し、前回の確認から24時間以上たっていれば、帳簿の中身のハッシュを前回と比べる。変わっていれば書き出し、変わっていなくても保存先に前回のファイルがなければ書き直す
  • 世代は、直近30日は日ごとに最新の1つ、それより前は月ごとに最新の1つを残し、7年より古いものは消す
  • 仮の名前で書いて読み戻し、復号と検証が通ってから正式な名前に変える
  • 最後の確認から48時間たったときと、直近の書き出しが失敗したときは、画面の上部に知らせる

運用では、次の点に注意が要る。

  • 保存先の既定はリポジトリ直下の bak/ である。Mac を失うとバックアップも失うので、同期フォルダに変えておく(README)
  • 書き出しは解錠している間だけ動く。帳簿も解錠している間しか変わらないので、使った日に取れていれば足りる
  • 証憑のファイルは、本体とは別に同期フォルダの trebuchet-receipts/ へ増分で写る。年3GB前後という見積もりなので、同期サービスの容量を見ておく
  • 復元には、バックアップのファイル、証憑の写し、回復キーの3つが要る。回復キーを同じクラウドに置くと、暗号化の意味が薄れる。README は、回復キーを紙に書いて Mac とは別の場所に保管するよう求めている
  • 復元は、アプリの版(DB の構造を更新するマイグレーションの適用数)が今のアプリと完全に一致するバックアップしか受け付けず、古くても新しくても拒否する。アプリを更新した後に古いバックアップを戻すには、当時のコミットで復元してから新しい版で起動し直すことになると思われる(この手順は文書になく、筆者の推測である)

申告の提出は何を前提にしているか

trebuchet は e-Tax での申告を前提にしているが、e-Tax への送信はしない。 決算処理の仕様には、青色申告決算書(一般用)の各欄の値を作り、利用者が e-Tax へ転記できるようにすると書いてある。 要件の文書では、国税庁の確定申告書等作成コーナーへの転記用と位置づけている。

  • 決算書の値は画面、印刷、CSV で示し、e-Tax には利用者が手で転記する
  • e-Tax に取り込める形式(XML や CSV)での出力は、利用者に確認したうえで範囲外にしている
  • 青色申告特別控除(65万円、55万円、10万円)は、要件のチェックリストに利用者が年度ごとに答えて決める。「期限内の e-Tax 送信または優良な電子帳簿保存」を満たさないと答えると、上限は55万円になる。e-Tax で送信したかどうかを、システムの側では確かめない

e-Tax に取り込める経路

民間のソフトが e-Tax の形式(拡張子 .xtx)で申告データを書き出せば、個人でも e-Tax に取り込んで送信できる。 国税庁の FAQ(令和7年10月31日作成)による経路は次のとおりである。

経路民間ソフトの .xtx
e-Taxソフト(ダウンロード版)インストールと初期設定のあと、組み込み、電子署名、送信の順に進む
e-Taxソフト(WEB版)事前準備セットアップと利用者情報の登録のあと、「作成済みデータの利用」から読み込んで送信する
確定申告書等作成コーナー取り込めない。決算書は作成コーナーで入力し直すか、書面で提出する

trebuchet は .xtx を出さないので、どの経路にも乗らない。 決算書の数字は、作成コーナーで入力し直すことになる。

e-Tax の側にあるチェック

e-Taxソフトの操作マニュアルによると、手入力では、必須項目に入力漏れがあると「OK」を押した時点でエラーになる。 自動で計算される欄の結果を手で書き換えると、申告データの状態に「手計算あり」と表示される。 署名のときには署名前チェック、署名の要らない手続では送信前チェックが走り、エラーなら状態に表示される(何を検査するかまでは、この章に書かれていない)。 組み込んだデータは帳票の一覧で中身を表示でき、署名と送信は別の操作である。

金額そのものが帳簿と合っているか、計算が正しいかを e-Tax の側で保証する仕組みは、読んだ範囲では見当たらなかった。

XML スキーマで形式を検査する

自前で .xtx を作る場合は、国税庁の e-Tax 仕様書一覧で公開されている XML スキーマを使える。 ダウンロードは CAB 形式(約9.4MB)で、展開すると XML スキーマ定義(拡張子 .xsd)のファイルが約1万7千個出てくる(2026-11-16 に筆者が取得して確かめた)。 所得税の申告の手続のスキーマ(shotoku/RKO0010-250.xsd など)が、申告書や青色申告決算書(KOA210)など帳票ごとのスキーマを読み込む構造になっている。

.xtx をこのスキーマで検証すれば、要素の並び、型、必須の要素といった形式の誤りは送信前に見つけられる。 ただし、スキーマは計算の正しさを表せないので、所得や税額の計算が合っているかの検査にはならない。

代償と注意点

  • パスキーと回復キーの両方を失うと、バックアップを含めて帳簿は読めない。データを外部に預けないので、運営側で戻す手段もない(README)
  • PRF に対応したパスキーが必要で、対応しない認証器は登録の時点で断られる
  • 30分操作しないと施錠され、施錠中は定期バックアップと定期仕訳の自動登録も止まる
  • 証憑の画像を外部の AI に読ませる機能は、利用者が別に有効にしたときだけ動く。画像は口座番号や名前を伏せられないので、有効にするとそのまま外部に出る。原則の文書はこれを、外部に送る情報を最小限にしてマスクするという原則の例外として明記している

読んだ文書

e-Tax について参照した国税庁のページは次のとおり。

#会計ソフト#SQLite#暗号化#パスキー#WebAuthn#複式簿記#青色申告