saas-scaffolder

SaaS 脚手架生成器

生成完整的生产就绪型 SaaS 应用模板，包含身份验证（NextAuth、Clerk 或 Supabase Auth）、支持多租户的数据库架构、账单集成（Stripe 或 Lemon Squeezy）、带验证的 API 路由、使用 shadcn/ui 构建的仪表盘界面，以及部署配置。可根据产品规格在 30 分钟内生成可运行的应用。

核心能力

• 规格驱动的脚手架生成 — 根据简短的产品规格（身份验证／数据库／支付／租户／功能），生成完整的 Next.js App Router + TypeScript + Tailwind + shadcn/ui 文件树。
• 多租户数据库架构 — Drizzle ORM 架构包含工作区（租户边界）、用户、成员、OAuth 账户和会话，并配置适当的索引和级联规则。
• 身份验证 — NextAuth v5 搭配 Drizzle 适配器、OAuth（Google／GitHub）和 magic-link（Resend）提供方，以及路由保护中间件。
• Stripe 账单 — 结账会话、客户门户，以及通过签名验证的 webhook 处理器，确保订阅状态保持同步。
• 多租户模式 — 按工作区限定范围的查询，以及基于套餐的功能限制（free/pro/enterprise）。
• 分阶段构建 + 质量标准 — 按顺序分为 5 个脚手架生成阶段，每个阶段都包含验证、常见问题、最佳实践、故障排查和成功标准。

关键词： SaaS、模板、脚手架生成、Next.js、身份验证、Stripe、账单、多租户、订阅、起始模板、NextAuth、Drizzle ORM、shadcn/ui

适用场景

• 启动新的 SaaS 产品、订阅应用或多租户平台。
• 在构建产品功能前，快速搭建身份验证 + 账单 + 租户管理模板。
• 添加带有基于角色的访问控制和套餐限制的工作区／组织租户管理。
• 为 Next.js 技术栈生成基础 .env.example、架构和 API 路由。

首先确认

开始生成脚手架前，请确认以下输入。如果有任何一项未知或含糊不清，请先询问，不要自行假设：

• 身份验证提供方 — NextAuth / Clerk / Supabase Auth（--auth；会改变生成的身份验证配置和中间件）
• 支付提供方 — Stripe / Lemon Squeezy / 无（--payments；决定账单和 webhook 处理器）
• 租户模式 — 工作区 / 组织 / 单租户（--tenancy；影响整个数据库架构和限定范围的查询）
• 数据库 — Neon / Supabase / 其他 Postgres（--db；设置 Drizzle 适配器和连接配置）

停止规则：只询问最可能改变输出的 2-3 项。如果用户说“直接起草”，则继续，并在产物顶部列出你的假设。

工具

工具	用途	命令
saas_scaffolder.py	生成生产就绪的 SaaS 项目结构（身份验证、账单、租户管理）	python scripts/saas_scaffolder.py --name my-saas --auth nextauth --db neondb --payments stripe --tenancy workspace
feature_flag_manager.py	在 JSON 存储中创建、读取、更新、删除并评估功能标记	python scripts/feature_flag_manager.py evaluate --key dark-mode --environment production --plan pro
tenant_config_validator.py	验证多租户配置，并扫描源代码中缺失的租户范围限定／隔离问题	python scripts/tenant_config_validator.py --config tenant_config.json --src ./app

参考资料

加载与任务相符的参考资料——保持此文件精简，按需查阅详细信息：

• references/project-structure-and-schema.md — 输入规范格式、完整的生成文件树、多租户 Drizzle 架构，以及 .env.example 变量。定义规范、规划文件布局或编写架构／环境配置时阅读。
• references/auth-billing-and-tenancy.md — 完整的 NextAuth 配置、Stripe 结账与 webhook 处理程序、路由保护中间件，以及工作区范围的查询／套餐限制代码。接入身份验证、计费或多租户功能时阅读。
• references/workflow-and-quality.md — 5 个有序的脚手架搭建阶段及各阶段验证、常见问题、最佳实践、故障排除表和成功标准。开始搭建脚手架前以及发布前阅读。

范围与限制

此技能涵盖：

• 使用 Next.js App Router、TypeScript、Tailwind 和 shadcn/ui 搭建全栈 SaaS 脚手架
• 使用 NextAuth v5、Clerk 或 Supabase Auth 设置身份验证，包括 OAuth 和 magic link 提供方
• 集成 Stripe 和 Lemon Squeezy 计费功能，包括结账、webhook 和客户门户
• 多租户模式（工作区／组织），支持基于角色的访问控制和基于套餐的功能限制

此技能不涵盖：

• 初始集成之外的 Stripe 持续计费逻辑（按量计费、基于用量的定价、发票定制）——参见 stripe-integration-expert
• 核心多租户模型之外的数据库架构设计决策（复杂的关系建模、索引策略）——参见 database-schema-designer
• CI/CD 流水线配置、部署自动化或基础设施预配——参见 ci-cd-pipeline-builder
• API 设计标准、版本控制或 OpenAPI 规范生成——参见 api-design-reviewer

集成点

技能	集成方式	数据流
stripe-integration-expert	在已搭建脚手架的 Stripe 配置基础上扩展高级计费模式（按量计费、分级计费、基于用量的计费）	脚手架生成器输出基础 Stripe 配置和 webhook 处理程序；Stripe 专家优化定价模型并添加发票定制功能
database-schema-designer	设计超出核心多租户表范围的扩展架构	脚手架生成器提供基准 users/workspaces/members 架构；架构设计器添加特定领域的实体并优化索引
api-design-reviewer	审查并改进生成的 API 路由，确保一致性并符合标准	脚手架生成器生成初始 API 路由；审查者检查命名、错误处理和响应格式
ci-cd-pipeline-builder	为搭建好脚手架的项目创建部署流水线	脚手架生成器输出应用程序代码；流水线构建器添加 GitHub Actions、预览部署和生产发布工作流
env-secrets-manager	审核并保护环境变量配置	脚手架生成器生成 .env.example；密钥管理器验证没有硬编码密钥，并建议集成密钥库
observability-designer	为搭建好脚手架的应用程序添加日志记录、追踪和监控	脚手架生成器提供应用程序结构；可观测性设计器为 API 路由、webhook 和身份验证流程添加监测能力