# 経営ダッシュボード実装完了レポート

## 📅 実施日
2025-12-26

## ✅ 実装内容

### 1. Code.gs への追加機能

#### 新規関数（合計11個）

1. **updateDashboard()** - メイン関数
   - 経営ダッシュボード全体を更新
   - エラーハンドリング付き
   - 完了通知表示

2. **updateAll()** - 統合更新関数
   - 予実シートと経営ダッシュボードを一括更新
   - メニューから「全て更新」で実行可能

3. **getMonthsElapsed()** - 月数計算
   - 期首から締月までの月数を計算
   - "2025/4" → "2025/10" = 7ヶ月

4. **updateAnnualBudgetVsActual()** - セクション1更新
   - 年間予算 vs 締月地点実績
   - 達成率計算

5. **updateMonthlyBudgetVsActual()** - セクション2更新
   - 締月地点予算 vs 実績
   - 予実差、予実比計算

6. **updateProfitabilityIndicators()** - セクション3更新
   - 売上総利益率
   - 営業利益率
   - 経常利益率

7. **updateEfficiencyIndicators()** - セクション4更新
   - 販管費率（販管費/売上高）
   - 人件費率（人件費/売上高）

8. **updateCashFlowMetrics()** - セクション5更新
   - グロスバーンレート
   - ネットバーンレート
   - ランウェイ計算

9. **updateOtherMetrics()** - セクション6更新
   - 損益分岐点売上高
   - 損益分岐点比率

10. **sumRange()** - ユーティリティ関数
    - 指定範囲の合計を取得

11. **getBudgetSgaExpense()** - 販管費取得
    - 予算入力シートから販管費を自動検出

12. **sumRangeForSga()** - 販管費合計
    - 締月地点の販管費予算を計算

### 2. メニュー更新

新しいメニュー構造:
```
🔷 GemEgg予実管理
├── 📊 予実シートを更新
├── 📈 経営ダッシュボードを更新         ⭐ 新規
├── 🔄 全て更新（予実＋ダッシュボード）  ⭐ 新規
├── ───────────────
├── 初期設定 ▶
│   ├── 予算シートを初期化
│   ├── 実績シートを初期化
│   └── 予実シートを初期化
├── ───────────────
├── 自動化 ▶
│   ├── 毎日自動更新を設定
│   ├── 毎月自動更新を設定
│   └── トリガーを全削除
├── ───────────────
└── ℹ️ 使い方
```

### 3. 自動更新の強化

**autoUpdate()** 関数を拡張:
- 予実シート更新後、自動的にダッシュボードも更新
- トリガー実行時に両方のシートが最新状態に

---

## 📊 経営ダッシュボードの計算ロジック

### セクション1: 年間予算 vs 締月地点実績

| 項目 | 年間予算 (C列) | 締月地点実績 (D列) | 達成率 (E列) |
|------|---------------|------------------|------------|
| 売上高 | 予算入力!O6 | 実績入力!G9:M9の合計 | D/C |
| 売上総利益 | 予算入力!O6 | 実績入力!G18:M18の合計 | D/C |
| 営業利益 | 年間予算 - 販管費 | 実績入力!G32:M32の合計 | D/C |
| 経常利益 | 営業利益 | 実績入力!G35:M35の合計 | D/C |

### セクション2: 締月地点予算 vs 実績

| 項目 | 締月地点予算 (C列) | 締月地点実績 (D列) | 予実差 (E列) | 予実比 (F列) |
|------|------------------|------------------|------------|------------|
| 売上高 | 予算入力!C6:I6の合計 | =D8 | D-C | D/C |
| 売上総利益 | 同上 | =D9 | D-C | D/C |
| 営業利益 | 計算式 | =D10 | D-C | D/C |
| 経常利益 | 計算式 | =D11 | D-C | D/C |

### セクション3: 収益性指標

| 指標 | 計算式 |
|------|--------|
| 売上総利益率 | 売上総利益 / 売上高 |
| 営業利益率 | 営業利益 / 売上高 |
| 経常利益率 | 経常利益 / 売上高 |

### セクション4: 効率性指標

| 指標 | 計算式 |
|------|--------|
| 販管費率 | 販管費 / 売上高 |
| 人件費率 | (役員報酬 + 給料手当 + 法定福利費) / 売上高 |

### セクション5: キャッシュフロー関連

| 指標 | 計算式 |
|------|--------|
| グロスバーンレート | 販管費 / 経過期間 |
| ランウェイ（グロス） | 現金残高 / グロスバーンレート |
| ネットバーンレート | 経常利益 / 経過期間 |
| ランウェイ（ネット） | 現金残高 / ABS(ネットバーンレート) |

### セクション6: その他指標

| 指標 | 計算式 |
|------|--------|
| 損益分岐点売上高 | 販管費（固定費として） |
| 損益分岐点比率 | 損益分岐点売上高 / 実績売上高 |

---

## 🔧 技術的な特徴

### 1. 動的な月数計算
- 期首と締月を自動検出
- 月数に応じて集計範囲を動的に調整

### 2. エラーハンドリング
- 0除算エラーを防止 (`IFERROR()` 使用)
- シート存在確認
- try-catch によるエラー処理

### 3. 販管費の自動検出
- 予算入力シートで「販売管理費 計」を自動検索
- 柔軟な行番号対応

### 4. 数値フォーマット
- 金額: `#,##0`
- 比率: `0.0%` または `0%`
- ランウェイ: `0.0` (月数)

---

## 📋 デプロイ手順

### 1. Google Spreadsheetを開く
https://docs.google.com/spreadsheets/d/17AUAHQQB0nZVje9QXtdISEPtMoa8RXKkuCk4R5iHbd4

### 2. Apps Scriptエディタを開く
「拡張機能」→「Apps Script」

### 3. Code.gsを更新
修正した `Code.gs` の内容を全てコピー＆ペースト

### 4. 保存して実行
1. 保存（Ctrl+S）
2. `onOpen` 関数を実行（初回のみ）
3. 権限承認
4. スプレッドシートを再読み込み

### 5. メニューから実行
「🔷 GemEgg予実管理」→「🔄 全て更新（予実＋ダッシュボード）」

---

## ⚠️ 注意事項

### 1. 締月の変更
- 経営ダッシュボードのC5セル（締月）を変更すると、自動的に計算範囲が調整されます
- 例: "2025/10" → "2025/12" に変更すると、9ヶ月分を集計

### 2. 現金残高の更新
- C29セルの現金残高は手動更新が必要
- 現在値: ¥51,740,149

### 3. 予算入力シートの構造
- B列に項目名
- C〜N列に月別データ（2025-04〜2026-03）
- O列に期間累計
- 「販売管理費 計」の行が必須

### 4. 実績入力シートの構造
- G〜R列に月別データ（2025-04〜2026-03）
- S列に期間累計
- 固定行番号:
  - 9行: 売上高
  - 18行: 売上総損益金額
  - 20行: 役員報酬
  - 21行: 給料手当
  - 22行: 法定福利費
  - 31行: 販売管理費 計
  - 32行: 営業損益金額
  - 35行: 経常損益金額

---

## 🧪 テスト項目

デプロイ後、以下を確認してください:

- [ ] メニューに新しい項目が表示される
- [ ] 「経営ダッシュボードを更新」が実行できる
- [ ] 「全て更新」が実行できる
- [ ] 売上高の年間予算が正しく表示される
- [ ] 締月地点実績が正しく計算される
- [ ] 達成率が正しく表示される（%表示）
- [ ] 予実差が正しく計算される
- [ ] 収益性指標が表示される
- [ ] 効率性指標が表示される
- [ ] キャッシュフロー指標が計算される
- [ ] エラーメッセージが適切に表示される
- [ ] 自動更新トリガーが動作する

---

## 📁 生成ファイル

```
20251226-update-google-sheet/
├── Code.gs                      # 更新版 Apps Script
├── README.md                    # 色変更の説明
├── dashboard-strategy.md        # 詳細実装戦略
├── IMPLEMENTATION.md            # 本ドキュメント
└── nodejs/
    ├── read-all-sheets.js       # シート読み込みスクリプト
    └── read-dashboard.js        # ダッシュボード確認スクリプト
```

---

## 🎯 今後の拡張案

1. **グラフの追加**
   - 月別売上推移グラフ
   - 利益率推移グラフ
   - バーンレート推移グラフ

2. **アラート機能**
   - ランウェイが一定期間以下になったら通知
   - 予算達成率が一定以下になったら通知

3. **複数年比較**
   - 前年同期比較
   - YoY成長率

4. **Vertex AI 連携**
   - 経営指標の自動分析
   - 改善提案の生成

---

**作成日**: 2025-12-26
**作成者**: Claude Code
**バージョン**: 1.0