パイプライン計画データ読込 — dmIngestPipelinePlanData

1. 基本情報

焦点質問: パイプラインの確度別売上見込みをどう計画に反映するか？

設計方針

インメモリアプローチ（仮想INVの動的生成）を採用。

• 32_wrk_invoice（物理INV台帳）には不確実なヨミのデータを書き込まない
• Datamart構築時に 21_bud_pipeline を読み込み、確度加重した「仮想INVイベント」をメモリ上で生成
• 計画用配列（planCtx.finalUnionData）に concat して、既存の dmProcessAllEvents_ で処理
• 確度の変更は次回マート更新時に即座に反映される

2. インターフェース定義

3. データスキーマ

入力スキーマ (21_bud_pipeline)

出力スキーマ (仮想INVイベント)

Array<{
  pYm: string,       // 発生月（売上計上月）
  sYm: string,       // 決済月（入金月 = pYm + 入金ラグ）
  acc: string,        // 売上科目
  amt: number,        // 確度加重 × 税込金額（Math.round済み）
  booked: false,      // 計画扱い（期ずれ解消も生成）
  isBsForce: null,    // P/L扱い（売上）
  noCash: false       // CF対象
}>

4. 処理ロジック

4.1 確度変換 (STEP 1)

確度文字列 → 加重係数:
  "Sヨミ" or 100% → SKIP（受注確定 = 既にINV台帳にある前提）
  "Aヨミ" or 80%  → 0.8
  "Bヨミ" or 50%  → 0.5
  "Cヨミ" or 30%  → 0.3  ※ 20%→30%に変更（402_project_profitability.js と統一）
  "失注" or 0%   → 0（SKIP）
  数値N%          → N/100
  空              → 1.0（デフォルト）

Sヨミの二重計上防止: Sヨミ（受注確定）の案件はRPA起票で32タブにINV化される前提。 計画Datamartでも dmIngestPlanData_ が32タブの全INVを読むため、Sヨミを仮想INVに含めると二重計上になる。

4.2 パイプライン処理マトリクス (STEP 2-4)

4.3 合流 (STEP 5)

return pipelineEvents[]
→ 呼び出し元で planData = planData.concat(pipelineEvents)
→ planCtx.finalUnionData = planData
→ dmProcessAllEvents_(planCtx) で処理

4.4 呼び出し箇所の変更（602_datamart_main.js）

  var planData = dmIngestPlanData_(ctx, sheetInv);
  // 計上パイプラインのPHASE 2(STL消込)データも計画に含める
  for (var pi = 0; pi < ctx.finalUnionData.length; pi++) {
    var row = ctx.finalUnionData[pi];
    if (row.fromSTL) planData.push(row);
  }
+ // パイプライン（確度加重）を計画に合流
+ var sheetPipe = ss.getSheetByName('21_bud_pipeline');
+ if (sheetPipe) {
+   var pipeEvents = dmIngestPipelinePlanData_(ctx, sheetPipe);
+   planData = planData.concat(pipeEvents);
+ }
  planCtx.finalUnionData = planData;
  dmProcessAllEvents_(planCtx);

4.5 processEvent での自動処理

仮想INVイベントは booked: false で acc: "売上高" 等の売上科目を持つ。 processEvent は以下を自動処理する：

CF: booked: false のため計画CFに反映。sYm月に入金として計上。

5. 財務ロジック (FRD)

※ 本セクションは経理担当・CFOが検証可能な表現で記述。技術用語は使用しない。 → 技術詳細: SS4 処理ロジック 参照

5.1 確度加重

パイプライン上の未受注案件は、受注確度（ヨミ）に応じた加重係数を乗じて計画売上に反映する。受注確定（Sヨミ）の案件は既に請求台帳に登録されるため、二重計上を防止するために計画展開の対象外とする。

5.2 入金ラグと期ずれ

売上の計上月と入金月にずれがある場合（入金ラグ）、売上計上月に売上債権（未収入金）が発生し、入金月にその債権が回収される。これにより計画B/Sに売上債権が反映され、計画CFでは入金月に現金入金として計上される。

5.3 消費税の補正

パイプラインの金額は税抜で入力する。計画への反映時には税込金額（税抜 x 確度 x (1 + 消費税率)）に変換する。

5.4 業務ルール・注意点

1. Sヨミの二重計上防止 -- Sヨミ=受注確定はRPA起票から請求台帳にINV化される。仮想INVに含めると二重になる
2. 消費税の補正 -- パイプラインの金額は税抜。仮想INVでは 金額 = 端数処理(税抜 x 確度 x (1 + 税率)) で税込に変換
3. 継続月数のデフォルト -- 契約形態に「継続」を含む場合は入力値、「スポット」の場合は1、未指定は120（10年上限）
4. 対象期外のスキップ -- 対象期最終月を超える月は生成しない
5. パイプラインは計画シートのみに反映 -- 計上シート（61/62/71/81/83）には一切影響しない
6. 着手金＋残金パターン -- 確度や入金時期が異なる場合は21タブで2行に分けて登録する運用ルール
7. 確度変換は402_project_profitability.jsと統一 -- 同じ変換ロジックを使用。Cヨミ=30%

6. 冪等性・整合性保証

7. テスト仕様

7.1 単体テスト観点

7.2 テストデータ・期待結果

テストデータ（21タブ 3行）

期待結果（対象期: 2025-04〜2026-03 の場合）

行1 (A社 スポット): 計上開始=2026-06 → 対象期外 → 0件 行2 (B社 継続MRR): 計上開始=2026-04 → 対象期外（2026-03まで）→ 0件 行3 (C社 Sヨミ): Sヨミ → SKIP（二重計上防止）

期待結果（対象期: 2026-04〜2027-03 の場合）

行1 (A社 スポット Aヨミ):

prob = 0.8, taxRate = 0.10
amt = round(1,000,000 × 0.8 × 1.1) = 880,000
pYm = "2026-06", sYm = "2026-08" (ラグ2)
→ 仮想イベント 1件

行2 (B社 継続MRR Bヨミ):

prob = 0.5, taxRate = 0.10
weightedMrr = round(100,000 × 0.5 × 1.1) = 55,000
計上開始=2026-04, 継続12ヶ月 → 2026-04〜2027-03
→ 仮想イベント 12件（各55,000）, sYm = pYm + 1ヶ月

行3 (C社 Sヨミ): SKIP

計画P/Lへの反映（売上高）:

計画B/Sへの反映（売上債権・未収入金）:

付録

付録A: 関連仕様書