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。梳理注册、身份、资源配置、配置管理、权益评估、用量采集、发票权责、暂停、支持和重新激活的流程，不要将计费或安全策略隐含处理。
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
连接注册、身份、权益、用量和计费	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 决策都有明确的负责人、备选方案及其影响、生命周期和故障处理路径、证据或明确标注的缺口，以及明确的专家交接时，即可停止。对于尚未解决的租户权威性、隔离、商业、隐私或恢复问题，应予以升级，而不是自行臆定策略。