要件定義書：リハビリサービス運営ダッシュボード生成システム

介護保険の訪問リハビリテーション・通所リハビリテーションの実績データ（Excel）から、年度別（4月～3月）の運営分析ダッシュボードを単体HTMLファイルとして自動生成するPythonスクリプト。生成されたHTMLをCloudflare Pagesにデプロイし、パスワード保護付きでWeb共有する。

主な特徴

• CSS/JS全て埋め込みの単体HTML（外部依存なし、オフライン閲覧可能）
• 複数年度のExcelを一括処理し、年度タブで切り替え表示
• 訪問リハ・通所リハを左右2カラムで常に並列比較
• 損益分岐点・人件費率のインタラクティブ計算
• 年度間比較・季節性分析（複数年度の場合）
• Basic認証付きCloudflare Pagesデプロイ

介護保険の請求実績Excelファイル。1ファイル＝1ヶ月分。複数ファイルを1フォルダに配置して一括処理。

必須列

オプション列

4分類ルール

要介護度の正規化

# 「要介護度1」→「要介護1」に統一
# 「要支援1」「要支援2」はそのまま
# 区分: 「支援」を含む → 要支援、それ以外 → 要介護

同一利用者を年度を跨いで正確に追跡するための複合キー uid を生成。

# 優先順位:
1. 保険者番号 + ID番号  （保険者番号が存在し、1件でも非NaN）
2. 被保険者番号 + ID番号（被保険者番号が存在し、1件でも非NaN）
3. ID番号のみ          （フォールバック）

# 生成例:
uid = "123456_12345"  # 保険者番号_ID番号

# 前処理:
- ID番号がNaNの行は除外
- 文字列化してstrip()で空白除去

6-1. KPIカード（年度サマリー）

6-2. キャンセル率

# 契約区分の推定（月の実日数から）
1～4日  → 週1契約（期待日数 = 4日/月）
5～8日  → 週2契約（期待日数 = 8日/月）
9～12日 → 週3契約（期待日数 = 12日/月）
13日以上 → 週4契約（期待日数 = 16日/月）

# キャンセル率
cancel_rate = (期待日数 - 実日数) / 期待日数 × 100

6-3. 加算分析

各加算（リハビリマネジメント加算、社会参加支援加算、移行支援加算など）について:

• 取得ユーザー数 / 全体ユーザー数
• 取得率（%）
• 加算収益額（¥）

6-4. 時間区分分析（訪問リハのみ）

# 連続セッションを1枠として判定
# 各ユーザーの最頻セッション数から推定:
  1セッション連続 → 40分契約
  2セッション以上 → 60分契約

6-5. 要介護・要支援別 売上分析

訪問・通所それぞれについて:

• 要介護 売上額 / 利用者数 / 平均単価
• 要支援 売上額 / 利用者数 / 平均単価

6-6. 利用期間・連続利用（全履歴ベース）

# 全利用期間（スパン）
duration = (最終月 - 初回月) の月数差 + 1

# 実利用月数
actual_months = 実際に利用があった月の数

# 連続利用月数（最長連続ストリーク）
月番号に変換 → 連続する月を検出 → 最長の連続区間

# 直近連続月数
最終利用月から遡って何ヶ月連続しているか

# 統計値
平均、中央値、最小、最大（スパン・連続利用それぞれ）

6-7. 利用継続率（年度内）

# 年度内で各ユーザーが何ヶ月利用したか
# 分布: 1ヶ月=N名, 2ヶ月=N名, ... 12ヶ月=N名
# 統計: 平均、最小、最大、中央値

6-8. 損益分岐点・利益計算 インタラクティブ

# 入力（JavaScriptで即時計算）
月額コスト（¥）  ... 訪問・通所それぞれ
月額人件費（¥）  ... 訪問・通所それぞれ

# 計算
年度利益 = 年度売上 - (月額コスト × 月数)
人件費率 = (月額人件費 × 月数) ÷ 年度売上 × 100

# 評価基準（色分け）
人件費率 ≤ 50% → 良好（緑）
50% < 人件費率 ≤ 70% → 注意（黄）
人件費率 > 70% → 要改善（赤）

6-9. 併用利用者

# 同一月内で訪問 ∩ 通所を利用した利用者
concurrent_users = houmon_user_ids ∩ tsusho_user_ids

# 年度サマリー
- 月平均 併用利用者数
- 年度内ユニーク併用利用者数

6-10. 年度間比較（複数年度の場合）

• 利用者数トレンド（年度別、訪問/通所別）
• 売上トレンド（年度別、訪問/通所別）
• 平均単価トレンド
• キャンセル率推移
• 季節性分析（月別平均、季節指数、変動係数）

┌─ ヘッダー (.hdr)
│   タイトル / サブタイトル / メタ情報（年度数・月数・生成日）
│
├─ タブバー (.tab-bar)
│   [2025年度(R7) 1ヶ月] [2024年度(R6) 12ヶ月] ... [年度間比較]
│
├─ 年度パネル (.tab-panel) × N年度
│   ├─ パネルヘッダー（年度名・集計期間）
│   ├─ KPI 6カード (.srow6) ← 3列グリッド
│   ├─ 損益分岐点・利益計算 (.bep-section)
│   ├─ 月別推移チャート (.dg) ← 訪問(左) / 通所(右) SVGバーチャート
│   ├─ 月別詳細比較表 (full-width テーブル)
│   ├─ 併用利用者セクション
│   ├─ 4分類別売上（予防訪問/訪問/予防通所/通所）
│   ├─ 利用期間・連続利用（全履歴ベース）
│   ├─ 最新月の詳細 (.dg)
│   │   ├─ 訪問リハ: 要介護度分布, 加算取得率, 時間契約, キャンセル
│   │   └─ 通所リハ: 同上
│   ├─ サービス種別 比較一覧テーブル
│   ├─ キャンセル率 比較
│   └─ 利用者一覧 (.dg) ← 訪問(左) / 通所(右)
│
├─ 年度間比較パネル（複数年度の場合のみ）
│   ├─ トレンド分析チャート
│   ├─ 年度比較チャート（利用者数/売上/キャンセル率）
│   └─ 季節性分析
│
└─ フッター (.ft)

カラーパレット（CSS変数）

主要CSSクラス

9-1. calcAll(el) — 損益・人件費率の即時計算

入力イベント: oninput で呼び出し

1. 入力値のカンマ除去 → 数値化 → カンマ再フォーマット
2. パネル内の年度売上(data-revenue)・月数(data-months)を取得
3. 利益計算: revenue - (cost × months)
4. 人件費率: (labor × months) / revenue × 100
5. 色分け表示（≤50%=green, 50-70%=yellow, >70%=red）

9-2. switchTab(id) — タブ切り替え

全パネルから .active 除去 → 指定パネルに .active 付与
利用者テーブルの遅延ロード（pop関数）も実行

9-3. pop(id) — 利用者テーブル遅延ロード

userData オブジェクトからデータを取得し、
tbodyが空のテーブルに行を動的挿入
（初期ロード高速化のため）

コマンドライン引数

python dashboard_generator.py [オプション] [ファイル...]

--data-dir, -d <DIR>    実績データフォルダ（再帰検索: *.xlsx, *.csv）
--output, -o <FILE>     出力先ファイルパス
files（位置引数）         個別ファイル指定

バッチファイル（ダッシュボード生成.bat）

1. chcp 65001（UTF-8設定）
2. Python存在確認
3. pandas/openpyxl ライブラリ確認 → なければ pip install
4. PowerShell select_folder.ps1 でフォルダ選択GUI表示
5. 選択フォルダを --data-dir に渡して実行
6. 完了後 pause で結果確認

select_folder.ps1

COM FileOpenDialog（モダンUI）でフォルダ選択
→ フォールバック: FolderBrowserDialog
→ 結果を %TEMP%\folder_result.txt に書き出し

デプロイ構成

dist/
├── index.html     ← ダッシュボードHTML
└── _worker.js     ← Basic認証ミドルウェア（Advanced Mode）

_worker.js（認証ミドルウェア）

export default {
  async fetch(request, env) {
    const AUTH_USER = 'admin';
    const AUTH_PASS = '****';  // 設定したパスワード

    const auth = request.headers.get('Authorization');
    if (auth && auth.startsWith('Basic ')) {
      const [user, pass] = atob(auth.slice(6)).split(':');
      if (user === AUTH_USER && pass === AUTH_PASS) {
        return env.ASSETS.fetch(request);  // 静的アセット配信
      }
    }
    return new Response('認証が必要です', {
      status: 401,
      headers: { 'WWW-Authenticate': 'Basic realm="Dashboard"' }
    });
  }
};

デプロイコマンド

# 初回: プロジェクト作成
npx wrangler pages project create dashboard-rehab --production-branch=main

# デプロイ（初回以降共通）
npx wrangler pages deploy dist --project-name=dashboard-rehab

# 削除
npx wrangler pages project delete dashboard-rehab

テスト内容（Playwright）

出力先: 出力/e2e_screenshots/

dashboard_deploy/
├── dashboard_generator.py      ← メインスクリプト（約1950行）
├── ダッシュボード生成.bat       ← GUI実行用バッチ
├── select_folder.ps1            ← フォルダ選択ダイアログ
├── e2e_visual_test.py           ← E2Eテスト（Playwright）
├── install.bat                  ← 環境セットアップ
├── dist/                        ← デプロイ用
│   ├── index.html
│   └── _worker.js
├── 実績データ/                  ← Excelデータ配置先
│   └── *.xlsx
├── 出力/                        ← 生成HTML出力先
│   ├── ダッシュボード_*.html
│   └── e2e_screenshots/
├── ダッシュボード更新手順.html  ← 操作手順書
└── 要件定義書_*.html            ← 本ドキュメント

以下のプロンプトをAIに渡すことで、本システムをゼロから再構築できます。段階的に実行することを推奨します。

一括プロンプト（全フェーズ統合版）

上記Phase 1～5を全て統合した単一プロンプトです。コピーしてそのまま使えます。