MAS-115: 財務諸表タブの統合（プルダウン切替方式）

概要

目的

現状、P/L・B/S・CF の財務諸表は 61_pl_monthly / 62_pl_ytd / 63_pl_monthly_plan / 64_pl_ytd_plan / 65_pl_variance / 71_bs / 72_bs_snap / 73_bs_plan / 81_cf_indirect / 81b_cf_indirect_ytd / 82_cf_indirect_plan / 82b_cf_indirect_plan_ytd の 12 タブに分散しており、ユーザーが「今月の実績 P/L を単月で見たい」「計画比で累積 B/S を見たい」といった目的ごとに複数タブを跨ぐ必要がある。スプレッドシート左下のタブ一覧が肥大化し、目的のデータへ到達するまでの操作コストが高い。

MAS-115 では、P/L・B/S・間接法 CF をそれぞれ 1 タブに統合し、タブ内 A1 セルに配置する「表示モード」プルダウンで切替できる UX に変更する。切替は onEdit トリガーで即時に再描画し、12 タブ → 4〜5 タブ（P/L 1 + B/S 1 + CF間接 1 + CF日次 1〜2）へ 60% 以上の削減を目指す。なお日次 CF（83/84/85）は性質が異なるため統合対象外とする。

現在のコード

既存シートと KEY マッピング（600_report/602_datamart_main.js L172-188 および 100_config/101_sys_config.js L609-620 で確認済み）

既存レンダラ関数（600_report/602_datamart_main.js）

isActualOnly フラグの実際の型と挙動

• 型: JavaScript 素の boolean（ctx.isActualOnly = true; L243、計画側は isActualOnly: false L267）
• 参照箇所: 603 L204 / 604 L148 / 605 L57
• 挙動: true のとき filterValues() / filterWithRecalcTotal() で境界月以降を空白に除去し、ヘッダーから「(実績)/(予算)」ラベルを落とす。false のときは全月表示＋ラベル付き

既存の onEdit 定義（100_config/101_sys_config.js L363-413）

• GAS の onEdit は 100_config/101_sys_config.js L363 で単一定義されている（300_ui/301_ui_assist.js には存在しない。同ファイルの handleUxAssist(e) が L412 で呼び出されるだけ）
• 既存分岐は sheetName === e.range.getSheet().getName() と row / col による判定（getA1Notation() は使っていない）
• 既存分岐リスト: (a) Constants.CONFIG_SHEET の key/logic 生成、(b) 36_wrk_bank_import のマッチ方法自動更新、(c) 33_wrk_bank/32_wrk_invoice の仕訳発行後編集監査、(d) handleUxAssist(e) への委譲

メニュー構造の現状（100_config/101_sys_config.js L299-307）

onOpen() は 🚀 BizLP メニュー 1 本のみを生成し、個別のマート更新系ボタンは全て templates/operations_sidebar.html のサイドバーに移設されている。MAS-094 仕様書内に記載された 📊 マート更新 トップメニューは現行コードでは廃止されている点に注意（新規メニューを増やすのではなく、サイドバー HTML に追記する運用）。

BudgetRepository の不在（Phase 1 で Read 確認済）

• 200_data/202_repository.js に定義されている Repository は OrderRepository / InvoiceRepository / BankTxRepository / JournalRepository / AccountRepository の 5 つのみ
• BudgetRepository は未実装。本案件は既存 dmIngestData_ が返す ctx.finalUnionData を再利用するため、41_trn_budget への直接アクセスは原則不要。仮に新規に読み込む必要が生じた場合は 41_trn_budget.getDataRange().getValues() + ヘッダー名ベース indexOf 参照で暫定対応する（Repository 新設は別案件として分離）

動的生成タブの扱い（CLAUDE.md 記載）

CLAUDE.md の「DDL (setupAllSchemas) で管理されないタブ」に列挙される動的生成タブ: 03_sys_params / 75_ss_equity_changes / 76_notes / 77_pj_raw / 78_pj_pl / 91_fs_bs / 92_fs_pl / 93_kpi_dashboard / 90_test_results。

一方で 61〜65 / 71〜73 / 81〜82b は DDL 管理対象（setupAllSchemas の対象）であり、setupAllSchemas 再実行でプルダウンが消失する可能性がある。統合タブを DDL 管理対象にするか動的生成扱いにするかは Step 1 の実装方針で決定する（本仕様書では DDL 管理対象として登録する方針を推奨）。

修正方針

Step 1: 統合シートの作成と初期化（Claude Sonnet 4.6 推奨）

1-a: 統合シートの番号帯・名称

本案件では以下の 3 シートを新設する。既存番号帯と重複しない 6X / 7X / 8X の空き番号を選定する:

注記: シート番号 60 / 70 / 80 は現行未使用（Phase 1 調査で確認）。ただし将来的に DDL で予約される可能性があるため、最終的な番号採番は実装着手時に 101_sys_config.js の setupAllSchemas スキーマ一覧と照合して確定する（「要確認」扱い）。

1-b: プルダウン（データバリデーション）の設置

各統合シートの A1 セルに DataValidation を設置する。選択肢は以下:

• P/L 統合（60_fs_pl_unified）:
  • 実績・単月（既存 61 相当、isActualOnly=true、viewMode='monthly'）
  • 実績・累積（既存 62 相当、isActualOnly=true、viewMode='ytd'）
  • 計画含む・単月（既存 63 相当、isActualOnly=false、viewMode='monthly'）
  • 計画含む・累積（既存 64 相当、isActualOnly=false、viewMode='ytd'）
• B/S 統合（70_fs_bs_unified）:
  • 実績（既存 71 相当）
  • スナップショット（月末時点）（既存 72 相当、viewMode='snap'）
  • 計画含む（既存 73 相当、isActualOnly=false）
• CF 統合（80_fs_cf_unified）:
  • 実績・単月（既存 81 相当）
  • 実績・累積（既存 81b 相当）
  • 計画含む・単月（既存 82 相当）
  • 計画含む・累積（既存 82b 相当）

注記: CLAUDE.md コーディング規約「シートへの書き込み位置は列 B (ID列) で最終行を判定（列 A のチェックボックス回避）」は 32_wrk_invoice 等のデータ入力シートに適用される規約。財務諸表レポートシート（本案件のアウトプット）は 1 行目＝ヘッダー、2 行目以降＝集計結果で、チェックボックス列は存在しないため A1 セルにプルダウンを設置して問題ない（既存 targetMonthsWithActBgt ヘッダーが列 A〜列 P に並ぶレイアウトと整合させ、プルダウンは列 A 1 行目のヘッダー文字列の代わりに配置するか、または 1 行目をプルダウン専用行・2 行目以降に既存のヘッダーを下げる構造に変更する。後者のほうが既存 dmApplyDwhFormat_ との衝突が少ない）。

1-c: 初期化フロー

プルダウンの初期設置は setupAllSchemas に統合するのが望ましい。代替として buildBudgetTrendDataMart 内の「出力書き込み」直前に ensureUnifiedSheetDropdown_(sheet) を挟み、毎回のマート更新で冪等的に設置する方式でもよい（既存 dmApplyDwhFormat_ との同居が容易）。両方式の長所短所は Step 1 実装時に人間判断で決める（「人間が検討すべき事項」に記載）。

1-d: 初期表示モード

プルダウン未選択状態（空セル）では 実績・単月 をデフォルトとしてフォールバック描画する。handleUnifiedFsEdit_ の冒頭で e.value が空のときは 実績・単月 をそのまま採用する。

Step 2: onEdit トリガーへの分岐追加（Claude Sonnet 4.6 推奨）

2-a: 挿入位置

100_config/101_sys_config.js L363-413 の既存 onEdit(e) 関数内、if (sheetName === Constants.CONFIG_SHEET ...) の分岐（L366）の後、if (sheetName === '36_wrk_bank_import') の分岐（L372）の前に、MAS-115 専用分岐を挿入する:

  // S-43: 財務諸表統合タブのプルダウン変更を検知して再描画
  if (sheetName === '60_fs_pl_unified' || sheetName === '70_fs_bs_unified' || sheetName === '80_fs_cf_unified') {
    if (e.range.getA1Notation() === 'A1') {
      try { handleUnifiedFsEdit_(e); } catch (err) { Utils.logError('handleUnifiedFsEdit_', err); }
      return;
    }
  }

return することで後続の handleUxAssist(e) を呼ばない（統合タブは手入力対象ではないため）。

2-b: LockService 排他制御

handleUnifiedFsEdit_(e) の冒頭で以下の排他制御を行う:

var lock = LockService.getScriptLock();
if (!lock.tryLock(3000)) {
  Utils.toastResult('unifiedFs', '他の処理が実行中のため再描画をスキップしました。数秒後に再操作してください。');
  return;
}
try {
  // 再描画本体
} finally {
  lock.releaseLock();
}

• tryLock(3000) で 3 秒待機。取得失敗時はトーストで通知して終了（waitLock ではなく tryLock を使う理由は、UI 操作の応答性を優先するため。マート更新など長時間処理と競合すると 3 秒でタイムアウトするが、再操作で済む）
• finally で releaseLock() を呼ぶ。エラー発生時もロックが残らない

2-c: MAS-094 との共存

MAS-094 は現在ダイアログ方式（buildDataMartWithCustomBoundary）のため同一 onEdit には干渉しない。ただし将来 MAS-094 が A1 セルプルダウン化される可能性があるため、e.range.getA1Notation() で判定する構造にしておく（同じ A1 セルを両機能が使うことは避ける。例えば MAS-094 は A2 セル、MAS-115 は A1 セル、と明示的に分担する）。

Step 3: 再描画ロジックの実装（Claude Opus 4.6 推奨）

3-a: 新規ファイル 600_report/611_datamart_unified.js を作成

以下の関数を定義する:

• handleUnifiedFsEdit_(e) — onEdit から呼ばれるエントリ。シート名で P/L / B/S / CF を分岐
• renderUnifiedPl_(mode) — P/L 統合シートに描画。mode は { isActualOnly, viewMode } のオブジェクト
• renderUnifiedBs_(mode) — B/S 統合シートに描画
• renderUnifiedCf_(mode) — CF 統合シートに描画
• ensureUnifiedSheetDropdown_(sheet, choices) — A1 プルダウンを冪等に設置

3-b: 既存マートビルダの再利用方針

既存 buildBudgetTrendDataMart は 12 シート全てを一括再描画する重い処理（dmIngestData_ で 32/33 タブをフルスキャン、実績と計画の 2 パス dmProcessAllEvents_ / dmCalcPl_ 等）。onEdit からの再描画では 1 モードのみ描画すれば十分なため、以下の方針で軽量化する:

方式 A（推奨）: buildBudgetTrendDataMart のロジックを部分抽出

• dmIngestData_ + dmProcessAllEvents_ + dmCalc*_ までは共通で実行（実績/計画どちらか一方のみ）
• dmBuild*Output_ の結果を dmApplyDwhFormat_ で統合シートに書き出す
• 既存の 12 タブへの書き出しはスキップ

方式 B: buildBudgetTrendDataMart をそのまま呼び、最後に統合シートへのコピー処理を追加

• 実装は簡単だが重い（P/L 1 枚見るだけで 12 枚全再描画）

Step 3 では方式 A を採用する。buildBudgetTrendDataMart をリファクタして「実績 ctx 構築部」「計画 ctx 構築部」「シート書き出し部」の 3 関数に分割する（buildActualCtx_() / buildPlanCtx_() / writeToSheets_()）。統合シート再描画はこの 3 関数のうち必要なものだけを呼ぶ。

リファクタリングの影響範囲: buildBudgetTrendDataMart 本体（~220 行）を分割。既存の呼び出し側（buildBudgetTrendDataMart / buildDataMartWithCustomBoundary）は引数なし呼び出しを維持し、内部的に分割後関数を順に呼ぶラッパー構造とする。

3-c: 表示モードと isActualOnly の対応

既存の isActualOnly（boolean）は「実績のみフィルタ」の意味であり、統合タブの viewMode（monthly/ytd/snap）とは直交する概念。以下のマトリクスで実際のレンダラ出力配列を切り替える:

3-d: 処理中表示

handleUnifiedFsEdit_ の冒頭で Utils.toastResult('unifiedFs', '更新中...') を呼び、再描画完了時に再度 Utils.toastResult('unifiedFs', '完了') を呼ぶ。数秒以上かかる場合にユーザーが操作フィードバックを得られる。

3-e: SpreadsheetApp.flush() の挿入

既存コードに SpreadsheetApp.flush() の使用箇所はないが、再描画完了後に 1 回だけ flush() を呼ぶことで、プルダウン変更 → 画面反映のラグを軽減する。dmApplyDwhFormat_ の直後、lock.releaseLock() の直前に挿入。

影響範囲

注意事項

1. BudgetRepository 不在への対応: 200_data/202_repository.js に BudgetRepository は存在しない（Phase 1 で Read 確認済）。本案件では既存 dmIngestData_ / dmIngestPlanData_ / dmIngestPipelinePlanData_ が返す ctx.finalUnionData を再利用し、41_trn_budget への直接アクセスは行わない。将来 Repository 化する場合は MAS-115 のスコープ外とする。
2. 既存 onEdit 分岐の破壊防止: L364 の if (row === 1) return; で「1 行目の編集はスキップ」されている点に注意。MAS-115 では A1 セルを編集対象とするため、この分岐を経由しない書き換えが必要。具体的には、A1 編集検出を row === 1 チェックより前に行うか、row === 1 分岐の中で A1 判定を行う。推奨は後者（既存の仕訳振り分けロジックなど他の row > 1 前提の分岐を壊さない）。
3. DDL 管理対象シートの扱い: 統合シート（60_fs_pl_unified 等）は DDL 管理対象として setupAllSchemas に登録する方針。DDL 再実行時にプルダウンが消失しないよう setVali で明示的に再設定するか、スキーマ定義に dataValidation プロパティを組み込む。
4. CLAUDE.md コーディング規約遵守: 列参照は全てヘッダー名ベース（indexOf）で行い、列番号ハードコード禁止（既存 dmApplyDwhFormat_ が targetMonthsWithActBgt 配列を引数で受けるためこの規約は既に守られている）。
5. 旧タブの並行稼働: 移行期間中（推奨 1 ヶ月）は 61〜65 / 71〜73 / 81〜82b の旧タブへの出力を継続する。既存 buildBudgetTrendDataMart の書き出しロジックを削除しないこと。旧タブの廃止は別案件（MAS-115-follow）として分離し、安定確認後に実施する。
6. MAS-094 との A1 セル衝突回避: MAS-094 は現時点でダイアログ方式だが、将来プルダウン化される場合は MAS-094 用セルを A2、MAS-115 用セルを A1 と明示的に分担する。
7. LockService のセッション範囲: LockService.getScriptLock() はスクリプト全体で 1 つのロックを共有するため、マート更新実行中にプルダウン操作すると 3 秒で tryLock が失敗する。これは正しい挙動（二重再描画を防ぐため）だが、ユーザーへの通知文言（Utils.toastResult の第 2 引数）で理由を明示する。
8. isActualOnly の既存参照箇所（603/604/605）の不変性: isActualOnly を参照する既存ロジックは変更しない。統合タブでも全く同じ ctx.isActualOnly ＋ 出力配列（outM/outY/outB/outC/outCY）を使い回す。
9. dmApplyDwhFormat_ の第 1 引数 sheet は統合シートに切替可能: 既存の書き出し関数 dmApplyDwhFormat_(sheet, out, fmt, 'PL'\|'BS'\|'CF', targetMonthsWithActBgt) はシートを引数で受けるため、統合シートを渡すだけで既存フォーマット処理を再利用できる。

エッジケース

実データ検証（実装前に MCP / GAS 実機で確認すべき項目）

関連ドキュメント

人間が検討すべき事項

以下は TODO_future.md に記載された事項＋本仕様策定で追加抽出した事項:

1. プルダウンの配置場所: A1 セル固定 vs フローティング（データバリデーションのみ）。本仕様では A1 セル固定案を推奨したが、最終判断は UX 要件次第（TODO_future.md より転記）。
2. 切替時の再描画速度: データ量が多いと遅延する可能性（TODO_future.md より転記）。方式 A（ctx 構築部 + 出力部の分割）で軽量化する設計だが、実測で 3 秒を超える場合は tryLock タイムアウトの調整が必要。
3. 既存タブの廃止タイミング: 並行稼働期間の設定（TODO_future.md より転記）。推奨 1 ヶ月。廃止ステップ: (a) 旧タブ上部に「➡️ 統合タブへ移動」バナー設置 → (b) 旧タブ非表示化（シートを非表示、データは保持） → (c) 安定確認（最低 2 週間）後に完全削除。
4. GCP 移行（MAS-238）後の投資対効果: WebUI で実現する前提の場合、GAS フェーズでの実装工数の投資対効果判断（TODO_future.md より転記）。移行見込み時期と GAS フェーズの残存期間から ROI を評価。
5. 統合シートの番号帯・シート名の最終確定: 60_fs_pl_unified / 70_fs_bs_unified / 80_fs_cf_unified は候補。番号衝突確認（V05 / E14）後に決定。
6. プルダウン選択肢文字列の確定: 本仕様では 実績・単月 / 実績・累積 / 計画含む・単月 / 計画含む・累積 を提案。ユーザー向け UX として「実績」「見込み」「計画」等の呼称バリエーションの検討余地あり（V02）。
7. BudgetRepository の設計判断: 本案件では直接アクセス不要だが、将来の別案件で新規 Repository クラス作成 vs 41_trn_budget 直接アクセスのどちらを採用するか。
8. buildBudgetTrendDataMart の 3 関数分割: 方式 A を採用する場合、リファクタの影響範囲が広い。既存テスト（901_test_runner.js）でマート更新系テストが存在する場合はリグレッション確認が必要。
9. プルダウン初期化の責務: DDL (setupAllSchemas) で担当 vs 毎マート更新で冪等設置 vs 初回専用のセットアップ関数 — 3 案の選択（1-c）。
10. 旧タブ関連の既存テストケース更新: 旧タブ廃止時に 901_test_runner.js のマート更新テストを更新する必要あり。廃止フェーズで別 PR として分離。
11. A1 / A2 の配置方針: MAS-094 が将来 A1 プルダウン化される場合の役割分担（MAS-094 は A2、MAS-115 は A1 等の明示化）。

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

あなたはGAS会計システム(bizlp-gas-accounting)のシニア開発者です。
案件 MAS-115「財務諸表タブの統合（プルダウン切替方式）」を実装してください。

## 実行前タスク

以下のファイルを Read し、実装前のコンテキストを把握してください:

1. `docs/dev/dev_mas-115_unified_financial_statements.md` — 本仕様書全体
2. `600_report/602_datamart_main.js` — `buildBudgetTrendDataMart(overrideBoundary)` の構造（L159-L380）。`dmIngestData_` / `dmProcessAllEvents_` / `dmBuildPlOutput_` / `dmBuildBsOutput_` / `dmBuildCfOutput_` / `dmApplyDwhFormat_` の呼び出し順序を確認
3. `600_report/603_datamart_pl.js` — `dmBuildPlOutput_` の引数と戻り値（`{outM, outY, fmtM, fmtY, yoyColCount}`）、`isActualOnly`（L204）および `filterValues` / `filterWithRecalcTotal` の実装
4. `600_report/604_datamart_bs.js` — `dmBuildBsOutput_` の実装、`isActualOnly`（L148）
5. `600_report/605_datamart_cf.js` — `dmBuildCfOutput_` の実装、`isActualOnly`（L57）
6. `100_config/101_sys_config.js` — `onEdit`（L363-413）の既存分岐構造、`setupAllSchemas` と `SYS_CONFIG` への KEY 登録ロジック（L609-620 付近）、`onOpen`（L299-307）のメニュー構造
7. `300_ui/301_ui_assist.js` — `handleUxAssist(e)` が `onEdit` 内 L412 から呼ばれていることを確認
8. `200_data/202_repository.js` — `OrderRepository` / `InvoiceRepository` / `BankTxRepository` / `JournalRepository` / `AccountRepository` のみ存在し、**`BudgetRepository` は未実装**であることを確認
9. `templates/operations_sidebar.html` — サイドバーの `§📊 マート更新` セクションへのボタン追加箇所を確認
10. `CLAUDE.md` — DDL 管理外タブ一覧、コーディング規約
11. `docs/dev/dev_mas-094_boundary_month_selector.md` — MAS-094 のダイアログ方式の実装、将来プルダウン化時の共存方針

## 修正対象ファイル

- **新規作成**: `600_report/611_datamart_unified.js`
- **既存への追記**:
  - `600_report/602_datamart_main.js` — `buildBudgetTrendDataMart` を 3 関数に分割（`buildActualCtx_` / `buildPlanCtx_` / `writeToSheets_`）し、既存ラッパーとして維持
  - `100_config/101_sys_config.js` — `onEdit` に MAS-115 分岐ブロック追加、`setupAllSchemas` の KEY 登録に `FS_PL_U` / `FS_BS_U` / `FS_CF_U` の 3 行追加、DDL スキーマ定義（該当がある場合のみ）
  - `templates/operations_sidebar.html` — 統合タブ初期化ボタン 1 つ追加

## 実装内容

### Step 1: 統合シートの作成と初期化

1. 新規シート `60_fs_pl_unified` / `70_fs_bs_unified` / `80_fs_cf_unified` を導入。シート番号が既存 DDL スキーマと衝突しないことを `101_sys_config.js` の `setupAllSchemas` 内スキーマ一覧で確認してから確定する
2. `SYS_CONFIG` （`03_sys_params` テーブル）に KEY `FS_PL_U` / `FS_BS_U` / `FS_CF_U` を追加（101 L609-620 のパターンに準拠）
3. 各シートの A1 セルにデータバリデーション（プルダウン）を設置:
   - P/L: `実績・単月` / `実績・累積` / `計画含む・単月` / `計画含む・累積`
   - B/S: `実績` / `スナップショット（月末時点）` / `計画含む`
   - CF: `実績・単月` / `実績・累積` / `計画含む・単月` / `計画含む・累積`
4. プルダウン未選択時（A1 が空）のデフォルトは P/L・CF は `実績・単月`、B/S は `実績` とする

### Step 2: `onEdit` トリガーへの分岐追加

1. `100_config/101_sys_config.js` L363 の `onEdit(e)` 関数内、`Constants.CONFIG_SHEET` 分岐（L366-370）の**後**、`36_wrk_bank_import` 分岐（L372）の**前**に以下を挿入:

    if (sheetName === '60_fs_pl_unified' || sheetName === '70_fs_bs_unified' || sheetName === '80_fs_cf_unified') {
      if (e.range.getA1Notation() === 'A1') {
        try { handleUnifiedFsEdit_(e); } catch (err) { Utils.logError('handleUnifiedFsEdit_', err); }
        return;
      }
    }

2. L365 の `if (row === 1) return;` より**前**に上記ブロックを配置することで、1 行目の編集でも処理される分岐を確保する

### Step 3: 再描画ロジックの実装（`600_report/611_datamart_unified.js`）

1. `handleUnifiedFsEdit_(e)` — `LockService.getScriptLock()` + `tryLock(3000)` + `try/finally releaseLock()` パターンで排他制御。`sheetName` で P/L / B/S / CF を分岐し、プルダウン値（`e.value`）を `{ isActualOnly: boolean, viewMode: string }` のオブジェクトに変換して `renderUnified*_` を呼ぶ
2. `renderUnifiedPl_(mode)` — `buildActualCtx_()` または `buildPlanCtx_()` を呼んで ctx を構築し、`dmBuildPlOutput_(ctx)` で出力配列を取得、`mode.viewMode === 'ytd'` なら `outY`、それ以外は `outM` を選んで `dmApplyDwhFormat_(sheet, out, fmt, 'PL', targetMonthsWithActBgt)` で統合シートに書き出す
3. `renderUnifiedBs_(mode)` — 同上の流れで `dmBuildBsOutput_` → `outB` を書き出し。`mode.viewMode === 'snap'` のときは `dmRenderBsSnapshot_` 相当の処理を統合シート向けに呼ぶ
4. `renderUnifiedCf_(mode)` — 同上の流れで `dmBuildCfOutput_` → `outC` / `outCY` を書き出し
5. `ensureUnifiedSheetDropdown_(sheet, choices)` — A1 セルにプルダウンを冪等に設置するヘルパー
6. `buildBudgetTrendDataMart` を 3 関数（`buildActualCtx_` / `buildPlanCtx_` / `writeToSheets_`）に分割。既存の呼び出し側（`buildBudgetTrendDataMart()` / `buildDataMartWithCustomBoundary()`）は引数なし呼び出しを維持し、内部的に分割後関数を順に呼ぶラッパー構造とする
7. `Utils.toastResult('unifiedFs', '更新中...')` → 再描画 → `SpreadsheetApp.flush()` → `Utils.toastResult('unifiedFs', '完了')` の順で UX フィードバック

## 制約

- 既存の `onEdit` 分岐ロジックを破壊しないこと（特に L365 の `row === 1` 早期リターンの挙動は他分岐に影響しない形で回避する）
- 列番号のハードコード禁止。ヘッダー名 `indexOf` で参照（CLAUDE.md 規約）
- `BudgetRepository` が未存在のため、`41_trn_budget` への直接アクセスは本案件では行わない。既存 `dmIngestData_` / `dmIngestPlanData_` / `dmIngestPipelinePlanData_` 経由で得た `ctx` を再利用する
- 動作未確認のコードを GitHub に push しない（CLAUDE.md 規約）
- 実在しないメニュー名・関数名を動作確認手順に記載しない
- 既存 `61〜65 / 71〜73 / 81〜82b` の旧タブへの出力は並行稼働期間中は継続する（本案件では削除しない）

## エッジケース

| # | 条件 | 表示値/挙動 | 理由 |
|---|------|------------|------|
| E01 | プルダウン未選択（A1 セルが空） | デフォルト `実績・単月` で描画 | 初回アクセス時の UX |
| E02 | `42_trn_journal` / `41_trn_budget` が空 | エラーなく空の表を描画 | データ未投入時の安全な初期表示 |
| E03 | P/L 売上高=0（ゼロ除算） | `"-"` 表示 | failure_patterns.md #2 |
| E04 | `onEdit` 多重実行 | `tryLock(3000)` 失敗で `Utils.toastResult` 通知してスキップ | パフォーマンス保護 |
| E05 | MAS-094 / MAS-115 の同一 `onEdit` 発火 | `e.range.getA1Notation()` と `sheetName` で分岐 | MAS-094 との共存 |
| E06 | 旧関数呼び出し残存 | デプロイ前に `grep` で全参照確認 | failure_patterns.md #7 |
| E07 | 統合シート未作成でプルダウン操作 | `getSheetByKey` null → 早期 return | 未セットアップ環境での安全フェイル |
| E08 | `setupAllSchemas` でプルダウン消失 | DDL 側で `dataValidation` 再設定または毎マート更新で冪等設置 | DDL との整合性 |
| E09 | `boundaryMonthStr` 未確定（`1900-01`） | 既存 L237 の挙動継承 | 既存仕様継承 |
| E10 | 選択肢外の文字列が A1 に書き込まれる | バリデーションで拒否。通過時はデフォルトにフォールバック | 異常入力の安全処理 |
| E11 | B/S スナップで実績月なし | 空白表示 | 既存 72 挙動継承 |
| E12 | `flush()` 重複 | 冪等で安全 | パフォーマンス |
| E13 | プルダウン操作とマート更新同時 | `LockService` 競合で失敗 → 再操作依頼 | 二重書き込み防止 |
| E14 | 統合シート番号が将来予約 | 実装着手時にスキーマ一覧で再確認 | 番号衝突防止 |
| E15 | `handleUnifiedFsEdit_` 内例外 | `try/catch` で `Utils.logError` + alert、`finally` で `releaseLock` | 安全なエラーハンドリング |

## 実データ検証

- V01: 現行の `61_pl_monthly` / `62_pl_ytd` / `71_bs` / `81_cf_indirect` に実データがあることを dev 環境で確認
- V02: プルダウン選択肢文字列の UX ワーディングを確定
- V03: `isActualOnly` の型が boolean であることを 602 L243 で確認済
- V04: `41_trn_budget` に対象月のデータが存在することを確認
- V05: 統合タブ番号 60/70/80 が既存・計画中スキーマと衝突しないことを `grep` で確認
- V06: `LockService.tryLock(3000)` の挙動を手動検証
- V07: `setupAllSchemas` 再実行でプルダウンが消えないことを目視検証

## 動作確認

`npm run push:dev` 後、以下を確認:

1. スプレッドシートをリロードし、`🚀 BizLP` → 操作パネル（サイドバー）→ `📊 マート更新` セクションに「統合タブを初期化」ボタンが表示されること
2. 「統合タブを初期化」クリック → `60_fs_pl_unified` / `70_fs_bs_unified` / `80_fs_cf_unified` の 3 シートが生成され、A1 にプルダウンが設置されていること
3. P/L 統合タブの A1 を `実績・単月` に変更 → 61 タブと同じ内容が表示されること（境界月以降空白、実績のみ）
4. P/L 統合タブの A1 を `計画含む・累積` に変更 → 64 タブと同じ内容が表示されること
5. B/S 統合タブの A1 を `スナップショット（月末時点）` に変更 → 72 タブと同じ内容が表示されること
6. CF 統合タブの A1 を `実績・累積` に変更 → 81b タブと同じ内容が表示されること
7. プルダウン操作中に `buildBudgetTrendDataMart` を実行 → `LockService` 競合で片方がトースト通知してスキップされること
8. `setupAllSchemas` 実行 → 統合タブのプルダウンが消失しないこと

推奨実行モデル

変更履歴

仕様書作成プロンプト（再現性・監査性のため必ず記録）

# MAS-115: 財務諸表タブの統合（プルダウン切替方式）
## 概要
## 目的
## 現在のコード
## 修正方針
## 影響範囲
## 注意事項
## エッジケース
## 実データ検証
## 関連ドキュメント
## 人間が検討すべき事項
## 実装プロンプト（Claude Code 用）
## 推奨実行モデル
## 変更履歴
## 仕様書作成プロンプト（再現性・監査性のため必ず記録）

あなたはGAS会計システム(bizlp-gas-accounting)のシニア開発者です。
案件 MAS-115「財務諸表タブの統合（プルダウン切替方式）」を実装してください。

## 実行前タスク
（Phase 1 で列挙したファイルリストと、各ファイルで確認すべきポイントを明記）

## 修正対象ファイル
（Phase 1 で確定したファイル名のみ。「のみ」または「への追記」を明示）

## 実装内容
（Step 1〜3 の具体的な変更手順。関数名・行番号は Phase 1 で裏取り済みのもののみ記載）

## 制約
- 既存 onEdit 分岐ロジックを破壊しないこと
- 列番号のハードコード禁止（ヘッダー名 indexOf で参照）
- BudgetRepository が未存在の場合は 41_trn_budget を直接参照する方式を採用
- 動作未確認のコードを GitHub に push しない（CLAUDE.md 規約）
- 実在しないメニュー名・関数名を動作確認手順に記載しないこと

## エッジケース
（Step 2-3a のテーブルを転記）

## 実データ検証
（Step 2-3a の実データ検証項目を転記）

## 動作確認
（npm run push:dev 後の検証手順。メニュー名は Phase 1 で onOpen を Read して確認した実在の文字列のみ使用）

<details><summary>展開して表示</summary>
（この instruction 全文をそのまま貼り付ける）
</details>

{ "file": "dev/dev_mas-115_unified_financial_statements.md", "title": "E.4.X S-43 財務諸表タブの統合（プルダウン切替方式）" }

| 2026-04-19 | [dev_mas-115_unified_financial_statements.md](dev_mas-115_unified_financial_statements.md) | 初版作成。財務諸表タブ統合（プルダウン切替方式）の開発仕様書 |

git add docs/dev/dev_mas-115_unified_financial_statements.md docs/_internal/changelog.md docs/_config.json
git commit -m "docs: S-43 財務諸表タブの統合（プルダウン切替方式）の開発仕様書を作成

P/L・B/S・CFタブをプルダウン切替方式で統合する仕様書の初版。
onEditトリガー・LockService排他制御・S-22連携・BudgetRepository要調査事項を設計。

https://claude.ai/code/session_XXXXX"
git push -u origin {現在のブランチ}