MAS-337: 融資審査スコアリング機能（Loan Screening Score）

概要

目的

bizlp Solo-CEO（一人社長）が事業性融資（公庫・信金・地銀）を申請する前段階で、自社の財務状況が審査基準を通過できるかを 1 画面で診断し、不足軸とその補強アクションを可視化することを目的とする。

現状の問題

MAS-071 v1.1 の アプローチ D「融資対策」 は、MAS071_TARGET_PROFIT（default 600 万円）を入力定数として受け取り、OP_pre - 報酬 ≥ TargetProfit を満たす役員報酬上限を計算している。

しかし「なぜ 600 万なのか」の根拠は 821_migration_mas071_strategy_seed.js line 35 の description に 「公庫融資審査基準」 とあるのみで、算出ロジックを持っていない。実態は実務経験則ベースの定数:

借入額 ÷ 当期純利益 ≦ 10 年（= 債務償還年数 10 年以内）

5,000〜6,000 万円借りるなら、年間利益 500〜600 万円以上欲しい

このため以下の限界がある:

• ユーザーが目標融資額（3,000 万・5,000 万・1 億）を変えても TargetProfit が連動しない
• 業種別（IT / コンサル / 製造 / 小売 / 飲食）のリスク係数が反映されない
• 公庫以外の金融機関（信金・地銀・メガバンク）の審査基準に切り替えられない
• DSCR / 自己資本比率 / 自己資金比率など複数指標との総合判定ができない

User Story（解決対象）

MAS-058 / MAS-067 / MAS-071 との位置づけ

• MAS-058（健全性診断）: 現シナリオの財務健全性 6 制約（黒字 / ランウェイ / 緊急予備 / 営業利益率 / 留保率 / 労働分配率）を 1 点評価。本案件はその「外部評価視点（融資審査）」を補完する位置づけ
• MAS-071（4 アプローチ役員報酬）: アプローチ D の targetProfit を本案件の 動的算出値で上書きできるようにする（UI 手動上書き > 動的算出 > historical_default 600 万）
• MAS-067（5 軸マルチイヤー）: v0.1 は当期スナップ評価のみ・v2 で MAS-067 Phase E として「3 年後の追加融資 X 億評価」を多年シミュレーションに統合

公庫の融資審査基準・実務知識（背景セクション）

📌 本セクションは v0.1 起票時点の調査メモを集約。閾値・係数は公開情報 + 実務目安ベースであり、公庫内規（非公開）とは異なる可能性がある。実装時は注意事項 #2 を参照。

3.1 日本政策金融公庫（JFC）の概要

日本政策金融公庫（Japan Finance Corporation）は政府系金融機関で、3 つの事業を持つ:

Solo-CEO は通常「国民生活事業」（融資上限 4,800 万・平均融資額 約 700 万）。

3.2 主要商品マッピング（v0.1 で MAS_LOAN_PRODUCTS に投入する 4 商品）

3.3 審査の主要評価軸（定量・定性）と本案件のスコア化マッピング

📌 法的根拠の有無: 公庫の審査基準は内規であり、「経営者保証ガイドライン」（中小企業庁 / 全国銀行協会・2014 年）以外は法律で明文化されていない。本案件のスコアリングは公開情報 + 実務目安ベースであり、最終判断は金融機関面談に委ねる（注意事項 #1 / #2 参照）。

機能仕様

4.1 入力項目（cockpit 入力フォーム）

4.2 算出ロジック（複数指標による総合スコアリング）

v0.1 は案 A（ルールベース）で起動・v2 で案 C（ハイブリッド・AI 統合）へ拡張（人間が検討すべき事項 Q1 推奨）。

# Step A: 推奨 TargetProfit を 3 ロジックの max で算出
推奨_目標法人利益 = max(
  借入希望額 ÷ 必要利益カバー年数,        // 案 A: 債務償還年数ベース（10 年）
  年間元利返済額 × DSCR_目標,              // 案 B: DSCR ベース（1.3 倍）
  業種ベンチマーク利益                     // 案 C: 業種別下限（MAS_INDUSTRY_BENCHMARKS）
)

# Step B: 必要自己資金
必要自己資金 = 借入希望額 × 自己資金比率（商品別 default）

# Step C: 自己資本比率（純資産 / 総資産 ≧ 30% で公庫優良判定）
自己資本比率 = 純資産 ÷ 総資産

# Step D: スコアリング（重み付き総合・w_i は MAS337_WEIGHTS_JSON で調整可能）
スコア_pre = (
  w_1 × score_利益カバー +    // 純利益 / 必要利益カバー
  w_2 × score_DSCR +          // DSCR / DSCR_目標
  w_3 × score_自己資金 +      // 自己資金 / 必要自己資金
  w_4 × score_業歴 +          // min(業歴, 3) / 3
  w_5 × score_自己資本比率 +  // 自己資本比率 / 0.30
  w_6 × score_経営者属性      // 連帯保証 + 担保 + 信用情報の合成
)
スコア = clip(スコア_pre × 100, 0, 100)
ランク = A (≥85) / B (70-84) / C (50-69) / D (30-49) / E (<30)

重みの推奨値（v0.1 default・MAS337_WEIGHTS_JSON）:

業種ベンチマーク利益（MAS_INDUSTRY_BENCHMARKS の default 値）:

4.3 出力項目（cockpit パネル）

4.4 cockpit 配置

• MAS-058 Required Revenue Solver の隣接 / 配下（外部評価視点として MAS-058 健全性診断を補完）
• MAS-071 Compensation Strategy Simulator のアプローチ D 入力に逆流連動（cockpit state lift）
• default ON（前提・Solo-CEO の融資検討を起点とする想定）

4.5 ステータス・スコア表示の例（bizlp 現状値ベース）

影響範囲

5.1 データソース

5.2 新規ファイル候補

• 400_domain/4XX_loan_screening_engine.js（具体番号は main 側で衝突確認 / 454-466 の隣接帯を想定）
• webapp_client/src/cockpit/LoanScreeningPanel.tsx（cockpit パネル新設）
• 800_ops/8XX_migration_loan_screening_seed.js（マスタ冪等シード・822 まで使用済 (MAS-336 で 822 を予約・MAS-338 で 823 を予約)・824 以降を採番予定だが、実装着手時に最新を再確認のうえ採番）

5.3 MAS-071 連動

• アプローチ D の targetProfit を本仕様の動的算出値で上書きできるようにする
• 優先順位: UI 手動上書き > 動的算出（MAS-337） > historical_default（600 万）
• MAS071_TARGET_PROFIT（sys_params）は default 保持・自動更新しない（人間が検討すべき事項 Q3）

5.4 影響しない範囲

• 既存の MAS071_TARGET_PROFIT 経験則 default は廃止しない（リグレッション診断容易）
• 海外取引・為替リスクは対象外（別仕様 MAS-XXX_fx_translation）
• マイクロローン（100 万円以下）は別フロー（注意事項 #9）

注意事項

1. スコアリングの「総合判定」はあくまで参考値。最終判断は金融機関面談時の人間判断。UI に「参考スコア」と明示する
2. 公庫の審査基準は非公開（内規）。本仕様の閾値（自己資本比率 30%・債務償還年数 10 年等）は公開情報 + 実務目安ベースであり、内規と異なる可能性を UI で明示
3. 自己資本比率 30% 等の閾値は「安全圏」目安。業種・規模で柔軟に解釈される（製造業は厚め・SaaS は薄くても可）
4. TargetProfit 自動算出と MAS-071 アプローチ D 入力の優先順位: UI 手動上書き > 動的算出（MAS-337） > default 600 万。03_sys_params.MAS071_TARGET_PROFIT は自動更新しない（cockpit 上書きは動的・sys_params は default 保持で過去経験則を保存）
5. 業種ベンチマーク（MAS_INDUSTRY_BENCHMARKS）は TKC 経営自己診断システム / 中小企業白書等の公開統計を参照。出典を 備考 列に記録し、年次更新運用とする
6. 創業 1 期目では債務償還年数が計算できない → 売上計画ベース（64_pl_ytd_plan）の代替算出にフォールバック（エッジケース #1 参照）
7. 役員借入金を「自己資金」と誤認しない。公庫は金融資産（預金 / 有価証券）として扱う。UI に「自己資金には役員借入金を含まないでください」のヘルパーテキストを表示
8. 海外取引・為替リスクは本仕様で対象外（MAS-XXX_fx_translation で別仕様化予定）
9. 借入希望額が小さい（例: 100 万円以下）ケースは別フロー（マイクロローン・クラウドファンディング等）。UI で「100 万円未満は別の資金調達手段を検討してください」と表示
10. 担保あり/なしで審査基準が大きく変わる（現状は default 担保なし）。担保ありモードは v2 で拡張
11. 連帯保証人の有無は信用補完の役割があり、スコア重み w_6 に反映。経営者本人の個人保証の場合は 「経営者保証ガイドライン」（中小企業庁・2014 年） 準拠を明示し、ガイドライン遵守時は w_6 加点
12. 73_bs_plan と連動した「3 年後の追加融資余力」シミュレーションは Phase 2（v2 / MAS-067 Phase E 統合）で検討。v0.1 は当期スナップ評価のみ
13. failure_patterns 反映:
    • #18-#20（命名造語禁止）: 「自己資本比率」等の固有名詞は 91_fs_bs の実列名を Read で確認してから記述
    • #26（oauthScopes 部分宣言）: appsscript.json は触らない（sub workspace 制約・main 担当）
    • #33（sync-engines.mjs + cockpit-main.tsx 副作用 import）: 4XX_loan_screening_engine.js を sync 対象に追加し、cockpit-main.tsx に副作用 import を必ず追加（MAS-066 / MAS-071 で同問題の前例あり）

エッジケース

実データ検証

MCP / GAS 環境で事前確認すべき項目

1. 91_fs_bs の実列名: 「純資産」「総資産」「現預金」「有利子負債」が実際にどの列名で格納されているか Read で確認（DDL 定義と実データの乖離チェック・failure_patterns #19）
2. 92_fs_pl の実列名: 「当期純利益」「営業利益」「営業 CF」「減価償却費」の格納位置を確認
3. MAS_LOAN_PRODUCTS シードの整合性: 公庫公式サイト（2026-05 時点）の最新商品条件と乖離がないか年次レビュー
4. MAS_INDUSTRY_BENCHMARKS の出典更新: 中小企業白書 / TKC 経営自己診断は年次更新があるため、シード時点の年度を 備考 列に記録
5. 03_sys_params の MAS337_* 5 キーの初期投入: 8XX_migration_loan_screening_seed.js を冪等運用（既存値があれば上書きしない）

実データ検証シナリオ（Section 8 と統合）

1. bizlp 現状値で公庫 3,000 万を申請: 法人利益 380 万 / 自己資本比率 18% / 自己資金 100 万 → スコア B 判定 / TargetProfit 推奨 600 万 / 不足: 利益 +220 万 + 自己資本比率 +12pt + 自己資金 +200 万 → cockpit にアクション提案（役員報酬調整 + 役員借入金資本金組入れ + 自己資金積増し）
2. 役員報酬 月 50 → 月 35 に下げた場合: 法人利益 380 → 560 万・スコア B → A- 改善・MAS-071 アプローチ D 連動表示
3. 自己資金 100 → 300 に増やした場合: 自己資金比率 1/30 → 1/10 改善・新創業融資要件クリア・スコア B → B+ 改善
4. マル経融資 2,000 万: 商工会議所推薦ありのため別フロー（本仕様では「マル経推薦取得後に申請」と表示）+ 参考スコア表示
5. 3 年後の追加融資 1 億: MAS-067 マルチイヤーで 3 年後の P/L 予測を取得して再評価（Phase 2 / v2 で MAS-067 Phase E 統合時）

関連ドキュメント

人間が検討すべき事項

Q1. スコアリングモデルのアプローチ

推奨: 案 C（ハイブリッド） — 定量はルール（Number.isFinite ガード + 透明な重み計算）でテスト容易性確保、定性（経営者属性 / 借入使途妥当性）は v1 では手動入力ベース、v2 で Vertex Gemini 統合（MAS-067 Phase D の AI 提案統合パターンを踏襲）。

段階導入: v0.1 は案 A（ルールベース）で起動・v2 で AI 統合へ拡張。理由は (a) 案 A で計算ロジックを安定させてから AI 統合 (b) 案 A だけでも US-1〜US-3 の 80% カバー (c) AI 統合は Vertex AI の API コスト + プロンプト設計が独立工程。

Q2. 適用金融機関のスコープ

推奨: v0.1 は公庫のみ・銀行別係数マスタ（MAS_LOAN_PRODUCTS）は将来拡張前提で構造だけ用意

理由:

• (a) 公庫の商品 4 種で本案件の 80% カバー
• (b) 信金・地銀の審査基準は地域差・取引履歴依存で標準化困難
• (c) v2 で「金融機関別」mode を追加する余地（MAS_LOAN_PRODUCTS に provider 列を追加し、シード時に 公庫 / 信金 / 地銀 / メガバンク の 4 値で切替可能な構造）

Q3. 「公庫融資審査基準 = 600 万」の定数化と注釈

推奨:

• (a) 現状の 600 万 default を historical_default として保存
• (b) 本仕様の動的算出値を recommended_targetProfit として表示
• (c) UI 手動上書き > 動的算出 > historical_default の優先順位
• (d) MAS071_TARGET_PROFIT を本仕様で算出した値で 03_sys_params 自動更新はしない（cockpit 上書きで動的・sys_params は default 保持）

理由: 過去経験則の感覚値も廃棄せず保存することでリグレッション診断容易・ユーザーの判断を尊重（自動上書きは「気づかぬうちに上書きされた」事故の温床）。

Q4. MAS-067（マルチイヤー）との連動

推奨: v0.1 は当期スナップ評価のみ・v2 で MAS-067 の 5 軸モデル + 多年シナリオ「3 年後追加融資 X 億」評価を Phase E として追加

理由:

• (a) v0.1 で当期評価のロジックを確定させてから多年化（段階導入・MAS-067 Phase A-D と同パターン）
• (b) MAS-067 Phase A-D が完成済（PR #459）のため拡張ポイントあり
• (c) Burnout / Cap of margin / セーフティ共済等の 5 軸との関連は別 Phase で議論

Q5. テストシナリオ

推奨: 上記「実データ検証」5 ケース + ロールバック（古い defaults に戻す手順）+ Edge case 12 件を 901_test_runner.js に F337-01〜F337-15 として実装

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

あなたはGAS会計システム(bizlp-gas-accounting)のシニア開発者です。
案件 MAS-337「融資審査スコアリング機能（Loan Screening Score）」の Step N を実装してください。

## 実行前タスク
以下のファイルを Read で確認:
1. `docs/dev/dev_mas-337_loan_screening_score.md` 全体（本仕様書）
2. `docs/dev/dev_mas-058_required_revenue_solver.md` の「Step 1 健全性制約 6 項目」「§配置原則」（健全性診断の 6 制約 + cockpit 配置原則）
3. `docs/dev/dev_mas-071_compensation_strategy_simulator.md` の「Step 1.5 評価 API」「アプローチ D」（`MAS071_TARGET_PROFIT` 連動）
4. `400_domain/454_compensation_strategy_engine.js`（IIFE パターン参考）
5. `webapp_client/src/cockpit/CompensationStrategyPanel.tsx`（cockpit パネル参考）
6. `webapp_client/scripts/sync-engines.mjs`（4XX を sync 対象に追加する手順）
7. `webapp_client/src/cockpit-main.tsx`（副作用 import の追加箇所・failure_patterns #33 対策）
8. `000_infra/002_constants.js`（`Constants.getParam` の使い方）
9. `200_data/202_repository.js`（既存 Repository パターン参考）

## 修正対象ファイル
Step 1: `800_ops/8XX_migration_loan_screening_seed.js`（新規）+ `100_config/101_sys_config.js`（DDL 追記のみ）
Step 2: `400_domain/4XX_loan_screening_engine.js`（新規・IIFE 名前空間 `LoanScreeningEngine`）
Step 3: `300_ui/302_spa_bridge.js`（追記のみ・bootstrap + `runLoanScreeningSimulation`）
Step 4: `webapp_client/src/cockpit/LoanScreeningPanel.tsx`（新規）+ `webapp_client/src/CockpitApp.tsx`（追記のみ）
Step 5: `webapp_client/src/cockpit/CompensationStrategyPanel.tsx`（追記のみ・アプローチ D state lift）
Step 6: `900_test/901_test_runner.js`（追記のみ・F337-01〜F337-15）
Step 7: dev 検証 → PR レビュー → main マージ → prod デプロイ

## 実装内容
### Step 1: マスタシード
- `MAS_LOAN_PRODUCTS`（4 商品・新創業 / 中小企業経営力強化 / マル経 / 女性若者シニア）
- `MAS_INDUSTRY_BENCHMARKS`（5 業種・IT / コンサル / 製造 / 小売 / 飲食）
- `03_sys_params` に `MAS337_*` 5 キー（既存値があれば上書きしない冪等性）
- `Utils.logInfo` + `SpreadsheetApp.getUi().alert` の両方
- メニュー登録（`101_sys_config.js` の「🔧 マイグレーション」配下）
- 番号体系: 800_ops/ は **822 まで使用済 (MAS-336 が 822 / MAS-338 が 823 を予約)** → **824 以降を採番**。実装着手時に `ls 800_ops/` で最新を再確認のこと

### Step 2: ドメインエンジン
- IIFE パターン（既存 442-454 と並列対称）
- 公開 API:
  - `LoanScreeningEngine.calcRecommendedTargetProfit(input)` → 3 ロジック max
  - `LoanScreeningEngine.calcRequiredSelfFund(input)` → 商品別必要自己資金
  - `LoanScreeningEngine.calcEquityRatio(bsSnapshot)` → 純資産 / 総資産
  - `LoanScreeningEngine.calcDSCR(input, plSnapshot)` → 営業 CF / 元利返済額
  - `LoanScreeningEngine.evaluateScreening(input)` → 総合スコアリング（A〜E ランク + 警告 + 質問予習リスト）
- エラーガード: `Number.isFinite()` で全数値入力をガード
- 単体テスト F337-01〜F337-14 の期待値で実装

### Step 3: spa_bridge
- bootstrap に `MAS337_*` 5 キー + `MAS_LOAN_PRODUCTS` + `MAS_INDUSTRY_BENCHMARKS` を追加
- `runLoanScreeningSimulation(input)` API 追加
- 結果保存 API（任意・`40_loan_screening_results` 履歴比較用）

### Step 4: cockpit パネル
- 既存 `CompensationStrategyPanel.tsx` パターンの応用
- 入力フォーム（4.1 入力項目テーブル）+ 出力（4.3 出力項目テーブル）
- スコアバッジ（A 緑 / B 黄緑 / C 黄 / D 橙 / E 赤）
- 不足軸の警告メッセージ + 公庫面談予習リスト
- default ON / MAS-058 直下に配置（`CockpitApp.tsx` 追記）

### Step 5: MAS-071 アプローチ D 連動
- cockpit state lift で `recommended_targetProfit` を `CompensationStrategyPanel.tsx` のアプローチ D 入力に注入
- 優先順位: UI 手動上書き > MAS-337 動的算出 > historical_default 600 万
- `MAS071_TARGET_PROFIT`（sys_params）は自動更新しない

### Step 6: テスト
- 単体: F337-01〜F337-14（`901_test_runner.js`）
- E2E: F337-15（cockpit 操作 → MAS-071 アプローチ D 連動表示）

## 制約
- sub workspace 制約準拠: `docs/dev/` のみ書き込み可
- main workspace 制約準拠: `400_domain/`, `300_ui/`, `webapp_client/src/`, `appsscript.json` は main 担当
- failure_patterns #33: `sync-engines.mjs` への追加 + `cockpit-main.tsx` 副作用 import の両方を必ず実施
- failure_patterns #18-#20: 「自己資本比率」等の固有名詞は `91_fs_bs` の実列名を Read で確認してから記述（造語禁止）
- failure_patterns #26: `appsscript.json` は触らない（oauthScopes 部分宣言の地雷）
- `MAS071_TARGET_PROFIT`（sys_params）は **default 保持**・自動更新禁止
- `MAS_INDUSTRY_BENCHMARKS` の出典は `備考` 列に必ず記録（年次更新運用）

## エッジケース
本仕様書「エッジケース」セクションの 12 件を全件テスト化（F337-05〜F337-14）。

## 実データ検証
1. `91_fs_bs` の「純資産」「総資産」「現預金」「有利子負債」列名を Read で実列名確認
2. `92_fs_pl` の「当期純利益」「営業利益」「営業 CF」「減価償却費」格納位置確認
3. `MAS_LOAN_PRODUCTS` シードの公庫公式サイト（2026-05 時点）整合性確認
4. `03_sys_params.MAS337_*` 5 キーの冪等投入動作確認（再実行で値が壊れない）

## 動作確認
1. `npm run push:dev` で開発用 GAS にデプロイ
2. 「🔧 マイグレーション → MAS-337 マスタシード」でマスタ投入
3. cockpit パネルを開き、入力 → スコア表示 → MAS-071 アプローチ D 連動表示を確認
4. F337-01〜F337-15 を `npm run test` で実行 → 全 PASS
5. dev で実データ検証シナリオ 5 件を手動実行
6. main マージ後 `npm run push:prod` で本番デプロイ

### 拡張思考の使用状況
| フェーズ | 拡張思考 | 備考 |
|---|:-:|---|
| Step 1 マスタシード | なし | 仕様書定義済の値を投入のみ |
| Step 2 ドメインエンジン | あり | 4 案アルゴリズム + 6 重み + 業種係数の設計判断 |
| Step 3 spa_bridge | なし | bootstrap 追加と API 配線のみ |
| Step 4 cockpit パネル | 一部 | 既存パターン応用 + UX 配置判断 |
| Step 5 MAS-071 連動 | なし | state lift 配線のみ |
| Step 6 テスト | なし | 期待値が仕様書に確定済 |

推奨実行モデル

変更履歴

仕様書作成プロンプト

あなたは bizlp-gas-accounting プロジェクトの仕様書起票担当です。新規仕様書 **MAS-337: 融資審査スコアリング機能 (Loan Screening Score)** の本体を起草し、ファイルに書き出してください。

## ゴール
`docs/dev/dev_mas-337_loan_screening_score.md` を新規作成。約 600〜800 行・14 セクション全網羅・`docs/_internal/dev_spec_prompt_template.md` のテンプレート遵守。

## 案件 ID 採番経緯 (確定済)
- MAS-336 は同セッションで `dev_mas-336_je_inv_phase1_recognition.md` で消化済
- ユーザー希望「MAS-071 と密接関連のため近傍 ID」だが MAS-071 cluster (MAS-065〜080) は全て使用済
- failure_patterns #31 (ID 衝突回避) に従い、次の空き **MAS-337** を採用
- 仕様書本文の関連ドキュメントセクションで MAS-058/071/067 とのリンクを明示

## 背景 (起票依頼の要約)
main ワークスペース実装担当からの依頼。

### 現状の問題
bizlp の MAS-071 (Compensation Strategy Simulator) アプローチ D「融資対策」は、`MAS071_TARGET_PROFIT` (default **600 万円**) を入力定数として受け取り、`OP_pre - 報酬 ≥ TargetProfit` を満たす役員報酬上限を計算する。

しかし「**なぜ 600 万なのか**」の根拠は `821_migration_mas071_strategy_seed.js` line 35 の description に **「公庫融資審査基準」** とあるのみで、**算出ロジックを持っていない**。実態は経験則ベースの定数:

> 借入額 ÷ 当期純利益 ≦ 10 年 (= 債務償還年数 10 年以内)
>
> 5,000〜6,000 万円借りるなら、年間利益 500〜600 万円以上欲しい

このため:
- ユーザーが目標融資額を変えても TargetProfit が連動しない
- 業種別 / 業歴年数別の係数が反映されない
- 公庫以外の金融機関 (信金・地銀・メガバンク) の審査基準に切り替えられない
- DSCR / 自己資本比率 / 自己資金比率など複数指標との総合判定ができない

### 解決したい User Story
- **Solo-CEO**: 「3,000 万円の運転資金を引きたい。今の月商 / 利益で公庫を通せるか?」を 1 画面で確認したい
- **Solo-CEO**: 「役員報酬を 月 50 万 → 月 80 万に上げると融資審査でどう影響するか」を試算したい
- **Solo-CEO**: 「マル経融資 (上限 2,000 万) と 新創業融資 (上限 3,000 万) の両方を並行検討したい」

## frontmatter (先頭)
```yaml
---
id: MAS-337
aliases: ["LOAN-SCREENING"]
type: Story
status: Open
---
```

## 仕様書に必ず含めるべき内容

### Section 1. 概要 + Section 2. 目的
依頼の問題意識 + User Story 3 件 + MAS-071/058/067 との位置づけ。
「公庫融資審査基準 = 600 万円」が経験則であって動的算出ではないことを明示。

### Section 3. 公庫の融資審査基準・実務知識 (背景セクション・必須)

**3.1 日本政策金融公庫 (JFC) の概要**:
- 国民生活事業 vs 中小企業事業 vs 農林水産事業
- Solo-CEO は通常 国民生活事業 (融資上限 4,800 万・平均 700 万)

**3.2 主要商品テーブル**:
| 商品 | 上限 | 特徴 |
|---|---|---|
| 新創業融資制度 | 3,000 万 (うち運転 1,500 万) | 創業 2 期以内、自己資金 1/10 要件 |
| 中小企業経営力強化資金 | 7,200 万 | 認定支援機関の事業計画書必要 |
| マル経融資 | 2,000 万 | 商工会議所 6 ヶ月指導必須、無担保無保証 |
| 女性・若者・シニア起業家支援資金 | 7,200 万 | 35 歳未満 / 55 歳以上 / 女性 |

**3.3 審査の主要評価軸 (定量・定性)**:
- 定量: 自己資金比率 (1/10 以上 ≦ 安全圏 1/3〜1/2) / 黒字化見込み / 税引前当期純利益 (借入額 ÷ 利益 ≦ 10 年) / 債務償還年数 ((有利子負債 - 現預金) ÷ (営業 CF + 減価償却費) ≦ 10 年) / 自己資本比率 (30% 以上望ましい) / DSCR (営業 CF ÷ 元利返済額 ≧ 1.2〜1.3 倍)
- 定性: 経営者経歴・信用情報 / 事業の独自性・市場性 / 借入金使途明確性 / 取引先・売上見込み / 経営者の人柄

→ 各軸に**法的根拠の有無 / 実務目安かどうか / bizlp で取得済みデータからスコア化できるか**をマッピングするテーブルを必ず記載すること

### Section 4. 機能仕様 (修正方針相当)

**4.1 入力項目**:
- 希望融資額 (運転 / 設備の内訳)
- 融資商品種別 (新創業 / マル経 / 中小企業経営力強化 / その他)
- 取引金融機関 (公庫 / 信金 / 地銀 / メガバンク — 商品により審査基準係数を切替)
- 業種 (IT / コンサル / 製造 / 小売 / 飲食 — リスク係数)
- 業歴 (創業何期目)
- 自己資金額 (役員借入金は除外)
- 連帯保証人有無 / 担保有無

**4.2 算出ロジック (案・複数指標による総合スコアリング)**:
```
推奨_目標法人利益 = max(
  借入希望額 ÷ 必要利益カバー年数,    // 案 A: 債務償還年数ベース
  年間元利返済額 × DSCR_目標,          // 案 B: DSCR ベース
  業種ベンチマーク利益                 // 案 C: 業種別下限
)
必要自己資金 = 借入希望額 × 自己資金比率 (商品別 default)
自己資本比率 (要求) = 純資産 / 総資産 ≧ 30% (公庫優良判定)
スコア = w1 × 利益カバー + w2 × DSCR + w3 × 自己資金 + w4 × 業歴 + w5 × 自己資本比率 + w6 × 経営者属性
```
→ 重み w_i は仕様書で議論して決めてほしい (推奨値 + 根拠)

**4.3 出力項目**:
- **推奨 TargetProfit** (= MAS-071 のアプローチ D に注入する値)
- **推奨自己資金額**
- **必要月商レンジ**
- **総合スコア** (例: A〜E ランク)
- **不足軸の警告メッセージ** (「自己資本比率が低い → 役員借入金の資本金組入れ検討」等)
- **公庫面談で詰められる質問の予習リスト**

**4.4 cockpit 配置**:
- MAS-058 Required Revenue Solver の隣接 / 配下
- MAS-071 Compensation Strategy Simulator のアプローチ D 入力に逆流連動

**4.5 ステータス・スコア表示の例**:
| 指標 | 現状値 | 目標値 | 判定 |
|---|---|---|---|
| 当期純利益 | 380 万 | 600 万 | △ (-220 万 不足) |
| 自己資本比率 | 18% | 30% | × |
| 債務償還年数 | 8.2 年 | < 10 年 | ○ |
| DSCR | 1.45 | ≧ 1.3 | ○ |
| 業歴 | 1 期目 | ≧ 2 期目 | × (新創業融資なら OK) |
| **総合判定** | | | **B (条件付通過見込)** |

### Section 5. 影響範囲 + データソース
- **71_bs / 91_fs_bs**: 自己資本比率、現預金、有利子負債
- **62_pl_ytd / 92_fs_pl**: 当期純利益、営業 CF
- **64_pl_ytd_plan / 95_sim_headcount**: 計画値の営業 CF
- **新規入力**: 融資希望額・商品・自己資金 (ユーザー入力)
- **新規マスタ**: `MAS_LOAN_PRODUCTS` (商品別の上限・自己資金比率・係数) / `MAS_INDUSTRY_BENCHMARKS` (業種別利益基準)
- 新規ファイル候補: `400_domain/4XX_loan_screening_engine.js` (具体番号は main 側で衝突確認)
- cockpit パネル: `webapp_client/src/cockpit/LoanScreeningPanel.tsx` 新設
- MAS-071 連動: アプローチ D の `targetProfit` を本仕様の動的算出値で上書きできるようにする (ユーザー手動上書き優先)

### Section 6. 注意事項 (10-12 件)
- スコアリングの「総合判定」はあくまで参考値。最終判断は金融機関面談時の人間判断
- 公庫の審査基準は非公開 (内規) のため、本仕様の閾値は公開情報 + 実務目安ベース
- 自己資本比率 30% 等の閾値は「安全圏」の目安であって、業種・規模で柔軟に解釈される
- TargetProfit 自動算出と MAS-071 アプローチ D 入力の優先順位 (UI 手動上書き > 動的算出 > default 600 万)
- 業種ベンチマーク (MAS_INDUSTRY_BENCHMARKS) は TKC 経営自己診断システム等の公開統計を参照
- 創業 1 期目では債務償還年数が計算できない → 売上計画ベースの代替算出
- 役員借入金を「自己資金」と誤認しない (公庫は金融資産として扱う)
- 海外取引・為替リスクは本仕様で対象外 (`MAS-XXX_fx_translation` で別仕様)
- 借入希望額が小さい (例: 100 万円以下) ケースは別フロー (マイクロローン)
- 担保あり/なしで審査基準が大きく変わる (現状は 担保なし default)
- 連帯保証人の有無は信用補完の役割があり、スコア重みに反映 (経営者属性 w6)
- 73_bs_plan と連動した「3 年後の追加融資余力」シミュレーションは Phase 2 で検討

### Section 7. エッジケース (10-12 件・計算式表)
- 業歴 1 期目 / 黒字化前: 売上計画ベースで TargetProfit 算出 + 自己資金比率を厳格適用
- 純資産マイナス (債務超過): 自己資本比率 = 0% としてスコア最低 (E ランク・要再建計画)
- DSCR 計算で営業 CF が 0 or マイナス: 即 NG 判定 (≧ 1.0 がそもそも満たせない)
- 自己資金 100% (借入なし): スコア計算スキップ・参考表示のみ
- 借入希望額が商品上限超過: エラー表示 + 別商品を推奨サジェスト
- 手元現金 + 自己資金が借入希望額の 1/10 未満 (新創業融資の最低要件): 警告
- 既存借入あり: (有利子負債 + 借入希望額) で再計算
- 役員報酬月 100 万円超 (高額役員報酬): 公庫は人件費として精査・スコアに警告反映
- 補助金/助成金収入を当期純利益に含めるか: 経常損益ベースで分離 (恒常的でない収入は除外)
- 業種が複数 (IT × コンサル等): 主たる業種のリスク係数を採用 + 注釈
- 連帯保証人が経営者本人 (個人保証) の場合: 中小企業庁ガイドライン (経営者保証ガイドライン) 準拠を明示
- マル経融資 (商工会議所推薦) は審査軸が大きく異なる: 別フローで対応 (推薦書ベース・財務指標は補助的)

### Section 8. 実データ検証 (具体シナリオ + 期待値)
1. **bizlp 現状値で公庫 3,000 万を申請**: 法人利益 380 万 / 自己資本比率 18% → スコア B 判定 / TargetProfit 推奨 600 万 / 不足: 利益 +220 万 + 自己資本比率 +12pt → cockpit にアクション提案 (役員報酬調整 + 役員借入金資本金組入れ)
2. **役員報酬 月 50 → 月 35 に下げた場合**: 法人利益 380 → 560 万・スコア B → A- 改善
3. **自己資金 100 → 300 に増やした場合**: 自己資金比率 1/30 → 1/10 改善・新創業融資要件クリア
4. **マル経融資 2,000 万**: 商工会議所推薦ありのため別フロー (本仕様では「マル経推薦取得後に申請」と表示)
5. **3 年後の追加融資 1 億**: MAS-067 マルチイヤーで 3 年後の P/L 予測を取得して再評価 (Phase 2)

### Section 9. 関連ドキュメント
- [MAS-058 Required Revenue Solver](dev_mas-058_required_revenue_solver.md) — 健全性診断との関係
- [MAS-071 Compensation Strategy Simulator](dev_mas-071_compensation_strategy_simulator.md) — アプローチ D 連動先
- [MAS-067 Multiyear Planning Workspace](dev_mas-067_multiyear_planning_workspace.md) — 5 軸モデル + マルチイヤー融資シミュレーション
- [MAS-057 Solo CEO Cockpit](dev_mas-057_solo_ceo_cockpit.md) — cockpit パネル配置
- 日本政策金融公庫公式サイト (商品別融資条件)
- 公庫国民生活事業の融資概況 (年次レポート)
- 中小企業庁「中小企業白書」 (中小企業の財務指標ベンチマーク)
- TKC / 経営自己診断システム (法人別 / 業種別の財務基準値)

### Section 10. 人間が検討すべき事項 (Q1-Q5 必須・推奨 + トレードオフ + 推奨理由)

#### Q1. スコアリングモデルのアプローチ
- **案 A**: ルールベース (重み w_i + 閾値 + ランク変換) — 透明性高い、調整容易
- **案 B**: AI/LLM ベース (Vertex AI / Gemini が事業計画書 + 数値から定性判定)
- **案 C**: ハイブリッド (定量はルール、定性は AI)
- **推奨**: **案 C (ハイブリッド)** — 定量はルール (Number.isFinite ガード + 透明な重み計算) でテスト容易性確保、定性 (経営者属性 / 借入使途妥当性) は v1 では手動入力ベース、v2 で Vertex Gemini 統合 (MAS-067 Phase D の AI 提案統合パターンを踏襲)。**v0.1 は案 A (ルールベース) で起動・v2 で AI 統合へ拡張**

#### Q2. 適用金融機関のスコープ
- **推奨**: **v0.1 は公庫のみ・銀行別係数マスタ (MAS_LOAN_PRODUCTS) は将来拡張前提で構造だけ用意**。理由: (a) 公庫の商品 4 種で本案件の 80% カバー (b) 信金・地銀の審査基準は地域差・取引履歴依存で標準化困難 (c) v2 で「金融機関別」mode を追加する余地

#### Q3. 「公庫融資審査基準」の定数化と注釈
- **推奨**: **(a) 現状の 600 万 default を「historical_default」として保存 (b) 本仕様の動的算出値を `recommended_targetProfit` として表示 (c) UI 手動上書き > 動的算出 > historical_default の優先順位 (d) `MAS071_TARGET_PROFIT` を本仕様で算出した値で `03_sys_params` 自動更新は**しない** (cockpit 上書きで動的・sys_params は default 保持)**。理由: 過去経験則の感覚値も廃棄せず保存することでリグレッション診断容易・ユーザーの判断尊重

#### Q4. MAS-067 (マルチイヤー) との連動
- **推奨**: **v0.1 は当期スナップ評価のみ・v2 で MAS-067 の 5 軸モデル + 多年シナリオ「3 年後追加融資 X 億」評価を Phase E として追加**。理由: (a) v0.1 で当期評価のロジックを確定させてから多年化 (b) MAS-067 Phase A-D が完成済 (PR #459) のため拡張ポイントあり (c) Burnout / Cap of margin / セーフティ共済等の 5 軸との関連は別 Phase で議論

#### Q5. テストシナリオ
推奨: 上記 Section 8 の 5 ケース + ロールバック (古い defaults に戻す手順) + Edge case 12 件を `901_test_runner.js` に F337-01〜F337-15 として実装

### Section 11. 実装プロンプト (Claude Code 用)
- Step 1: マスタシード (`MAS_LOAN_PRODUCTS` 4 商品 + `MAS_INDUSTRY_BENCHMARKS` 5 業種) 投入
- Step 2: ドメインエンジン (`400_domain/4XX_loan_screening_engine.js` IIFE パターン) 実装
- Step 3: spa_bridge.js に bootstrap 系 + `runLoanScreeningSimulation` API 追加
- Step 4: cockpit パネル (`webapp_client/src/cockpit/LoanScreeningPanel.tsx`) 実装
- Step 5: MAS-071 アプローチ D との連動配線 (cockpit state lift)
- Step 6: 単体テスト (F337-01〜) + E2E (F337-15)
- Step 7: dev 検証 → PR レビュー → main マージ → prod デプロイ

### Section 12. 推奨実行モデル
- マスタシード: Sonnet (DDL + シード値投入のみ)
- ドメインエンジン: Opus (4 案アルゴリズム + 6 重み + 業種係数の設計判断)
- cockpit パネル: Sonnet (既存 SoloFinancialStatementsPanel パターンの応用)
- テスト: Haiku

### Section 13. 変更履歴
| 日付 | 変更内容 |
|---|---|
| 2026-05-01 | v0.1 起票（main 側起票依頼を受けて MAS-337 として起草。Q1-Q5 推奨案を提示・MAS-071 アプローチ D と逆流連動・cockpit パネル新設・MAS_LOAN_PRODUCTS / MAS_INDUSTRY_BENCHMARKS マスタ追加） |

### Section 14. 仕様書作成プロンプト (`<details>` で本プロンプトを丸ごと格納)

## 進め方
1. まず以下の参照ファイルを Read して理解 (それぞれ読み終えたら破棄して構わない・本タスクではノート程度でOK):
   - `docs/_internal/dev_spec_prompt_template.md` (テンプレート構造を把握)
   - `docs/dev/dev_mas-058_required_revenue_solver.md` (MAS-058 健全性診断・隣接配置先)
   - `docs/dev/dev_mas-071_compensation_strategy_simulator.md` (アプローチ D の TargetProfit 連動先)
   - `docs/dev/dev_mas-067_multiyear_planning_workspace.md` (Phase E 拡張候補)
2. `docs/dev/dev_mas-337_loan_screening_score.md` を Write で**1 回の出力で**作成 (約 600〜800 行)
3. テンプレートのセクション構成と本プロンプト記載のセクションリストの両方を満たすこと
4. `<details>` ブロック (Section 14) には**本プロンプト全文を丸ごと**コピーすること

## 制約
- sub workspace 制約: `400_domain/`, `500_import/`, `600_report/`, `webapp_client/src/`, `appsscript.json` は触らない (READ のみ可)
- 仕様書本体のみ書き出す。`docs/_config.json` 反映 / `id_mapping_table.csv` / `todo_master_tables.md` / `changelog.md` 更新 / 関連 spec (MAS-058/071) のクロスリンク追記は親が担当
- 1 つの Write tool call で全文を出力すること (600-800 行は 1 call で十分)
- 出力後はファイルパスと行数を報告するだけでよい (要約や説明は不要)

実行してください。