MAS-094: 実績集計の基準年月プルダウン選択

概要

目的

マート更新時に実績集計の基準年月（境界月）をユーザーが選択できるようにし、月次締め前の仮集計や過去月の実績確認を可能にする。現在は boundaryMonthStr が自動計算（max実績月の翌月）で固定されており、任意月での実績確認ができない。

現在のコード

boundaryMonthStr の自動計算（601_datamart_ingest.js L251-256）

const today = new Date();
const currentYmStr = `${today.getFullYear()}-${String(today.getMonth() + 1).padStart(2, '0')}`;
let boundaryMonthStr = hasInvData && maxInvYm !== '1900-01'
  ? Utils.addMonths(maxInvYm, 1) : currentYmStr;
if (boundaryMonthStr > currentYmStr) boundaryMonthStr = currentYmStr;

buildBudgetTrendDataMart の関数シグネチャ（602_datamart_main.js L157）

function buildBudgetTrendDataMart() {   // ← 引数なし

boundaryMonthStr の上書き挿入ポイント（602_datamart_main.js L211）

dmIngestData_(ctx, sheetInv, sheetBank, sheetAcct);
// ★ この直後に overrideBoundary の反映を挿入する

// 1b. 32タブの諸表区分・表示区分を科目マスタから同期
dmSyncInvClassification_(ctx.acctMap, sheetInv);

boundaryMonthStr の使用箇所

既存のメニュー構造（101_sys_config.js L328-331）

ui.createMenu('📊 マート更新')
  .addItem('財務3表(P/L・B/S・C/F)の更新', 'buildBudgetTrendDataMart')
  .addItem('プロジェクト別 採算(限界利益)の生成', 'buildProjectProfitability')
  .addToUi();

修正方針

実装方式: ダイアログ方式

マート更新メニューに「基準年月を指定して更新」を追加。実行時にダイアログで基準月を入力し、buildBudgetTrendDataMart にオプション引数として渡す。

この方式を選んだ理由:

Step 1: buildBudgetTrendDataMart() への引数追加

602_datamart_main.js L157 の関数シグネチャにオプション引数を追加し、L211（dmIngestData_ 直後）に上書きロジックを挿入する。

// L157: 関数シグネチャ変更
function buildBudgetTrendDataMart(overrideBoundary) {

// L211-214: dmIngestData_ 直後に挿入
    dmIngestData_(ctx, sheetInv, sheetBank, sheetAcct);

    // S-22: 基準年月の手動上書き
    if (overrideBoundary) {
      ctx.boundaryMonthStr = overrideBoundary;
      Utils.logInfo(FUNC, '基準年月を手動指定: ' + overrideBoundary);
    }

    // 1b. 32タブの諸表区分・表示区分を科目マスタから同期
    dmSyncInvClassification_(ctx.acctMap, sheetInv);

Step 2: buildDataMartWithCustomBoundary() ラッパー関数の追加

602_datamart_main.js の末尾（buildBudgetTrendDataMart 関数の外側）に追加。

/**
 * S-22: 基準年月を指定して財務3表を更新する
 * ユーザーに基準年月をpromptで入力させ、buildBudgetTrendDataMart に渡す
 */
function buildDataMartWithCustomBoundary() {
  var ui = SpreadsheetApp.getUi();
  // 選択肢の構築: 今期の12ヶ月
  var today = new Date();
  var startYear = (today.getMonth() + 1 >= 8) ? today.getFullYear() : today.getFullYear() - 1;
  var choices = [];
  for (var i = 0; i < 12; i++) {
    var d = new Date(startYear, 7 + i, 1);
    choices.push(d.getFullYear() + '-' + String(d.getMonth() + 1).padStart(2, '0'));
  }

  var result = ui.prompt(
    '📅 基準年月の選択',
    '実績集計の末月を指定してください。\n'
      + '指定月までが実績、翌月以降が予算として表示されます。\n\n'
      + '選択肢:\n' + choices.join('\n') + '\n\n'
      + '入力例: 2025-12\n（空欄で自動計算）',
    ui.ButtonSet.OK_CANCEL
  );

  if (result.getSelectedButton() !== ui.Button.OK) return;

  var input = result.getResponseText().trim();
  if (!input) {
    buildBudgetTrendDataMart();  // 通常実行
  } else {
    var ym = Utils.parseDateToYm(input);
    if (!ym) {
      ui.alert('⚠️ 入力形式エラー', '「YYYY-MM」形式で入力してください。', ui.ButtonSet.OK);
      return;
    }
    // 入力月 = 実績最終月 → 翌月を境界月として設定
    buildBudgetTrendDataMart(Utils.addMonths(ym, 1));
  }
}

Step 3: メニューへの追加

101_sys_config.js L328-331 のメニュー構築に1行追加。

ui.createMenu('📊 マート更新')
  .addItem('財務3表(P/L・B/S・C/F)の更新', 'buildBudgetTrendDataMart')
  .addItem('📅 基準年月を指定して更新', 'buildDataMartWithCustomBoundary')  // S-22
  .addItem('プロジェクト別 採算(限界利益)の生成', 'buildProjectProfitability')
  .addToUi();

影響範囲

• 既存動作への影響: buildBudgetTrendDataMart() を引数なしで呼んだ場合は完全に従来通り。引数はオプション
• 下流への波及: ctx.boundaryMonthStr の上書きにより、filterValues / filterWithRecalcTotal / uiHeader / targetMonthsWithActBgt が全て連動して変わる。603/604/605 の変更は不要

注意事項

1. 上書きは一時的: ダイアログで指定した基準月は今回の実行にのみ適用。次回の通常実行（引数なし）では自動計算に戻る
2. 未来月の制限: dmIngestData_ 内の if (boundaryMonthStr > currentYmStr) クランプは維持。上書きはその後なので、未来月を指定しても実績データが存在しない月が含まれうる。ただしデータがない月は金額0になるだけで壊れない
3. 過去月の指定: 問題なし。指定月以降は予算扱いになるだけ
4. 計画タブ(63/64): planCtx.boundaryMonthStr = ctx.boundaryMonthStr（L252）で計画にも波及する。意図通りの動作
5. 上書き挿入位置: dmIngestData_ の直後かつ dmSyncInvClassification_ の前に挿入。dmIngestData_ で自動計算された boundaryMonthStr を上書きする

エッジケース

実データ検証（MCP でのデータ確認が必要な場合）

関連ドキュメント

人間が検討すべき事項

• プルダウンの配置場所: 本仕様ではダイアログ方式を採用（TODO_future.md から転記）
• 未来月の指定を許可するか: 技術的には可能だが、実績データがない月は金額0になる。初版では制限せず、ユーザー判断に委ねる

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

あなたはGAS会計システム(bizlp-gas-accounting)のシニア開発者です。
案件 MAS-094「実績集計の基準年月プルダウン選択」を実装してください。

## 実行前タスク
以下のファイルを読み込んでください:
1. `600_report/602_datamart_main.js` — `buildBudgetTrendDataMart()` の全体構造（L157）。`dmIngestData_()` 直後（L211）での ctx.boundaryMonthStr 設定箇所を確認
2. `600_report/601_datamart_ingest.js` — L251-256 の boundaryMonthStr 自動計算ロジック（変更しない。参照のみ）
3. `100_config/101_sys_config.js` — L328-331 の「📊 マート更新」メニュー構築箇所
4. `000_infra/004_utils.js` — `Utils.parseDateToYm()`（L92）と `Utils.addMonths()`（L127）のシグネチャ
5. `CLAUDE.md`
6. `docs/dev/dev_mas-094_boundary_month_selector.md`

## 修正対象ファイル
- `600_report/602_datamart_main.js` — 引数追加 + ラッパー関数追加
- `100_config/101_sys_config.js` — メニュー項目追加

## 実装内容

### A: buildBudgetTrendDataMart() への引数追加（602_datamart_main.js L157）
関数シグネチャを `function buildBudgetTrendDataMart(overrideBoundary)` に変更。
L211（`dmIngestData_(ctx, ...)` の直後、`dmSyncInvClassification_` の前）に以下を挿入:
```js
// S-22: 基準年月の手動上書き
if (overrideBoundary) {
  ctx.boundaryMonthStr = overrideBoundary;
  Utils.logInfo(FUNC, '基準年月を手動指定: ' + overrideBoundary);
}
```

### B: buildDataMartWithCustomBoundary() ラッパー関数の追加（602_datamart_main.js 末尾）
- `SpreadsheetApp.getUi().prompt()` でユーザーに基準年月を入力させる
- 今期の12ヶ月を選択肢として表示
- 入力値を `Utils.parseDateToYm()` でパースし、`Utils.addMonths(ym, 1)` で翌月を境界月に変換
- 空欄なら引数なしで通常実行、キャンセルなら何もしない

### C: メニュー追加（101_sys_config.js L328-331）
「📊 マート更新」メニューの「財務3表の更新」と「プロジェクト別」の間に追加:
`.addItem('📅 基準年月を指定して更新', 'buildDataMartWithCustomBoundary')`

## 制約
- 既存の `buildBudgetTrendDataMart()` を引数なしで呼んだ場合の動作は一切変えない
- `dmIngestData_()` 内の boundaryMonthStr 自動計算ロジック（601_datamart_ingest.js）は変更しない
- 603/604/605 のファイルは変更しない

## エッジケース
| 条件 | 動作 |
|------|------|
| 空欄で OK | 引数なしで通常実行 |
| キャンセル | 何も実行しない |
| 不正な入力 | エラーダイアログ表示 |
| 今期外の月 | 正常実行（全月が予算扱い） |

## 動作確認
`npm run push:dev` 後:
1. スプレッドシートをリロードし、「📊 マート更新」メニューに「📅 基準年月を指定して更新」が表示されること
2. メニュークリック → ダイアログが表示され、今期12ヶ月の選択肢が表示されること
3. 「2025-12」と入力 → OK → マート更新実行。61タブで2025-12月までが「(実績)」、2026-01以降が「(予算)」であること
4. 空欄で OK → 通常の自動計算と同じ結果になること
5. キャンセル → 何も実行されないこと
6. 「abc」と入力 → エラーダイアログが表示されること

### 拡張思考の使用状況

| フェーズ | 拡張思考 | 備考 |
|---------|:--------:|------|
| buildBudgetTrendDataMart 引数追加 | なし | 1行のシグネチャ変更 + 4行の条件分岐追加 |
| ラッパー関数実装 | なし | prompt → parseDateToYm → addMonths の単純なフロー |
| メニュー追加 | なし | addItem 1行追加 |

推奨実行モデル

変更履歴