契約プラン機能（Contract Plan）

組織に割り当てる料金プラン（月額・生成数区分ごとの上限・超過課金）を、システム管理者が管理する機能。

システム管理画面権限: システム管理者のみ課金実行は未実装（定義のみ）

概要

契約プランは、組織ごとの月額・月間の画像生成数の上限・上限超過時の課金額を定義する。生成数は3つの区分（区分1＝画像キレイ・3D間取り以外／区分2＝画像キレイ／区分3＝3D間取り）に分かれ、区分ごとに上限と超過課金を持つ。

システム管理者がプランを作成・編集し、各組織に割り当てる（組織は最大1プラン。用語: 契約プラン）。
組織一覧の検索（プラン絞り込み）にも利用される。
生成数に基づく実際の課金（請求）の実行は未実装。現状はプラン「定義」と組織への割当まで。実績は生成ログが SoT。

関連データモデル

ContractPlan

prisma/schema/contract-plan.prisma

name? プラン名
monthlyCharge 月額
monthlyGenerationQuota1 月間生成数上限（区分1）
monthlyGenerationQuota2 月間生成数上限（区分2＝画像キレイ）
monthlyGenerationQuota3 月間生成数上限（区分3＝3D間取り）
extraGenerationCharge1 超過課金（区分1）
extraGenerationCharge2 超過課金（区分2）
extraGenerationCharge3 超過課金（区分3）

Organization（割当先）

prisma/schema/organization.prisma

contractPlanId? 割り当てられたプラン（null=未割当）
activatedAt? / deactivatedAt? 有効化・無効化
initialPlanRatio 初期プラン比率（※現状未使用・課題）

生成数区分

区分	対象	上限	超過課金
区分1	画像キレイ・3D間取り以外の生成タイプ	`monthlyGenerationQuota1`	`extraGenerationCharge1`
区分2	画像キレイ（Refinement）	`monthlyGenerationQuota2`	`extraGenerationCharge2`
区分3	3D間取り（SolidFloorPlan）	`monthlyGenerationQuota3`	`extraGenerationCharge3`

関連する画面

apps/system-manager

/contract-plans — プラン一覧
/contract-plans/new — プラン作成
/contract-plans/[contractPlanId] — プラン詳細（削除）
/contract-plans/[contractPlanId]/edit — プラン編集
/organizations/... — 組織にプランを割り当て（組織の作成・編集）

主要な実装（参照）

取得/一覧：apps/system-manager/actions/contract-plan/{get,list}-contract-plan.ts
作成/編集/削除：apps/system-manager/app/contract-plans/ 配下の _actions / フォーム
プラン選択肢（流用）：組織検索のプラン絞り込み等で list-contract-plan.ts を使用

関連・未確定事項

決済（カード登録）：決済機能（Mulpay）
実績の集計：生成ログ機能（生成数の SoT）
月別課金の記録：課金履歴機能（プラン内容のスナップショット＋手動上書き）
課題：initialPlanRatio の廃棄・再設計
未実装：月次請求の自動生成バッチ（API Route）・登録カードへの実課金

開発セッション履歴

本ドキュメントは既存実装をもとに遡及作成。今後の改修は sessions/ 配下に追記する。