MAS-036: R&D投資対効果（ROI）ダッシュボード

概要

目的

R&Dプロジェクトごとの累積投資額と、そこから生まれたプロダクト収益・ライセンス収入・特許収入を紐付け、投資回収状況（ROI・回収期間・回収ステータス）を1枚のダッシュボードで可視化する。「このR&Dテーマにいくら投資して、いくら回収できたか」を定量的に把握し、R&D予算配分の意思決定材料を提供する。

前提案件

重要: 本案件は MAS-032 / MAS-034 の前提となるデータ構造（PJ名プレフィックス規約 R&D_ / プロダクト_）に依存するため、両案件未実装の段階では実データから ROI 計算ができない。実施順序は「人間が検討すべき事項」を参照。

現在のコード（関連既存実装）

JournalEntryDTO に存在しないフィールド（要注意）

000_infra/003_contracts.js L97-129 の typedef および 100_config/101_sys_config.js L860 の TRN_JOUR スキーマで確認した結果、42_trn_journal シートには以下のフィールドが存在しない:

修正方針

アーキテクチャ

• 新規モジュール 600_report/610_datamart_rd_roi.js を作成。公開関数 buildRdRoiDashboard() のみを export（既存 buildKpiDashboard()（609_datamart_kpi.js）の命名規則に倣う）。
• 出力先シート 94_rd_roi_dashboard は setupAllSchemas 非管理（93_kpi_dashboard と同様、動的生成・毎回上書き）。CLAUDE.md「DDL非管理タブ」一覧に追記する。シート未存在時は ss.insertSheet('94_rd_roi_dashboard') で生成。
• 新規マスタシート 19_mst_rd_product_link は setupAllSchemas 管理（101_sys_config.js の schemas 定義 L826〜 に追加）。システムキー MST_RD_LINK を 01_sys_config に登録。
• メニュー登録: 000_infra/002_constants.js の MENU_DEFINITION の 📋 サイドバー: 📊 マート更新 カテゴリ（L230〜）に { label: '🔬 R&D ROIダッシュボード', funcName: 'buildRdRoiDashboard', description: 'R&Dプロジェクト別 投資対効果 (94 タブ) を再計算' } を追加。メニュー文字列はカテゴリ名と既存項目（📊 KPIダッシュボード再描画 等）の表記に揃える。造語禁止（失敗パターン #20）。

データソースと取得方法

• 日付正規化: 全ての集計キーは Utils.parseDateToYm(dto['発生日(P/L計上日)']) で "YYYY-MM" に統一。String(Date) の直接比較は禁止（失敗パターン #17）。
• 仕訳ステータス === '仕訳振替' の扱い: 振替仕訳を ROI 計算に含めるか除外するかは経営判断。デフォルトは「除外しない（含める）」。決定は「人間が検討すべき事項」参照（CLAUDE.md「仕訳振替の判定は === '仕訳振替' の完全一致」を踏襲）。
• 有効フラグの扱い: 42_trn_journal には 有効フラグ カラムが存在しないため、フィルタは適用しない（前述の「JournalEntryDTO に存在しないフィールド」参照）。

紐付けロジック（19_mst_rd_product_link 使用）

1. シート取得: var linkSheet = ss.getSheetByName('19_mst_rd_product_link');
2. DTO 化: var linkResult = readSheetAsDtos_(linkSheet); （{ headers, dtos } を返す。GAS グローバルスコープから呼出可能）
3. フィルタ: dto['有効フラグ'] === false || String(dto['有効フラグ']).toUpperCase() === 'FALSE' の行はスキップ（既存 AccountRepository.findAsMap L329-330 の判定パターンに準拠）
4. マップ構築: { 'R&Dプロジェクト名': { product: '関連プロダクト名', rate: Number, startYm: 'YYYY-MM', endYm: 'YYYY-MM' | '' } }
5. デフォルト値:
   • 収益貢献率(%) が空欄/null/NaN → 1.0（100%）
   • 紐付け終了年月 が空欄 → 期限なし扱い（全期間対象）
6. マスタ未登録の R&Dプロジェクトの扱いはダッシュボード行の出力可否を決める（「人間が検討すべき事項」で確定）

新規マスタスキーマ（19_mst_rd_product_link）

100_config/101_sys_config.js の schemas 定義に追加（既存パターンに倣う）:

schemas への追加例:

'MST_RD_LINK': { headers: ["有効フラグ","R&Dプロジェクト名","関連プロダクト名","収益貢献率(%)","紐付け開始年月","紐付け終了年月"], color: "#666666",
  validations: {
    "収益貢献率(%)": { type: 'range', min: 0, max: 1, helpText: '0〜1の小数で入力してください（例: 0.8 = 80%）' }
  }
}

color: "#666666" はマスタの慣例色（MST_ACCT / MST_PART 等と統一）。

ダッシュボード出力レイアウト（94_rd_roi_dashboard）

1行 = 1 R&Dプロジェクト。列構成:

ヘッダーは行1、データは行2以降。冪等性のため毎回 clearContent() してから書き込む。

影響範囲

注意事項

1. 94_rd_roi_dashboard は setupAllSchemas 管理外。動的生成シートのため、CLAUDE.md「DDL非管理タブ」リストに 94_rd_roi_dashboard を追記すること（93_kpi_dashboard の直後）。実装漏れがあると次回の DDL 全更新時に挙動が読めなくなる。
2. PJ名のプレフィックス規約（'R&D_' / 'プロダクト_'）は実装着手前に「実データ検証」セクションの手順で実値を確認する。記憶・推測で記述しない（失敗パターン #18-#20）。
3. 列番号ハードコード禁止。ヘッダー名ベースで列参照する（CLAUDE.md コーディング規約）。headers.indexOf('PJ名') 等の動的取得を必ず使用。
4. 冪等性: buildRdRoiDashboard() 冒頭で 94_rd_roi_dashboard の既存行を sheet.clearContent() してから書き込む。シート未存在時は ss.insertSheet('94_rd_roi_dashboard') で生成。2 回連続実行で重複行が発生しないこと。
5. 仕訳ステータス === '仕訳振替' の取扱いを実装者が独断で決めない。「人間が検討すべき事項」で経営判断を待つ。デフォルト挙動は「振替も含めて集計」とし、除外する判断が下りたら dto['仕訳ステータス'] !== '仕訳振替' のフィルタを追加する設計とする。
6. JournalEntryDTO に 有効フラグ フィールドが存在しないため、42_trn_journal 側ではフラグフィルタ不要。一方、19_mst_rd_product_link 側では 有効フラグ === false || 'FALSE' のスキップを実施する（既存 AccountRepository.findAsMap L329-330 の判定パターンに準拠）。
7. 収益貢献率(%) の値域は 0.0〜1.0 の小数。100 のような百分率値で入力されるとリターンが 100 倍に膨張する。DDL 側で validations: { "収益貢献率(%)": { type: 'range', min: 0, max: 1 } } を指定して入力時点で防ぐ。

エッジケース

実データ検証

実装着手前に MCP（Google Sheets MCP サーバー）または getValues() で以下を確認する。確認結果を実装プロンプト Step 1 のコメントに記録すること。

関連ドキュメント

人間が検討すべき事項

TODO_future.md MAS-036 記載事項（転記）

• R&D成果とプロダクト収益の紐付けルール: 直接帰属（特定R&Dから生まれた特定プロダクトの全収益）vs 間接貢献（複数R&Dが組み合わさったプロダクトに対する貢献率の按分）。本仕様書では 19_mst_rd_product_link.収益貢献率(%) で間接貢献を扱う設計だが、按分ルールの運用ポリシーは経営判断。
• 回収期間の目安: 「投資中 → 回収中 → 回収済」のステータス判定で「回収済」と見なすまでの期間（例: 5年以内に回収すべき / 10年スパンで評価する 等）。本仕様書は「累積純利益が初めてプラスに転じた月数」をステータス基準とするのみで、目安基準は持たない。

本仕様書で確定が必要な追加事項

1. 19_mst_rd_product_link.収益貢献率(%) の運用主体・レビュー頻度: マスタ値の経営判断は事業責任者・経営企画部の責務。レビュー頻度は推奨「四半期ごと」。
2. 仕訳ステータス === '仕訳振替' 行を ROI 計算に含めるか: CLAUDE.md「仕訳振替の判定は === '仕訳振替' の完全一致」を踏まえた判断が必要。デフォルトは「含める」（除外しない）。除外決定時は dto['仕訳ステータス'] !== '仕訳振替' のフィルタを追加する。
3. MAS-032（プロダクト別P/L）／ MAS-034（R&D費用集計）が未実装の段階で本案件を着手するか否か:
   • 両案件未実装の場合、PJ名 の命名規約自体が未確立で、本ダッシュボードは空のまま。
   • 推奨実施順序: MAS-032 / MAS-034 → MAS-036。または「MAS-036 を先行実装してマスタ・ダッシュボード枠組みのみ用意し、データ流入を MAS-032 / MAS-034 完了後に開始する」段階運用も可。
4. PJ名 命名規約の周知: R&D_ / プロダクト_ プレフィックスを全メンバーに周知し、既存仕訳データの遡及整備（リネーム）が必要かを判断する。整備が必要な場合は別案件として 8XX_migration_*.js を新設（CLAUDE.md「マイグレーションスクリプト運用ガイドライン」に従う）。
5. マスタ未登録プロジェクトの表示方法:
   • 案A: 当該行を出力しない（マスタ整備を強く促進）
   • 案B: 関連プロダクト名 を "マスタ未設定" と表示し、収益 = 0 で出力（投資が見えやすい）
   • デフォルト推奨は案A（マスタ整備を運用ルールとして定着させるため）
6. 同一R&Dプロジェクトが複数プロダクトに紐付くケースの行展開:
   • 案A: マスタ行ごとに 1 行（プロダクト別の細分粒度・本仕様書のデフォルト）
   • 案B: R&Dプロジェクト単位で集約 1 行・関連プロダクト名はカンマ連結
7. 紐付け開始年月 / 紐付け終了年月 の運用: プロダクトの撤退・スピンアウト時に 紐付け終了年月 を入れる運用ルールを定義する。撤退判定の責任部署を明確化する。
8. 税抜 vs 税込: 本仕様書は 税抜金額_実績 を集計対象とする（経営管理上の本来金額）。経営方針として税込で見たい場合は 税込金額_実績 に変更する経営判断が必要。

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

あなたはGAS会計システム(bizlp-gas-accounting)のシニア開発者です。
案件 MAS-036「R&D投資対効果（ROI）ダッシュボード」を実装してください。

## 実行前タスク（必ず Read してから実装着手）

- `000_infra/003_contracts.js` を Read し、`JournalEntryDTO` の全 `@property` を確認する。特に `有効フラグ` / `諸表区分` は未定義であることを確認（フィルタを使わない根拠）
- `200_data/202_repository.js` を Read し、`JournalRepository.findAll()` の戻り値型 `{ headers, dtos }` と `readSheetAsDtos_(sheet)` の引数・戻り値を確認
- `000_infra/004_utils.js` を Read し、`Utils.parseDateToYm(val)` → `"YYYY-MM" | ""` と `Utils.parseAmt(val)` → `number` のシグネチャを確認
- `100_config/101_sys_config.js` を Read し、`setupAllSchemas` 内の `schemas` 定義形式（L826〜）、システムキー登録 `confSheet.appendRow([...])` ブロック（L773〜）を確認
- `000_infra/002_constants.js` の `MENU_DEFINITION`（L206〜）を Read し、`📋 サイドバー: 📊 マート更新` カテゴリ（L230〜）の既存項目 `buildKpiDashboard` の表記を確認（実在文字列のみ引用）
- `600_report/609_datamart_kpi.js` を Read し、`buildKpiDashboard()` の「シート取得→clear→描画」パターンを把握
- `600_report/601_datamart_ingest.js` を Read し、プライベートヘルパーの命名規則（`dm*_`）を把握
- MCP または `getValues` で `42_trn_journal` の `PJ名` 列サンプルを10件程度確認し、`R&D_` / `プロダクト_` プレフィックスが実在するかを検証（実データ検証 #1-#6）
- `CLAUDE.md` の「DDL (setupAllSchemas) で管理されないタブ」一覧を確認

## 修正対象ファイル

- `600_report/610_datamart_rd_roi.js`（**新規作成**）
- `100_config/101_sys_config.js`（`MST_RD_LINK` の DDL スキーマ追加 + システムキー登録行 1 行）
- `000_infra/002_constants.js`（`MENU_DEFINITION` に 1 項目追加のみ）
- `CLAUDE.md`（「DDL非管理タブ」一覧に `94_rd_roi_dashboard` を追記）

## 実装内容

### 1. `600_report/610_datamart_rd_roi.js` 新規作成

公開関数: `buildRdRoiDashboard()`

処理ステップ:

1. **シート初期化・冪等性確保**
    - `ss.getSheetByName('94_rd_roi_dashboard')` でシート取得。未存在なら `ss.insertSheet('94_rd_roi_dashboard')` で生成
    - `sheet.clearContent()` でデータクリア（ヘッダーも含めて全消去してから再書き込み）

2. **マスタ読込（19_mst_rd_product_link）**
    - `ss.getSheetByName('19_mst_rd_product_link')` → `readSheetAsDtos_(sheet)` で DTO 配列取得
    - 有効フラグチェック: `dto['有効フラグ'] === false || String(dto['有効フラグ']).toUpperCase() === 'FALSE'` はスキップ
    - `linkMap[R&Dプロジェクト名] = [{ product, rate, startYm, endYm }, ...]` でマップ構築（同一R&Dに複数プロダクトがあり得る）
    - `rate` が空欄/NaN → 1.0 をデフォルト

3. **仕訳読込（42_trn_journal）**
    - `JournalRepository.findAll()` → `{ dtos }` を取得
    - 投資フィルタ: `dto['収支区分'] === '支出'` かつ `String(dto['PJ名']).startsWith('R&D_')`
    - 収益フィルタ: `dto['収支区分'] === '収入'` かつ `String(dto['PJ名']).startsWith('プロダクト_')` かつ `dto['科目名'] === '売上高'`
    - 各仕訳で `ym = Utils.parseDateToYm(dto['発生日(P/L計上日)'])` を取得。`ym === ''` のレコードはスキップ
    - 金額: `amt = Utils.parseAmt(dto['税抜金額_実績'])`

4. **月次集計**
    - `investByRd[R&Dプロジェクト名][ym] += amt`（投資）
    - `revenueByProduct[プロダクト名][ym] += amt`（収益）

5. **R&Dプロジェクト別 ROI 計算**
    - マスタの全 R&Dプロジェクト行をループ
    - 投資: `Object.values(investByRd[rdName]).reduce((a,b) => a+b, 0)`
    - 収益: 紐付け期間内の月次収益 × `rate` を加算（`startYm <= ym <= endYm`、`endYm === ''` なら上限なし）
    - 純利益 = 収益 - 投資
    - ROI(%) = 投資 === 0 ? "-" : (純利益 / 投資) * 100
    - 回収期間(月): 月次純利益の累積が初めて > 0 になった月数。該当なしなら "未回収"
    - ステータス: 純利益 < 0 → "投資中"、純利益 >= 0 && 回収期間 === "未回収" → "回収中"、純利益 >= 0 && 回収期間 が数値 → "回収済"

6. **書き込み**
    - ヘッダー行: `[R&Dプロジェクト名, 関連プロダクト名, 累計投資額, 累計リターン(貢献率調整後), 純利益, ROI(%), 回収期間(月), ステータス, 月次純利益推移]`
    - データ行を `sheet.getRange(2, 1, rows.length, 9).setValues(rows)` で一括書き込み
    - フィルター設定: `sheet.getRange(1, 1, 1, 9).createFilter()`（既存行にフィルタがあれば先に `sheet.getFilter().remove()`）

### 2. `100_config/101_sys_config.js` 変更

**2-A**: L773〜のシステムキー登録ブロックに 1 行追加（既存 `if (!existKeys.includes(...))` パターンに揃える）:

    if (!existKeys.includes('MST_RD_LINK')) confSheet.appendRow(['MST_RD_LINK', '', '19_mst_rd_product_link', 'マスタ_R&Dプロジェクト⇔プロダクト紐付け']);

**2-B**: L826〜の `schemas` 定義に 1 エントリ追加（他のマスタ（MST_ACCT 等）の近くに、色は慣例の `#666666`）:

    'MST_RD_LINK': { headers: ["有効フラグ","R&Dプロジェクト名","関連プロダクト名","収益貢献率(%)","紐付け開始年月","紐付け終了年月"], color: "#666666",
      validations: {
        "収益貢献率(%)": { type: 'range', min: 0, max: 1, helpText: '0〜1の小数で入力してください（例: 0.8 = 80%）' }
      }
    },

### 3. `000_infra/002_constants.js` 変更

`MENU_DEFINITION` の `📋 サイドバー: 📊 マート更新` カテゴリ（L230〜）の `items` 配列末尾（`📸 前年度P/Lスナップショット` の後）に 1 行追加:

    { label: '🔬 R&D ROIダッシュボード', funcName: 'buildRdRoiDashboard', description: 'R&Dプロジェクト別 投資対効果 (94 タブ) を再計算' },

### 4. `CLAUDE.md` 変更

「DDL (setupAllSchemas) で管理されないタブ」セクションの `93_kpi_dashboard,` の直後に `94_rd_roi_dashboard,` を挿入。

## 制約

- 列番号ハードコード禁止。ヘッダー名ベースで列参照（`headers.indexOf('PJ名')` 等）。CLAUDE.md 規約
- `94_rd_roi_dashboard` は DDL 管理外。`101_sys_config.js` の `schemas` には追加しない
- メニュー文字列・シート名・関数名は実在する文字列のみ引用。造語禁止（失敗パターン #20）
- `PJ名` プレフィックス（`R&D_` / `プロダクト_`）は実データ検証（実行前タスク）で確認した値に従う。記憶で書かない（失敗パターン #18）
- `JournalEntryDTO` には `有効フラグ` / `諸表区分` が存在しない。これらのフィールドを参照しない
- `仕訳ステータス === '仕訳振替'` の扱いはデフォルト「含める」（仕様書「人間が検討すべき事項 2」で別途判断）
- ゼロ除算時は `"-"`（ハイフン文字列）を出力。`0` や空文字にしない（失敗パターン #2）

## エッジケース（実装必須）

| 条件 | 実装 |
|------|------|
| 累計投資額 = 0 | ROI(%) セルに `"-"` を出力 |
| 純利益 < 0 | ROI(%) を負値でそのまま出力 |
| 回収未到達（累積純利益が一度も > 0 にならない） | 回収期間に `"未回収"` を出力 |
| マスタ未登録の R&Dプロジェクト | 出力行なし（「人間が検討すべき事項 5」決定後に再検討） |
| `収益貢献率(%)` が空欄 | デフォルト 1.0 を適用 |
| `紐付け終了年月` が空欄 | 終了期限なしとして全期間を対象 |
| `紐付け開始年月` より前の収益 | 貢献率 = 0 で除外 |
| 同一R&Dに複数プロダクトのマスタ行 | マスタ行ごとに 1 行出力（デフォルト・プロダクト別の細分粒度） |

## 動作確認

1. `npm run push:dev` で dev 環境にデプロイ
2. GAS エディタで `setupAllSchemas()` を実行 → `19_mst_rd_product_link` シートが生成され、ヘッダー・バリデーションが設定されることを確認
3. `19_mst_rd_product_link` にテストデータを入力（R&Dプロジェクト名・関連プロダクト名・収益貢献率 1.0・紐付け開始年月）
4. `42_trn_journal` に `PJ名 = 'R&D_xxx'` の支出と `PJ名 = 'プロダクト_xxx'` かつ `科目名 = '売上高'` の収入のテストデータがあることを確認（なければ手動で数件追加）
5. サイドバー or メニュー「📊 マート更新 → 🔬 R&D ROIダッシュボード」を実行
6. `94_rd_roi_dashboard` に ROI 計算結果が出力されることを確認
7. 累計投資額 = 0 の行で ROI(%) が `"-"` になることを確認（ゼロ除算テスト）
8. 2 回連続実行し、重複行が発生しないこと・既存行が置き換わることを確認（冪等性テスト）
9. `19_mst_rd_product_link` の `収益貢献率(%)` に 1.5 を入力しようとしてバリデーションでブロックされることを確認（範囲チェック）

推奨実行モデル

変更履歴

仕様書作成プロンプト

# MAS-036: R&D投資対効果（ROI）ダッシュボード
## 概要
## 目的
## 前提案件
## 現在のコード（関連既存実装）
## 修正方針
## 影響範囲
## 注意事項
## エッジケース
## 実データ検証
## 関連ドキュメント
## 人間が検討すべき事項
## 実装プロンプト（Claude Code 用）
## 推奨実行モデル
## 変更履歴
## 仕様書作成プロンプト

{ "file": "dev/dev_mas-036_rd_roi_dashboard.md", "title": "E.5.X MAS-036 R&D ROI ダッシュボード" }