2026年11月16日の開発日記 - 所得税の申告書をA4の見た目で描き、書籍の計算例をExcelブックに起こし続けた日
2026年11月16日の開発日記
夕方、Windows の前を離れて、iPad から作業を見ていた。 判断のフォームも、ブックの見た目も、ふだんは Chrome に出してもらっている。 iPad からはそれが見えないので、「ターミナル上に出して」と頼んだ。 同じお願いを、この日は3つのセッションで繰り返した。
この日のログは28本あり、そのうち22本が excel-books(Excel の参照をたどるビューアー)のリポジトリだった。 所得税の申告書、税と社会保険の計算モジュール、書籍の計算例と、どれも Excel のブックを起こして画面で確かめる作業である。 朝に頼んだ「開く、切り替える、乗せるの待ちを1秒以内に」という目安だけは、その日のうちに届かなかった。
今日のタイムライン

今日やったこと
1. 所得税の申告書を A4 の様式の見た目で描く
excel-books の所得税ブックに、「申告書の見た目(A4)」へ切り替える表示を足した。 第一表と第二表の試作では、Claude Code に正解の表と照らすテストを書かせ、A4 の枠 1123px に中身の下端 1034px で収まった。 試作を見て「決算の申告書っぽくなってて非常に良い」と返し、決算書へ進めた。 決算書は横向きの A4 で、4ページ(貸借対照表)までできた。 残りの事例は3つのセッションに分け、CPU を測りながら1本ずつ立ち上がった。
消費税の付表では、ブックにすでにある付表4-1と5-1のまま描く案が推奨として出てきた。 年度ごとに版を合わせればいいのではと聞くと、その推奨は取り下げられた。 付表は、事例の課税期間に合う版(付表4-3と5-3)で描くことになった。
主な成果:
- 第一表と第二表を A4 の見た目で試作し、正解の表と照らすテストを付けた
- 青色申告決算書を横向きの A4 で4ページ(貸借対照表)まで描いた
- 参考書の記載例12件を Excel ブックにした(収支内訳書2件と合わせて14ブック)
- 青色申告の弁護士の事例は、付表を課税期間に合う版にして10様式すべてそろえた
- 未了は、決算書3ページの書き方の判断1件と、令和2年分の消費税だけの事例で 254,545 円が「255」と出る表示の2つ
詳細: 所得税の確定申告書をA4の様式の見た目で描く:第一表と第二表の試作から、青色申告決算書、収支内訳書、消費税の付表まで事例ごとに広げる
2. 税と社会保険の計算モジュールに簡易版(1人版)を足す
税と社会保険の計算モジュール(Excel のブック)に、簡易版(1人版)を足した。 給与所得の A1 から老後の医療介護の A8 まで、論点ごとに1冊ずつ Claude Code に作らせた。 A1 の簡易版を見て、前提のシートの説明文(「青は手入力」など)は書かなくていいと伝え、妻を足すよう頼んだ。
A4 では、国保の「前年の所得」が総所得金額なのか所得控除後の値なのか、シートからはっきりしなかった。 その計算を入れるよう頼み、新しいセッションで部品を切り出させた。 A4 と A8 には、前年の所得を収入から計算する行が入った。 労働保険を入れるかは迷い、別のモジュールにするかは次の計画書の判断に回った。
主な成果:
- 簡易版を A1 から A8 まで論点ごとに1冊ずつ作った
- 部品を切り出し、A4 と A8 で前年の所得を収入から計算する形にした
- 別のセッションのコミットに A8 の登録の2行が
bookThemes.tsごと入り、HEAD がビルドできなくなった。A8 をコミットして直った
詳細: 税と社会保険の計算モジュールに簡易版のExcelブックを足す:前提シートの説明文を消し、国保の「前年の所得」を収入から計算する
3. 書籍の計算例を Excel ブックに起こす
本の計算例を Excel ブックに起こす作業を、5つのテーマで進めた。 ファイナンスの参考書は、61ブックを載せ終えた。
資本連結のブックでは、土地の評価差額が連結精算表に残って見えた。 調べさせると、連結修正のロジックは正しかった。 資産の側の行に「土地の評価差額」という名前を付けていたのが原因で、数字の照合では名前の誤りを見つけられず、テストを通ってしまっていた。 S社の資産を土地とそれ以外に分けるよう提案し、土地のある10冊に当てさせた。
リアル・オプションの専門書は、移植と、本文だけから書いた2つ目の実装を突き合わせさせた。 決定的な検査393個がすべて本の値と一致し、最初の2ブックを組ませたところで止めている。
主な成果:
- ファイナンスの参考書を61ブック載せ終えた
- 資本連結の「残って見えた評価差額」は行の名前の誤りと分かり、土地のある10冊で S社の資産を分けた
- 会計帳簿の体系のブックは、チェックのシートを非表示にし、総勘定元帳に取引ごとの残高の列を足した
- 書き起こしで使い捨てにされていた帯に切るスクリプトを、上限つきの共通の道具に移させた
詳細: 書籍の計算例をExcelブックに起こす:評価差額が連結に残って見えた理由と、リアル・オプションの検算
4. ビューアーの読み込みを測る、書籍の配布 Excel を集める
excel-books の高速化を、「開く、切り替える、乗せるの待ちが1秒以内」という目安で頼んだ。 トレースを取らせると、dev のモジュール662本の読み込みに約1.2秒、冊を返す API に0.16秒かかっていた。 青い点の計算をシートごとにし、2つの集める処理を量に比例する形にし、冊を先読みさせた。 それでも締めの報告では、自分の Chrome で1秒以内に届いたページはまだ無かった。 残った待ちは dev 全体のモジュールの読み込みと計算と描画で、判断の画面で「触らない」「止める」と決めた種類だった。
配布 Excel の収集では、別のセッション経由で許可を出しても、収集のセッションはフォームを送らなかった。 そのセッションに直接「送信の手前まで入力して」と頼んだ。 旧版と新版でパスワードが違うらしい本は、わからないものとしてパスすると決めた。
主な成果:
- トレースで、待ちの大半が冊の API ではなく dev のモジュールの読み込みにあると切り分けた
- 計算の単位をシートごとにし、冊の先読みを入れた
- 配布 Excel の取得状況を本ごとに記録した
詳細: Excel ビューアーの読み込みをトレースで測って直す:1秒の目安と、書籍の配布 Excel の収集
5. ローカル会計アプリの記事、モニターの拡大率、自炊した本の取り込み
ローカル会計アプリのリポジトリを、clone せずに読んでもらった。 帳簿の持ち方と暗号化を記事にまとめ、e-Tax の話も書き足して本番へデプロイした。 デプロイは合計924.5秒だった。 メモリを64GBに増やしても速くはならないが、100%に張り付かずにビルドが通るようになった。 個人の申告を e-Tax 側で扱えないかという話から、e-Tax の仕様を分析するリポジトリとセッションを別に立ち上げてもらい、午後の申告書の計画につながった。
別表を大きく見るために、もっと大きな4Kモニターが要るかを考えた。 27型の4Kだけ、拡大率を150%から125%に下げてもらった。 最初に変わったのは全モニター共通のカスタム スケーリングで、意図と違うと伝えて、そのモニターだけの設定に直してもらった。 いま見えている範囲は、検討中の大きなモニターを125%で使ったときと同じになるので、この範囲で別表が足りるかを確かめる。
自炊した本は、昼に Dropbox の連番フォルダへ3冊を入れた。 分割されていた1冊は、434ページと2ページを結合して436ページにした。 午後にスキャンした4本のうち2本は新しい本で、OCR をかけて蔵書DBに登録した。 残りの2本は既存の本の再スキャンで、1冊は欠けていた4ページを差し込み、もう1冊は既存のままにした。
ほかに、X で見た練習についての投稿から、コツと教材づくりについての随筆を1本書いた。
詳細: ローカル会計アプリ trebuchet は帳簿をどう保存し、なぜ暗号化しているのか
今日の試行錯誤
| # | テーマ | 試したこと | 結果 | 気づき |
|---|---|---|---|---|
| 1 | 申告書(13:13) | 第一表と第二表を試作し、Chrome で A4 に収まるか測らせた | 縦書きの欄名がはみ出し、⑰と⑱の数字が折り返した。改行の指定と幅 22px の列の詰めではみ出しが消えた | はみ出しの元は縦書きの欄名と細い列だった |
| 2 | 申告書(14:39) | 横向きの決算書をわざと壊すテストで確かめさせた | 資産の並びを逆にする壊し方では落ちず、名前と値をずらす壊し方に変えた | 名前と値が一緒に動く壊し方では、落ちないのが正しい動き |
| 3 | 申告書(16:18) | 参考書の記載例12件を Excel ブックにさせた | 試作の2件目のコミットが Codex のゲートで止まった(扶養親族の所得要件が式から抜けていた)。式を直してコミットさせた | コミット時の Codex レビューが式の抜けを拾った |
| 4 | 申告書(17:12) | 消費税の付表を、ブックにある付表4-1と5-1のまま描く案が出た | 年度ごとに版を合わせればと聞くと案が取り下げられ、付表4-3と5-3で10様式すべてできた | 前提を聞き返して推奨が変わった |
| 5 | 申告書(17:20) | iPad で見るためにスクリーンショットを撮らせた | 右端と下端が切れたが、表示の崩れではなかった(枠 1036px より横の紙 1123px が広い)。幅 2400 と高さを広げて撮り直させた | 見切れは、表示の枠と紙の幅を先に見る |
| 6 | 計算モジュール(15:57) | A3、A4、A7、A8 の簡易版を作ってコミットさせた | A7 で「▲15,000,000」が #### になり、年の列を広げた。別のセッションのコミットに A8 の登録の2行が入って HEAD がビルドできなくなり、A8 をコミットして直った | 共有のファイルにある自分の行は、相手のコミットに入りうる |
| 7 | 計算モジュール(17:16) | 部品を切り出し、A4 と A8 の前年の所得を収入から計算させた | 形だけを確かめるテストを A3 の値との突き合わせに差し替えた。Chrome DevTools MCP が3回続けて接続できず、headless の Playwright に切り替えた | DevTools が繋がらない日は Playwright で代えた |
| 8 | 書籍の Excel 化(08:01) | 総勘定元帳に取引ごとの残高の列を足させた | 最初は貸方残高が ▲ で出た。空欄の判定を日付でするように、残高は勘定の側から見てプラスで出るように直させ、27勘定で合計残高試算表と一致した | 残高は勘定の側から見てプラスで出す |
| 9 | 書籍の Excel 化(12:49) | 連結精算表に残って見えた土地の評価差額の原因を調べさせた | ロジックは正しく、資産の側の行の名前が原因だった。土地のある10冊で S社の資産を土地とそれ以外に分けた | 数字の照合だけのテストは、行の名前の誤りを素通りする |
| 10 | 書籍の Excel 化(16:24) | 2つ目の実装に渡すページを切り抜かせた | 端にコードの行が入り込み、枠線で検出しても2ページで漏れた。縦の線で検出する形にして消えた | 枠線ではなく縦の線を手がかりにした |
| 11 | 高速化(10:29) | 計測用のタブで再読み込みを繰り返し測らせた | タブが外から2回閉じられ、同じタブの中で iframe を使って測る形に切り替えた | 計測を同じタブの中に収めた |
| 12 | 配布 Excel(11:42) | 別のセッション経由でフォームの送信を許可した | 送られず、このセッションで直接、送信の手前までの入力を頼んだ | 外へ送る操作は、そのセッションで直接 OK を出す |
今日の学び
- テストが数字の照合だけだと、行の名前の誤りは素通りする。評価差額が残って見えた件は、ロジックではなく資産の側の行の名前が原因だった。
- わざと壊して落ちるかを確かめるテストでは、名前と値が一緒に動く壊し方だと落ちないのが正しい動きになる。名前と値をずらす壊し方を選ぶ。
- 同じリポジトリで別のセッションが動いていると、共有のファイルにある自分の行が相手のコミットに入り、HEAD がビルドできなくなることがある。
- 別のセッション経由の許可では、最初の指示で禁じたことは外れなかった。外へ送る、取り消しのきかない操作は、そのセッションで直接 OK を出す必要があった。
明日やること
- 決算書3ページの書き方の判断1件を決める
- 令和2年分の消費税だけの事例で、254,545 円が「255」と出る表示を直す
- 労働保険を別のモジュールにするかを、次の計画書で決める
- リアル・オプションの専門書の3ブック目から組ませる