MAS-141: 節税・共済効果シミュレーター（小規模企業共済 + 経営セーフティ共済）

概要

目的

1 人法人の最重要節税手段を定量化し、最適掛金設定を支援する。

小規模企業共済（掛金上限月 7 万円・年 84 万円・全額所得控除）と経営セーフティ共済（月 20 万円・年 240 万円・全額損金算入・積立上限 800 万円）を対象に、想定当期利益・役員報酬・掛金から法人税・所得税の軽減額を計算する。掛金 0 〜上限のスキャンで「限界節税額」一覧を提示し、ユーザーが手元資金の最大化と現預金拘束のトレードオフを即座に判断できる。

MAS-041（繰越欠損金）/ MAS-049（賃上げ税制）は法人税額控除、本案件は役員個人の所得控除を含む複合節税シミュレーションで、より包括的な「税引後キャッシュ最大化」を扱う。MAS-057 BRD §6 UX 戦略の「共済積立額スライダー」を実装する基盤となる。

現在のコード

本案件は MAS-057 Phase 1/1.5 で確立した PersonalTaxEngine を順呼び出して、共済掛金を所得控除（個人）/ 損金算入（法人）に算入した状態の税額差分を算出するアグリゲータ。新規ロジックは共済 2 種の制度パラメータ管理 + スキャン + 出口リスク警告のみ。

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

法定実効税率（既存・本案件で参照）

法人税合算実効税率は約 34%（軽減区分は約 22%）。本案件は実際の課税所得ベースで Constants.TAX_RATES を順呼び出して個別計算する（平均実効税率近似ではなく累進ベース正確算出）。

MAS-061 Cash ETR（仕様書完了・本案件と相互参照）

MAS-061 の「合法節税優先順位サジェスト」が本案件の simulateScan 結果を呼び出して優先順位リストに統合。MAS-141 が共済 2 種の効果を spec の責任範囲、MAS-061 が複数節税策の統合スコアリング という役割分担。

修正方針

Step 1 — 共済 2 種の制度パラメータ集中管理

2024-10 改正の重要ポイント: 経営セーフティ共済を解約後 2 年以内に再加入した場合は損金算入不可（S69_BIZ_REJOIN_RESTRICTION_YEARS = 2）。spec 上で警告表示必須。

// 03_sys_params 経由で読込（年次更新時に変更可能）
var KYOSAI_PERSONAL = {
  minMonthly: Constants.getParam('S69_KYOSAI_PERSONAL_MIN_MONTHLY', 1000),
  maxMonthly: Constants.getParam('S69_KYOSAI_PERSONAL_MAX_MONTHLY', 70000),
  step:        Constants.getParam('S69_KYOSAI_PERSONAL_STEP', 1000),
};
var KYOSAI_BIZ = {
  minMonthly: Constants.getParam('S69_KYOSAI_BIZ_MIN_MONTHLY', 5000),
  maxMonthly: Constants.getParam('S69_KYOSAI_BIZ_MAX_MONTHLY', 200000),
  totalCap:   Constants.getParam('S69_KYOSAI_BIZ_TOTAL_CAP', 8000000),
};

Step 2 — 単点シミュレーション（指定掛金での税額差分）

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

var TaxSavingSimulator = (function () {

  /**
   * @param {Object} input
   * @param {number} input.corporateTaxablePretax  共済掛金算入前の法人税課税所得
   * @param {number} input.officerCompAnnual       役員報酬年額
   * @param {number} input.kyosaiPersonalMonthly   小規模企業共済の月額掛金
   * @param {number} input.kyosaiBizMonthly        経営セーフティ共済の月額掛金
   * @param {number} input.kyosaiBizCumulative     経営セーフティ共済 既積立額
   * @param {boolean} [input.isOver40]             40 歳以上（介護保険料）
   * @returns {{
   *   corporateTaxBefore, corporateTaxAfter, corporateTaxSaving,
   *   personalTaxBefore, personalTaxAfter, personalTaxSaving,
   *   totalSaving, netCashBefore, netCashAfter,
   *   warnings: Array<string>
   * }}
   */
  function simulatePoint(input) {
    var p = _loadParams_();

    // (a) 入力バリデーション + 上限到達チェック
    var warnings = [];
    var bizMonthly = _clampBizMonthly_(input.kyosaiBizMonthly, input.kyosaiBizCumulative, p, warnings);
    var personalMonthly = _clampPersonalMonthly_(input.kyosaiPersonalMonthly, p, warnings);

    // (b) 法人税: セーフティ共済を損金算入した場合の課税所得差分
    var bizAnnual = bizMonthly * 12;
    var corporateTaxableAfter = input.corporateTaxablePretax - bizAnnual;
    var corporateTaxBefore = _calcCorporateTax_(input.corporateTaxablePretax);
    var corporateTaxAfter  = _calcCorporateTax_(corporateTaxableAfter);
    var corporateTaxSaving = corporateTaxBefore - corporateTaxAfter;

    // (c) 個人税: 小規模企業共済を所得控除に算入した場合の差分
    var personalAnnual = personalMonthly * 12;
    var taxableIncomeBefore = _calcTaxableIncomeFromGrossComp_(input.officerCompAnnual, input.isOver40);
    var taxableIncomeAfter  = taxableIncomeBefore - personalAnnual;
    var personalTaxBefore = PersonalTaxEngine.calcIncomeTax(taxableIncomeBefore) +
                            PersonalTaxEngine.calcResidentTax(taxableIncomeBefore);
    var personalTaxAfter  = PersonalTaxEngine.calcIncomeTax(taxableIncomeAfter) +
                            PersonalTaxEngine.calcResidentTax(taxableIncomeAfter);
    var personalTaxSaving = personalTaxBefore - personalTaxAfter;

    return {
      corporateTaxBefore: corporateTaxBefore,
      corporateTaxAfter: corporateTaxAfter,
      corporateTaxSaving: corporateTaxSaving,
      personalTaxBefore: personalTaxBefore,
      personalTaxAfter: personalTaxAfter,
      personalTaxSaving: personalTaxSaving,
      totalSaving: corporateTaxSaving + personalTaxSaving,
      netCashBefore: -bizAnnual - personalAnnual + 0,
      netCashAfter:  -bizAnnual - personalAnnual + (corporateTaxSaving + personalTaxSaving),
      warnings: warnings,
    };
  }

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

Step 3 — スキャンシミュレーション（掛金 0 〜上限の限界節税額一覧）

function simulateScan(input, options) {
  var p = _loadParams_();
  var bizSteps = _generateSteps_(p.bizMin, p.bizMax, p.bizStep);             // 例: 0, 5000, 10000, ..., 200000
  var personalSteps = _generateSteps_(p.personalMin, p.personalMax, p.personalStep); // 例: 0, 1000, ..., 70000

  var results = [];
  for (var i = 0; i < bizSteps.length; i++) {
    for (var j = 0; j < personalSteps.length; j++) {
      var single = simulatePoint(_extend_(input, {
        kyosaiBizMonthly: bizSteps[i],
        kyosaiPersonalMonthly: personalSteps[j],
      }));
      results.push({
        bizMonthly: bizSteps[i],
        personalMonthly: personalSteps[j],
        totalSaving: single.totalSaving,
        netCashEffect: single.netCashAfter,  // 共済掛金支出 - 節税額 = 実質キャッシュアウト
        warnings: single.warnings,
      });
    }
  }
  // 「限界節税額」=「掛金 1 円増やしたときの節税効果」
  var marginalEffect = _calcMarginalEffect_(results);
  return { scan: results, marginalEffect: marginalEffect };
}

スキャン結果の出力先: 98_sim_tax_saving（DDL 外・動的生成）に表形式で書出し。ヒートマップ的に視認しやすい配置（行 = セーフティ掛金 / 列 = 小規模共済掛金 / セル = 総節税額）。

Step 4 — 限界節税額の算出（最適掛金設定の判断材料）

marginalEffect = 「掛金 1 円増やしたときの節税効果」。これが 0.40 を下回ったら効率低下（個人累進税率が下がるブラケット境界・法人軽減税率と標準税率の境界 等）。UI 上で限界節税効率の落ち込みポイントを視覚的にハイライト。

例: 役員報酬 600 万 + 想定法人課税所得 800 万のケース:

• 小規模共済 月 0 → 月 1 万: 限界節税効率 0.42（個人 23% + 住民 10% = 33% × 控除）
• 小規模共済 月 7 万: 限界節税効率 0.40 程度（同ブラケット内）
• セーフティ共済 月 0 → 月 5 万: 限界節税効率 0.34（軽減 15% + 地方 7% = 22%）
• セーフティ共済 月 20 万: 限界節税効率 0.34（800 万境界以下なら同水準）
• セーフティ共済 月 33.3 万（年 400 万）: 軽減税率境界突破で限界効率 0.40 へジャンプ

Step 5 — 出口リスク警告（解約時税務）

2024-10 改正の重要警告: 経営セーフティ共済を 解約後 2 年以内に再加入した場合は損金算入不可（S69_BIZ_REJOIN_RESTRICTION_YEARS）。spec 上で「過去 2 年以内に解約していないか」のチェックボックスを入力 UI に必須配置。チェック時は警告表示 + シミュレーション結果に「再加入制限該当: 損金算入不可」コメント追加。

Step 6 — メニュー統合 + サイドバー連携

000_infra/002_constants.js の MENU_DEFINITION:

📊 マート更新 カテゴリに追加:

{ label: '💰 共済節税シミュレーション (MAS-141)', funcName: 'openTaxSavingSimulator', description: '小規模企業共済 + 経営セーフティ共済の節税効果スキャン (MAS-141)' },

300_ui/301_ui_assist.js のサイドバーエントリ:

サイドバー UI に「共済シミュレーション」タブを追加。入力フォーム（想定法人課税所得・役員報酬・既積立額・40 歳以上フラグ・再加入制限チェック）→ simulateScan 呼出 → 結果ヒートマップ表示。

影響範囲

注意事項

1. 2024-10 改正の解約後再加入制限: 経営セーフティ共済を解約後 2 年以内に再加入した場合は損金算入不可。spec 上で「過去 2 年以内に解約していないか」の UI チェックボックスを必須配置。チェック時は損金算入不可フラグで再計算 + 警告表示。S69_BIZ_REJOIN_RESTRICTION_YEARS で年数管理。

2. 解約時益金算入リスク（経営セーフティ共済）: 解約手当金は法人の益金として課税対象。spec は「節税ではなく課税繰延」を明示し、UI 上で「将来の解約時に法人税課税が戻る」コメント自動付加。MAS-058 連携時は将来年度の課税所得増を見込む warning。

3. 小規模企業共済の出口課税最適化: 一括受取（退職所得）vs 分割受取（雑所得）で税負担が大きく変わる。spec v1 では一括受取（退職所得控除有利）を default 算出。分割受取の選択肢は v2 で追加。20 年加入で退職所得控除 800 万を案内コメントで提示。

4. 個人所得税ブラケットの境界効果: 課税所得が 195 万 / 330 万 / 695 万 / 900 万 / 1,800 万 / 4,000 万のブラケット境界で限界節税効率が変化。PersonalTaxEngine.calcIncomeTax の累進計算結果をそのまま使い、spec 内で再計算しない（DRY 原則）。

5. 法人税軽減税率の 800 万境界: 法人課税所得 800 万以下は 15% / 超は 23.2%（地方税合算で実効率 22% / 34%）。セーフティ共済掛金で 800 万を切るかどうかが大きな分岐点。スキャン結果でこの境界を視覚的にハイライト。

6. 掛金支払のキャッシュフロー影響: 共済掛金は実支払が発生する（節税ではなく現預金の制度内拘束）。netCashEffect フィールドで「掛金支払 - 節税額」= 実質キャッシュアウトを併記し、UI 上で「キャッシュは X 円減るが税負担は Y 円減る」を明示。

7. failure_patterns #25 遵守（並列実装対称性）: MAS-057 SocialInsuranceTierEngine / MAS-058 RequiredRevenueSolver と純粋関数 + Constants.getParam パターンで対称。simulatePoint / simulateScan は MAS-057 既存メソッド命名と整合（動詞 + 目的語）。

8. failure_patterns #18-#20 遵守（命名造語禁止）: 関数名 simulatePoint / simulateScan / TaxSavingSimulator は既存命名と整合。「共済」「Kyosai」を変数名に使うが、これは制度名（既存業界用語）で新語ではない。Read で既存ファイルに同名関数がないことを着手時に裏取り。

9. failure_patterns #26 遵守: appsscript.json の OAuth スコープは変更不要（既存スコープ内で完結）。

10. 法令変更時の年次更新フロー: 共済掛金上限は法令で変動可能性あり（2025/2026 改正動向は要 watch）。03_sys_params の S69_* キーを年次更新するだけで対応できる構造を維持。Constants 直接書き換えは禁止（テナント別オーバーライドを将来許可するため）。

11. 小規模企業共済加入資格の制約: 個人事業主または小規模企業の役員のみ加入可能（従業員 20 名以下の業種制限あり）。spec は加入資格 OK 前提（一人法人前提）。商用化時の加入資格チェックロジックは v2 で追加。

12. MAS-061 Cash ETR 統合時の優先順位ロジック: MAS-061 が複数節税策を統合スコアリングする際、本案件の simulateScan 結果から 限界節税効率の高い掛金 + 残予算 をサジェスト候補として渡す。MAS-061 spec の「節税優先順位サジェスト」アルゴリズムと整合。

13. 「税引後キャッシュ最大化」の評価軸: 単純な税額削減額ではなく、「(税額削減 - 掛金支払) + 退職時受取の現在価値」 で評価するのが本質。spec v1 では現在価値割引なしの単純差分を採用、v2 で NPV ベース評価を検討（F58_NPV_DISCOUNT_RATE キーで割引率管理）。

エッジケース

実データ検証

1. 齋藤 Baseline での期待値（役員報酬 600 万 / 想定法人課税所得 800 万 / 40 歳未満）

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

2. 限界節税効率の境界点検証

役員報酬 1,200 万（個人課税所得 約 900 万・税率 23%）→ 小規模共済 7 万まで限界効率 33% で一定。役員報酬 1,800 万（個人課税所得 約 1,500 万・税率 33%）→ 限界効率 43% にジャンプ。これらの境界が spec の _calcMarginalEffect_ 出力で正確にトラックされることを単体テスト S69-06/S69-07 で検証。

3. 法人税軽減税率境界（800 万）の検証

想定法人課税所得 1,000 万 + セーフティ共済 月 17 万（年 204 万）→ 課税所得 796 万に圧縮 → 軽減税率適用で節税効果ジャンプ。スキャン結果のヒートマップでこの境界が視認できることを実機確認。

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

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

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

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

関連ドキュメント

人間が検討すべき事項

1. 小規模企業共済の出口受取方式 default: 一括受取（退職所得・spec 採用）vs 分割受取（雑所得）。20 年加入後の試算で一括受取が有利だが、ユーザー意向で切替可能にするか。

2. 限界節税効率 0.40 の閾値妥当性: 個人 33% + 法人 22% を境にする数値だが、住民税均等割や事業税の細部で異なる。現行 spec はざっくり 0.40 採用、業界税理士レビューで再評価。

3. 掛金スキャン粒度: 千円刻み（小規模共済）/ 5,000 円刻み（セーフティ共済）の現行設定で 71 × 41 = 2,911 セル。GAS 6 分制限と UI 視認性のバランス。粗くするか / 動的にスキャン範囲を絞るか。

4. 2024-10 改正の解約後再加入制限の警告 UI: チェックボックスでの自己申告のみで OK か / 過去解約履歴を別マスタで管理するか。商用化時のテナント別履歴管理が必要になる可能性。

5. NPV ベース評価への拡張（v2 候補）: 現在価値割引率（F58_NPV_DISCOUNT_RATE）の default 値（5% / 3% / 0%）。共済 20 年積立の長期評価で大きな差が出る。MAS-058 と共有定数化する設計。

6. MAS-058 必要年商連動の実装タイミング: MAS-058 spec で共済掛金を固定費に算入するロジックは v2 候補。MAS-141 単体実装後に MAS-058 連携を別 PR で追加するか、同時実装するか。

7. MAS-061 Cash ETR 優先順位サジェストへの統合タイミング: MAS-061 実装と本案件実装の前後関係。本案件先行 → MAS-061 が MAS-141 結果を呼出する形が筋。

8. MAS-056 対話 UI Tool 登録タイミング: MAS-056 Phase 2 で Tool 登録するか、Phase 3 で個人 B/S 統合と合わせて統合するか。MAS-058 注意事項 #5 と同じ判断軸。

9. 業務委託・アルバイト等への加入資格チェック: 商用化時のマルチテナント対応で「小規模企業共済加入資格 OK ですか？」を初期セットアップウィザードで確認するか、運用前提として spec 外とするか。

10. 共済以外の節税策（iDeCo / NISA / ふるさと納税）の追加判断: spec v1 は共済 2 種のみ、v2 で iDeCo（月 6.8 万・全額所得控除）/ NISA / ふるさと納税の併設検討。一人法人の最重要節税は共済 2 種で完結するため v1 はスコープ絞り推奨。

11. 税率パラメータの年次更新運用: 法人税・個人税ブラケットは年次税制改正で変動。Constants.TAX_RATES / Constants.INCOME_TAX_BRACKETS の更新フロー（毎年 3 月税制改正後に直接更新）を spec で明示。

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

Claude Sonnet 4.6 推奨。MAS-057 エンジン結合 + スキャンアルゴリズム + 出口リスク警告の中難易度。

## 案件
MAS-141 — 節税・共済効果シミュレーター（小規模企業共済 + 経営セーフティ共済）

## 事前調査（必ず Read する）
1. `docs/dev/dev_mas-141_tax_saving_simulator.md` 全文（本仕様書）
2. `docs/brd_solo_ceo_financial_navigator.md` §4.3（共済積立額スライダー）
3. `400_domain/442_social_insurance_tier_engine.js` 全文
   — PersonalTaxEngine.calcIncomeTax/calcResidentTax の関数シグネチャ確認
4. `docs/dev/dev_mas-057_solo_ceo_cockpit.md` §実データ検証（数値整合）
5. `docs/dev/dev_mas-058_required_revenue_solver.md` 純粋関数 + Constants.getParam パターン手本
6. `docs/dev/dev_mas-061_cash_etr_tracking.md` 統合先のサジェストアルゴリズム
7. `000_infra/002_constants.js` — Constants.TAX_RATES.brackets / INCOME_TAX_BRACKETS / getParam
8. `300_ui/301_ui_assist.js` サイドバー実装パターン
9. `docs/_internal/failure_patterns.md` #18-#20 / #25 / #26

## 実装対象

1. `400_domain/451_tax_saving_simulator.js` 新規（IIFE 名前空間 TaxSavingSimulator）:
   - simulatePoint(input) — 単点シミュレーション
   - simulateScan(input, options) — スキャン（71 × 41 セル）
   - 内部ヘルパ: _loadParams_ / _clampBizMonthly_ / _clampPersonalMonthly_ /
     _calcCorporateTax_ / _calcTaxableIncomeFromGrossComp_ / _calcMarginalEffect_

2. `000_infra/002_constants.js` の MENU_DEFINITION:
   - 「📊 マート更新」カテゴリに「💰 共済節税シミュレーション (MAS-141)」追加

3. `300_ui/301_ui_assist.js` 拡張:
   - サイドバーに「共済シミュレーション」タブ追加
   - 入力フォーム + ヒートマップ表示

4. `03_sys_params` の 8 キー追加（default は Constants.getParam の第 2 引数）

5. `8XX_migration_s69_sys_params.js` 新規（任意・番号は `ls 800_ops/` で次番取得）:
   - S69_* キーのシーダー（MAS-232 Stage 2 の 813 と同パターン）

6. `900_test/901_test_runner.js` に S69-01〜S69-13 単体テスト

## 動作確認
1. 齋藤 Baseline 4 ケース（共済 0/0, 7/0, 0/20, 7/20）の合計節税 ±5% 一致
2. 限界節税効率の境界点検出（役員報酬 1,200 万 → 1,800 万）
3. 法人税軽減税率 800 万境界のヒートマップ表示
4. MAS-057 PersonalTaxEngine との数値整合 ±1 円一致
5. エッジケース 13 項目すべて想定通り

## デプロイ
1. dev で push:dev → メニュー「💰 共済節税シミュレーション」実行 → 98_sim_tax_saving 確認
2. Go なら push:prod
3. コミット: feat(MAS-141): 節税・共済効果シミュレーター (小規模 + セーフティ + 限界節税効率)

## failure_patterns チェック
- #18-#20: TaxSavingSimulator / simulatePoint / simulateScan を Read で裏取り
- #25: MAS-057 PersonalTaxEngine と純粋関数 + Constants.getParam パターン対称
- #26: appsscript.json は変更なし

推奨実行モデル

変更履歴