MAS-066: 配当ミックス最適化（役員報酬 + 賞与 + 配当の 3 軸最適化）

概要

目的

MAS-057 Phase 3 実装完了後の振り返りで「MAS-057 / MAS-058 は給与系（報酬 + 賞与）のみで配当を扱っていない・特に高所得帯で配当ミックスが手取り最大化に有利」気付きから派生した案件。

BRD §3.2 デッドヒート 3 ルート（A 役員報酬 / B 賞与 / C 株式配当・v2.1 で拡張済）を完成させ、年収帯別の最適配分曲線を提供する。配当は社保ゼロ + 配当控除（10% / 12.8%）の特性を持つが、法人税後利益から支払（損金 NG）+ 会社法 461 条の分配可能額制約 + 株主総会決議事務工数を伴うため、年収 1,500 万超のゾーンで社保頭打ち + 個人累進高税率の組合せにより役員報酬代替手段として有利になる。

齋藤 Baseline の現フェーズ（年収 600-1,000 万帯）では優先度低・将来課題（BRD §8）。実装は MAS-057 Step 6（3 区分テーブル）+ MAS-058 Step 5（UI/SPA 連携）完了後の UI フレーム安定後を推奨。

現在のコード

本案件は MAS-057 Phase 1/1.5 で確立した PersonalTaxEngine を順呼び出して、配当所得を総合課税で算入した状態の税額差分を算出するアグリゲータ。新規ロジックは配当税制パラメータ管理 + 配当控除算出 + 3 軸最適化スキャン + 分配可能額バリデーションのみ。

MAS-057 Phase 1（✅ 完了）の利用関数

既存定数の構造（拡張時の参考）

Constants.INCOME_TAX_BRACKETS は { brackets: [{ upTo, rate, deduction }, ...] } 形式。本案件で新設する Constants.DIVIDEND_TAX_BRACKETS も同パターンで設計（並列対称性・failure_patterns #25 遵守）。

MAS-061 Cash ETR（v1.1・本案件と相互参照）

MAS-061 v1.1 の §6-3「合法節税優先順位サジェスト」連携策テーブルに 配当ミックス最適化（MAS-066 起票） が追加済（PR #382 で対応）。MAS-141 が共済 2 種、MAS-066 が配当ミックスの役割分担で、両者の simulateScan 結果を MAS-061 が統合スコアリングする設計。

MAS-057 Phase 3 SPA 基盤の流用

webapp_client/scripts/sync-engines.mjs（PR #379 で確立）が 400_domain/{442,443,444,445}*.js を webapp_client/src/engines/ にコピー + window 露出する仕組み。本案件で 449 を sync 対象に追加するだけで MAS-066 ドメインエンジンも同じ SSoT 共有方式が適用される（TypeScript 複製ゼロ）。

UI 統合方式は人間検討事項 #1 で要判断（案 A: MAS-057 cockpit に 4 つ目ドロップダウン追加 / 案 B: MAS-066 独立 cockpit 新設）。

修正方針

Step 1: 配当税制パラメータの整備

Constants.DIVIDEND_TAX_BRACKETS を新設（000_infra/002_constants.js・既存 INCOME_TAX_BRACKETS 直後に追加）:

// Constants.DIVIDEND_TAX_BRACKETS (本案件で新設・2026 年税制対応)
Constants.DIVIDEND_TAX_BRACKETS = {
  // 上場株式配当（申告分離課税の場合・一律 20.315%）
  listed_separated: {
    rate: 0.20315,  // 所得税 15.315% + 住民税 5%
    incomeTaxRate: 0.15315,
    residentTaxRate: 0.05,
  },
  // 上場株式配当（総合課税の場合・配当控除あり）
  listed_combined: {
    creditRate: 0.10,  // 課税所得 1,000 万以下: 配当所得 × 10%
    creditRateOver1000: 0.05,  // 1,000 万超部分: 5%（配当控除半減）
    residentTaxCreditRate: 0.028,  // 住民税側配当控除 2.8% (1,000 万超は 1.4%)
    residentTaxCreditRateOver1000: 0.014,
  },
  // 非上場株式配当（総合課税のみ・配当控除あり）
  unlisted_combined: {
    creditRate: 0.10,
    creditRateOver1000: 0.05,
    residentTaxCreditRate: 0.028,
    residentTaxCreditRateOver1000: 0.014,
    minorityShareholderThreshold: 100000,  // 10 万円以下は申告不要可（少額配当・非上場）
  },
};

法令変更時の年次更新フロー（注意事項 #11 と整合）: 毎年 3 月税制改正後に 002_constants.js を直接編集して更新。03_sys_params の F66_* キーは default 上書き用で、税制本体は Constants 一元管理。

Step 2: 配当所得計算 + 配当控除エンジン

// 400_domain/449_dividend_mix_optimizer.js (純粋関数 + IIFE 名前空間)

var DividendMixOptimizer = (function () {

  /**
   * @param {Object} input
   * @param {number} input.dividendAmount      配当年額（円）
   * @param {number} input.salaryIncome        給与収入額（年額・給与所得控除前）
   * @param {number} input.dividendIncome      配当収入額（同 input.dividendAmount と等価・将来名称統一）
   * v1.1: input を「課税所得」から「収入」に変更（Gemini レビュー Major 2 反映）
   *       基礎控除の逓減（合計所得 2,400 万超で逓減・3,000 万超で消失）に対応するため、
   *       課税所得を内部で再計算する必要がある
   * @param {string} input.dividendType        'listed_combined' / 'listed_separated' / 'unlisted_combined'
   * @returns {{ incomeTax, residentTax, dividendCredit, netDividend }}
   */
  function calcDividendTax(input) {
    var bracket = Constants.DIVIDEND_TAX_BRACKETS[input.dividendType];
    if (!bracket) throw new Error('Unknown dividendType: ' + input.dividendType);
    if (input.dividendType === 'listed_separated') {
      // 申告分離課税: 一律 20.315%（給与所得とは合算しない）
      var incomeTax = input.dividendAmount * bracket.incomeTaxRate;
      var residentTax = input.dividendAmount * bracket.residentTaxRate;
      return {
        incomeTax: incomeTax,
        residentTax: residentTax,
        dividendCredit: 0,
        netDividend: input.dividendAmount - incomeTax - residentTax,
      };
    }
    // 総合課税: 累進 + 配当控除（v1.1 で総所得ベース再計算に修正・Gemini レビュー Major 2 反映）
    // ① 給与所得 = 給与収入 − 給与所得控除（年収 850 万超は 195 万円固定）
    var salaryIncomeAfterDeduction = _calcSalaryIncomeAfterDeduction_(input.salaryIncome);
    // ② 合計所得金額 = 給与所得 + 配当所得（総合課税）
    var totalIncome = salaryIncomeAfterDeduction + input.dividendAmount;
    // ③ 基礎控除（合計所得 2,400 万以下: 48 万 / 2,400-2,450 万: 32 万 / 2,450-2,500 万: 16 万 / 2,500 万超: 0）
    var basicDeduction = _calcBasicDeduction_(totalIncome);
    // ④ 課税所得 = 合計所得 − 基礎控除 − 社保控除 − 他控除
    var totalTaxable = Math.max(0, totalIncome - basicDeduction - (input.otherDeductions || 0));
    var grossIncomeTax = PersonalTaxEngine.calcIncomeTax(totalTaxable);
    var dividendCredit = _calcDividendCredit_(input.dividendAmount, totalTaxable, bracket);
    var incomeTax = Math.max(0, grossIncomeTax - dividendCredit);
    var grossResidentTax = totalTaxable * 0.10;
    var residentCredit = _calcResidentDividendCredit_(input.dividendAmount, totalTaxable, bracket);
    var residentTax = Math.max(0, grossResidentTax - residentCredit);
    var taxOnDividend = (incomeTax + residentTax) * (input.dividendAmount / totalTaxable);
    return {
      incomeTax: incomeTax,
      residentTax: residentTax,
      dividendCredit: dividendCredit,
      netDividend: input.dividendAmount - taxOnDividend,
    };
  }

  return { calcDividendTax: calcDividendTax /* 他 */ };
})();

配当控除のブラケット境界処理: 課税所得 1,000 万を跨ぐ場合は、1,000 万までは 10% / 1,000 万超部分は 5% で按分計算（spec エッジケース #5 で網羅）。

【v1.2 追記】配当は離散イベント・月按分しない:

配当は株主総会決議で確定する金額であり離散イベントとして扱う。MAS-066 PR (#402) 実装では dividendAnnual 入力額を Y1 短縮事業年度でも按分せずそのまま使う。

設計理由:

• 入力 50 万 → 法人留保からきっかり 50 万減るのが直観的
• 会社法 461 条の分配可能額もこの設計と整合 (決議額 = 計上額)
• 配当は給与・固定費・法人保険料等のように毎月発生する支出ではない

他の年額項目との非対称性: cockpit の他の年額項目 (給与・固定費・法人保険料等) は monthFactor で按分するが、配当のみ按分しない。webapp_client/src/cockpit/calc.ts の computeYearlyBreakdown で配当処理時のみ dividendIncome = dividendAnnual (按分式 × monthFactor を適用しない) で実装されている。

Step 3: 3 軸最適化スキャン（A + B + C）

齋藤 Baseline + 高所得帯（年収 1,500 万）で 3 軸スキャン:

総組合せ: 16 × 7 × 11 = 1,232 セル。スキャン結果を「総報酬合計」「世帯純資産」「税負担合計」「社保負担合計」「配当ミックス比率」の 5 軸で評価し、パレート最適解を強調表示。

GAS 6 分制限への対応: simulateScan は純粋 JS 計算のみで 1 セル 1ms 想定 → 1,232 セル × 1ms = 1.3 秒で完走可能（クライアント側計算で実装する場合は更に高速）。

Step 4: 分配可能額制約バリデーション（会社法 461 条準拠）

// v1.1 追記 (Gemini レビュー Minor 反映)・v1.2 で取得元を訂正: BS データ取得経路
//
// validateDistributableAmount が要求する以下のフィールドは UI 層 / SPA bridge で
// 既存 BS シートから抽出して input に詰める前処理が必要。
//
// **【v1.2 訂正】v1.1 では `91_fs_bs` から抽出するとしていたが事実誤り**:
// `91_fs_bs` は決算 B/S で**動的生成タブ**であり、行/列構造が決算実行時に書き換わる。
// 正しい取得元は **`71_bs` (DDL 管理対象・行=科目/列=月の安定構造)**。
//
// | フィールド | 取得元 (v1.2 訂正) | 抽出方法 |
// |---|---|---|
// | retainedEarnings (利益剰余金) | **`71_bs`** (DDL 管理対象・行=科目/列=月の安定構造) | `BalanceSheetReader.getRetainedEarnings(fiscalYear)` (新設・別 PR) |
// | capitalSurplusOther (その他資本剰余金) | **`71_bs`** | 同上 |
// | treasuryStock (自己株式) | **`71_bs`** | 同上・通常は 0 |
// | previousDividends (既配当額) | `42_trn_journal` (配当決議仕訳) | `JournalRepository.findByAccountId('未払配当金')` |
// | fiscalYearCount (会計年度カウント) | `100_config/101_sys_config.js` | 設立日 + 会計期間で算出 |
//
// **【v1.2 実装スコープ判断】F-66 PR #402 では `validateDistributableAmount` を
// 純粋関数のみ実装** (input は呼び出し側が手で詰める)。`BalanceSheetReader` 新設は
// **F-66 マージ後の追加開発案件**として残置。F-66 cockpit UI 上は配当ドロップダウンを
// 提供するのみで、分配可能額の自動 BS 検証は将来 PR で追加予定。

function validateDistributableAmount(input) {
  var distributable = input.retainedEarnings + input.capitalSurplusOther
                    - input.treasuryStock - input.previousDividends;
  var safetyBuffer = Constants.getParam('F66_DISTRIBUTABLE_AMOUNT_BUFFER', 0.20);
  var maxAllowed = distributable * (1 - safetyBuffer);
  if (input.fiscalYearCount < 1) {
    return { valid: false, reason: '1 期目決算前は配当不可', maxAllowed: 0 };
  }
  if (input.dividendAmount > maxAllowed) {
    return { valid: false, reason: '分配可能額超過（安全余力 20% 控除後）', maxAllowed: maxAllowed };
  }
  return { valid: true, maxAllowed: maxAllowed };
}

分配可能額の計算（簡易版）

分配可能額 = その他資本剰余金 + その他利益剰余金 − 自己株式 − 既配当額 − 法務省令で定める額

bizlp 適用シナリオ:

• 1 期目（2025-11 〜 2026-07 想定）: 決算確定までは配当決議不可
• 2 期目（2026-08 〜 2027-07）: 1 期目利益剰余金確定後・初の配当検討可

F66_DISTRIBUTABLE_AMOUNT_BUFFER（default 20%）で安全余力を確保。実値は顧問税理士相談で確定（人間検討事項 #3）。

Step 5: UI 統合（要判断・人間検討事項 #1）

案 A: MAS-057 cockpit に 4 つ目ドロップダウン追加（spec 推奨・実装容易）

webapp_client/src/cockpit/CompensationDropdowns.tsx に「配当年額」ドロップダウン追加（既存 3 ドロップダウン: 役員報酬月額 / 賞与年額 / 社宅 / 共済 と並列）。webapp_client/src/cockpit/calc.ts に calcDividendTax を組込。v1.1 で本案を確定採用（F66_UI_INTEGRATION_MODE フラグは削除・Gemini レビュー Major 1 反映）。

Pros: 実装容易・SSoT 維持・MAS-057 cockpit のサンキー / 3 区分テーブルで配当軸も統一表示 Cons: MAS-057 Phase 3 実装に手戻り発生・配当 disabled 時の表示制御が必要

案 B: MAS-066 独立 cockpit 新設

templates/dividend_cockpit.html + webapp_client/src/dividend/*.tsx（5 React コンポーネント）。MAS-067 マルチイヤー cockpit と同様の独立 cockpit 構造（?view=dividend_spa）。 v1.1 で本案は不採用（Gemini レビュー Major 1 反映・案 A 確定）。将来的に MAS-066 専用 UI が必要になった場合は本案を再検討（人間検討事項として残置）。

Pros: MAS-057 cockpit に手戻りなし・MAS-066 専用の高所得帯向け UI に特化可能 Cons: 実装規模大・3 cockpit（MAS-057/MAS-066/MAS-067）の運用負荷増

v1.1 で案 A 確定（Gemini レビュー Major 1 反映・実装プロンプトの分岐を削除し単一仕様化）。F66_UI_INTEGRATION_MODE フラグは廃止。

Step 6: MAS-061 Cash ETR 連携 + MAS-058 v2 拡張 + MAS-067 連携

MAS-061 連携（v1.1 で対応済）

MAS-061 v1.1（PR #382）の節税優先順位サジェストに MAS-066 simulateScan 結果を統合する API:

// 連携 API (F-61 から呼出される)
function getDividendMixOptimization(input) {
  var scan = DividendMixOptimizer.simulateScan(input);
  return {
    bestMix: scan.paretoOptimal[0],
    marginalEffect: scan.marginalEffect,
    risks: ['1 期目決算前は配当不可', '会社法 461 条分配可能額制約'],
  };
}

MAS-058 v2 拡張（別 PR・MAS-058 v2 起票後）

MAS-058 v2 で dividendMixRatio を solveRequiredRevenue の input に追加し、配当併用時の必要年商再計算を実装。MAS-058 spec の労働分配率制約（≤ 65%）の分子は役員報酬のみ → 配当併用で分子が減り粗利要件が緩む効果を反映。

MAS-067 マルチイヤー連携

MAS-067 spec v1.0（PR #386）の F67_DIVIDEND_INTEGRATION_ENABLED フラグで配当軸を任意有効化。MAS-066 仕様書完成後の MAS-067 Phase B 以降で本格統合。

影響範囲

注意事項

1. 会社法 461 条の分配可能額制約: 1 期目決算前は配当決議不可。分配可能額の 20% は安全余力として確保（F66_DISTRIBUTABLE_AMOUNT_BUFFER）。実値は顧問税理士相談で確定。違反時は validateDistributableAmount がエラー返却し UI で「配当決議不可」警告。

2. 株主総会決議の事務工数: 通常 1-2 時間 + 議事録作成。bizlp は一人法人なので手続き簡略化可だが記録は必須（税務調査時の証拠）。spec 内では事務工数は計算範囲外（人間判断・運用ガイドで対応）。

3. 配当源泉徴収（20.42%）: 支払時に源泉徴収・確定申告で精算。spec の calcDividendTax は確定申告後の実効税率を返却。源泉徴収のキャッシュフロー影響は別途 _computeDividendCashFlow_ ヘルパで算出。

4. 配当所得の住民税申告不要制度: 2024 年改正で原則廃止（所得税と住民税は同一申告必須）。spec はこの改正後ルール準拠で実装。F66_DIVIDEND_TAX_MODE で旧ルール（住民税申告不要）への切替は提供しない。

5. 配当ミックスの「最低限の社保」確保戦略: 役員報酬を月 8 万円未満にすると国民健康保険 + 国民年金へ強制切替（厚生年金資格喪失）。F66_MIN_OFFICER_COMP_FOR_INSURANCE（default 80,000）で警告閾値を管理。エッジケース #3 で対応。

6. 事前確定届出給与（賞与）と配当決議のタイミング相互制約: 賞与届出（株主総会決議日から 1 ヶ月以内）と配当決議（株主総会で同時決定可）のスケジュール調整必要。spec は F66_DIVIDEND_DECISION_FREQUENCY = annual を default とし、四半期配当等の頻度変更は v2 で対応。

7. failure_patterns #18-#20 遵守（命名造語禁止）: 関数名（calcDividendTax / simulateScan / validateDistributableAmount / DividendMixOptimizer）は既存命名規則と整合（動詞 + 目的語）。「Dividend」は業界標準英語で新語ではない。Read で既存ファイルに同名関数なきこと裏取り。

8. failure_patterns #25 遵守（並列実装対称性）: MAS-057 / MAS-058 / MAS-141 と純粋関数 + Constants.getParam パターンで対称。Constants.DIVIDEND_TAX_BRACKETS は Constants.INCOME_TAX_BRACKETS と同形式（{ brackets: [...] }）。

9. failure_patterns #26 遵守（oauthScopes）: appsscript.json は変更なし。

10. failure_patterns #29 遵守（V8→Java Infinity null・v1.1 で対策方針を境界処理に修正・Gemini レビュー Critical 2 反映 / v1.2 で _scrubInfinityForJSON_ の出自を訂正）: ❌ NG（v1.0 案）「Constants.DIVIDEND_TAX_BRACKETS に Infinity を含めない（Number.MAX_SAFE_INTEGER 使用）」 → 既存 Constants.INCOME_TAX_BRACKETS / TAX_RATES は upTo: Infinity を使用しており、本案件だけ別形式にすると failure_patterns #25（並列実装対称性漏れ）違反。✅ 採用方式（v1.1）: Constants.DIVIDEND_TAX_BRACKETS も既存定数と完全に同形式で upTo: Infinity を使用。Infinity → null 化の境界問題は 300_ui/302_spa_bridge.js の _scrubInfinityForJSON_(value) 純粋ヘルパで runDividendMixSimulation がクライアントへ返す直前に置換する。サーバー側ロジック（DividendMixOptimizer）は Infinity のまま動作。
    
    【v1.2 訂正】_scrubInfinityForJSON_ の出自: v1.1 では「MAS-067 v1.1 で確立した同パターン」と参照していたが、MAS-067 v1.1 PR (#388) では具体的な汎用ヘルパとしては未実装で、300_ui/302_spa_bridge.js 内の _buildF57CockpitBootstrap_ でインライン .map() 置換していただけだった。汎用ヘルパとして _scrubInfinityForJSON_(value) が初実装されたのは MAS-066 PR (#402) で、300_ui/302_spa_bridge.js 末尾に再帰的に array / object をスキャンして Infinity / -Infinity / NaN を Number.MAX_SAFE_INTEGER / -Number.MAX_SAFE_INTEGER / null に置換する純粋関数として追加された。_buildF57CockpitBootstrap_ の既存インライン置換は本 PR では触っていない (将来リファクタ候補・統一化予定)。

11. 税理士・公認会計士の個別助言代替不可: 全画面で常時表示の Disclaimer 必須（MAS-058 / MAS-061 / MAS-067 と同パターン）。「本提案は税理士・公認会計士の個別助言に代わるものではありません」を画面下部固定。

12. 租税回避行為（法人税法 132 条）警告: 同族会社の行為計算否認規定に該当しうる手法（過大配当による役員報酬不当圧縮等）は提案しない。spec 内で「経済合理性のない配当ミックス」は警告表示。MAS-061 v1.1 のガードレールと整合。

13. 法令変更時の年次更新フロー: 配当税率は 2024 年改正で住民税申告不要制度廃止 → 今後も改正可能性あり。Constants.DIVIDEND_TAX_BRACKETS の年次更新フロー（毎年 3 月税制改正後に 002_constants.js を直接編集）を spec で明示。

14. 「税引後キャッシュ最大化」の評価軸: 単純な税額削減額ではなく、「(税額削減 - キャッシュアウト) + 退職時受取の現在価値」 で評価するのが本質。spec v1 では現在価値割引なしの単純差分を採用、v2 で NPV ベース評価を検討（MAS-141 spec の注意事項 #13 と同パターン）。

エッジケース

実装時に必ず以下 15 件を単体テストでカバーする。

実データ検証

1. 齋藤 Baseline 拡張版（年商 5,000 万 + 役員報酬 1,000 万 + 配当 500 万）

実装完了後に以下を 901_test_runner.js で自動検証し、±5% 以内で一致を合格基準とする:

2. 配当控除のブラケット境界検証

3 ケースを単体テスト F66-04〜F66-06 で検証。

3. 分配可能額バリデーションの境界検証

• 1 期目（fiscalYearCount = 0）→ 配当不可
• 2 期目期首（fiscalYearCount = 1）+ 利益剰余金 1,000 万 + 安全余力 20% → maxAllowed = 800 万
• 配当 850 万入力 → エラー「分配可能額超過」
• 配当 800 万入力 → OK

4. MAS-057 PersonalTaxEngine との数値整合

calcDividendTax 内で呼び出した PersonalTaxEngine.calcIncomeTax / calcResidentTax の戻り値を MAS-057 単体テストの期待値と照合し、±1 円一致を合格基準とする（同一ライブラリ呼出のため）。

5. エッジケース検証（単体テスト F66-01〜F66-15）

エッジケースセクションの 15 項目それぞれを 1 テストケースとして 901_test_runner.js に追加。

関連ドキュメント

人間が検討すべき事項

1. UI 統合 vs 分離: ✅ v1.1 で解決済（Gemini レビュー Major 1 反映・案 A「MAS-057 cockpit 拡張」に確定・F66_UI_INTEGRATION_MODE フラグ廃止）。将来的に MAS-066 専用 UI が必要になった場合の再検討余地のみ残置（v2 候補）。

2. 配当税制 default モード: 上場（listed_combined）vs 非上場（unlisted_combined）vs 申告分離（listed_separated）。bizlp は非上場法人なので unlisted_combined が現実的だが、商用化時の顧客は上場法人ケースもあり得る。

3. 分配可能額の安全余力: default 20% の妥当性（顧問税理士相談必須）。SBI 証券等の実務目安では 10-30% が一般的。

4. 国民健康保険切替の閾値: 役員報酬月 8 万円境界の精度（実額確認必要）。社労士相談で実値確定。

5. bizlp の配当ミックス導入時期: 1 期目決算後（2026-08 〜 想定）の運用開始判断。決算確定後に MAS-066 仕様書 v1.0 → 実装着手の流れ。

6. 株主総会決議事務の自動化: GAS で議事録テンプレ自動生成するか（v2 候補）。一人法人なので手続き簡略化可だが記録自動化の価値あり。

7. MAS-058 v2 拡張のタイミング: MAS-066 実装と同時 or 別 PR。spec は別 PR 推奨（MAS-066 単体で完結 → MAS-058 v2 で連携追加）。

8. MAS-061 v1.2 連携実装のタイミング: MAS-066 仕様書完了後すぐ or MAS-066 実装後。MAS-061 v1.1 で API 連携の設計は済んでいるため、MAS-066 実装後の別 PR で対応推奨。

9. 税理士レビュー必須項目の整理: spec 内に「税理士確認待ち」マーカーを設置する基準（注意事項 #1 / #11、人間検討事項 #3 / #4 等）。

10. 顧客向けサービス化時の汎用化: bizlp 自身の運用を経て商用化時に顧客向けテンプレ化（PH-4）。上場 / 非上場の切替 UI、複数株主向けの按分計算等、商用化時の拡張余地。

11. 配当 + 共済（MAS-141）の複合節税シミュレーション: MAS-066 と MAS-141 を統合した「節税策横断的最適化」（v3 候補）。両者の限界節税効率を統一スコアで比較する設計。

12. 配当決議頻度の拡張: F66_DIVIDEND_DECISION_FREQUENCY = annual を default としたが、四半期配当（quarterly）や月次配当（monthly・米国 REIT 型）への拡張を v2 で検討。

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

Claude Opus 4.7（1M context）推奨。MAS-057 PersonalTaxEngine 結合 + 配当税制 + 会社法 461 条準拠 + 3 軸最適化アルゴリズム（1,232 セル）の複合判断。

## 案件
MAS-066 — 配当ミックス最適化（役員報酬 + 賞与 + 配当の 3 軸最適化）

## 事前調査（必ず Read する）
1. `docs/dev/dev_mas-066_dividend_mix_optimizer.md` 全文（本仕様書）
2. `docs/brd_solo_ceo_financial_navigator.md` §3.2 / §4.2 / §5.1 / §8（v2.1 改訂内容）
3. `tasks/prompts/task_F-66.md`（手動骨格プロンプト・PR #383）
4. `tasks/prompts/task_F-66.gemini.md`(Gemini 版・PR #385・補完視点)
5. `400_domain/442_social_insurance_tier_engine.js` 全文
   — PersonalTaxEngine.calcIncomeTax/calcResidentTax の関数シグネチャ確認
6. `docs/dev/dev_mas-057_solo_ceo_cockpit.md` v2.0（案 A 採用時の UI 拡張対象）
7. `docs/dev/dev_mas-058_required_revenue_solver.md` v1.2（純粋関数 + Constants.getParam パターン手本）
8. `docs/dev/dev_mas-061_cash_etr_tracking.md` v1.1(連携策テーブル)
9. `docs/dev/dev_mas-067_multiyear_planning_workspace.md` v1.0(MAS-067 Phase B 以降の連携先)
10. `000_infra/002_constants.js` — Constants.INCOME_TAX_BRACKETS / TAX_RATES.brackets / getParam
11. `webapp_client/src/cockpit/CompensationDropdowns.tsx`(案 A 採用時の改修対象)
12. `webapp_client/scripts/sync-engines.mjs`(449 を sync 対象に追加)
13. `docs/_internal/failure_patterns.md` #18-#20 / #25 / #26 / #29 / #31

## 実装対象

1. `400_domain/449_dividend_mix_optimizer.js` 新規(IIFE 名前空間 DividendMixOptimizer):
   - calcDividendTax(input) — 配当税計算 + 配当控除
   - simulateScan(input, options) — 3 軸スキャン(1,232 セル)
   - validateDistributableAmount(input) — 会社法 461 条準拠
   - getDividendMixOptimization(input) — MAS-061 連携 API
   - 内部ヘルパ: _loadParamsFromSysParams_ / _calcDividendCredit_ /
     _calcResidentDividendCredit_ / _computeDividendCashFlow_

2. `000_infra/002_constants.js` 拡張:
   - Constants.DIVIDEND_TAX_BRACKETS 新設(既存 INCOME_TAX_BRACKETS 直後)

3. UI 統合 (v1.1 で案 A 確定・案 B 廃止・Gemini レビュー Major 1 反映):
   - webapp_client/src/cockpit/CompensationDropdowns.tsx に
     配当年額ドロップダウン追加 (既存 3 ドロップダウンと並列で 4 つ目)
   - webapp_client/src/cockpit/calc.ts に calcDividendTax を組込

4. webapp_client/scripts/sync-engines.mjs 拡張(449 を sync 対象に追加)

5. 300_ui/302_spa_bridge.js 拡張:
   - bootstrap に F66_* キー追加
   - runDividendMixSimulation 関数追加
   - getDividendMixOptimization 関数追加(MAS-061 連携)

6. 03_sys_params の F66_* 5 キー追加

7. 8XX_migration_f66_dividend_seed.js 新規(任意・番号は `ls 800_ops/` で次番取得):
   - F66_* キーシーダー(MAS-232 / MAS-057 Phase 3 同パターン)

8. 900_test/901_test_runner.js に F66-01〜F66-15 単体テスト

## 動作確認
1. 齋藤 Baseline 拡張版(年商 5,000 万 + 配当 500 万)で 3 シナリオの世帯純資産 ±5% 一致
2. 配当控除のブラケット境界検証(1,000 万跨ぎの按分計算)
3. 分配可能額バリデーションの境界検証(1 期目不可・分配超過エラー)
4. MAS-057 PersonalTaxEngine との数値整合 ±1 円一致
5. 3 軸スキャン(1,232 セル)が GAS 6 分制限内で完走
6. エッジケース 15 項目すべて想定通り

## デプロイ
1. dev で push:dev → メニュー or MAS-057 cockpit から配当軸シミュレーション実行
2. Go なら push:prod
3. コミット: feat(MAS-066): 配当ミックス最適化 (3 軸スキャン + 会社法 461 条準拠 + MAS-061 連携)

## failure_patterns チェック
- #18-#20: DividendMixOptimizer / calcDividendTax / simulateScan を Read で裏取り
- #25: MAS-057 / MAS-058 / MAS-141 と純粋関数 + Constants.getParam パターン対称
- #26: appsscript.json は変更なし
- #29: Constants.DIVIDEND_TAX_BRACKETS は既存 INCOME_TAX_BRACKETS と同形式 (Infinity 使用) で
  整合性を維持 (v1.1・Gemini レビュー Critical 2 反映・定数 mutate 禁止)。
  Infinity null 化対策は 300_ui/302_spa_bridge.js の _scrubInfinityForJSON_(dto)
  境界処理 (MAS-067 v1.1 と同パターン) でクライアント送信直前に置換
- #31: 本仕様書起票時に Phase 1-A-pre 適用済(MAS-066 が次空き番号確認)

推奨実行モデル

変更履歴