# ダッシュボード指標 - 繁盛店指数 仕様モック

> ⚠️ **ROI仕様の更新 (2026-04-23)**
> フェーズ別ROI仕様(投資回収期間ベース)は**持ち越し**。現仕様は以下のシンプル版:
> - `月次利回り = 単月営業利益 ÷ 初期投資額 × 100`
> - 初期投資額 = 0 または月次利回り > 100% → アラート「**初期投資額が設定されていないです**」を発動
> - 他3指標(坪月商/営業利益率/家賃比率)のフェーズ別評価は維持

> **制作:** [@suguru789987](https://github.com/suguru789987) (PdM)
> **担当範囲:** 現行ロジックの構造問題特定 / 4段階フェーズモデル設計 / 業態×フェーズ×係数の三重決定ロジック / 会社ダッシュボードの3ビュー切替情報設計 / 加重平均ROIへの是正
> **ツール:** Claude Code / HTML / CSS / JavaScript / Markdown
> **🌐 Live Demo:** https://suguru789987.github.io/dashboard-metrics/

---

ラクミー経営管理ダッシュボードの**繁盛店指数4指標すべて**をフェーズ別評価に拡張する仕様モック。
投資回収期間（Payback Period）をベースに、店舗のライフサイクルフェーズごとに**坪月商/営業利益率/家賃比率/ROI**の目標値と評価方式を切り替える。

## 背景

現行ロジック `ROI = 単月営業利益 ÷ 初期投資額` は以下の構造問題を抱える:

- 初期投資が小さい店舗/利益が大きい店舗で **1000%, 10000%** などの異常値が出る
- 会社全体の集計値が **41,972,376.8%** など構造破綻
- 単月基準のため月次ブレの影響が大
- オープン直後と成熟店が同じ指標で比較され、意思決定に使えない

## UIカスタマイズ対応(V89/V69/V17連携)

ダッシュボード指標は**1次/2次/3次**の指標階層で整理され、顧客ごと/業態ごと/フェーズごと/店舗ごと/個人ごとに**タイル構成をカスタマイズ**できます。

| 階層 | 内容 | 例 |
|---|---|---|
| 1次(Raw) | POS/会計から直接取得 | sales, operating_profit, rent, tsubo, customers |
| 2次(Ratio) | 1次の比率・差分 | tsubo_sales, profit_rate, rent_rate, simple_roi, payback_progress |
| 3次(Composite) | 2次+フェーズ分岐の合成指標 | phase_roi, target_achievement, weighted_company_roi, custom_* |

**スコープ継承**: 会社デフォルト → 業態プリセット → フェーズプリセット → 店舗個別 → 個人ビュー

**カスタム指標ビルダー**: 既存の1次/2次を組み合わせて3次指標を自由作成(四則演算+組み込み関数)

## 設計方針

| 要素 | 設計 |
|---|---|
| フェーズ数 | デフォルト **4段階**(会社/店舗単位でカスタム可) |
| フェーズ境界倍率 | デフォルト **1.5倍**(カスタム可) |
| 売上予測方式 | **手動選択**(①実績/②業界ベンチマーク/③予算) |
| 業態ベンチマーク | 業態別、顧客独自業態+ベンチマーク値登録可 |
| タイル構成 | **表示/非表示/順序/サイズをカスタマイズ可**(V89/V69) |
| 指標階層 | **1次/2次/3次で整理**、カスタム指標追加可 |

## 4段階フェーズモデル（デフォルト）

| フェーズ | 判定 | 主ROI | 補助指標 |
|---|---|---|---|
| 🔵 立上期 Launch | オープン〜3ヶ月 | 回収進捗率 | 予測回収月 |
| 🟡 回収期 Recovery | 累計利益 < 初期投資 | 回収進捗率 | 残回収月数 |
| 🟢 安定期 Stable | 回収完了〜目標回収期間×1.5倍 | 年率ROI | 回収倍率 |
| 🟣 成熟期 Mature | 目標回収期間×1.5倍超過 | 年率ROI | 回収倍率、3年トレンド |

## 繁盛店指数4指標 × フェーズ目標値（デフォルト）

| 指標 | 立上期 | 回収期 | 安定期 | 成熟期 | 算出方法 |
|---|---|---|---|---|---|
| 坪月商 | 業態基準×0.6 | 業態基準×0.8 | 業態基準×1.0 | 業態基準×1.0 | 業態ベンチマーク×係数 |
| 営業利益率 | 業態基準×0.4 | 業態基準×0.7 | 業態基準×1.0 | 業態基準×1.1 | 業態ベンチマーク×係数 |
| 家賃比率 | ≤15% | ≤12% | ≤10% | ≤8% | フェーズ別固定値 |
| ROI | 回収進捗率 | 回収進捗率 | 年率25% | 年率20% | 計算方式自体が切替 |

## 計算式

```
投資回収期間(月) = 初期投資額 ÷ 月次予測営業利益
回収進捗率(%)   = 累計営業利益(オープン〜現在) ÷ 初期投資額 × 100
残回収月数      = (初期投資額 − 累計営業利益) ÷ 直近3ヶ月平均営業利益
年率ROI(%)      = 直近12ヶ月営業利益 ÷ 初期投資額 × 100
回収倍率         = 累計営業利益 ÷ 初期投資額
```

## 月次予測営業利益の選択肢（手動）

| 方式 | 計算式 |
|---|---|
| ① 実績ベース | 直近3〜6ヶ月平均営業利益 |
| ② 業界ベンチマーク | 坪数 × 業態別坪月商基準 × 営業利益率基準 |
| ③ 予算ベース | 月次予算営業利益 |

## 会社ダッシュボード集計

```
会社ROI = Σ(各店年率営業利益) ÷ Σ(各店初期投資)  ※加重平均
```

単純和ではなく加重平均化。フェーズ別店舗数構成も併記。

## ファイル構成

- `index.html` - トップ / ナビゲーション
- `shop-dashboard.html` - 店舗ダッシュボード
- `company-dashboard.html` - 会社ダッシュボード
- `settings.html` - フェーズ/ベンチマーク/店舗別設定画面
- `logic-cheatsheet.html` - 計算ロジック可視化
- `SPEC.md` - 詳細仕様書
