MAS-025: 予算vs実績差異分析（41_trn_budget ベース）

概要

目的

41_trn_budget の予算データと 42_trn_journal の実績データを科目・月次で突合し、差異額・差異率を新規タブ 66_pl_budget_variance に出力するレポートビルダーを新規実装する。

MAS-001（65_pl_variance）は「直近の確定実績 vs 当初計画（dmIngestPlanData_ で生成される計画値）」を比較する着地見込み・承認漏れ検出ベースの差異分析であり、予算策定→PDCAサイクルの主要ツールである「正規予算（41_trn_budget の入力データ）vs 実績」の比較は未実装であった。本案件はこのギャップを埋めるもので、独立した出力タブ 66_pl_budget_variance に予算/実績/差異額/差異率の 4 行 × 全科目を出力する。

BudgetRepository が未実装であるため、200_data/202_repository.js への追加も本案件のスコープに含める。

現在のコード

修正方針

3 Step 構成で実装する。

Step 1 — BudgetRepository 追加（200_data/202_repository.js 末尾、L351 の直後）

OrderRepository（L107-146）と同一パターンで実装する。

• _getSheet(): Utils.getSheetByKey('TRN_BUDG', '41_trn_budget')（システムキー登録済を活用）
• findAll(): readSheetAsDtos_(BudgetRepository._getSheet()) を呼び、{ headers: string[], dtos: BudgetDTO[] } を返す
• save() / append() は本案件では実装不要（読み取り専用）

有効フラグ のフィルタは Repository 層では行わず、呼び出し側でスキップする方針（既存 AccountRepository.findAsMap() L323-341 と同パターン）。

Step 2 — レポートビルダー新規作成（600_report/610_datamart_budget_variance.js）

• 関数名: buildBudgetVarianceReport()（公開関数）
• 既存 600_report/ 配下のレポートビルダーは LockService を使用していない（609_datamart_kpi.js 等で確認済）。本案件でも LockService は導入せず、既存パターンに合わせて try { ... } catch (e) { Utils.logError(FUNC, e); throw e; } のみで実装する
• 出力シートのクリア手段は sheet.clear()（書式・条件付き書式を含めて全消去、609_datamart_kpi.js L28 と同パターン）
• 処理フロー:
  1. 予算データ取得 — BudgetRepository.findAll().dtos → 有効フラグフィルタ（flag === false || String(flag).toUpperCase() === 'FALSE' で除外）→ 予算バージョン === '最新予算(V1)' でフィルタ
  2. 予算データ 0 件ガード — getWebSpreadsheet_().toast('予算データが未登録です（バージョン=最新予算(V1)、有効フラグ=TRUE 該当なし）', 'F-25', 5) を表示して return
  3. 対象期間の確定 — フィルタ後予算 DTO から Utils.parseDateToYm(dto['対象年月']) の最小・最大値を求め、{ minYm, maxYm, count } の集計サマリを作成
  4. 実行前確認ダイアログ — SpreadsheetApp.getUi().alert('F-25 予算vs実績差異分析', '予算 ' + count + ' 件（' + minYm + ' 〜 ' + maxYm + '）を集計します。よろしいですか？', SpreadsheetApp.getUi().ButtonSet.OK_CANCEL) を表示し、OK 以外が返ったら return（Webアプリ経由で getUi() が取れない場合は try/catch でスキップして続行）
  5. 実績データ取得 — JournalRepository.findAll().dtos をそのまま使用（JournalEntryDTO には 有効フラグ が定義されていないことを Phase 1 1-3 で確認済。TRN_JOUR の DDL ヘッダー定義 L656 にも 有効フラグ は含まれない。フィルタ不要）
  6. 科目マスタ取得 — AccountRepository.findAsMap()（既存キャッシュをそのまま使用、resetCache() は呼ばない）
  7. 集計 — Utils.parseDateToYm() でキー生成し、科目名×YYYY-MM の 2 段階 Map 構造で budget と actual を加算するピボット集計。予算側は 予算金額、実績側は 税抜金額_実績 を使用。Utils.parseDateToYm が空文字列を返した行（パース不能）は集計対象外
  8. 出力シート取得・クリア — getWebSpreadsheet_().getSheetByName('66_pl_budget_variance') → null なら ss.insertSheet('66_pl_budget_variance') → sheet.clear()（書式含めて全消去）
  9. ヘッダー行書き込み — A=大分類、B=科目名、C=指標、D〜O=4月〜3月（会計年度 12 ヶ月、列ヘッダー値は YYYY-MM 文字列）、P=年度合計
  10. データ行書き込み — 科目ごとに「予算」「実績」「差異額」「差異率」の 4 行を書き込み
• 差異計算:
  • 差異額 = 実績金額 − 予算金額
  • 差異率: 予算金額 ≠ 0 → 差異額 / 予算金額 / 予算金額 = 0 かつ 実績金額 = 0 → 0（数値）/ それ以外 → '-'（文字列）
• 対象年度の決定: buildKpiDashboard（609_datamart_kpi.js）が「P/L 売上高行の末尾非空セル」から境界月を逆算するのに対し、本案件は 予算データそのものから 対象年月 の最小〜最大を取り、該当年度を全カバーする 12 ヶ月 を対象とする。明示的な会計年度設定は行わず、予算の登録範囲＝集計範囲とする（年度跨ぎがある場合は人間検討事項参照）

Step 3 — DDL 登録 ＋ サイドバー UI 追加

3-1. DDL 登録（100_config/101_sys_config.js）

setupAllSchemas 内、PL_VAR（L613）の直後に以下を追加:

if (!existKeys.includes('PL_BUD_VAR')) confSheet.appendRow(['PL_BUD_VAR', '', '66_pl_budget_variance', 'P/L予実差異分析(予算ベース)']);

schemas 辞書には登録しない（書式は buildBudgetVarianceReport 側で sheet.clear() 後に都度設定するため、DDL 管理外として扱う）。

3-2. サイドバー UI 追加（templates/operations_sidebar.html）

「📊 マート更新」セクション（L62-68）の buildKpiDashboard ボタン直下に以下を追加:

<button class="btn" onclick="run('buildBudgetVarianceReport', this)">📊 予実差異分析（予算ベース）を更新</button>

SpreadsheetApp.getUi().createMenu() ベースの GAS 標準メニューは本プロジェクトでは使用していないため、addItem 追加ではなくサイドバー HTML への button 要素追加とする。

影響範囲

注意事項

1. 有効フラグの判定パターン統一 — flag === false || String(flag).toUpperCase() === 'FALSE' で除外する（AccountRepository.findAsMap() L329-330、Utils.normalizePartnerName() L357 と同じパターン）。BudgetDTO は 有効フラグ を先頭フィールド（003_contracts.js L134）として持つので、DTO 経由で安全に取得可能。
2. JournalEntryDTO に 有効フラグ は存在しない — 003_contracts.js の JournalEntryDTO 定義（L97-129）および TRN_JOUR の DDL ヘッダー（101_sys_config.js L656）の両方に 有効フラグ が含まれないことを Phase 1 で確認済。実績データのフィルタは行わない。将来 有効フラグ 列が追加された場合は本仕様の更新が必要。
3. 予算バージョンの複数共存リスク — Constants.SHEET_DEFAULTS の 41_trn_budget エントリ（002_constants.js L74）でデフォルト値 '最新予算(V1)' が定義されているが、ユーザーが手動で別バージョン（例: '当初予算'、'修正予算'）を入力する可能性がある。本仕様ではフィルタ対象を '最新予算(V1)' の完全一致のみとし、複数バージョン対応は将来案件（MAS-002 予算スナップショット/バージョン管理）に委ねる。
4. 収支区分の符号扱いの統一 — BudgetDTO.収支区分（'収入' / '支出'）と JournalEntryDTO.収支区分（同上）はいずれも文字列ラベルであり、金額は両者とも 正値で格納される（既存の P/L マートも金額の絶対値で比較）。差異額計算（実績 − 予算）は単純な数値減算でよい。「収益科目で実績 > 予算 = 良好」「費用科目で実績 < 予算 = 良好」の業務的な解釈は、エッジケースセクションの差異評価方向性の表で示す。
5. Utils.parseDateToYm() の入力形式 — BudgetDTO.対象年月 は 'YYYY-MM' 文字列、JournalEntryDTO.発生日(P/L計上日) は Date 型または文字列。Utils.parseDateToYm()（004_utils.js L92-99）は両方に対応済（Date / 'YYYY-MM' / 'YYYY/MM' / 'YYYY年MM月'）。空値が来た場合は '' を返す → 空キーは集計対象外として扱う必要あり。
6. 科目マスタ未登録時の扱い — 予算 / 実績の 科目名 が 11_mst_account に未登録の場合、本仕様では「未分類」グループに集約せず、集計対象から除外し warning ログを出力（Utils.logInfo('buildBudgetVarianceReport', '科目マスタ未登録: ' + acc)）。既存 dmProcessAllEvents_（602_datamart_main.js L49）は throw する設計だが、レポート系では実行継続を優先する。
7. DDL 管理外シートの追記 — 66_pl_budget_variance は DDL の schemas 辞書には登録しないため、CLAUDE.md の「DDL (setupAllSchemas) で管理されないタブ」一覧への追記が必要。本案件のスコープに含める。
8. SpreadsheetApp.getUi() がない実行コンテキスト — トリガーや Web アプリ経由で実行された場合、getUi() は例外を投げる。確認ダイアログ表示は try { ui = SpreadsheetApp.getUi(); ... } catch(e) { /* スキップして続行 */ } で囲む（setupAllSchemas L580 と同パターン）。

エッジケース

差異評価の方向性（業務解釈ガイド）

本仕様では数値・差異額・差異率の出力までを範囲とし、色分け（条件付き書式）は将来案件として「人間が検討すべき事項」に記載する。

実データ検証

実装前および実装後に以下を MCP（または手動シート確認）で検証する:

• 41_trn_budget の状態確認

  • 有効フラグ=TRUE のレコード件数（バージョン別カウント）。フィルタ後 0 件にならないことを事前確認
  • 予算バージョン の実際の格納値一覧。'最新予算(V1)' との完全一致確認（前後スペースなし、全角半角混在なし）
  • 対象年月 の最小・最大値、および年度跨ぎがある場合の月分布
  • 予算金額 の絶対値合計（予算規模の把握）

• 11_mst_account と 41_trn_budget の科目名突合

  • 41_trn_budget.科目名 が 11_mst_account.科目名 と完全一致するか（全角半角・前後スペースの違いも確認）
  • 不一致がある場合、注意事項 6 に従い該当行は集計対象外として除外（ログ警告で可視化）

• 42_trn_journal の確認

  • JournalEntryDTO 定義に 有効フラグ 列が含まれていないことを再確認（003_contracts.js L97-129、および TRN_JOUR ヘッダー定義 101_sys_config.js L656）
  • 集計対象期間内の 税抜金額_実績 の科目別合計（実績規模の把握）
  • 仕訳ステータス=仕訳振替 のレコードを除外する必要があるかの判断（CLAUDE.md「仕訳振替の判定は === "仕訳振替" の完全一致」ルール参照）。本仕様では当面除外せず、将来要件に応じて対応

• 出力後の検算

  • 全科目の差異額の合算が、 全科目の実績合計 − 全科目の予算合計 と一致すること（集計ロジックのサンクチェック）
  • 単一科目の月別差異額の合計が、その科目の年度合計差異額（P 列）と一致すること

関連ドキュメント

人間が検討すべき事項

docs/_internal/TODO_future.md の MAS-025 行に記載された「人間が検討すべき事項」:

• 41_trn_budget のデータ整備状況 — 本案件の前提として、ユーザー（経営層・経理担当）が 41_trn_budget シートに予算を入力済みであることが必要。実装後に「データ未登録のため使えない」とならないよう、運用開始前に予算入力フェーズの完了を確認すること。

追加で検討すべき事項（実装過程で判明したもの）:

1. 集計対象年度の指定方法 — 本仕様は「予算データの 対象年月 最小〜最大」で動的に決定する設計。代替案として a) 03_sys_params に BUDGET_VARIANCE_FISCAL_YEAR を追加して固定 / b) 実行時ダイアログで「対象年度」をプルダウン選択 / c) 暦年度・会計年度の選択を可能にする、なども検討余地あり。
2. 予算バージョン フィルタ仕様の拡張 — 複数バージョン共存（当初予算 / 修正予算 / 最終予算 など）が必要になった場合、 a) 全バージョン横並び比較レポート / b) 実行時にバージョン選択ダイアログ / c) 03_sys_params で参照バージョンを明示指定、のいずれを採用するか。MAS-002（予算スナップショット/バージョン管理）と統合検討すべき。
3. 66_pl_budget_variance シートの DDL 管理化 — 現在は DDL 管理外（schemas 辞書未登録）。書式パターンが安定したら DDL schemas 辞書に登録して setupAllSchemas で初期化される運用に移行することを推奨。本仕様完了後、運用 1〜2 ヶ月の安定確認をもって判断。
4. 差異セルの条件付き書式（色分け） — 「差異評価の方向性」テーブルに記載した収益/費用ごとの良/悪の色分けを将来案件として実装する余地あり（MAS-001 と同様に 03_sys_params の CFG_VARIANCE_* 閾値を流用可能）。
5. 科目マスタ未登録の警告通知 — 本仕様ではログ出力のみだが、件数が多い場合は実行後トースト通知での集約サマリ表示を追加検討。
6. PJ別 / 組織別の予実差異 — BudgetDTO には PJ名 / 組織名 フィールドがあるが、本仕様では集計次元に含めない（科目×月のみ）。需要があれば 66b_pl_budget_variance_by_pj 等の派生レポートを後続案件として検討。

実装プロンプト（Claude Code 用）

あなたはGAS会計システム(bizlp-gas-accounting)のシニア開発者です。
案件 MAS-025「予算vs実績差異分析（41_trn_budget ベース）」を実装してください。

## 実行前タスク
- `200_data/202_repository.js` を Read し、`OrderRepository` の `_getSheet` / `findAll` の実装（L107-146）を確認する（BudgetRepository 作成のテンプレートとして使用）。`readSheetAsDtos_`（L19）の引数・戻り値も確認
- `100_config/101_sys_config.js` を Read し、`41_trn_budget` のシステムキー `TRN_BUDG`（L604）と、`PL_VAR` 登録行（L613）の正確な位置を確認する
- `templates/operations_sidebar.html` を Read し、「📊 マート更新」セクション（L62-68）の `buildKpiDashboard` ボタンの位置を確認する
- `000_infra/003_contracts.js` を Read し、`BudgetDTO`（L131-149）の全フィールドと、`JournalEntryDTO`（L97-129）に `有効フラグ` 列が含まれないことを確認する
- `600_report/609_datamart_kpi.js` を Read し、`sheet.clear()` パターン（L28）と `try/catch` での `Utils.logError` 呼び出しパターン（L49-52）を確認する
- `000_infra/004_utils.js` を Read し、`Utils.parseDateToYm()`（L92-99）の入力形式と戻り値仕様、`getWebSpreadsheet_()`（L9-15）の挙動を確認する

## 修正対象ファイル
1. `200_data/202_repository.js` — `BudgetRepository` を末尾（L351 の直後）に追加
2. `600_report/610_datamart_budget_variance.js` — 新規作成（番号は既存最大 609 +1 で `610` 確定）
3. `100_config/101_sys_config.js` — `setupAllSchemas` の `PL_VAR` 直後（L613 の次）に `PL_BUD_VAR` の `appendRow` 1 行を追加
4. `templates/operations_sidebar.html` — 「📊 マート更新」セクションの `buildKpiDashboard` ボタン直下に新規ボタン 1 行を追加
5. `CLAUDE.md` — 「DDL (setupAllSchemas) で管理されないタブ」一覧に `66_pl_budget_variance` を追記

## 実装内容

### 1. BudgetRepository 追加（`202_repository.js` 末尾）
`OrderRepository`（L107-146）と同一構造で実装すること:
- `_getSheet()`: `Utils.getSheetByKey('TRN_BUDG', '41_trn_budget')`（システムキー登録済を活用）
- `findAll()` のみ実装（戻り値: `{ headers: string[], dtos: BudgetDTO[] }`）
- `save()` / `append()` は実装しない（読み取り専用 Repository）
- 有効フラグフィルタは Repository 層では行わない（呼び出し側で実施）

### 2. レポートビルダー新規作成（`600_report/610_datamart_budget_variance.js`）
関数名: `buildBudgetVarianceReport()`

処理フロー（既存 `609_datamart_kpi.js` のパターンに倣うこと）:
1. `var FUNC = 'buildBudgetVarianceReport'; try { ... } catch (e) { Utils.logError(FUNC, e); throw e; }` でラップ。`LockService` は使用しない（既存レポートビルダーとの整合）
2. 予算データ取得: `BudgetRepository.findAll().dtos` → 有効フラグフィルタ（`flag === false || String(flag).toUpperCase() === 'FALSE'` で除外）→ `予算バージョン === '最新予算(V1)'` でフィルタ
3. 件数 0 ガード: `getWebSpreadsheet_().toast('予算データが未登録です（バージョン=最新予算(V1)、有効フラグ=TRUE 該当なし）', 'F-25', 5)` → return
4. 対象期間決定: フィルタ後 DTO の `Utils.parseDateToYm(dto['対象年月'])` から最小・最大を計算（空文字列は除外）
5. 実行前確認ダイアログ: `try { var ui = SpreadsheetApp.getUi(); var resp = ui.alert('F-25 予算vs実績差異分析', msg, ui.ButtonSet.OK_CANCEL); if (resp !== ui.Button.OK) return; } catch(e) {}`（Webアプリ経由は try/catch でスキップ）
6. 実績データ取得: `JournalRepository.findAll().dtos` をそのまま使用（`有効フラグ` 列なしのためフィルタ不要）
7. 科目マスタ取得: `AccountRepository.findAsMap()`（既存キャッシュ流用、`resetCache()` 呼ばない）
8. 集計: 科目名 × `Utils.parseDateToYm(...)` の 2 段階 Map で `budget` / `actual` を加算。予算側は `予算金額`、実績側は `税抜金額_実績`。`acctMap[acc]` が undefined の科目はスキップ + `Utils.logInfo(FUNC, '科目マスタ未登録: ' + acc)` でログ警告
9. 出力シート取得: `ss.getSheetByName('66_pl_budget_variance')` → null なら `ss.insertSheet('66_pl_budget_variance')` → `sheet.clear()`
10. ヘッダー行書き込み: A=大分類、B=科目名、C=指標、D〜O=4月〜3月（YYYY-MM 文字列、対象期間に基づき動的算出）、P=年度合計
11. データ行書き込み: 科目ごとに「予算」「実績」「差異額」「差異率」の 4 行（科目名は B 列に予算行のみ表示、他は空欄でグルーピング表現）
12. 数値フォーマット: 予算/実績/差異額は `Constants.NUMBER_FORMATS.CURRENCY`、差異率は `Constants.NUMBER_FORMATS.PERCENT`、文字列 `"-"` のセルはフォーマット適用後も `"-"` 表示
13. 列幅調整: A=120, B=240, C=80, D-O=90, P=100
14. 完了通知: `Utils.toastResult(FUNC, sheetName + ' 再描画完了 (科目=' + accCount + ', 期間=' + minYm + '〜' + maxYm + ')')`

差異計算式:
- 差異額 = 実績金額 − 予算金額
- 差異率: 予算金額 ≠ 0 → 差異額 / 予算金額（数値）/ 予算=0 かつ 実績=0 → 0 / それ以外 → 文字列 `'-'`

### 3. DDL 登録（`101_sys_config.js`）
`setupAllSchemas` 内、`PL_VAR` の `appendRow`（L613）の直後の行に追加:
```js
if (!existKeys.includes('PL_BUD_VAR')) confSheet.appendRow(['PL_BUD_VAR', '', '66_pl_budget_variance', 'P/L予実差異分析(予算ベース)']);
```
`schemas` 辞書には登録しない（DDL 管理外シートとして扱う）。

### 4. サイドバー UI 追加（`templates/operations_sidebar.html`）
「📊 マート更新」セクション（L62-68）の `buildKpiDashboard` ボタン直下に追加:
```html
<button class="btn" onclick="run('buildBudgetVarianceReport', this)">📊 予実差異分析（予算ベース）を更新</button>
```

### 5. CLAUDE.md 追記
「DDL (setupAllSchemas) で管理されないタブ」一覧に `66_pl_budget_variance` を追記する（既存リスト末尾、`78_pj_pl` の後ろ等の適切な位置）。

## 制約
- `202_repository.js` の既存 Repository（OrderRepository / InvoiceRepository / BankTxRepository / JournalRepository / AccountRepository）は変更しない
- 有効フラグ判定は必ず `flag === false || String(flag).toUpperCase() === 'FALSE'` パターンを使用すること（`AccountRepository.findAsMap()` L329-330 と同パターン）
- 列参照はヘッダー名ベース（列番号ハードコード禁止）
- `AccountRepository.resetCache()` は呼ばない（既存動作への影響回避）
- `LockService` は使用しない（既存 600_report/ 配下レポートビルダーとの整合）
- `SpreadsheetApp.getUi()` の例外（Webアプリ経由）は `try/catch` で握りつぶしてダイアログをスキップする
- 出力シートが既存の場合は `sheet.clear()` で書式・条件付き書式まで全消去してから再描画（冪等性）

## エッジケース
| 条件 | 表示値 | 理由 |
|------|--------|------|
| 予算金額=0、実績金額>0 | `"-"` | 差異率が無限大のため表示不可 |
| 予算金額=0、実績金額=0 | `0`（フォーマット適用後 `0.0%`） | 計画通り |
| 予算金額=0、実績金額<0 | `"-"` | 予算外費用、計算不可 |
| 予算データが 0 件（バージョンフィルタ後） | 処理中断・トースト | 未登録ガード |
| 科目が一方のみに存在 | 不在側=0 として計算 | 和集合アプローチ |
| 科目マスタ未登録 | 集計対象外 + ログ警告 | レポート系は実行継続優先 |
| `対象年月` パース失敗 | 該当 DTO を集計対象外 | `Utils.parseDateToYm()` `""` ガード |

## 動作確認
1. `npm run push:dev` で開発用 GAS にデプロイ
2. GAS エディタで `setupAllSchemas` を実行し、`01_sys_config` に `PL_BUD_VAR` 行が追加されたことを確認
3. 操作パネルを開き、「📊 マート更新」セクションに「📊 予実差異分析（予算ベース）を更新」ボタンが表示されることを確認
4. ボタンクリック → 確認ダイアログが「件数」「期間」付きで表示されること
5. OK 押下 → `66_pl_budget_variance` シートが生成され、科目ごとに予算/実績/差異額/差異率 の 4 行が出力されること
6. `予算バージョン` を一時的に変更して 0 件状態を作り、トースト通知で中断されることを確認
7. 2 回連続実行してシートが重複せず上書きされること（冪等性確認）
8. Webアプリ経由（`getUi()` が取れない経路）で実行しても例外で止まらず、ダイアログをスキップして処理が完走することを確認（任意）

### 拡張思考の使用状況
| フェーズ | 拡張思考 | 備考 |
|---------|---------|------|
| BudgetRepository 追加 | なし | OrderRepository パターン踏襲のみ |
| レポートビルダー実装 | あり | ピボット集計ロジック・差異率エッジケース処理の設計 |
| DDL 登録 + サイドバー追加 | なし | 挿入位置特定後は定型作業 |
| CLAUDE.md 追記 | なし | リスト末尾追加のみ |

推奨実行モデル

変更履歴

仕様書作成プロンプト

# F-25: 予算vs実績差異分析（41_trn_budget ベース）
## 概要
## 目的
## 現在のコード
## 修正方針
## 影響範囲
## 注意事項
## エッジケース
## 実データ検証
## 関連ドキュメント
## 人間が検討すべき事項
## 実装プロンプト（Claude Code 用）
## 推奨実行モデル
## 変更履歴
## 仕様書作成プロンプト

あなたはGAS会計システム(bizlp-gas-accounting)のシニア開発者です。
案件 MAS-025「予算vs実績差異分析（41_trn_budget ベース）」を実装してください。

## 実行前タスク
- `200_data/202_repository.js` を Read し、`OrderRepository` の `_getSheet` / `findAll` の実装を確認する（BudgetRepository 作成のテンプレートとして使用）
- `100_config/101_sys_config.js` を Read し、`41_trn_budget` のシステムキーと「📊 レポート」メニューへの追加位置（行番号）を確認する
- `000_infra/003_contracts.js` を Read し、`BudgetDTO` の全フィールドと `JournalEntryDTO` の `有効フラグ` 列の有無を確認する
- `600_report/` 配下の既存レポートビルダーを 1 件 Read し、`LockService.getScriptLock()` の使用パターンと出力シートのクリア手段を確認する

## 修正対象ファイル
1. `200_data/202_repository.js` — `BudgetRepository` を末尾に追加
2. `600_report/60X_datamart_budget_variance.js` — 新規作成（番号は `600_report/` 配下の既存最大番号+1 で確定）
3. `100_config/101_sys_config.js` — 「📊 レポート」メニューへのメニュー項目追加

## 実装内容

### 1. BudgetRepository 追加（`202_repository.js` 末尾）
`OrderRepository` と同一構造で実装すること:
- `_getSheet()`: `Utils.getSheetByKey('{101_sys_config.jsで確認したシステムキー}', '41_trn_budget')`（キー未登録の場合はフォールバック名のみで対応）
- `findAll()` のみ実装。戻り値: `{ headers: string[], dtos: BudgetDTO[] }`
- `有効フラグ` フィルタは Repository 層では行わない（呼び出し側で実施）

### 2. レポートビルダー新規作成（`600_report/60X_datamart_budget_variance.js`）
関数名: `buildBudgetVarianceReport()`

処理フロー（既存レポートビルダーのパターンに倣うこと）:
1. `LockService.getScriptLock().tryLock(3000)` でロック取得。失敗時は toast 表示して return。`try...finally` で `lock.releaseLock()` を確実に実行
2. 予算データ取得: `BudgetRepository.findAll().dtos` → 有効フラグフィルタ（`flag === false || String(flag).toUpperCase() === 'FALSE'` で除外）→ `予算バージョン === '最新予算(V1)'` でフィルタ
3. 件数 0 ガード: `SpreadsheetApp.getActiveSpreadsheet().toast('予算データが未登録です', 'F-25', 5)` → return
4. 実行前確認ダイアログ: 件数と `対象年月` の範囲を整形して `SpreadsheetApp.getUi().alert('確認', msg, SpreadsheetApp.getUi().ButtonSet.OK_CANCEL)` で表示。CANCEL なら return
5. 実績データ取得: `JournalRepository.findAll().dtos` → 有効フラグ列が存在する場合のみフィルタ
6. 科目マスタ取得: `AccountRepository.findAsMap()`
7. 集計: `Utils.parseDateToYm()` でキー生成し、`{ 科目名: { 'YYYY-MM': { budget: 0, actual: 0 } } }` 形式でピボット集計
8. 出力シート取得: `ss.getSheetByName('66_pl_budget_variance')` → null なら `ss.insertSheet('66_pl_budget_variance')` → `sheet.clearContents()`
9. ヘッダー行書き込み: A=大分類、B=科目名、C=指標、D〜O=4月〜3月（会計年度 12 ヶ月）、P=年度合計
10. 科目ごとに「予算」「実績」「差異額」「差異率」の 4 行を書き込み

差異計算式:
- 差異額 = 実績金額 − 予算金額
- 差異率: 予算金額 ≠ 0 → 差異額 / 予算金額 / 予算=0 かつ 実績=0 → 0 / それ以外 → null（セルに "-" を表示）

### 3. メニュー追加（`101_sys_config.js`）
「📊 レポート」メニューの確認済み行番号に `.addItem('予実差異分析（予算ベース）を更新', 'buildBudgetVarianceReport')` を追加

## 制約
- `202_repository.js` の既存 Repository（OrderRepository / InvoiceRepository 等）は変更しない
- 有効フラグ判定は必ず `flag === false || String(flag).toUpperCase() === 'FALSE'` パターンを使用すること
- 列参照はヘッダー名ベース（列番号ハードコード禁止）
- `AccountRepository` のキャッシュをリセットしない（既存動作に影響しないよう、`AccountRepository.resetCache()` を呼ばない）

## エッジケース
| 条件 | 表示値 | 理由 |
|------|--------|------|
| 予算金額=0、実績金額>0 | "-" | 差異率が無限大のため表示不可 |
| 予算金額=0、実績金額=0 | "0.0%" | 計画通り |
| 予算金額=0、実績金額<0 | "-" | 予算外費用、計算不可 |
| 予算データが 0 件 | 処理中断・トースト | 未登録ガード |
| 科目が一方のみに存在 | 不在側=0 として計算 | 和集合アプローチ |

## 動作確認
1. `npm run push:dev` で開発用 GAS にデプロイ
2. 「📊 レポート」>「予実差異分析（予算ベース）を更新」を実行
3. 確認ダイアログが件数・期間付きで表示されること
4. `66_pl_budget_variance` シートが生成され、科目ごとに予算/実績/差異額/差異率 の 4 行が出力されること
5. `予算バージョン` フィルタで 0 件になる場合にトースト通知で中断されること
6. 2 回実行してシートが重複せず上書きされること（べき等性確認）

### 拡張思考の使用状況
| フェーズ | 拡張思考 | 備考 |
|---------|---------|------|
| BudgetRepository 追加 | なし | OrderRepository パターン踏襲のみ |
| レポートビルダー実装 | あり | ピボット集計ロジックの設計 |
| メニュー追加 | なし | 挿入位置特定後は定型作業 |

<details><summary>展開して表示</summary>

（この instruction 全文）

</details>