multi-tenant-saas-architecture

マルチテナント SaaS アーキテクチャ

このスキルを使って、プロダクトのテナンシーに関する意味をシステム境界や運用上の判断に結び付けます。このスキルが担うのは、各判断の実装や専門家による根拠ではなく、横断的なアーキテクチャの選択です。

ワークフロー

1. サービスの約束を明確にします。 顧客やアカウントの形態、ユーザーと運用担当者、サブスクリプションのコミットメント、リージョン、データの分類、ライフサイクルの状態、サポートモデル、スケールに関する前提、不明点を特定します。契約上の約束と願望を区別します。
2. テナントの意味を定義します。 references/tenant-domain-model-and-boundaries.md を読み込みます。テナント、アカウント、組織、ユーザー、メンバーシップ、サブスクリプション、エンタイトルメント、リソース、環境の意味、所有権、多重度、ライフサイクルの管理主体を確立します。
3. プレーンを分離します。 references/control-and-application-planes.md を読み込みます。制御プレーンのポリシーとライフサイクルの責務を、アプリケーションプレーンのリクエスト処理やデータ提供から分けて図示します。非同期の引き継ぎと障害時の動作も含めます。
4. リソースごとに分離方法を選択します。 references/tenancy-and-data-partitioning-models.md を読み込みます。データ、コンピューティング、キャッシュ、キュー、検索、運用リソースについて、プール型、ブリッジ型、サイロ型、ハイブリッド型を比較します。選択がサービスの約束を満たす理由と、変更のきっかけとなる要因を記録します。
5. 商用フローをつなぎます。 references/onboarding-identity-entitlements-metering-billing.md を読み込みます。課金やセキュリティのポリシーを暗黙の前提にすることなく、サインアップ、ID、プロビジョニング、設定、エンタイトルメント評価、使用量の記録、請求書の管理主体、利用停止、サポート、再開までの流れを追跡します。
6. ライフサイクルと運用を設計します。 references/tenant-aware-operations-capacity-and-cost.md を読み込みます。デプロイ、オブザーバビリティ、クォータ、負荷の高いテナント、復元範囲、エクスポート／削除、コストの帰属、エスカレーションを網羅します。根拠が多く必要な判断は専門家の担当者に引き継ぎます。
7. 記録して検証します。 templates/saas-architecture-brief.md、templates/tenancy-decision-record.md、templates/tenant-lifecycle-checklist.md を使用します。テナント間の安全性、ライフサイクルの冪等性、エンタイトルメントの反映遅延、請求内容の不一致、復元範囲、ノイジーネイバーの挙動を検証します。

出力要件

次の内容を含む SaaS アーキテクチャ概要を作成します。サービスの約束、ドメイン用語と管理主体、制御プレーンとアプリケーションプレーンの境界、リソースごとのテナンシーの選択、ライフサイクルの状態遷移、エンタイトルメント・計測・請求の引き継ぎ、データと復旧の境界、テナントを考慮した運用シナリオ、明示的な前提と根拠の不足、専門家への引き継ぎ、担当者とレビューのきっかけを含む判断事項。

所有権の境界

• 脅威モデリング、認可、テナント分離制御、シークレット、セキュリティ証跡は、secure-software-engineering の担当です。
• 容量モデル、負荷試験またはソークテストの証跡、容量制御としてのクォータ、単位コスト、SLO とコストのトレードオフは、capacity-and-cost-engineering の担当です。
• 価格設定、ARR/MRR、チャーン、顧客維持率、利益率、SaaS の財務成果は、financial-modeling の担当です。
• インフラストラクチャ、ネットワーク、デプロイ、オブザーバビリティ基盤、シークレット管理の実装は、platform-engineering の担当です。
• API、イベント、Webhook、スキーマ、互換性、非推奨化の契約は、api-design-and-evolution の担当です。
• サービスコード、データアクセス、ジョブ、統合、アプリケーションレベルのテストは、backend-engineering の担当です。
• ストレージプラットフォーム、データモデル、データプロダクト、ガバナンスに関する判断は、data-architect の担当です。ライフサイクルに伴う削除要件と検証は、privacy-engineering の担当です。
• システムをまたぐテナント移動、パーティション移行、切り替え、照合、非推奨化の実行は、migration-engineering の担当です。
• 一般的なシステム境界とアーキテクチャ品質に関する判断は、software-architecture の担当です。このスキルでは、その判断に SaaS のテナントおよび商用ライフサイクルの意味合いを加えます。

使用しない場合

セキュリティレビュー、API 契約、データプラットフォームの選定、サービス実装、移行計画、プライバシー関連成果物、容量調査、財務モデル、プラットフォーム運用手順のいずれか単独を扱う場合は、このスキルを使用しないでください。SaaS の文脈が付随的な場合は、より範囲の狭い担当領域から始めてください。テナントライフサイクルやサブスクリプションの境界に関係しない一般的なアーキテクチャ判断には、software-architecture を使用してください。

リファレンスガイド

読み込むタイミング	リファレンスまたはテンプレート
テナント／アカウント／サブスクリプションの用語と所有権を定義するとき	references/tenant-domain-model-and-boundaries.md
ライフサイクルポリシーとリクエスト処理を分離するとき	references/control-and-application-planes.md
プール型、ブリッジ型、サイロ型、ハイブリッド型の分離を比較するとき	references/tenancy-and-data-partitioning-models.md
サインアップ、ID、エンタイトルメント、使用量、課金を接続するとき	references/onboarding-identity-entitlements-metering-billing.md
テナントを考慮した運用、復元、公平性、単位コストの入力値を計画するとき	references/tenant-aware-operations-capacity-and-cost.md
アーキテクチャ全体の成果物を作成するとき	templates/saas-architecture-brief.md
テナンシーの選択と再検討の契機を記録するとき	templates/tenancy-decision-record.md
テナントライフサイクルの完全性を確認するとき	templates/tenant-lifecycle-checklist.md
公開されている出典情報と変換上の制限を確認するとき	references/source-index.md

完了

SaaS に関する重要な各判断について、責任者、代替案とその結果、ライフサイクルと障害時の経路、証拠または明示された不足事項、専門担当者への明確な引き継ぎがそろった時点で終了してください。テナントの権限、分離、商用面、プライバシー、復旧に関する未解決の疑問は、ポリシーを独自に作らず、エスカレーションしてください。