Next.js SaaS 启动模板文档

用于安装、配置、扩展和运维 Sushi SaaS starter 的参考步骤;架构决策与实现模式请查看“指南”。

管理控制台的配置与访问

运行和部署独立的管理应用,提升操作员权限、强制 MFA,并配置专用域名。

  • 管理
  • 安全
  • 运维

管理控制台页面与运维操作

了解当前提供的每个管理页面,以及账单、账号风控和写操作的安全规则。

  • 管理
  • 账单
  • 账号风控

快速开始

使用受支持的 Node、pnpm、PostgreSQL 与 Redis 在本地运行 Sushi SaaS Web 和管理端。

  • 安装
  • 本地开发

架构与错误契约

了解 Sushi SaaS 强制执行的应用分层、浏览器数据流、授权边界和多语言无泄漏错误系统。

  • 架构
  • 错误
  • 测试

数据库与迁移

安全使用 PostgreSQL、Drizzle schema、测试数据库和生产迁移执行器。

  • 数据库
  • 运维

身份验证与管理端

配置 Better Auth、账户身份、个人组织与独立的 MFA 管理应用。

  • 身份验证
  • 管理端
  • 安全

组织、团队与租户隔离

配置个人工作区、成员角色、邀请、席位上限、租户隔离、共享积分与组织计费。

  • 组织
  • 授权
  • 租户

方案、上限与功能权限

自定义 Free、Plus、Max 的能力、组织上限、Stripe 映射、宽限期、叠加订阅和客服例外。

  • 方案
  • 计费
  • 权限

Stripe 计费

配置订阅价格、幂等结账、Webhook、积分、客户门户安全与对账。

  • 计费
  • Stripe

组织积分账本

理解组织共享积分、只追加账本、过期、幂等消费与退款。

  • 积分
  • 记账

私有存储上传

通过策略、套餐、配额、校验和与持久删除控制配置 S3 兼容私有上传。

  • 存储
  • 安全

持久任务与就绪检查

运维 PostgreSQL 任务队列、Cron runner、重试、去重、存活探针与依赖就绪检查。

  • 任务
  • 运维
  • 可靠性

事务邮件

配置 Resend、React Email 模板、安全的本地认证链接与持久发送任务。

  • 邮件
  • 运维

Slack 运维通知

通过持久任务队列将运维事件发送到 Slack,并避免泄露敏感数据。

  • Slack
  • 运维

结构化日志

使用可关联、已脱敏的结构化日志运维 Node 与 Edge runtime。

  • 日志
  • 运维

账号数据导出与删除

配置隐私数据清单、认证导出、延迟删除、外部 provider 清理、伪匿名化和取消保护。

  • 隐私
  • 账号
  • 生命周期

文生视频任务模式

通过组织 entitlement、配额、积分、幂等与退款扩展可选的文生视频演示。

  • 任务
  • AI

预约功能

启用带并发安全保留、Stripe 结账、邮件与日历的可选预约流程。

  • 预约
  • 支付

部署与安全清单

通过显式迁移、Cron、readiness、可信网络与生产安全控制部署 Web 和管理应用。

  • 部署
  • 安全
Next.js SaaS 启动模板文档 · Sushi SaaS